@prestyj/editor 0.7.1

package/dist/system-prompt.test.js

@@ -0,0 +1,87 @@
+import { describe, expect, it } from "vitest";
+import { NoneAdapter } from "./core/hosts/none/adapter.js";
+import { buildEditorHostBlock, buildEditorStaticBody, buildEditorSystemPrompt, spliceHostBlock, } from "./system-prompt.js";
+/**
+ * The system prompt is split into:
+ *   - a static body (cached for the session — host-independent)
+ *   - a host block (rebuilt on host changes)
+ * spliceHostBlock joins them. These tests pin that contract so future
+ * edits don't accidentally bake host state into the static body or drop
+ * the {HOST_BLOCK} sentinel.
+ */
+describe("buildEditorStaticBody", () => {
+    it("contains the {HOST_BLOCK} sentinel exactly once", () => {
+        const body = buildEditorStaticBody("/tmp", { skills: [], styles: [] });
+        const occurrences = body.match(/\{HOST_BLOCK\}/g) ?? [];
+        expect(occurrences.length).toBe(1);
+    });
+    it("does not bake host name / capabilities into static body", () => {
+        const body = buildEditorStaticBody("/tmp", { skills: [], styles: [] });
+        // Templated host strings would match these patterns; descriptive prose
+        // (e.g. "Resolve only") is fine, but a literal "host=resolve  ok=true"
+        // line means the dynamic snapshot leaked into the static body.
+        expect(body).not.toMatch(/host=resolve\s+ok=/);
+        expect(body).not.toMatch(/host=premiere\s+ok=/);
+        expect(body).not.toMatch(/host=none\s+ok=/);
+        // No `caps: move=... color=...` line either — that's host-block territory.
+        expect(body).not.toMatch(/caps:\s*move=/);
+    });
+    it("includes cwd (it's per-session, but doesn't change mid-session)", () => {
+        const body = buildEditorStaticBody("/Users/test/project", {
+            skills: [],
+            styles: [],
+        });
+        expect(body).toContain("cwd=/Users/test/project");
+    });
+    it("renders skill descriptions when provided", () => {
+        const body = buildEditorStaticBody("/tmp", {
+            skills: [
+                {
+                    name: "test-skill",
+                    description: "a fake skill for testing",
+                    content: "...",
+                    origin: "bundled",
+                },
+            ],
+            styles: [],
+        });
+        expect(body).toContain("test-skill");
+        expect(body).toContain("a fake skill for testing");
+    });
+});
+describe("buildEditorHostBlock", () => {
+    it("emits a host=none block for NoneAdapter (ok=true — file-only ops still work)", async () => {
+        const block = await buildEditorHostBlock(new NoneAdapter());
+        expect(block).toContain("host=none");
+        expect(block).toContain("ok=true");
+        expect(block).toContain("# Host");
+        expect(block).toContain("caps: move=");
+    });
+    it("notes that host identity is dynamic (so the agent doesn't anchor to it)", async () => {
+        const block = await buildEditorHostBlock(new NoneAdapter());
+        expect(block).toMatch(/dynamic|re-detect|host_info/i);
+    });
+});
+describe("spliceHostBlock", () => {
+    it("replaces the sentinel with the host block", () => {
+        const fakeStatic = "above\n{HOST_BLOCK}\nbelow";
+        const fakeHost = "# Host\nhost=resolve";
+        expect(spliceHostBlock(fakeStatic, fakeHost)).toBe("above\n# Host\nhost=resolve\nbelow");
+    });
+    it("throws if the sentinel is missing (refuses to ship a prompt without a host section)", () => {
+        expect(() => spliceHostBlock("no sentinel here", "# Host")).toThrow(/sentinel/);
+    });
+});
+describe("buildEditorSystemPrompt — backward-compat one-shot", () => {
+    it("produces a prompt with both static body and live host block", async () => {
+        const prompt = await buildEditorSystemPrompt(new NoneAdapter(), "/tmp", {
+            skills: [],
+            styles: [],
+        });
+        expect(prompt).toContain("# Host");
+        expect(prompt).toContain("host=none");
+        expect(prompt).toContain("# Tool tiers");
+        expect(prompt).not.toContain("{HOST_BLOCK}");
+    });
+});
+//# sourceMappingURL=system-prompt.test.js.map

