@prestyj/editor 0.7.1

package/dist/tools/punch-in.js

@@ -0,0 +1,131 @@
+import { 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 { buildPunchInFilter, punchInsAfterCuts } from "../core/punch-in.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+const PunchRangeSchema = z.object({
+    startSec: z.number().min(0),
+    endSec: z.number().min(0),
+    zoom: z
+        .number()
+        .min(1)
+        .max(2)
+        .optional()
+        .describe("1.0 = no zoom, 1.10 = 10% punch (default), 1.20 = obvious push-in. Capped at 2.0."),
+});
+const PunchInParams = z.object({
+    input: z.string().describe("Source video (relative resolves to cwd)."),
+    output: z.string().describe("Output video. Re-encoded; audio is copied through."),
+    ranges: z
+        .array(PunchRangeSchema)
+        .optional()
+        .describe("Explicit punch ranges. If omitted you must supply `cutPoints` so the tool can " +
+        "auto-derive a brief punch after each cut."),
+    cutPoints: z
+        .array(z.number().min(0))
+        .optional()
+        .describe("Auto mode: timestamps of cuts (e.g. from cut_filler_words.keeps boundaries or " +
+        "detect_silence). One short punch is dropped after each cut to disguise the jump. " +
+        "Mutually exclusive with `ranges` — if both supplied, `ranges` wins."),
+    defaultZoom: z
+        .number()
+        .min(1)
+        .max(2)
+        .optional()
+        .describe("Default zoom when ranges omit it, or for cutPoints mode. Default 1.10."),
+    holdSec: z
+        .number()
+        .positive()
+        .optional()
+        .describe("In cutPoints mode, how long each punch lasts after the cut. Default 1.5s."),
+    rampSec: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Smooth-in/out window in seconds. 0 = instant snap (default). 0.08-0.15s for a " +
+        "subtle push-in animation rather than a pop."),
+    videoCodec: z.string().optional().describe("Default libx264."),
+    crf: z.number().int().min(0).max(51).optional().describe("Default 18."),
+});
+/**
+ * punch_in — digital zoom on a list of ranges. The single best
+ * disguise for jump cuts on a single-camera talking head: cut the
+ * filler / silence, then punch in slightly on the kept side, and the
+ * head-jerk vanishes.
+ *
+ * Also takes `cutPoints` to auto-generate punches after every cut —
+ * pair with `cut_filler_words` or `detect_silence` for a one-shot
+ * "clean up the talking head" pipeline.
+ */
+export function createPunchInTool(cwd) {
+    return {
+        name: "punch_in",
+        description: "Apply digital zoom (punch-in) to one or more ranges of a video. Used to disguise " +
+            "jump cuts on single-camera talking heads — the universal YouTuber trick. Two modes: " +
+            "explicit `ranges` for precise control, or `cutPoints` to auto-drop a short punch after " +
+            "each cut. File-only — works in every host. Re-encodes video; audio is copied through.",
+        parameters: PunchInParams,
+        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.width || !probe.height) {
+                    return err("probe returned no width/height", "input must be a video file with a video stream");
+                }
+                const defaultZoom = args.defaultZoom ?? 1.1;
+                let ranges = [];
+                if (args.ranges && args.ranges.length > 0) {
+                    ranges = args.ranges.map((r) => ({
+                        startSec: r.startSec,
+                        endSec: r.endSec,
+                        zoom: r.zoom ?? defaultZoom,
+                    }));
+                }
+                else if (args.cutPoints && args.cutPoints.length > 0) {
+                    ranges = punchInsAfterCuts(args.cutPoints, probe.durationSec, args.holdSec ?? 1.5, defaultZoom);
+                }
+                else {
+                    return err("neither `ranges` nor `cutPoints` supplied", "pass one — `ranges` for explicit control, `cutPoints` for auto-derive");
+                }
+                if (ranges.length === 0) {
+                    return err("no usable punch ranges produced", "check cutPoints / ranges — every range may have collapsed (zoom<=1 or invalid timing)");
+                }
+                const vf = buildPunchInFilter(ranges, probe.width, probe.height, {
+                    defaultZoom,
+                    rampSec: args.rampSec,
+                });
+                if (!vf) {
+                    return err("filter expression empty", "all supplied ranges were no-ops");
+                }
+                const codec = args.videoCodec ?? "libx264";
+                const crf = String(args.crf ?? 18);
+                const r = await runFfmpeg(["-i", inAbs, "-vf", vf, "-c:v", codec, "-crf", crf, "-c:a", "copy", outAbs], { signal: ctx.signal });
+                if (r.code !== 0) {
+                    return err(`ffmpeg failed: ${tail(r.stderr)}`);
+                }
+                return compact({
+                    path: outAbs,
+                    ranges: ranges.length,
+                    defaultZoom,
+                    rampSec: args.rampSec ?? 0,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+function tail(s) {
+    return s.split("\n").filter(Boolean).slice(-3).join(" | ").slice(-300);
+}
+//# sourceMappingURL=punch-in.js.map

package/dist/tools/punch-in.js.map

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

package/dist/tools/read-skill.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { SkillSource } from "../core/skills-loader.js";
+declare const ReadSkillParams: z.ZodObject<{
+    name: z.ZodString;
+}, z.core.$strip>;
+export declare function createReadSkillTool(skills: SkillSource[]): AgentTool<typeof ReadSkillParams>;
+export {};
+//# sourceMappingURL=read-skill.d.ts.map

package/dist/tools/read-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-skill.d.ts","sourceRoot":"","sources":["../../src/tools/read-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,QAAA,MAAM,eAAe;;iBAEnB,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,OAAO,eAAe,CAAC,CAqB5F"}

package/dist/tools/read-skill.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { err } from "../core/format.js";
+const ReadSkillParams = z.object({
+    name: z.string().min(1).describe("Skill name (without .md extension)."),
+});
+export function createReadSkillTool(skills) {
+    const byName = new Map(skills.map((s) => [s.name, s]));
+    return {
+        name: "read_skill",
+        description: "Read the full content of a skill (recipe). The system prompt lists available skill " +
+            "names + one-line descriptions; call this when you decide a skill applies to the user's " +
+            "request. Returns the markdown content verbatim. Skills include bundled defaults plus " +
+            "user-defined skills from .ezcoder/editor-skills/*.md (project) and ~/.ezcoder/editor-skills/*.md (user).",
+        parameters: ReadSkillParams,
+        async execute({ name }) {
+            const skill = byName.get(name);
+            if (!skill) {
+                return err(`unknown skill: ${name}`, `valid: ${[...byName.keys()].sort().join(", ") || "(none)"}`);
+            }
+            return skill.content;
+        },
+    };
+}
+//# sourceMappingURL=read-skill.js.map

package/dist/tools/read-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-skill.js","sourceRoot":"","sources":["../../src/tools/read-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGxC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CACxE,CAAC,CAAC;AAEH,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,qFAAqF;YACrF,yFAAyF;YACzF,uFAAuF;YACvF,0GAA0G;QAC5G,UAAU,EAAE,eAAe;QAC3B,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE;YACpB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,GAAG,CACR,kBAAkB,IAAI,EAAE,EACxB,UAAU,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAC7D,CAAC;YACJ,CAAC;YACD,OAAO,KAAK,CAAC,OAAO,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/read-transcript.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const ReadTranscriptParams: z.ZodObject<{
+    path: z.ZodString;
+    startSec: z.ZodOptional<z.ZodNumber>;
+    endSec: z.ZodOptional<z.ZodNumber>;
+    contains: z.ZodOptional<z.ZodString>;
+    speaker: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    includeWords: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function createReadTranscriptTool(cwd: string): AgentTool<typeof ReadTranscriptParams>;
+export {};
+//# sourceMappingURL=read-transcript.d.ts.map

package/dist/tools/read-transcript.d.ts.map

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

package/dist/tools/read-transcript.js

@@ -0,0 +1,86 @@
+import { readFileSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err, summarizeList } from "../core/format.js";
+import { parseTranscript } from "../core/whisper.js";
+const ReadTranscriptParams = z.object({
+    path: z.string().describe("Path to a transcript JSON file written by `transcribe`."),
+    startSec: z.number().min(0).optional().describe("Lower bound (inclusive)."),
+    endSec: z.number().min(0).optional().describe("Upper bound (exclusive)."),
+    /** Optional substring filter (case-insensitive). */
+    contains: z.string().optional(),
+    speaker: z
+        .string()
+        .optional()
+        .describe("Filter to one speaker label (case-insensitive). Only meaningful for transcripts that " +
+        "include speaker labels (whisperx / AssemblyAI / manual). ezeditor's bundled transcribe does not."),
+    /** Maximum segments to return inline. Default 50. */
+    limit: z.number().int().min(1).optional(),
+    /** When true, include each segment's word-level timings if present. */
+    includeWords: z
+        .boolean()
+        .optional()
+        .describe("Include word-level timings (when transcribe was run with wordTimestamps=true). " +
+        "Required for building word-by-word burned captions via write_srt(words=...)."),
+});
+export function createReadTranscriptTool(cwd) {
+    return {
+        name: "read_transcript",
+        description: "Query a saved transcript by time range and/or text substring. " +
+            "Use this to pull only the segments you need for a decision instead of dumping the whole transcript. " +
+            "Returns matching segments with timestamps. Long results are truncated (head + tail summary).",
+        parameters: ReadTranscriptParams,
+        async execute({ path, startSec, endSec, contains, speaker, limit = 50, includeWords }) {
+            try {
+                const abs = resolvePath(cwd, path);
+                const t = parseTranscript(readFileSync(abs, "utf8"));
+                const needle = contains?.toLowerCase();
+                const wantSpeaker = speaker?.toLowerCase();
+                const matched = t.segments.filter((s) => {
+                    if (startSec !== undefined && s.end <= startSec)
+                        return false;
+                    if (endSec !== undefined && s.start >= endSec)
+                        return false;
+                    if (needle && !s.text.toLowerCase().includes(needle))
+                        return false;
+                    if (wantSpeaker && (s.speaker ?? "").toLowerCase() !== wantSpeaker)
+                        return false;
+                    return true;
+                });
+                const trimmed = matched.slice(0, limit);
+                const summary = summarizeList(trimmed, 30);
+                const compactSegs = (segs) => segs.map((s) => ({
+                    start: +s.start.toFixed(2),
+                    end: +s.end.toFixed(2),
+                    text: s.text,
+                    ...(s.speaker ? { speaker: s.speaker } : {}),
+                    ...(includeWords && s.words
+                        ? {
+                            words: s.words.map((w) => ({
+                                start: +w.start.toFixed(2),
+                                end: +w.end.toFixed(2),
+                                text: w.text,
+                            })),
+                        }
+                        : {}),
+                }));
+                return compact({
+                    totalMatched: matched.length,
+                    returned: trimmed.length,
+                    truncated: matched.length > limit,
+                    ...(summary.omitted > 0
+                        ? {
+                            head: compactSegs(summary.head),
+                            tail: compactSegs(summary.tail),
+                            omitted: summary.omitted,
+                        }
+                        : { segments: compactSegs(trimmed) }),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=read-transcript.js.map

package/dist/tools/read-transcript.js.map

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

package/dist/tools/read-transcript.test.d.ts

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

package/dist/tools/read-transcript.test.d.ts.map

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

package/dist/tools/read-transcript.test.js

@@ -0,0 +1,136 @@
+import { mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { describe, expect, it } from "vitest";
+import { createReadTranscriptTool } from "./read-transcript.js";
+/**
+ * Filter combinations for read_transcript. The tool is the agent's main
+ * pull-only-what-you-need lever — wrong filtering blows the context budget.
+ */
+function makeTranscriptFile(t) {
+    const dir = mkdtempSync(join(tmpdir(), "gg-rt-"));
+    const path = join(dir, "transcript.json");
+    writeFileSync(path, JSON.stringify(t), "utf8");
+    return { dir, path };
+}
+const TX = {
+    language: "en",
+    durationSec: 120,
+    segments: [
+        { start: 0, end: 5, text: "Hello, welcome to the show.", speaker: "SPEAKER_00" },
+        { start: 5, end: 10, text: "Today we discuss authentication.", speaker: "SPEAKER_00" },
+        { start: 10, end: 20, text: "Auth is a deep topic.", speaker: "SPEAKER_01" },
+        { start: 20, end: 30, text: "Yeah, OAuth and OIDC.", speaker: "SPEAKER_00" },
+        { start: 30, end: 40, text: "Let's wrap with closing thoughts.", speaker: "SPEAKER_01" },
+    ],
+};
+const ctx = {
+    signal: new AbortController().signal,
+    toolCallId: "t1",
+};
+describe("read_transcript", () => {
+    it("returns all segments when no filter supplied", async () => {
+        const { dir } = makeTranscriptFile(TX);
+        const tool = createReadTranscriptTool(dir);
+        const r = await tool.execute({ path: "transcript.json" }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.totalMatched).toBe(5);
+        expect(parsed.returned).toBe(5);
+    });
+    it("filters by [startSec, endSec) interval", async () => {
+        const { dir } = makeTranscriptFile(TX);
+        const tool = createReadTranscriptTool(dir);
+        // Segments fully outside [10, 30) should be excluded; partial overlaps
+        // included. End is exclusive so seg [10,20] is in; seg [20,30] is in
+        // (start=20 < endSec=30); seg [30,40] is OUT (start >= endSec).
+        const r = await tool.execute({ path: "transcript.json", startSec: 10, endSec: 30 }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.totalMatched).toBe(2);
+    });
+    it("filters by case-insensitive substring", async () => {
+        const { dir } = makeTranscriptFile(TX);
+        const tool = createReadTranscriptTool(dir);
+        const r = await tool.execute({ path: "transcript.json", contains: "AUTH" }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.totalMatched).toBe(3);
+    });
+    it("filters by speaker (case-insensitive)", async () => {
+        const { dir } = makeTranscriptFile(TX);
+        const tool = createReadTranscriptTool(dir);
+        const r = await tool.execute({ path: "transcript.json", speaker: "speaker_00" }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.totalMatched).toBe(3);
+    });
+    it("intersects multiple filters (range + speaker + contains)", async () => {
+        const { dir } = makeTranscriptFile(TX);
+        const tool = createReadTranscriptTool(dir);
+        // SPEAKER_00 segments containing "auth" inside [0, 30)
+        const r = await tool.execute({
+            path: "transcript.json",
+            speaker: "SPEAKER_00",
+            contains: "auth",
+            startSec: 0,
+            endSec: 30,
+        }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.totalMatched).toBe(2);
+    });
+    it("respects limit and surfaces truncated=true", async () => {
+        const { dir } = makeTranscriptFile(TX);
+        const tool = createReadTranscriptTool(dir);
+        const r = await tool.execute({ path: "transcript.json", limit: 2 }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.returned).toBe(2);
+        expect(parsed.truncated).toBe(true);
+    });
+    it("returns surface-level error on missing path", async () => {
+        const tool = createReadTranscriptTool("/nonexistent");
+        const r = await tool.execute({ path: "missing.json" }, ctx);
+        expect(r).toMatch(/^error:/);
+    });
+    it("includes speaker in compact output when present", async () => {
+        const { dir } = makeTranscriptFile(TX);
+        const tool = createReadTranscriptTool(dir);
+        const r = await tool.execute({ path: "transcript.json", contains: "Hello" }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.segments[0].speaker).toBe("SPEAKER_00");
+    });
+    it("omits speaker when transcript has no labels", async () => {
+        const noSpeaker = {
+            language: "en",
+            durationSec: 5,
+            segments: [{ start: 0, end: 5, text: "Hi" }],
+        };
+        const { dir } = makeTranscriptFile(noSpeaker);
+        const tool = createReadTranscriptTool(dir);
+        const r = await tool.execute({ path: "transcript.json" }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.segments[0].speaker).toBeUndefined();
+    });
+    it("includes word-level timing only when includeWords=true", async () => {
+        const withWords = {
+            language: "en",
+            durationSec: 1,
+            segments: [
+                {
+                    start: 0,
+                    end: 1,
+                    text: "hi there",
+                    words: [
+                        { start: 0, end: 0.4, text: "hi" },
+                        { start: 0.5, end: 1, text: "there" },
+                    ],
+                },
+            ],
+        };
+        const { dir } = makeTranscriptFile(withWords);
+        const tool = createReadTranscriptTool(dir);
+        const r1 = await tool.execute({ path: "transcript.json" }, ctx);
+        const p1 = JSON.parse(r1);
+        expect(p1.segments[0].words).toBeUndefined();
+        const r2 = await tool.execute({ path: "transcript.json", includeWords: true }, ctx);
+        const p2 = JSON.parse(r2);
+        expect(p2.segments[0].words).toHaveLength(2);
+    });
+});
+//# sourceMappingURL=read-transcript.test.js.map

package/dist/tools/read-transcript.test.js.map

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

package/dist/tools/reformat-timeline.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const ReformatTimelineParams: z.ZodObject<{
+    output: z.ZodString;
+    preset: z.ZodEnum<{
+        "9:16": "9:16";
+        "1:1": "1:1";
+        "4:5": "4:5";
+        "16:9": "16:9";
+        "4:3": "4:3";
+    }>;
+    title: z.ZodString;
+    frameRate: z.ZodNumber;
+    events: z.ZodArray<z.ZodObject<{
+        reel: z.ZodString;
+        sourcePath: z.ZodString;
+        sourceInFrame: z.ZodNumber;
+        sourceOutFrame: z.ZodNumber;
+        clipName: z.ZodOptional<z.ZodString>;
+        sourceDurationFrames: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare function createReformatTimelineTool(cwd: string): AgentTool<typeof ReformatTimelineParams>;
+export {};
+//# sourceMappingURL=reformat-timeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reformat-timeline.d.ts","sourceRoot":"","sources":["../../src/tools/reformat-timeline.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAehD,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;iBAQ1B,CAAC;AAEH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,sBAAsB,CAAC,CAmChG"}

package/dist/tools/reformat-timeline.js

@@ -0,0 +1,61 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { z } from "zod";
+import { buildFcpxml } from "../core/fcpxml.js";
+import { compact, err } from "../core/format.js";
+import { reformatSpec } from "../core/reformat.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+const EventSchema = z.object({
+    reel: z.string(),
+    sourcePath: z.string(),
+    sourceInFrame: z.number().int().min(0),
+    sourceOutFrame: z.number().int().min(1),
+    clipName: z.string().optional(),
+    sourceDurationFrames: z.number().int().positive().optional(),
+});
+const ReformatTimelineParams = z.object({
+    output: z.string().describe("Output .fcpxml path (relative resolves to cwd)."),
+    preset: z
+        .enum(["9:16", "1:1", "4:5", "16:9", "4:3"])
+        .describe("Target aspect ratio. 9:16 for TikTok/Reels/Shorts."),
+    title: z.string(),
+    frameRate: z.number().positive(),
+    events: z.array(EventSchema).min(1),
+});
+export function createReformatTimelineTool(cwd) {
+    return {
+        name: "reformat_timeline",
+        description: "Generate an FCPXML preset for a target aspect ratio (9:16 / 1:1 / 4:5 / 16:9 / 4:3). " +
+            "Pair with import_edl to land a vertical/square version of an existing edit. The host " +
+            "(Resolve Studio Smart Reframe / Premiere Auto Reframe) handles the per-clip reframe " +
+            "after import. Output is one-line confirmation only.",
+        parameters: ReformatTimelineParams,
+        async execute({ output, preset, title, frameRate, events }) {
+            try {
+                const spec = reformatSpec(preset);
+                const text = buildFcpxml({
+                    title: `${title} [${spec.label}]`,
+                    frameRate,
+                    width: spec.width,
+                    height: spec.height,
+                    events,
+                });
+                const abs = safeOutputPath(cwd, output);
+                mkdirSync(dirname(abs), { recursive: true });
+                writeFileSync(abs, text, "utf8");
+                return compact({
+                    ok: true,
+                    path: abs,
+                    preset: spec.preset,
+                    width: spec.width,
+                    height: spec.height,
+                    events: events.length,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=reformat-timeline.js.map

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

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

package/dist/tools/render-multi-format.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import { checkFfmpeg, probeMedia, runFfmpeg } from "../core/media/ffmpeg.js";
+import { MULTI_FORMATS } from "../core/multi-format.js";
+declare const RenderMultiFormatParams: z.ZodObject<{
+    input: z.ZodString;
+    outputDir: z.ZodString;
+    formats: z.ZodArray<z.ZodEnum<{
+        "youtube-1080p": "youtube-1080p";
+        "shorts-9x16": "shorts-9x16";
+        "reels-9x16": "reels-9x16";
+        "tiktok-9x16": "tiktok-9x16";
+        "square-1x1": "square-1x1";
+        "instagram-4x5": "instagram-4x5";
+        "twitter-16x9": "twitter-16x9";
+    }>>;
+    videoCodec: z.ZodOptional<z.ZodString>;
+    crf: z.ZodOptional<z.ZodNumber>;
+    audioBitrate: z.ZodOptional<z.ZodString>;
+    parallel: z.ZodOptional<z.ZodBoolean>;
+    faceTracked: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Internal factory — exposed for tests so they can inject mock ffmpeg
+ * runners without touching the global module. Production code should use
+ * `createRenderMultiFormatTool(cwd)` which wires the real implementations.
+ */
+export interface RenderMultiFormatDeps {
+    runFfmpeg: typeof runFfmpeg;
+    probeMedia: typeof probeMedia;
+    checkFfmpeg: typeof checkFfmpeg;
+}
+export declare function createRenderMultiFormatTool(cwd: string, deps?: Partial<RenderMultiFormatDeps>): AgentTool<typeof RenderMultiFormatParams>;
+export { MULTI_FORMATS };
+//# sourceMappingURL=render-multi-format.d.ts.map

package/dist/tools/render-multi-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-multi-format.d.ts","sourceRoot":"","sources":["../../src/tools/render-multi-format.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAE7E,OAAO,EAEL,aAAa,EAGd,MAAM,yBAAyB,CAAC;AAajC,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;iBAiD3B,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,WAAW,EAAE,OAAO,WAAW,CAAC;CACjC;AAID,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACpC,SAAS,CAAC,OAAO,uBAAuB,CAAC,CAgK3C;AAID,OAAO,EAAE,aAAa,EAAE,CAAC"}