@prestyj/editor 0.7.1

package/dist/tools/cluster-takes.js

@@ -0,0 +1,72 @@
+import { readFileSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { clip, compact, err, summarizeList } from "../core/format.js";
+import { clusterSegments } from "../core/clustering.js";
+import { parseTranscript } from "../core/whisper.js";
+const ClusterTakesParams = z.object({
+    path: z.string().describe("Transcript JSON file written by `transcribe`."),
+    threshold: z
+        .number()
+        .min(0)
+        .max(1)
+        .optional()
+        .describe("Jaccard similarity 0-1 to count as same take. Default 0.6 (loose); 0.8 = strict."),
+    window: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Only compare segments within N positions of each other. Default 100."),
+    minTokens: z
+        .number()
+        .int()
+        .min(1)
+        .optional()
+        .describe("Skip segments with fewer than N meaningful tokens. Default 4."),
+});
+export function createClusterTakesTool(cwd) {
+    return {
+        name: "cluster_takes",
+        description: "Find repeated takes in a transcript — groups of segments that are likely the same line " +
+            "said multiple times (re-takes). Use to pick the BEST take per cluster: read each cluster's " +
+            "members, then call score_shot at their timestamps to evaluate visual quality, then write_edl " +
+            "with the winners. Token-based similarity (free, deterministic, no API call).",
+        parameters: ClusterTakesParams,
+        async execute({ path, threshold, window, minTokens }) {
+            try {
+                const abs = resolvePath(cwd, path);
+                const t = parseTranscript(readFileSync(abs, "utf8"));
+                if (!t.segments || t.segments.length === 0) {
+                    return err("transcript has no segments", "verify the file is from `transcribe`");
+                }
+                const clusters = clusterSegments(t.segments, { threshold, window, minTokens });
+                // Compact view: one entry per cluster with size + member timestamps + truncated text.
+                // Cap members per cluster to 5 so context stays predictable.
+                const compactClusters = clusters.map((c) => ({
+                    id: c.id,
+                    size: c.members.length,
+                    members: c.members.slice(0, 5).map((m) => ({
+                        start: +m.start.toFixed(2),
+                        end: +m.end.toFixed(2),
+                        text: clip(m.text, 80),
+                    })),
+                    ...(c.members.length > 5 ? { truncated: c.members.length - 5 } : {}),
+                }));
+                const summary = summarizeList(compactClusters, 30);
+                return compact({
+                    totalSegments: t.segments.length,
+                    clustersFound: clusters.length,
+                    totalRetakes: clusters.reduce((sum, c) => sum + c.members.length, 0),
+                    ...(summary.omitted > 0
+                        ? { omitted: summary.omitted, head: summary.head, tail: summary.tail }
+                        : { clusters: compactClusters }),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=cluster-takes.js.map

package/dist/tools/cluster-takes.js.map

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

package/dist/tools/color-match.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const ColorMatchParams: z.ZodObject<{
+    referenceVideo: z.ZodString;
+    referenceAtSec: z.ZodNumber;
+    targetVideo: z.ZodString;
+    targetAtSec: z.ZodNumber;
+    detail: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function createColorMatchTool(cwd: string): AgentTool<typeof ColorMatchParams>;
+export {};
+//# sourceMappingURL=color-match.d.ts.map

package/dist/tools/color-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-match.d.ts","sourceRoot":"","sources":["../../src/tools/color-match.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhD,QAAA,MAAM,gBAAgB;;;;;;;;;;iBAOpB,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,gBAAgB,CAAC,CAsCpF"}

package/dist/tools/color-match.js

@@ -0,0 +1,55 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { deriveColorMatch } from "../core/color-match.js";
+import { extractAtTimes } from "../core/frames.js";
+import { checkFfmpeg } from "../core/media/ffmpeg.js";
+const ColorMatchParams = z.object({
+    referenceVideo: z.string().describe("Reference video file (the look you want)."),
+    referenceAtSec: z.number().min(0).describe("Time in the reference to sample."),
+    targetVideo: z.string().describe("Target video file (clip you want to match)."),
+    targetAtSec: z.number().min(0).describe("Time in the target to sample."),
+    detail: z.enum(["low", "high"]).optional().describe("Vision detail. Default low (cheap)."),
+    model: z.string().optional().describe("OpenAI model id. Default gpt-4o-mini."),
+});
+export function createColorMatchTool(cwd) {
+    return {
+        name: "color_match",
+        description: "Vision-derived CDL: compares a reference frame to a target frame and emits " +
+            "slope/offset/power/saturation values that bring the target toward the reference. " +
+            "READ-ONLY — returns the CDL; agent then pipes it to set_primary_correction " +
+            "(or rejects it if confidence is low). NOT a substitute for ColorChecker matching — " +
+            "this is for 'similar shots that feel off'. ALWAYS check `confidence`; below 0.4 means " +
+            "the model is guessing and you should skip applying.",
+        parameters: ColorMatchParams,
+        async execute(args, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            if (!process.env.OPENAI_API_KEY) {
+                return err("OPENAI_API_KEY not set", "export OPENAI_API_KEY=...");
+            }
+            try {
+                const refAbs = resolvePath(cwd, args.referenceVideo);
+                const tgtAbs = resolvePath(cwd, args.targetVideo);
+                const [refFrame] = await extractAtTimes(refAbs, [args.referenceAtSec], {
+                    maxWidth: 768,
+                    signal: ctx.signal,
+                });
+                const [tgtFrame] = await extractAtTimes(tgtAbs, [args.targetAtSec], {
+                    maxWidth: 768,
+                    signal: ctx.signal,
+                });
+                const cdl = await deriveColorMatch(refFrame.path, tgtFrame.path, {
+                    detail: args.detail,
+                    model: args.model,
+                    signal: ctx.signal,
+                });
+                return compact({ cdl });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=color-match.js.map

package/dist/tools/color-match.js.map

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

package/dist/tools/compose-layered.d.ts

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const ComposeLayeredParams: z.ZodObject<{
+    title: z.ZodString;
+    frameRate: z.ZodNumber;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    layers: z.ZodArray<z.ZodObject<{
+        reel: z.ZodString;
+        sourcePath: z.ZodString;
+        sourceInFrame: z.ZodNumber;
+        sourceOutFrame: z.ZodNumber;
+        lane: z.ZodDefault<z.ZodNumber>;
+        recordOffsetFrame: z.ZodNumber;
+        clipName: z.ZodOptional<z.ZodString>;
+        opacity: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+            keyframes: z.ZodArray<z.ZodObject<{
+                frame: z.ZodNumber;
+                value: z.ZodNumber;
+                interp: z.ZodOptional<z.ZodEnum<{
+                    linear: "linear";
+                    easeIn: "easeIn";
+                    easeOut: "easeOut";
+                    smooth: "smooth";
+                }>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>]>>;
+        volumeDb: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+            keyframes: z.ZodArray<z.ZodObject<{
+                frame: z.ZodNumber;
+                value: z.ZodNumber;
+                interp: z.ZodOptional<z.ZodEnum<{
+                    linear: "linear";
+                    easeIn: "easeIn";
+                    easeOut: "easeOut";
+                    smooth: "smooth";
+                }>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>]>>;
+    }, z.core.$strip>>;
+    fcpxmlOutput: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function createComposeLayeredTool(host: VideoHost, cwd: string): AgentTool<typeof ComposeLayeredParams>;
+export {};
+//# sourceMappingURL=compose-layered.d.ts.map

package/dist/tools/compose-layered.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-layered.d.ts","sourceRoot":"","sources":["../../src/tools/compose-layered.ts"],"names":[],"mappings":"AAGA,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;AA6CxD,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBxB,CAAC;AAEH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,oBAAoB,CAAC,CAyCxC"}

package/dist/tools/compose-layered.js

@@ -0,0 +1,104 @@
+import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { buildFcpxml } from "../core/fcpxml.js";
+import { compact, err } from "../core/format.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+const LayerSchema = z.object({
+    reel: z.string().describe("Source identifier — same reel = same asset."),
+    sourcePath: z.string().describe("Absolute (or cwd-relative) source media path."),
+    sourceInFrame: z.number().int().min(0),
+    sourceOutFrame: z.number().int().min(1),
+    /** 0 = main spine, 1+ = stacked above. */
+    lane: z.number().int().min(0).default(0),
+    /** Frame on the timeline where this layer's clip starts. */
+    recordOffsetFrame: z.number().int().min(0),
+    clipName: z.string().optional(),
+    /** Static or animated opacity 0..1. Pass a number for static; an object for keyframed. */
+    opacity: z
+        .union([
+        z.number().min(0).max(1),
+        z.object({
+            keyframes: z.array(z.object({
+                frame: z.number().int().min(0),
+                value: z.number().min(0).max(1),
+                interp: z.enum(["linear", "easeIn", "easeOut", "smooth"]).optional(),
+            })),
+        }),
+    ])
+        .optional(),
+    /** Static volume in dB; pass an object for keyframed ramps. */
+    volumeDb: z
+        .union([
+        z.number(),
+        z.object({
+            keyframes: z.array(z.object({
+                frame: z.number().int().min(0),
+                value: z.number(),
+                interp: z.enum(["linear", "easeIn", "easeOut", "smooth"]).optional(),
+            })),
+        }),
+    ])
+        .optional(),
+});
+const ComposeLayeredParams = z.object({
+    title: z.string().describe("Project name on the rebuilt timeline."),
+    frameRate: z.number().positive(),
+    width: z.number().int().positive().optional(),
+    height: z.number().int().positive().optional(),
+    layers: z
+        .array(LayerSchema)
+        .min(1)
+        .describe("Multi-track composition. Spine clips (lane=0) lay out in array order; lane>=1 " +
+        "clips sit at their recordOffsetFrame above the spine."),
+    fcpxmlOutput: z
+        .string()
+        .optional()
+        .describe("Optional .fcpxml output path. Defaults to a tempfile."),
+    dryRun: z.boolean().optional(),
+});
+export function createComposeLayeredTool(host, cwd) {
+    return {
+        name: "compose_layered",
+        description: "Build a multi-track timeline (B-roll + lower-thirds + main A-roll) by emitting an " +
+            "FCPXML with lane='N' clips and importing it. One call replaces the active timeline " +
+            "with the composed result. DESTRUCTIVE — clone_timeline first if you need a safety " +
+            "net. Use insert_broll for single-clip layer additions.",
+        parameters: ComposeLayeredParams,
+        async execute({ title, frameRate, width, height, layers, fcpxmlOutput, dryRun }) {
+            try {
+                const events = layers.map((l) => {
+                    const sourcePath = resolvePath(cwd, l.sourcePath);
+                    return {
+                        reel: l.reel,
+                        sourcePath,
+                        sourceInFrame: l.sourceInFrame,
+                        sourceOutFrame: l.sourceOutFrame,
+                        lane: l.lane,
+                        recordOffsetFrame: l.recordOffsetFrame,
+                        clipName: l.clipName,
+                        opacity: l.opacity,
+                        volumeDb: l.volumeDb,
+                    };
+                });
+                const xml = buildFcpxml({ title, frameRate, width, height, events });
+                const outAbs = fcpxmlOutput
+                    ? safeOutputPath(cwd, fcpxmlOutput)
+                    : join(mkdtempSync(join(tmpdir(), "gg-compose-")), "composed.fcpxml");
+                if (fcpxmlOutput)
+                    mkdirSync(dirname(outAbs), { recursive: true });
+                writeFileSync(outAbs, xml, "utf8");
+                if (dryRun) {
+                    return compact({ ok: true, path: outAbs, layers: layers.length, dryRun: true });
+                }
+                await host.importTimeline(outAbs);
+                return compact({ ok: true, path: outAbs, layers: layers.length });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=compose-layered.js.map

package/dist/tools/compose-layered.js.map

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

package/dist/tools/compose-thumbnail-variants.d.ts

@@ -0,0 +1,70 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import { type ExtractedFrame } from "../core/frames.js";
+import { type ShotScore } from "../core/vision.js";
+declare const ComposeThumbnailVariantsParams: z.ZodObject<{
+    input: z.ZodString;
+    outputDir: z.ZodString;
+    text: z.ZodString;
+    count: z.ZodOptional<z.ZodNumber>;
+    intervalSec: z.ZodOptional<z.ZodNumber>;
+    minSpacingSec: z.ZodOptional<z.ZodNumber>;
+    strategy: z.ZodOptional<z.ZodEnum<{
+        label: "label";
+        expression: "expression";
+        mixed: "mixed";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+    detail: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+    }>>;
+    fontFile: z.ZodOptional<z.ZodString>;
+    fontSize: z.ZodOptional<z.ZodNumber>;
+    fontColor: z.ZodOptional<z.ZodString>;
+    outlineColor: z.ZodOptional<z.ZodString>;
+    position: z.ZodOptional<z.ZodEnum<{
+        top: "top";
+        center: "center";
+        bottom: "bottom";
+    }>>;
+    width: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+interface VariantPick {
+    frame: ExtractedFrame;
+    score: ShotScore;
+}
+/**
+ * compose_thumbnail_variants — generate N thumbnails for A/B testing.
+ *
+ * Samples frames at `intervalSec`, scores via vision rubric, picks the
+ * top-N spaced ≥ minSpacingSec apart, burns the headline. YouTube
+ * native A/B is now standard — variants beat single guesses.
+ *
+ * Strategies:
+ *   - "mixed"      (default): 3 distinct frames, same label.
+ *   - "expression": same as mixed — picked separately for face-driven
+ *     content where the agent wants to emphasise expression variation.
+ *   - "label":     ONE best frame, 3 LLM-generated label variations.
+ *     Use when the source only has one usable visual.
+ */
+export declare function createComposeThumbnailVariantsTool(cwd: string): AgentTool<typeof ComposeThumbnailVariantsParams>;
+/**
+ * Greedy top-N selection with minimum spacing. Sort by score desc, walk
+ * the list, accept a candidate only if it's ≥ minSpacingSec away from
+ * every already-accepted pick. Stable — ties preserve input order.
+ *
+ * Pure — exported for testing.
+ */
+export declare function pickTopSpaced(paired: VariantPick[], count: number, minSpacingSec: number): VariantPick[];
+/**
+ * Ask the LLM for N label variations. Pure-ish (network call) — exported
+ * for testing under a mocked fetch.
+ */
+export declare function generateLabelVariations(headline: string, n: number, opts?: {
+    apiKey?: string;
+    model?: string;
+    signal?: AbortSignal;
+}): Promise<string[]>;
+export {};
+//# sourceMappingURL=compose-thumbnail-variants.d.ts.map

package/dist/tools/compose-thumbnail-variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-thumbnail-variants.d.ts","sourceRoot":"","sources":["../../src/tools/compose-thumbnail-variants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAG3E,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGhE,QAAA,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgClC,CAAC;AAEH,UAAU,WAAW;IACnB,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kCAAkC,CAChD,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,8BAA8B,CAAC,CA6JlD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,WAAW,EAAE,CAaf;AASD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,CAAC,EAAE,MAAM,EACT,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACnE,OAAO,CAAC,MAAM,EAAE,CAAC,CAyCnB"}