@prestyj/editor 0.7.1

package/dist/tools/text-based-cut.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+/**
+ * text_based_cut — Descript's flagship feature, generalised. Given an
+ * arbitrary list of (startSec, endSec) cut ranges, emit an EDL of KEEP
+ * ranges using the same frame-aligned, padding-aware math as
+ * cut_filler_words. The agent typically populates `cuts` after one of:
+ *
+ *   - The user marked sentences in the transcript they want removed.
+ *   - An LLM diffed an "edited" transcript against the original and
+ *     produced a delete-list.
+ *   - A previous tool (e.g. cluster_takes) flagged ranges to drop.
+ *
+ * Distinct from cut_filler_words because the cut list is opinion-free
+ * here — the caller decides what to remove. Distinct from write_edl
+ * because this tool computes the *inverse* (keep ranges) for you.
+ */
+declare const TextBasedCutParams: z.ZodObject<{
+    sourceVideo: z.ZodString;
+    cuts: z.ZodArray<z.ZodObject<{
+        startSec: z.ZodNumber;
+        endSec: z.ZodNumber;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    edlOutput: z.ZodOptional<z.ZodString>;
+    reel: z.ZodOptional<z.ZodString>;
+    frameRate: z.ZodOptional<z.ZodNumber>;
+    paddingMs: z.ZodOptional<z.ZodNumber>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function createTextBasedCutTool(cwd: string): AgentTool<typeof TextBasedCutParams>;
+export {};
+//# sourceMappingURL=text-based-cut.d.ts.map

package/dist/tools/text-based-cut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-based-cut.d.ts","sourceRoot":"","sources":["../../src/tools/text-based-cut.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAWhD;;;;;;;;;;;;;;GAcG;AAEH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;iBAwCtB,CAAC;AAEH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,kBAAkB,CAAC,CAyHxF"}

package/dist/tools/text-based-cut.js

@@ -0,0 +1,172 @@
+import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, dirname, extname, join, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { buildEdl } from "../core/edl.js";
+import { keepRangesFromFillers, keepRangesToFrameRanges, } from "../core/filler-words.js";
+import { compact, err } from "../core/format.js";
+import { probeMedia } from "../core/media/ffmpeg.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+/**
+ * text_based_cut — Descript's flagship feature, generalised. Given an
+ * arbitrary list of (startSec, endSec) cut ranges, emit an EDL of KEEP
+ * ranges using the same frame-aligned, padding-aware math as
+ * cut_filler_words. The agent typically populates `cuts` after one of:
+ *
+ *   - The user marked sentences in the transcript they want removed.
+ *   - An LLM diffed an "edited" transcript against the original and
+ *     produced a delete-list.
+ *   - A previous tool (e.g. cluster_takes) flagged ranges to drop.
+ *
+ * Distinct from cut_filler_words because the cut list is opinion-free
+ * here — the caller decides what to remove. Distinct from write_edl
+ * because this tool computes the *inverse* (keep ranges) for you.
+ */
+const TextBasedCutParams = z.object({
+    sourceVideo: z.string().describe("The source media. Frame rate auto-detected via probe."),
+    cuts: z
+        .array(z.object({
+        startSec: z.number().min(0),
+        endSec: z.number().min(0),
+        reason: z.string().optional().describe("Optional human-readable reason for this cut."),
+    }))
+        .min(1)
+        .describe("Ranges to REMOVE. The tool emits the inverse (keep ranges) as an EDL. For multi-segment " +
+        "removals, pass them all in one call; ranges may overlap (they're merged)."),
+    edlOutput: z.string().optional().describe("Where to write the EDL. Default: a tempfile."),
+    reel: z
+        .string()
+        .optional()
+        .describe("EDL reel name. Default = source basename without extension (truncated to 8 chars)."),
+    frameRate: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Override frame rate. Auto-detected from probe if omitted; 30 if probe fails."),
+    paddingMs: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Optional padding extending each KEEP range outward, so cuts don't clip word edges. " +
+        "Default 20ms."),
+    dryRun: z
+        .boolean()
+        .optional()
+        .describe("If true (default), return the EDL path + stats without importing. The agent should " +
+        "preview the diff before calling import_edl."),
+});
+export function createTextBasedCutTool(cwd) {
+    return {
+        name: "text_based_cut",
+        description: "Cut arbitrary ranges from a source via EDL. Pass `cuts: [{startSec, endSec}]` and the " +
+            "tool emits the INVERSE (keep ranges) as an EDL ready for import_edl. The general-purpose " +
+            "version of cut_filler_words — same frame-aligned math, but the caller picks what to drop. " +
+            "Use this for transcript-driven 'delete this paragraph' edits (Descript-style text-based " +
+            "editing) and for any LLM-derived removal list.",
+        parameters: TextBasedCutParams,
+        async execute(args) {
+            try {
+                const sourceAbs = resolvePath(cwd, args.sourceVideo);
+                const probe = probeMedia(sourceAbs);
+                const totalSec = probe?.durationSec;
+                if (!totalSec || totalSec <= 0) {
+                    return err(`probe failed for ${sourceAbs}`, "verify the source file exists and is readable");
+                }
+                const fps = args.frameRate ?? probe?.frameRate ?? 30;
+                const padSec = (args.paddingMs ?? 20) / 1000;
+                // Validate / clamp cut ranges, then translate them into the
+                // FillerRange shape that keepRangesFromFillers expects (it only
+                // reads startSec / endSec — the word-index fields are unused).
+                const validatedCuts = [];
+                for (const c of args.cuts) {
+                    if (c.endSec <= c.startSec) {
+                        return err(`invalid cut: endSec (${c.endSec}) must be > startSec (${c.startSec})`, "fix the cut list");
+                    }
+                    if (c.startSec >= totalSec)
+                        continue; // out of range — silently skip
+                    validatedCuts.push({
+                        startSec: Math.max(0, c.startSec),
+                        endSec: Math.min(totalSec, c.endSec),
+                        reason: c.reason,
+                    });
+                }
+                if (validatedCuts.length === 0) {
+                    return err("no valid cuts in range", "verify cut times are within the source duration");
+                }
+                // Sort + merge overlapping cuts so the keep computation is clean.
+                validatedCuts.sort((a, b) => a.startSec - b.startSec);
+                const merged = [];
+                for (const c of validatedCuts) {
+                    const prev = merged[merged.length - 1];
+                    if (prev && c.startSec <= prev.endSec) {
+                        prev.endSec = Math.max(prev.endSec, c.endSec);
+                        if (c.reason && prev.reason && !prev.reason.includes(c.reason)) {
+                            prev.reason = `${prev.reason}; ${c.reason}`;
+                        }
+                    }
+                    else {
+                        merged.push({ ...c });
+                    }
+                }
+                const fillers = merged.map((c) => ({
+                    startSec: c.startSec,
+                    endSec: c.endSec,
+                    text: c.reason ?? "cut",
+                    startWordIndex: 0,
+                    endWordIndex: 0,
+                }));
+                // Negative padSec collapses keep ranges; a positive value extends
+                // them. keepRangesFromFillers does inward padding by virtue of the
+                // way it carves keeps; we widen by relaxing both endpoints.
+                const keeps = keepRangesFromFillers(fillers, totalSec, 0).map((k) => ({
+                    startSec: Math.max(0, k.startSec - padSec),
+                    endSec: Math.min(totalSec, k.endSec + padSec),
+                }));
+                const frameKeeps = keepRangesToFrameRanges(keeps, fps);
+                if (frameKeeps.length === 0) {
+                    return err("no keep ranges produced — the cut list covers the entire source");
+                }
+                const reelName = args.reel ??
+                    basename(sourceAbs, extname(sourceAbs))
+                        .replace(/[^A-Za-z0-9_]/g, "_")
+                        .slice(0, 8);
+                const edl = buildEdl({
+                    title: `${basename(sourceAbs)} (text-based cut)`,
+                    frameRate: fps,
+                    events: frameKeeps.map((k) => ({
+                        reel: reelName,
+                        track: "B",
+                        sourceInFrame: k.startFrame,
+                        sourceOutFrame: k.endFrame,
+                        clipName: basename(sourceAbs),
+                    })),
+                });
+                const outAbs = args.edlOutput
+                    ? safeOutputPath(cwd, args.edlOutput)
+                    : join(mkdtempSync(join(tmpdir(), "gg-textcut-")), "cuts.edl");
+                if (args.edlOutput)
+                    mkdirSync(dirname(outAbs), { recursive: true });
+                writeFileSync(outAbs, edl, "utf8");
+                const removedSec = +merged.reduce((s, c) => s + (c.endSec - c.startSec), 0).toFixed(3);
+                return compact({
+                    path: outAbs,
+                    dryRun: args.dryRun ?? true,
+                    fps,
+                    totalSec,
+                    cuts: merged.length,
+                    keeps: keeps.length,
+                    removedSec,
+                    sample: merged.slice(0, 10).map((c) => ({
+                        startSec: +c.startSec.toFixed(2),
+                        endSec: +c.endSec.toFixed(2),
+                        reason: c.reason,
+                    })),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=text-based-cut.js.map

package/dist/tools/text-based-cut.js.map

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

package/dist/tools/text-based-cut.test.d.ts

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

package/dist/tools/text-based-cut.test.d.ts.map

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

package/dist/tools/text-based-cut.test.js

@@ -0,0 +1,32 @@
+import { describe, expect, it } from "vitest";
+// We test the keep-range computation indirectly via the keepRangesFromFillers
+// helper that text_based_cut wraps. The tool's own validation/merge logic is
+// covered here by exercising the public interface.
+import { keepRangesFromFillers, keepRangesToFrameRanges } from "../core/filler-words.js";
+describe("text_based_cut keep-range math (via keepRangesFromFillers)", () => {
+    it("emits two keeps when one cut is in the middle", () => {
+        const cuts = [{ startSec: 5, endSec: 10, text: "x", startWordIndex: 0, endWordIndex: 0 }];
+        const keeps = keepRangesFromFillers(cuts, 30, 0);
+        expect(keeps).toEqual([
+            { startSec: 0, endSec: 5 },
+            { startSec: 10, endSec: 30 },
+        ]);
+    });
+    it("emits one keep when cuts are at the start", () => {
+        const cuts = [{ startSec: 0, endSec: 5, text: "head", startWordIndex: 0, endWordIndex: 0 }];
+        const keeps = keepRangesFromFillers(cuts, 30, 0);
+        expect(keeps).toEqual([{ startSec: 5, endSec: 30 }]);
+    });
+    it("frame-aligns with OUTWARD rounding to preserve speech in partial frames", () => {
+        const keeps = [{ startSec: 1.05, endSec: 2.95 }];
+        // 30 fps: floor(31.5)=31, ceil(88.5)=89 — expands keep by one frame on
+        // each end. Was inward (32, 88), which lost ~33 ms per junction.
+        expect(keepRangesToFrameRanges(keeps, 30)).toEqual([{ startFrame: 31, endFrame: 89 }]);
+    });
+    it("returns empty when cuts cover the entire source", () => {
+        const cuts = [{ startSec: 0, endSec: 30, text: "all", startWordIndex: 0, endWordIndex: 0 }];
+        const keeps = keepRangesFromFillers(cuts, 30, 0);
+        expect(keeps).toEqual([]);
+    });
+});
+//# sourceMappingURL=text-based-cut.test.js.map

package/dist/tools/text-based-cut.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-based-cut.test.js","sourceRoot":"","sources":["../../src/tools/text-based-cut.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,8EAA8E;AAC9E,6EAA6E;AAC7E,mDAAmD;AACnD,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEzF,QAAQ,CAAC,4DAA4D,EAAE,GAAG,EAAE;IAC1E,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,IAAI,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1F,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;YACpB,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;YAC1B,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,IAAI,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5F,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,KAAK,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,uEAAuE;QACvE,iEAAiE;QACjE,MAAM,CAAC,uBAAuB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,IAAI,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5F,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/transcribe.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const TranscribeParams: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodString;
+    backend: z.ZodOptional<z.ZodEnum<{
+        whisperx: "whisperx";
+        api: "api";
+        local: "local";
+        auto: "auto";
+    }>>;
+    modelPath: z.ZodOptional<z.ZodString>;
+    apiModel: z.ZodOptional<z.ZodEnum<{
+        "whisper-1": "whisper-1";
+        "gpt-4o-transcribe": "gpt-4o-transcribe";
+        "gpt-4o-mini-transcribe": "gpt-4o-mini-transcribe";
+        "gpt-4o-transcribe-diarize": "gpt-4o-transcribe-diarize";
+    }>>;
+    language: z.ZodOptional<z.ZodString>;
+    wordTimestamps: z.ZodOptional<z.ZodBoolean>;
+    diarize: z.ZodOptional<z.ZodBoolean>;
+    whisperxModel: z.ZodOptional<z.ZodString>;
+    chunkingStrategy: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+    }>>;
+}, z.core.$strip>;
+export declare function createTranscribeTool(cwd: string): AgentTool<typeof TranscribeParams>;
+export {};
+//# sourceMappingURL=transcribe.d.ts.map

package/dist/tools/transcribe.d.ts.map

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

package/dist/tools/transcribe.js

@@ -0,0 +1,117 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+import { detectApiKey, detectLocalWhisper, transcribe } from "../core/whisper.js";
+const TranscribeParams = z.object({
+    input: z.string().describe("Audio/video file path (.wav recommended; ≤25MB for API backend)."),
+    output: z
+        .string()
+        .describe("Where to save the full transcript JSON. Used by read_transcript later."),
+    backend: z.enum(["local", "api", "whisperx", "auto"]).optional(),
+    modelPath: z
+        .string()
+        .optional()
+        .describe("Path to whisper.cpp ggml model. Required for local backend."),
+    apiModel: z
+        .enum(["whisper-1", "gpt-4o-transcribe", "gpt-4o-mini-transcribe", "gpt-4o-transcribe-diarize"])
+        .optional()
+        .describe("OpenAI transcription model. Default 'whisper-1' — the only one with word/segment " +
+        "timestamps (needed for burn_subtitles). 'gpt-4o-transcribe' has higher accuracy but " +
+        "text-only (no segments). 'gpt-4o-transcribe-diarize' returns speaker-labelled " +
+        "segments without needing whisperx/HF_TOKEN — prefer this for speaker analysis."),
+    language: z.string().optional().describe("ISO-639-1 code (e.g. 'en'). Auto-detected if omitted."),
+    wordTimestamps: z
+        .boolean()
+        .optional()
+        .describe("Request per-word timestamps (needed for word-by-word burned captions). " +
+        "Local whisper.cpp uses -ml=1 mode; OpenAI uses timestamp_granularities=word. " +
+        "Only effective with whisper-1 backend (gpt-4o-* don't support word-level timing)."),
+    diarize: z
+        .boolean()
+        .optional()
+        .describe("Local diarization via whisperx + pyannote. Requires `whisperx` on PATH and " +
+        "HF_TOKEN env (free Hugging Face account). For server-side diarization with no " +
+        "local install, set apiModel='gpt-4o-transcribe-diarize' instead. " +
+        "Use this BEFORE detect_speaker_changes — if diarization succeeds you don't need the heuristic."),
+    whisperxModel: z
+        .string()
+        .optional()
+        .describe("whisperx model size (tiny/base/small/medium/large-v3). Default 'base'."),
+    chunkingStrategy: z
+        .enum(["auto"])
+        .optional()
+        .describe("Server-side chunking for the gpt-4o-transcribe family. 'auto' lets OpenAI " +
+        "normalize loudness, run VAD, and process clips up to ~25 min within the 25MB cap. " +
+        "Auto-enabled for gpt-4o-transcribe-diarize on inputs >30s."),
+});
+export function createTranscribeTool(cwd) {
+    return {
+        name: "transcribe",
+        description: "Transcribe audio/video to text with timestamps. Writes full transcript JSON to `output`; " +
+            "returns compact summary (lang, segment count, duration) plus head/tail samples. " +
+            "Use read_transcript to query the file by time/text. " +
+            "Backends: 'local' (whisper.cpp), 'api' (OpenAI — see apiModel for model choice), " +
+            "or 'whisperx' (local diarization). For speaker labels without a local install, " +
+            "use backend='api' + apiModel='gpt-4o-transcribe-diarize'.",
+        parameters: TranscribeParams,
+        async execute(args, ctx) {
+            const { input, output, backend, modelPath, language } = args;
+            try {
+                const inAbs = resolvePath(cwd, input);
+                const outAbs = safeOutputPath(cwd, output);
+                const want = backend === "auto" ? undefined : backend;
+                const local = detectLocalWhisper();
+                const haveApiKey = !!detectApiKey();
+                if (!want && !local && !haveApiKey) {
+                    return err("no transcription backend available", "install whisper.cpp + pass modelPath, or set OPENAI_API_KEY");
+                }
+                const t = await transcribe(inAbs, {
+                    backend: want,
+                    modelPath,
+                    apiModel: args.apiModel,
+                    language,
+                    wordTimestamps: args.wordTimestamps,
+                    diarize: args.diarize,
+                    whisperxModel: args.whisperxModel,
+                    chunkingStrategy: args.chunkingStrategy,
+                    signal: ctx.signal,
+                });
+                mkdirSync(dirname(outAbs), { recursive: true });
+                writeFileSync(outAbs, JSON.stringify(t), "utf8");
+                // LLM-shaped summary. Don't dump 500 segments inline — agent uses
+                // read_transcript to query the saved file.
+                const head = t.segments.slice(0, 3).map((s) => ({
+                    start: +s.start.toFixed(2),
+                    end: +s.end.toFixed(2),
+                    text: s.text,
+                }));
+                const tail = t.segments.length > 6
+                    ? t.segments.slice(-3).map((s) => ({
+                        start: +s.start.toFixed(2),
+                        end: +s.end.toFixed(2),
+                        text: s.text,
+                    }))
+                    : [];
+                const wordsTotal = t.segments.reduce((acc, s) => acc + (s.words?.length ?? 0), 0);
+                const speakers = new Set(t.segments.map((s) => s.speaker).filter((x) => !!x));
+                return compact({
+                    ok: true,
+                    path: outAbs,
+                    lang: t.language,
+                    dur: +t.durationSec.toFixed(2),
+                    segments: t.segments.length,
+                    ...(args.wordTimestamps ? { words: wordsTotal } : {}),
+                    ...(speakers.size > 0 ? { speakers: [...speakers].sort() } : {}),
+                    head,
+                    ...(tail.length > 0 ? { tail } : {}),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=transcribe.js.map

package/dist/tools/transcribe.js.map

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

package/dist/tools/transition-videos.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const TransitionVideosParams: z.ZodObject<{
+    inputA: z.ZodString;
+    inputB: z.ZodString;
+    output: z.ZodString;
+    preset: z.ZodEnum<{
+        crossfade: "crossfade";
+        dissolve: "dissolve";
+        pixelize: "pixelize";
+        radial: "radial";
+        "dip-to-black": "dip-to-black";
+        "dip-to-white": "dip-to-white";
+        "smash-cut": "smash-cut";
+        "whip-left": "whip-left";
+        "whip-right": "whip-right";
+        "slide-left": "slide-left";
+        "slide-right": "slide-right";
+        "wipe-left": "wipe-left";
+        "wipe-right": "wipe-right";
+        "circle-open": "circle-open";
+        "circle-close": "circle-close";
+        "zoom-in": "zoom-in";
+    }>;
+    durationSec: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createTransitionVideosTool(cwd: string): AgentTool<typeof TransitionVideosParams>;
+export {};
+//# sourceMappingURL=transition-videos.d.ts.map

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

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

package/dist/tools/transition-videos.js

@@ -0,0 +1,130 @@
+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";
+/**
+ * Transition presets that wrap ffmpeg's `xfade` filter with content-creator
+ * friendly names + sensible default durations. Two new presets vs the
+ * underlying xfade list:
+ *   - smash-cut : 1-frame xfade (≈ a hard cut with imperceptible blend)
+ *   - whip-left/right : very-fast wipe simulating a whip-pan transition
+ *
+ * The remaining presets are 1:1 aliases of xfade names that creators tend
+ * to call by friendlier labels (dip-to-black, dip-to-white).
+ */
+const PresetSchema = z.enum([
+    "crossfade",
+    "dip-to-black",
+    "dip-to-white",
+    "smash-cut",
+    "whip-left",
+    "whip-right",
+    "slide-left",
+    "slide-right",
+    "wipe-left",
+    "wipe-right",
+    "circle-open",
+    "circle-close",
+    "zoom-in",
+    "dissolve",
+    "pixelize",
+    "radial",
+]);
+const PRESETS = {
+    crossfade: { xfade: "fade", defaultDurationSec: 0.5 },
+    "dip-to-black": { xfade: "fadeblack", defaultDurationSec: 0.5 },
+    "dip-to-white": { xfade: "fadewhite", defaultDurationSec: 0.5 },
+    // 1-frame xfade is the cleanest way to do a smash cut while still letting
+    // the audio acrossfade ride underneath.
+    "smash-cut": { xfade: "fade", defaultDurationSec: 0.04 },
+    "whip-left": { xfade: "wipeleft", defaultDurationSec: 0.15 },
+    "whip-right": { xfade: "wiperight", defaultDurationSec: 0.15 },
+    "slide-left": { xfade: "slideleft", defaultDurationSec: 0.5 },
+    "slide-right": { xfade: "slideright", defaultDurationSec: 0.5 },
+    "wipe-left": { xfade: "wipeleft", defaultDurationSec: 0.4 },
+    "wipe-right": { xfade: "wiperight", defaultDurationSec: 0.4 },
+    "circle-open": { xfade: "circleopen", defaultDurationSec: 0.6 },
+    "circle-close": { xfade: "circleclose", defaultDurationSec: 0.6 },
+    "zoom-in": { xfade: "zoomin", defaultDurationSec: 0.5 },
+    dissolve: { xfade: "dissolve", defaultDurationSec: 0.5 },
+    pixelize: { xfade: "pixelize", defaultDurationSec: 0.4 },
+    radial: { xfade: "radial", defaultDurationSec: 0.5 },
+};
+const TransitionVideosParams = z.object({
+    inputA: z.string(),
+    inputB: z.string(),
+    output: z.string(),
+    preset: PresetSchema.describe("Transition style. crossfade/dip-to-black/dip-to-white = soft cuts. " +
+        "whip-left/right = fast wipe (energetic). smash-cut = 1-frame blend " +
+        "for jump-cuts. zoom-in / circle-open = stylised reveal."),
+    durationSec: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Override duration. Defaults: 0.5s for crossfade, 0.04s for smash-cut, " +
+        "0.15s for whip presets."),
+});
+export function createTransitionVideosTool(cwd) {
+    return {
+        name: "transition_videos",
+        description: "Transition between two videos using a named preset (smash-cut, whip-left/right, " +
+            "dip-to-black/white, crossfade, …). Wraps ffmpeg xfade with creator-friendly " +
+            "presets + sensible default durations. For raw xfade names use crossfade_videos.",
+        parameters: TransitionVideosParams,
+        async execute({ inputA, inputB, output, preset, durationSec }, 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}`);
+                const spec = PRESETS[preset];
+                const dur = durationSec ?? spec.defaultDurationSec;
+                if (dur >= probeA.durationSec) {
+                    return err(`durationSec (${dur}) >= duration of inputA (${probeA.durationSec.toFixed(2)})`, "transition must fit inside the first clip");
+                }
+                const offset = +(probeA.durationSec - dur).toFixed(3);
+                const filter = `[0:v][1:v]xfade=transition=${spec.xfade}:duration=${dur}:offset=${offset}[v];` +
+                    `[0:a][1:a]acrossfade=d=${dur}[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, preset, durationSec: dur });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=transition-videos.js.map

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

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