package/dist/system-prompt.test.js.map

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

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

@@ -0,0 +1,13 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const AddFadesParams: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodString;
+    fadeInSec: z.ZodOptional<z.ZodNumber>;
+    fadeOutSec: z.ZodOptional<z.ZodNumber>;
+    videoCodec: z.ZodOptional<z.ZodString>;
+    crf: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createAddFadesTool(cwd: string): AgentTool<typeof AddFadesParams>;
+export {};
+//# sourceMappingURL=add-fades.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add-fades.d.ts","sourceRoot":"","sources":["../../src/tools/add-fades.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKhD,QAAA,MAAM,cAAc;;;;;;;iBAelB,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,cAAc,CAAC,CAkEhF"}

package/dist/tools/add-fades.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"add-fades.js","sourceRoot":"","sources":["../../src/tools/add-fades.ts"],"names":[],"mappings":"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,UAAU,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC3C,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;IACrE,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;IACtE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAC9D,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;CACxE,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,wFAAwF;YACxF,uFAAuF;YACvF,iDAAiD;QACnD,UAAU,EAAE,cAAc;QAC1B,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,GAAG,CAAC,EAAE,UAAU,GAAG,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,GAAG;YAClF,IAAI,CAAC,WAAW,EAAE;gBAAE,OAAO,GAAG,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;YACvE,IAAI,SAAS,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;gBACxC,OAAO,GAAG,CAAC,qCAAqC,EAAE,mCAAmC,CAAC,CAAC;YACzF,CAAC;YACD,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,yBAAyB,CAAC,CAAC;gBAChF,CAAC;gBACD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;gBAChC,IAAI,CAAC,KAAK;oBAAE,OAAO,GAAG,CAAC,oBAAoB,KAAK,EAAE,CAAC,CAAC;gBACpD,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,CAAC;gBAC9B,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;oBACxC,OAAO,GAAG,CACR,eAAe,UAAU,kBAAkB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAC5D,mCAAmC,CACpC,CAAC;gBACJ,CAAC;gBAED,MAAM,QAAQ,GAAa,EAAE,CAAC;gBAC9B,MAAM,QAAQ,GAAa,EAAE,CAAC;gBAC9B,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;oBAClB,QAAQ,CAAC,IAAI,CAAC,kBAAkB,SAAS,EAAE,CAAC,CAAC;oBAC7C,QAAQ,CAAC,IAAI,CAAC,mBAAmB,SAAS,EAAE,CAAC,CAAC;gBAChD,CAAC;gBACD,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;oBACnB,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,GAAG,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;oBAC7C,QAAQ,CAAC,IAAI,CAAC,eAAe,KAAK,MAAM,UAAU,EAAE,CAAC,CAAC;oBACtD,QAAQ,CAAC,IAAI,CAAC,gBAAgB,KAAK,MAAM,UAAU,EAAE,CAAC,CAAC;gBACzD,CAAC;gBACD,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChD,MAAM,IAAI,GAAG;oBACX,IAAI;oBACJ,KAAK;oBACL,KAAK;oBACL,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;oBAClB,KAAK;oBACL,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;oBAClB,MAAM;oBACN,UAAU,IAAI,SAAS;oBACvB,MAAM;oBACN,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;oBACjB,MAAM;oBACN,KAAK;oBACL,MAAM;oBACN,MAAM;oBACN,MAAM;iBACP,CAAC;gBACF,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;gBACxD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;oBAAE,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACxD,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;YACpE,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,GAAG,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"add-marker.d.ts","sourceRoot":"","sources":["../../src/tools/add-marker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAMxD,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;iBAiCnB,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,eAAe,CAAC,CAgBtF"}

package/dist/tools/add-marker.js

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

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

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

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

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

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

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

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

