@prestyj/editor 0.7.1

package/dist/tools/append-clip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"append-clip.js","sourceRoot":"","sources":["../../src/tools/append-clip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAClC,IAAe,EACf,GAAW;IAEX,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,mFAAmF;YACnF,iDAAiD;QACnD,UAAU,EAAE,gBAAgB;QAC5B,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE;YAChC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBACxC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC5C,wDAAwD;gBACxD,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YACrE,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/apply-lut.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const ApplyLutParams: z.ZodObject<{
+    clipId: z.ZodString;
+    lutPath: z.ZodString;
+    nodeIndex: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createApplyLutTool(host: VideoHost, cwd: string): AgentTool<typeof ApplyLutParams>;
+export {};
+//# sourceMappingURL=apply-lut.d.ts.map

package/dist/tools/apply-lut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-lut.d.ts","sourceRoot":"","sources":["../../src/tools/apply-lut.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,QAAA,MAAM,cAAc;;;;iBASlB,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,cAAc,CAAC,CAkBjG"}

package/dist/tools/apply-lut.js

@@ -0,0 +1,33 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+const ApplyLutParams = z.object({
+    clipId: z.string().min(1).describe("Clip id from get_timeline."),
+    lutPath: z.string().min(1).describe(".cube/.dat LUT file (relative path resolves to cwd)."),
+    nodeIndex: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("1-based node index. Default 1 (always exists)."),
+});
+export function createApplyLutTool(host, cwd) {
+    return {
+        name: "apply_lut",
+        description: "Apply a LUT to a clip's grading node (Resolve only). " +
+            "Premiere has no scriptable equivalent — the tool will return an error there. " +
+            "Use as the base of a per-clip grade, then layer set_primary_correction on top.",
+        parameters: ApplyLutParams,
+        async execute({ clipId, lutPath, nodeIndex }) {
+            try {
+                const abs = resolvePath(cwd, lutPath);
+                await host.applyLut(clipId, abs, nodeIndex);
+                return compact({ clipId, lutPath: abs, nodeIndex: nodeIndex ?? 1 });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=apply-lut.js.map

package/dist/tools/apply-lut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-lut.js","sourceRoot":"","sources":["../../src/tools/apply-lut.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAChE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IAC3F,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,IAAe,EAAE,GAAW;IAC7D,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,uDAAuD;YACvD,+EAA+E;YAC/E,gFAAgF;QAClF,UAAU,EAAE,cAAc;QAC1B,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE;YAC1C,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBACtC,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;gBAC5C,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,IAAI,CAAC,EAAE,CAAC,CAAC;YACtE,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/audit-first-frame.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const AuditFirstFrameParams: z.ZodObject<{
+    input: z.ZodString;
+    detail: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+interface FirstFrameVisionResponse {
+    score: number;
+    hasFace: boolean;
+    faceProminent: boolean;
+    hasReadableText: boolean;
+    hasClearSubject: boolean;
+    hasMotion: boolean;
+    mode: "static-logo" | "cold-open-load" | "face-blink" | "usable" | "strong";
+    findings: string[];
+}
+/**
+ * audit_first_frame — score t=0.0s as if it were the thumbnail.
+ *
+ * Per Hoyos / Galloway: "treat the first frame like a thumbnail."
+ * Autoplay surfaces the first frame BEFORE audio loads, so a logo slate
+ * or cold-open hold tanks retention before viewers ever hear the hook.
+ */
+export declare function createAuditFirstFrameTool(cwd: string): AgentTool<typeof AuditFirstFrameParams>;
+/**
+ * Parse the model's JSON response. Robust to missing keys / weird types
+ * — never throws as long as the JSON itself is valid. Pure — exported
+ * for testing.
+ */
+export declare function parseFirstFrameResponse(content: string): FirstFrameVisionResponse;
+export {};
+//# sourceMappingURL=audit-first-frame.d.ts.map

package/dist/tools/audit-first-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-first-frame.d.ts","sourceRoot":"","sources":["../../src/tools/audit-first-frame.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhD,QAAA,MAAM,qBAAqB;;;;;;;iBAIzB,CAAC;AA+BH,UAAU,wBAAwB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,aAAa,GAAG,gBAAgB,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC5E,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,qBAAqB,CAAC,CAmD9F;AAwDD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,wBAAwB,CA6BjF"}

package/dist/tools/audit-first-frame.js

@@ -0,0 +1,181 @@
+import { readFileSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { resolveApiKey } from "../core/auth/api-keys.js";
+import { compact, err } from "../core/format.js";
+import { extractAtTimes } from "../core/frames.js";
+import { checkFfmpeg, probeMedia } from "../core/media/ffmpeg.js";
+const AuditFirstFrameParams = z.object({
+    input: z.string().describe("Source video (relative resolves to cwd)."),
+    detail: z.enum(["low", "high"]).optional().describe("Vision detail. Default low."),
+    model: z.string().optional().describe("OpenAI model. Default gpt-4o-mini."),
+});
+const VISION_SYSTEM = `You score a SINGLE FRAME (the first frame of a YouTube video) AS IF it were the thumbnail at 100x56 mobile-feed scale. Autoplay shows this frame BEFORE audio loads — if it looks like a logo slate, a black hold, or a mid-blink face, the viewer scrolls.
+
+Output a JSON object with these EXACT keys:
+{
+  "score":           <0..100 integer>,
+  "hasFace":         <bool>,
+  "faceProminent":   <bool>,         // face fills ≥ ~20% of frame area
+  "hasReadableText": <bool>,         // any large legible text (hook line, label)
+  "hasClearSubject": <bool>,         // a single obvious focal point
+  "hasMotion":       <bool>,         // not strictly possible from one frame; mark true only when blur / streak / mid-action implies motion
+  "mode":            "static-logo"|"cold-open-load"|"face-blink"|"usable"|"strong",
+  "findings":        [<string>, ...] // 1-4 short findings (≤120 chars each)
+}
+
+Scoring rubric:
+  85-100: STRONG — clear subject, expressive face, color contrast, readable text, no logo slate.
+  60-84:  USABLE — subject present, decent contrast, no obvious blockers.
+  30-59:  WEAK — abstract pattern, small subject, soft contrast, mid-blink, or pre-roll filler.
+  0-29:   FAIL — black slate, plain logo card, glitch frame, mid-blink face, totally unreadable.
+
+Modes:
+  static-logo    = a logo card / channel branding slate
+  cold-open-load = a near-black or solid-color frame (intro hasn't started)
+  face-blink     = a face mid-blink / mid-word / awkward expression
+  usable         = nothing wrong but nothing exceptional either
+  strong         = thumbnail-ready opening frame
+
+Be honest — this rubric exists so the creator knows when to recut their first frame.`;
+/**
+ * audit_first_frame — score t=0.0s as if it were the thumbnail.
+ *
+ * Per Hoyos / Galloway: "treat the first frame like a thumbnail."
+ * Autoplay surfaces the first frame BEFORE audio loads, so a logo slate
+ * or cold-open hold tanks retention before viewers ever hear the hook.
+ */
+export function createAuditFirstFrameTool(cwd) {
+    return {
+        name: "audit_first_frame",
+        description: "Score the first frame of a video as if it were the thumbnail at 100×56 mobile-feed " +
+            "scale. Per Galloway / Hoyos: 'treat your intro like a thumbnail' — autoplay shows the " +
+            "first frame BEFORE audio loads, so logo slates and cold-open holds tank retention. " +
+            "Penalises static-logo, cold-open-load, face-blink modes; rewards a clear subject + " +
+            "expressive face + readable hook text. Pair with `audit_retention_structure` and " +
+            "`analyze_hook` as the three short-form pre-render checks. Returns score 0-100 + " +
+            "findings + mode.",
+        parameters: AuditFirstFrameParams,
+        async execute(args, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            const apiKey = resolveApiKey("OPENAI_API_KEY", "openai");
+            if (!apiKey)
+                return err("OPENAI_API_KEY not set", "export OPENAI_API_KEY=...");
+            try {
+                const inAbs = resolvePath(cwd, args.input);
+                const probe = probeMedia(inAbs);
+                if (!probe)
+                    return err(`probe failed for ${inAbs}`, "verify file exists and is media");
+                const frames = await extractAtTimes(inAbs, [0], {
+                    maxWidth: 768,
+                    signal: ctx.signal,
+                });
+                if (frames.length === 0) {
+                    return err("could not extract first frame", "verify the input is a readable video");
+                }
+                const vision = await runFirstFrameVision(frames[0].path, {
+                    apiKey,
+                    model: args.model,
+                    detail: args.detail,
+                    signal: ctx.signal,
+                });
+                return compact({
+                    score: vision.score,
+                    mode: vision.mode,
+                    hasFace: vision.hasFace,
+                    faceProminent: vision.faceProminent,
+                    hasReadableText: vision.hasReadableText,
+                    hasClearSubject: vision.hasClearSubject,
+                    hasMotion: vision.hasMotion,
+                    findings: vision.findings,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+async function runFirstFrameVision(framePath, opts) {
+    const b64 = readFileSync(framePath).toString("base64");
+    const detail = opts.detail ?? "low";
+    const model = opts.model ?? "gpt-4o-mini";
+    const body = {
+        model,
+        messages: [
+            { role: "system", content: VISION_SYSTEM },
+            {
+                role: "user",
+                content: [
+                    { type: "text", text: "FIRST FRAME (t=0):" },
+                    {
+                        type: "image_url",
+                        image_url: { url: `data:image/jpeg;base64,${b64}`, detail },
+                    },
+                ],
+            },
+        ],
+        response_format: { type: "json_object" },
+        max_tokens: 2000,
+        temperature: 0,
+    };
+    const res = await fetch("https://api.openai.com/v1/chat/completions", {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${opts.apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+        signal: opts.signal,
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`OpenAI HTTP ${res.status}: ${text.slice(0, 200)}`);
+    }
+    const data = (await res.json());
+    const content = data.choices[0]?.message?.content;
+    if (!content)
+        throw new Error("audit_first_frame: empty model response");
+    return parseFirstFrameResponse(content);
+}
+/**
+ * Parse the model's JSON response. Robust to missing keys / weird types
+ * — never throws as long as the JSON itself is valid. Pure — exported
+ * for testing.
+ */
+export function parseFirstFrameResponse(content) {
+    const start = content.indexOf("{");
+    const end = content.lastIndexOf("}");
+    if (start < 0 || end < start) {
+        throw new Error("audit_first_frame: no JSON object in response");
+    }
+    const parsed = JSON.parse(content.slice(start, end + 1));
+    const modeRaw = String(parsed.mode ?? "usable");
+    const mode = (["static-logo", "cold-open-load", "face-blink", "usable", "strong"].includes(modeRaw)
+        ? modeRaw
+        : "usable");
+    const findings = Array.isArray(parsed.findings)
+        ? parsed.findings
+            .map((v) => String(v ?? "").slice(0, 200))
+            .filter((v) => v.length > 0)
+            .slice(0, 8)
+        : [];
+    return {
+        score: clampScore(parsed.score),
+        hasFace: Boolean(parsed.hasFace),
+        faceProminent: Boolean(parsed.faceProminent),
+        hasReadableText: Boolean(parsed.hasReadableText),
+        hasClearSubject: Boolean(parsed.hasClearSubject),
+        hasMotion: Boolean(parsed.hasMotion),
+        mode,
+        findings,
+    };
+}
+function clampScore(v) {
+    const n = typeof v === "number" ? v : Number(v);
+    if (!Number.isFinite(n))
+        return 0;
+    return Math.max(0, Math.min(100, Math.round(n)));
+}
+//# sourceMappingURL=audit-first-frame.js.map

package/dist/tools/audit-first-frame.js.map

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

package/dist/tools/audit-retention-structure.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const AuditRetentionStructureParams: z.ZodObject<{
+    transcript: z.ZodString;
+    durationSec: z.ZodOptional<z.ZodNumber>;
+    checkpoints: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * audit_retention_structure — long-form retention checkpoint auditor.
+ *
+ * Per MrBeast's documented manual, every ~3 minutes a re-engagement is
+ * required to keep retention from collapsing. This tool builds a 60s
+ * window around each requested checkpoint, asks the LLM to score
+ * whether re-engagement is happening, and reports the weakest one so
+ * the agent knows where to insert b-roll, punch-ins, or a recut.
+ */
+export declare function createAuditRetentionStructureTool(cwd: string): AgentTool<typeof AuditRetentionStructureParams>;
+export {};
+//# sourceMappingURL=audit-retention-structure.d.ts.map

package/dist/tools/audit-retention-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-retention-structure.d.ts","sourceRoot":"","sources":["../../src/tools/audit-retention-structure.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhD,QAAA,MAAM,6BAA6B;;;;;iBAqBjC,CAAC;AAEH;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,6BAA6B,CAAC,CAiEjD"}

package/dist/tools/audit-retention-structure.js

@@ -0,0 +1,95 @@
+import { readFileSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { runRetentionAudit } from "../core/retention-structure.js";
+import { parseTranscript } from "../core/whisper.js";
+const AuditRetentionStructureParams = z.object({
+    transcript: z
+        .string()
+        .describe("Path to a transcript JSON written by `transcribe`. Segments required."),
+    durationSec: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Override transcript.durationSec — useful when you trust the ffprobe duration over the " +
+        "transcript's reported one."),
+    checkpoints: z
+        .array(z.number().positive())
+        .optional()
+        .describe("Checkpoints to audit (seconds). Default [180, 360] — the 3-min and 6-min " +
+        "re-engagement marks. For a 12+ min video pass [180, 360, 540, 720]. Each becomes a " +
+        "60s window centred on the timestamp."),
+    model: z.string().optional().describe("OpenAI model. Default gpt-4o-mini."),
+});
+/**
+ * audit_retention_structure — long-form retention checkpoint auditor.
+ *
+ * Per MrBeast's documented manual, every ~3 minutes a re-engagement is
+ * required to keep retention from collapsing. This tool builds a 60s
+ * window around each requested checkpoint, asks the LLM to score
+ * whether re-engagement is happening, and reports the weakest one so
+ * the agent knows where to insert b-roll, punch-ins, or a recut.
+ */
+export function createAuditRetentionStructureTool(cwd) {
+    return {
+        name: "audit_retention_structure",
+        description: "Audit a long-form video transcript for retention checkpoints (3-min, 6-min " +
+            "re-engagements per MrBeast's documented method) and overall escalation pattern. Each " +
+            "checkpoint scored 0-1 with a one-line suggestion when weak. Pair with the " +
+            "youtube-algorithm-primer skill — viewers drop hardest at flat stretches between " +
+            "minutes 1-7. Returns checkpoints[], escalationScore, and weakestCheckpoint so the " +
+            "agent knows where to insert b-roll, punch-ins, or re-cut. Requires `transcribe` first.",
+        parameters: AuditRetentionStructureParams,
+        async execute(args, ctx) {
+            try {
+                if (!process.env.OPENAI_API_KEY) {
+                    return err("OPENAI_API_KEY not set", "export OPENAI_API_KEY=...");
+                }
+                const transcriptAbs = resolvePath(cwd, args.transcript);
+                let raw;
+                try {
+                    raw = readFileSync(transcriptAbs, "utf8");
+                }
+                catch (e) {
+                    return err(`cannot read transcript ${transcriptAbs}: ${e.message}`, "verify the transcript JSON exists");
+                }
+                let t;
+                try {
+                    t = parseTranscript(raw);
+                }
+                catch (e) {
+                    return err(e.message);
+                }
+                if (t.segments.length === 0) {
+                    return err("transcript has no segments", "rerun transcribe(...)");
+                }
+                const totalSec = args.durationSec ?? t.durationSec;
+                if (!totalSec || totalSec <= 0) {
+                    return err("transcript has zero duration", "pass durationSec explicitly");
+                }
+                const result = await runRetentionAudit(t, {
+                    model: args.model,
+                    checkpoints: args.checkpoints,
+                    durationSec: totalSec,
+                    signal: ctx.signal,
+                });
+                return compact({
+                    checkpoints: result.checkpoints.map((c) => ({
+                        atSec: c.atSec,
+                        score: +c.score.toFixed(2),
+                        summary: c.summary,
+                        ...(c.suggestion ? { suggestion: c.suggestion } : {}),
+                    })),
+                    escalationScore: +result.escalationScore.toFixed(2),
+                    overallSummary: result.overallSummary,
+                    weakestCheckpoint: result.weakestCheckpoint,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=audit-retention-structure.js.map

package/dist/tools/audit-retention-structure.js.map

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

package/dist/tools/audit-retention-structure.test.d.ts

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

package/dist/tools/audit-retention-structure.test.d.ts.map

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

package/dist/tools/audit-retention-structure.test.js

@@ -0,0 +1,93 @@
+import { mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { createAuditRetentionStructureTool } from "./audit-retention-structure.js";
+const ctx = {
+    signal: new AbortController().signal,
+    toolCallId: "t1",
+};
+function writeTranscript(dir, payload) {
+    const p = join(dir, "t.json");
+    writeFileSync(p, JSON.stringify(payload), "utf8");
+    return p;
+}
+describe("audit_retention_structure tool", () => {
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        delete process.env.OPENAI_API_KEY;
+    });
+    it("description names MrBeast + checkpoints + the algorithm-primer pairing", () => {
+        const tool = createAuditRetentionStructureTool("/tmp");
+        expect(tool.description).toMatch(/MrBeast|3-min|checkpoint/);
+        expect(tool.description).toMatch(/youtube-algorithm-primer/);
+        expect(tool.description).toMatch(/weakestCheckpoint|b-roll|punch-in/);
+    });
+    it("errors when OPENAI_API_KEY is missing", async () => {
+        delete process.env.OPENAI_API_KEY;
+        const tool = createAuditRetentionStructureTool("/tmp");
+        const r = await tool.execute({ transcript: "x.json" }, ctx);
+        expect(r).toMatch(/^error:.*OPENAI_API_KEY/);
+    });
+    it("errors on missing transcript file", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const tool = createAuditRetentionStructureTool("/tmp");
+        const r = await tool.execute({ transcript: "no/such.json" }, ctx);
+        expect(r).toMatch(/^error:.*cannot read/);
+    });
+    it("errors on transcript with no segments", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const dir = mkdtempSync(join(tmpdir(), "gg-ars-"));
+        writeTranscript(dir, { language: "en", durationSec: 600, segments: [] });
+        const tool = createAuditRetentionStructureTool(dir);
+        const r = await tool.execute({ transcript: "t.json" }, ctx);
+        expect(r).toMatch(/no segments/);
+    });
+    it("returns parseable JSON with default checkpoints", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const dir = mkdtempSync(join(tmpdir(), "gg-ars-"));
+        writeTranscript(dir, {
+            language: "en",
+            durationSec: 600,
+            segments: Array.from({ length: 30 }, (_, i) => ({
+                start: i * 20,
+                end: (i + 1) * 20,
+                text: `segment ${i}`,
+            })),
+        });
+        let captured;
+        vi.stubGlobal("fetch", vi.fn(async (_url, init) => {
+            captured = JSON.parse(init?.body ?? "{}");
+            return {
+                ok: true,
+                status: 200,
+                json: async () => ({
+                    choices: [
+                        {
+                            message: {
+                                content: JSON.stringify({
+                                    checkpoints: [
+                                        { atSec: 180, score: 0.3, summary: "flat", suggestion: "add b-roll" },
+                                        { atSec: 360, score: 0.8, summary: "twist", suggestion: "" },
+                                    ],
+                                    escalationScore: 0.6,
+                                    overallSummary: "decent build",
+                                }),
+                            },
+                        },
+                    ],
+                }),
+                text: async () => "",
+            };
+        }));
+        const tool = createAuditRetentionStructureTool(dir);
+        const r = await tool.execute({ transcript: "t.json" }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.checkpoints).toHaveLength(2);
+        expect(parsed.weakestCheckpoint).toBe(180);
+        expect(parsed.escalationScore).toBeCloseTo(0.6);
+        expect(captured?.response_format).toEqual({ type: "json_object" });
+        expect(captured?.temperature).toBe(0);
+    });
+});
+//# sourceMappingURL=audit-retention-structure.test.js.map

package/dist/tools/audit-retention-structure.test.js.map

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

package/dist/tools/bleep-words.d.ts

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { Transcript } from "../core/whisper.js";
+/**
+ * bleep_words — compliance / brand-safety tool. Scan a word-timestamped
+ * transcript for any occurrence of `wordList`, then either mute (silence)
+ * or bleep-overlay each range in the source audio. Outputs a re-encoded
+ * mp4 with the same video stream copied through.
+ *
+ * Two modes:
+ *   - "mute" — `volume=enable='between(t,a,b)':volume=0` per range. Cleanest;
+ *      lands as silence under the speaker's mouth movements.
+ *   - "bleep" — same mute applied AND a bleep tone (sine wave at 1kHz by
+ *     default) amix'd over the muted region. The classic broadcast censor.
+ */
+declare const BleepWordsParams: z.ZodObject<{
+    transcript: z.ZodString;
+    input: z.ZodString;
+    output: z.ZodString;
+    wordList: z.ZodArray<z.ZodString>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        mute: "mute";
+        bleep: "bleep";
+    }>>;
+    toneFreqHz: z.ZodOptional<z.ZodNumber>;
+    paddingMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+interface MatchRange {
+    startSec: number;
+    endSec: number;
+    text: string;
+}
+export declare function createBleepWordsTool(cwd: string): AgentTool<typeof BleepWordsParams>;
+/**
+ * Find every word-list match in the transcript. Multi-word phrases are
+ * matched against contiguous word sequences. Case-insensitive, ignores
+ * surrounding punctuation.
+ */
+export declare function findRanges(transcript: Transcript, wordList: string[], paddingSec: number): MatchRange[];
+/** Merge overlapping or touching ranges. */
+export declare function mergeRanges(ranges: MatchRange[]): MatchRange[];
+/**
+ * Build a filter_complex that mutes (and optionally beeps over) the audio
+ * in every range. Output label: `[aout]`.
+ *
+ * mute mode:
+ *   [0:a]volume=enable='between(t,a1,b1)':volume=0,volume=enable='between(t,a2,b2)':volume=0[aout]
+ * bleep mode:
+ *   muted = same as mute
+ *   tones = sine sources, one per range, gated by adelay + atrim
+ *   [muted][tones...]amix=inputs=N+1:duration=first:dropout_transition=0[aout]
+ *   then sidechained back through volume…
+ *
+ * Simpler bleep: chain a sine source per range, mix all in. Below is the
+ * implementation:
+ */
+export declare function buildBleepFilter(ranges: MatchRange[], mode: "mute" | "bleep", toneHz: number): string;
+export {};
+//# sourceMappingURL=bleep-words.d.ts.map

package/dist/tools/bleep-words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bleep-words.d.ts","sourceRoot":"","sources":["../../src/tools/bleep-words.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;;;;GAWG;AAEH,QAAA,MAAM,gBAAgB;;;;;;;;;;;iBA8BpB,CAAC;AAEH,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,gBAAgB,CAAC,CAiFpF;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,EAAE,MAAM,GACjB,UAAU,EAAE,CA8Bd;AAED,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAc9D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,UAAU,EAAE,EACpB,IAAI,EAAE,MAAM,GAAG,OAAO,EACtB,MAAM,EAAE,MAAM,GACb,MAAM,CA6BR"}