@@ -0,0 +1,145 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { bundledSfxDescriptionList, listBundledSfxNames, resolveSfx } from "../core/bundled-sfx.js";
+import { compact, err } from "../core/format.js";
+import { checkFfmpeg, probeMedia, runFfmpeg } from "../core/media/ffmpeg.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+import { buildSfxOnCutsFilter } from "../core/sfx-on-cuts.js";
+const AddSfxAtCutsParams = z.object({
+    input: z.string().describe("Source video / audio (relative resolves to cwd)."),
+    sfx: z
+        .string()
+        .describe(`SFX. Pass a bundled name (synthesised on demand, cached at ~/.ezcoder/sfx-cache/) OR a file path. ` +
+        `Bundled names: ${listBundledSfxNames().join(", ")}. ` +
+        `For a custom file: stereo wav / mp3, 200 ms–1 s long is typical.`),
+    output: z.string().describe("Output file. Re-encoded; uses input video codec passthrough."),
+    cutPoints: z
+        .array(z.number().min(0))
+        .min(1)
+        .describe("Timestamps (seconds) where the SFX should fire — RELATIVE TO THE INPUT FILE. ⚠️ If the " +
+        "input is a rendered cut (post-`cut_filler_words` / `text_based_cut`), pass the " +
+        "`timelineCutPoints` from that tool's result — NOT source-video transcript timestamps. " +
+        "Source-space points drift further out of sync after every cut (fine for the first " +
+        "~30 s, off by 20+ s by the end of a typical podcast). Closer-than-minSpacingSec hits " +
+        "are deduped automatically."),
+    sfxGainDb: z
+        .number()
+        .min(-30)
+        .max(6)
+        .optional()
+        .describe("SFX gain offset in dB. Default -8 (subtle, sits below voice). -4 = prominent, " +
+        "-12 = barely-there texture."),
+    duckDb: z
+        .number()
+        .max(0)
+        .optional()
+        .describe("Optional voice ducking depth (dB) under each SFX hit. 0 = off (default), -3 to -6 = " +
+        "polished. Negative values only."),
+    minSpacingSec: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Minimum spacing between SFX hits. Closer cuts get collapsed (avoids 8 stacked whooshes " +
+        "on machine-gun edits). Default 0.25s."),
+    videoCodec: z
+        .string()
+        .optional()
+        .describe("Default 'copy' — no video re-encode. Set to libx264 if input has no compatible video stream."),
+});
+/**
+ * add_sfx_at_cuts — drop a whoosh / pop / swoosh on every cut point
+ * and mix it into the existing audio. The standard sound-design polish
+ * on every retention-tuned vlog. One ffmpeg pass; video is copied
+ * through untouched by default.
+ *
+ * Pair with `cut_filler_words` or `detect_silence` to feed cut points
+ * automatically.
+ */
+export function createAddSfxAtCutsTool(cwd) {
+    return {
+        name: "add_sfx_at_cuts",
+        description: `BAKE SFX into a rendered mp4 — file-only, final-delivery tool. ` +
+            `⚠️ When a host (Resolve / Premiere) is connected, prefer ` +
+            `\`add_sfx_to_timeline\` instead — it places real audio clips on track A3 so ` +
+            `the user hears them on playback and can tune levels in Fairlight. Use this tool ONLY ` +
+            `when host=none OR the user has explicitly asked for a final flat mp4. ` +
+            `Bundled SFX (synthesised on demand): ${bundledSfxDescriptionList()}. ` +
+            `Default gain -8 dB sits below voice; optional -3 to -6 dB voice ducking. Video is ` +
+            `copied through untouched.`,
+        parameters: AddSfxAtCutsParams,
+        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");
+                }
+                // Resolve bundled name OR file path. Synthesises on first cache miss.
+                let sfxAbs;
+                let sfxInfo;
+                try {
+                    const r = await resolveSfx(args.sfx, cwd, ctx.signal);
+                    sfxAbs = r.path;
+                    sfxInfo = { bundled: r.bundled, name: r.name };
+                }
+                catch (e) {
+                    return err(e.message, "use a bundled SFX name or supply a real file path");
+                }
+                const probe = probeMedia(inAbs);
+                if (!probe)
+                    return err(`probe failed for ${inAbs}`, "verify file exists and is media");
+                if (!probe.audioCodec) {
+                    return err("input has no audio stream", "add audio first or use a different input");
+                }
+                const { filterComplex, hits } = buildSfxOnCutsFilter({
+                    cutPoints: args.cutPoints,
+                    totalSec: probe.durationSec,
+                    sfxGainDb: args.sfxGainDb,
+                    duckDb: args.duckDb,
+                    minSpacingSec: args.minSpacingSec,
+                });
+                if (hits === 0) {
+                    return err("no usable cut points after filtering", "all cuts were outside [0, duration) or collapsed by minSpacingSec");
+                }
+                const videoCodec = args.videoCodec ?? "copy";
+                const ffArgs = [
+                    "-i",
+                    inAbs,
+                    "-i",
+                    sfxAbs,
+                    "-filter_complex",
+                    filterComplex,
+                    "-map",
+                    "0:v?",
+                    "-map",
+                    "[mix]",
+                    "-c:v",
+                    videoCodec,
+                    "-c:a",
+                    "aac",
+                    "-b:a",
+                    "192k",
+                    outAbs,
+                ];
+                const r = await runFfmpeg(ffArgs, { signal: ctx.signal });
+                if (r.code !== 0) {
+                    return err(`ffmpeg failed: ${tail(r.stderr)}`);
+                }
+                return compact({
+                    path: outAbs,
+                    hits,
+                    sfx: sfxInfo.bundled ? `bundled:${sfxInfo.name}` : sfxAbs,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+function tail(s) {
+    return s.split("\n").filter(Boolean).slice(-3).join(" | ").slice(-300);
+}
+//# sourceMappingURL=add-sfx-at-cuts.js.map

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

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

package/dist/tools/add-sfx-to-timeline.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+/**
+ * add_sfx_to_timeline — drop SFX clips DIRECTLY onto the active timeline's
+ * audio track at each cut point. Sibling of `add_sfx_at_cuts` but operates
+ * on the live host (Resolve / Premiere) instead of producing a new mp4.
+ *
+ * Why this exists: `add_sfx_at_cuts` is file-only — it bakes SFX into a
+ * rendered mp4. That's right for "ship the final file" workflows but wrong
+ * when the user wants the SFX in the timeline so they can keep editing,
+ * tune levels in Fairlight, or hear it on playback in Resolve.
+ *
+ * Mechanics:
+ *   1. Resolve the SFX (bundled name → synthesise via ffmpeg / cache;
+ *      file path → pass through).
+ *   2. Get the timeline frame rate (needed to convert seconds → record frames).
+ *   3. For each cut point: place the SFX wav at that record frame on the
+ *      target audio track via `host.insertClipOnTrack(mediaKind="audio")`.
+ *
+ * Volume / ducking: the inserted clips land at unity gain. Use Fairlight
+ * (Resolve) or Audio Mixer (Premiere) to adjust per-clip levels — Fairlight
+ * isn't scriptable so we don't try.
+ */
+declare const AddSfxToTimelineParams: z.ZodObject<{
+    sfx: z.ZodString;
+    cutPoints: z.ZodArray<z.ZodNumber>;
+    track: z.ZodOptional<z.ZodNumber>;
+    frameRate: z.ZodOptional<z.ZodNumber>;
+    minSpacingSec: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createAddSfxToTimelineTool(host: VideoHost, cwd: string): AgentTool<typeof AddSfxToTimelineParams>;
+export {};
+//# sourceMappingURL=add-sfx-to-timeline.d.ts.map

package/dist/tools/add-sfx-to-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-sfx-to-timeline.d.ts","sourceRoot":"","sources":["../../src/tools/add-sfx-to-timeline.ts"],"names":[],"mappings":"AAAA,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;AAGxD;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,QAAA,MAAM,sBAAsB;;;;;;iBA2C1B,CAAC;AAEH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,sBAAsB,CAAC,CAwH1C"}