@kenkaiiii/gg-editor 0.7.0 → 0.7.2

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

@@ -0,0 +1,70 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-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,qBAAqB,CAAC;AAIrD,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"}

package/dist/tools/compose-thumbnail-variants.js

@@ -0,0 +1,274 @@
+import { resolve as resolvePath, join } from "node:path";
+import { z } from "zod";
+import { resolveApiKey } from "../core/auth/api-keys.js";
+import { loadBrandKit } from "../core/brand-kit.js";
+import { compact, err } from "../core/format.js";
+import { extractAtInterval } from "../core/frames.js";
+import { checkFfmpeg, probeMedia } from "../core/media/ffmpeg.js";
+import { composeThumbnailFrame } from "../core/thumbnail-compose.js";
+import { scoreFrames } from "../core/vision.js";
+import { pickBrandFont } from "./compose-thumbnail.js";
+const ComposeThumbnailVariantsParams = z.object({
+    input: z.string().describe("Source video (relative resolves to cwd)."),
+    outputDir: z.string().describe("Directory for the variant images. Created if missing."),
+    text: z.string().min(1).describe("Headline burned on each variant."),
+    count: z.number().int().min(1).max(5).optional().describe("How many variants. Default 3."),
+    intervalSec: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Sampling interval. Default = totalSec/40 (≈40 candidates over the video)."),
+    minSpacingSec: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Minimum seconds between picked variants. Default 10."),
+    strategy: z
+        .enum(["expression", "label", "mixed"])
+        .optional()
+        .describe("Variant generation strategy. 'mixed' (default) = 3 distinct frames + same label. " +
+        "'expression' = 3 best frames, all same label (vary expression only — face-driven " +
+        "content). 'label' = ONE best frame + 3 LLM-generated label variations (use when the " +
+        "source has only one usable face / product / screen)."),
+    model: z.string().optional().describe("OpenAI model. Default gpt-4o-mini."),
+    detail: z.enum(["low", "high"]).optional().describe("Vision detail. Default low."),
+    fontFile: z.string().optional(),
+    fontSize: z.number().int().positive().optional(),
+    fontColor: z.string().optional(),
+    outlineColor: z.string().optional(),
+    position: z.enum(["top", "center", "bottom"]).optional(),
+    width: z.number().int().positive().optional(),
+});
+/**
+ * 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 function createComposeThumbnailVariantsTool(cwd) {
+    return {
+        name: "compose_thumbnail_variants",
+        description: "Generate N thumbnail variants for A/B testing. Samples frames across the video, scores " +
+            "each via vision LLM, picks top-N distinct frames (≥minSpacingSec apart), burns the " +
+            "headline. `strategy` controls what varies: 'expression' (default for face-driven " +
+            "content) picks 3 frames with the SAME label; 'label' picks ONE frame + generates 3 " +
+            "distinct labels via LLM (use when only one usable face / product / screen exists); " +
+            "'mixed' = current behaviour (3 frames + same label). Output ordered best-first. " +
+            "Auto-applies brand kit (fonts.heading, colors.primary). YouTube native A/B is now " +
+            "standard — ship variants, not a single guess. Requires OPENAI_API_KEY + ffmpeg. Pair " +
+            "with `generate_youtube_metadata` before publish.",
+        parameters: ComposeThumbnailVariantsParams,
+        async execute(args, ctx) {
+            try {
+                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=...");
+                }
+                const inAbs = resolvePath(cwd, args.input);
+                const outDir = resolvePath(cwd, args.outputDir);
+                const probe = probeMedia(inAbs);
+                if (!probe)
+                    return err(`probe failed for ${inAbs}`, "verify file exists and is media");
+                if (probe.durationSec <= 0)
+                    return err("source has zero duration");
+                const count = Math.min(5, Math.max(1, args.count ?? 3));
+                const minSpacing = Math.max(0, args.minSpacingSec ?? 10);
+                const interval = args.intervalSec && args.intervalSec > 0
+                    ? args.intervalSec
+                    : Math.max(1, probe.durationSec / 40);
+                const strategy = args.strategy ?? "mixed";
+                // Brand-kit fallback: only fill in fontFile / outlineColor when the
+                // caller didn't pass an explicit value.
+                const brand = loadBrandKit(cwd);
+                const brandFont = pickBrandFont(cwd, brand?.fonts?.heading);
+                const fontFile = args.fontFile ?? brandFont;
+                const outlineColor = args.outlineColor ?? brand?.colors?.primary;
+                const brandKitLoaded = brand !== null;
+                // Sample frames across the whole video.
+                const frames = await extractAtInterval(inAbs, interval, probe.durationSec, {
+                    maxWidth: 1280,
+                    signal: ctx.signal,
+                });
+                if (frames.length === 0)
+                    return err("no frames extracted", "lower intervalSec");
+                // Score each frame.
+                const scores = await scoreFrames(frames, {
+                    model: args.model,
+                    detail: args.detail,
+                    signal: ctx.signal,
+                });
+                // Pair scores with their source frames + pick top-N respecting
+                // minSpacingSec.
+                const paired = scores.map((s, i) => ({ frame: frames[i], score: s }));
+                // ── label strategy: 1 frame, 3 LLM-generated labels ────────────
+                if (strategy === "label") {
+                    const top = paired.sort((a, b) => b.score.score - a.score.score)[0];
+                    if (!top)
+                        return err("no variants survived spacing constraint", "lower minSpacingSec");
+                    const labels = await generateLabelVariations(args.text, count, {
+                        model: args.model,
+                        signal: ctx.signal,
+                    });
+                    const variants = [];
+                    for (let i = 0; i < labels.length; i++) {
+                        const outPath = join(outDir, `variant-${i + 1}.jpg`);
+                        await composeThumbnailFrame({
+                            input: inAbs,
+                            output: outPath,
+                            atSec: top.frame.atSec,
+                            text: labels[i],
+                            fontFile,
+                            fontSize: args.fontSize,
+                            fontColor: args.fontColor,
+                            outlineColor,
+                            position: args.position,
+                            width: args.width,
+                            signal: ctx.signal,
+                        }, cwd);
+                        variants.push({
+                            path: outPath,
+                            atSec: +top.frame.atSec.toFixed(2),
+                            score: top.score.score,
+                            why: top.score.why,
+                            label: labels[i],
+                        });
+                    }
+                    return compact({
+                        variants,
+                        count: variants.length,
+                        totalScored: paired.length,
+                        strategy,
+                        brandKitLoaded,
+                    });
+                }
+                // ── mixed / expression strategies: N frames, same label ────────
+                const picks = pickTopSpaced(paired, count, minSpacing);
+                if (picks.length === 0) {
+                    return err("no variants survived spacing constraint", "lower minSpacingSec");
+                }
+                // Burn the headline on each pick.
+                const variants = [];
+                for (let i = 0; i < picks.length; i++) {
+                    const p = picks[i];
+                    const outPath = join(outDir, `variant-${i + 1}.jpg`);
+                    await composeThumbnailFrame({
+                        input: inAbs,
+                        output: outPath,
+                        atSec: p.frame.atSec,
+                        text: args.text,
+                        fontFile,
+                        fontSize: args.fontSize,
+                        fontColor: args.fontColor,
+                        outlineColor,
+                        position: args.position,
+                        width: args.width,
+                        signal: ctx.signal,
+                    }, cwd);
+                    variants.push({
+                        path: outPath,
+                        atSec: +p.frame.atSec.toFixed(2),
+                        score: p.score.score,
+                        why: p.score.why,
+                    });
+                }
+                return compact({
+                    variants,
+                    count: variants.length,
+                    totalScored: paired.length,
+                    strategy,
+                    brandKitLoaded,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+/**
+ * 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 function pickTopSpaced(paired, count, minSpacingSec) {
+    const sorted = [...paired].sort((a, b) => {
+        if (b.score.score !== a.score.score)
+            return b.score.score - a.score.score;
+        return a.frame.atSec - b.frame.atSec;
+    });
+    const kept = [];
+    for (const p of sorted) {
+        if (kept.length >= count)
+            break;
+        const tooClose = kept.some((k) => Math.abs(k.frame.atSec - p.frame.atSec) < minSpacingSec);
+        if (tooClose)
+            continue;
+        kept.push(p);
+    }
+    return kept;
+}
+const LABEL_SYSTEM = `You distill a YouTube headline into thumbnail labels. Given an input headline, output exactly N distinct 2-4-word labels. Each label should attack the same headline from a DIFFERENT angle (e.g. one curiosity-driven, one outcome-driven, one number-driven). Labels render large on a 100x56 mobile-feed thumbnail — no punctuation, no quotes, ALL CAPS preferred when it fits.
+
+Output JSON with this EXACT shape:
+{ "labels": ["...", "...", "..."] }
+
+No prose, no extra keys.`;
+/**
+ * Ask the LLM for N label variations. Pure-ish (network call) — exported
+ * for testing under a mocked fetch.
+ */
+export async function generateLabelVariations(headline, n, opts = {}) {
+    const apiKey = opts.apiKey ?? resolveApiKey("OPENAI_API_KEY", "openai");
+    if (!apiKey)
+        throw new Error("OPENAI_API_KEY required for compose_thumbnail_variants.");
+    const model = opts.model ?? "gpt-4o-mini";
+    const body = {
+        model,
+        messages: [
+            { role: "system", content: LABEL_SYSTEM },
+            { role: "user", content: `HEADLINE:\n${headline}\n\nN: ${n}` },
+        ],
+        response_format: { type: "json_object" },
+        temperature: 0,
+    };
+    const res = await fetch("https://api.openai.com/v1/chat/completions", {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${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("compose_thumbnail_variants: empty model response");
+    const parsed = JSON.parse(content);
+    const arr = Array.isArray(parsed.labels) ? parsed.labels : [];
+    const labels = arr
+        .map((v) => String(v ?? "").trim())
+        .filter((v) => v.length > 0)
+        .slice(0, n);
+    // Pad with the headline itself if the model under-delivers, so caller
+    // always gets N entries.
+    while (labels.length < n)
+        labels.push(headline);
+    return labels;
+}
+//# sourceMappingURL=compose-thumbnail-variants.js.map

package/dist/tools/compose-thumbnail-variants.js.map

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

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

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import type { AgentTool } from "@kenkaiiii/gg-agent";
+import { escapeDrawtextValue, pickFont } from "../core/thumbnail-compose.js";
 declare const ComposeThumbnailParams: z.ZodObject<{
     input: z.ZodString;
     output: z.ZodString;
@@ -17,19 +18,11 @@ declare const ComposeThumbnailParams: z.ZodObject<{
     width: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export declare function createComposeThumbnailTool(cwd: string): AgentTool<typeof ComposeThumbnailParams>;
+export { escapeDrawtextValue, pickFont };
 /**
- * Escape a string for ffmpeg drawtext's `text='...'` parameter.
- *
- * Rules (verified against real-world implementations — GVCLab/CutClaw,
- * g0ldyy/comet, ehendrix23/tesla_dashcam):
- *   1. `\\` first  → `\\\\`
- *   2. `:`         → `\\:`
- *   3. `'`         → `\\'`
- *   4. `%`         → `\\%`  (because `%{...}` is used for runtime expansions like timecode)
- *   5. newlines    → literal `\\n` (drawtext renders `\\n` as a line break)
- *
- * Backslash MUST come first so subsequent escapes don't double-escape it.
+ * Resolve a brand-kit `fonts.heading` value to a readable absolute path.
+ * Returns undefined when the kit doesn't define one or the file is missing.
+ * Pure-ish (touches the filesystem) — exported for testing.
  */
-export declare function escapeDrawtextValue(text: string): string;
-export {};
+export declare function pickBrandFont(cwd: string, heading: string | undefined): string | undefined;
 //# sourceMappingURL=compose-thumbnail.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"compose-thumbnail.d.ts","sourceRoot":"","sources":["../../src/tools/compose-thumbnail.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKrD,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;iBAyB1B,CAAC;AAUH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,sBAAsB,CAAC,CA0EhG;AAiBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOxD"}
+{"version":3,"file":"compose-thumbnail.d.ts","sourceRoot":"","sources":["../../src/tools/compose-thumbnail.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKrD,OAAO,EAAyB,mBAAmB,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAEpG,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;iBAyB1B,CAAC;AAEH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,sBAAsB,CAAC,CAqDhG;AAGD,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC;AAEzC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAQ1F"}

package/dist/tools/compose-thumbnail.js

@@ -1,9 +1,11 @@
-import { existsSync, mkdirSync } from "node:fs";
-import { dirname, resolve as resolvePath } from "node:path";
+import { existsSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
 import { z } from "zod";
+import { loadBrandKit } from "../core/brand-kit.js";
 import { compact, err } from "../core/format.js";
-import { checkFfmpeg, runFfmpeg } from "../core/media/ffmpeg.js";
+import { checkFfmpeg } from "../core/media/ffmpeg.js";
 import { safeResolveOutputPath } from "../core/safe-paths.js";
+import { composeThumbnailFrame, escapeDrawtextValue, pickFont } from "../core/thumbnail-compose.js";
 const ComposeThumbnailParams = z.object({
     input: z.string().describe("Source video."),
     output: z.string().describe("Thumbnail .jpg or .png."),
@@ -28,13 +30,6 @@ const ComposeThumbnailParams = z.object({
         .optional()
         .describe("Optional output width (height auto). Common: 1280 for YouTube."),
 });
-const SYSTEM_FONT_GUESSES = [
-    "/System/Library/Fonts/Helvetica.ttc",
-    "/System/Library/Fonts/Supplemental/Arial.ttf",
-    "/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf",
-    "/usr/share/fonts/TTF/DejaVuSans-Bold.ttf",
-    "C:\\Windows\\Fonts\\Arial.ttf",
-];
 export function createComposeThumbnailTool(cwd) {
     return {
         name: "compose_thumbnail",
@@ -49,47 +44,33 @@ export function createComposeThumbnailTool(cwd) {
             try {
                 const inAbs = resolvePath(cwd, args.input);
                 const resolved = safeResolveOutputPath(cwd, args.output);
-                const outAbs = resolved.path;
-                const fontFile = args.fontFile ? resolvePath(cwd, args.fontFile) : pickFont();
-                if (!fontFile) {
-                    return err("no system font found", "pass fontFile=<path-to-.ttf> (try ~/Library/Fonts on macOS or /usr/share/fonts on Linux)");
-                }
-                const fontSize = args.fontSize ?? 96;
-                const fontColor = args.fontColor ?? "white";
-                const outlineColor = args.outlineColor === "" ? "" : (args.outlineColor ?? "black");
-                const pos = args.position ?? "bottom";
-                const yExpr = pos === "top" ? "h*0.08" : pos === "center" ? "(h-text_h)/2" : "h-text_h-h*0.08";
-                const safeText = escapeDrawtextValue(args.text);
-                const drawText = `drawtext=fontfile=${escapeFilterPath(fontFile)}:` +
-                    `text='${safeText}':` +
-                    `fontsize=${fontSize}:` +
-                    `fontcolor=${fontColor}:` +
-                    `x=(w-text_w)/2:` +
-                    `y=${yExpr}` +
-                    (outlineColor ? `:bordercolor=${outlineColor}:borderw=4` : "");
-                const vf = args.width ? `scale=${args.width}:-1,${drawText}` : drawText;
-                mkdirSync(dirname(outAbs), { recursive: true });
-                const r = await runFfmpeg([
-                    "-ss",
-                    String(args.atSec),
-                    "-i",
-                    inAbs,
-                    "-frames:v",
-                    "1",
-                    "-vf",
-                    vf,
-                    "-q:v",
-                    "2",
-                    outAbs,
-                ], { signal: ctx.signal });
-                if (r.code !== 0) {
-                    return err(`ffmpeg drawtext exited ${r.code}`, "verify atSec is in range and ffmpeg has --enable-libfreetype");
-                }
+                // Brand-kit fallback: when fontFile / outlineColor aren't passed, fall
+                // back to the kit so a single tool call can pick up channel defaults.
+                const brand = loadBrandKit(cwd);
+                const brandFont = pickBrandFont(cwd, brand?.fonts?.heading);
+                const brandOutline = brand?.colors?.primary;
+                const fontFile = args.fontFile ?? brandFont;
+                const outlineColor = args.outlineColor ?? brandOutline;
+                const brandKitLoaded = brand !== null;
+                const r = await composeThumbnailFrame({
+                    input: inAbs,
+                    output: resolved.path,
+                    atSec: args.atSec,
+                    text: args.text,
+                    fontFile,
+                    fontSize: args.fontSize,
+                    fontColor: args.fontColor,
+                    outlineColor,
+                    position: args.position,
+                    width: args.width,
+                    signal: ctx.signal,
+                }, cwd);
                 return compact({
                     ok: true,
-                    path: outAbs,
+                    path: r.path,
                     atSec: args.atSec,
-                    fontFile,
+                    fontFile: r.fontFile,
+                    brandKitLoaded,
                     ...(resolved.redirected ? { redirected: true, reason: resolved.reason } : {}),
                 });
             }
@@ -99,40 +80,22 @@ export function createComposeThumbnailTool(cwd) {
         },
     };
 }
-function pickFont() {
-    for (const p of SYSTEM_FONT_GUESSES) {
-        try {
-            if (existsSync(p))
-                return p;
-        }
-        catch {
-            /* ignore */
-        }
-    }
-    return undefined;
-}
-function escapeFilterPath(p) {
-    return p.replace(/\\/g, "\\\\").replace(/:/g, "\\:").replace(/'/g, "\\'");
-}
+// Re-exports for backwards compatibility — older tests import these from here.
+export { escapeDrawtextValue, pickFont };
 /**
- * Escape a string for ffmpeg drawtext's `text='...'` parameter.
- *
- * Rules (verified against real-world implementations — GVCLab/CutClaw,
- * g0ldyy/comet, ehendrix23/tesla_dashcam):
- *   1. `\\` first  → `\\\\`
- *   2. `:`         → `\\:`
- *   3. `'`         → `\\'`
- *   4. `%`         → `\\%`  (because `%{...}` is used for runtime expansions like timecode)
- *   5. newlines    → literal `\\n` (drawtext renders `\\n` as a line break)
- *
- * Backslash MUST come first so subsequent escapes don't double-escape it.
+ * Resolve a brand-kit `fonts.heading` value to a readable absolute path.
+ * Returns undefined when the kit doesn't define one or the file is missing.
+ * Pure-ish (touches the filesystem) — exported for testing.
  */
-export function escapeDrawtextValue(text) {
-    return text
-        .replace(/\\/g, "\\\\")
-        .replace(/:/g, "\\:")
-        .replace(/'/g, "\\'")
-        .replace(/%/g, "\\%")
-        .replace(/\r\n?|\n/g, "\\n");
+export function pickBrandFont(cwd, heading) {
+    if (!heading)
+        return undefined;
+    const abs = resolvePath(cwd, heading);
+    try {
+        return existsSync(abs) ? abs : undefined;
+    }
+    catch {
+        return undefined;
+    }
 }
 //# sourceMappingURL=compose-thumbnail.js.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"concat-videos.d.ts","sourceRoot":"","sources":["../../src/tools/concat-videos.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAE3D;AACD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKrD,QAAA,MAAM,kBAAkB;;;;;;iBAatB,CAAC;AAEH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,kBAAkB,CAAC,CAuExF"}
+{"version":3,"file":"concat-videos.d.ts","sourceRoot":"","sources":["../../src/tools/concat-videos.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAE3D;AACD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKrD,QAAA,MAAM,kBAAkB;;;;;;iBAatB,CAAC;AAEH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,kBAAkB,CAAC,CA6ExF"}

package/dist/tools/concat-videos.js

@@ -1,4 +1,4 @@
-import { mkdirSync, writeFileSync } from "node:fs";
+import { mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, resolve as resolvePath } from "node:path";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
@@ -46,14 +46,21 @@ export function createConcatVideosTool(cwd) {
                 mkdirSync(dirname(outAbs), { recursive: true });
                 if (lossless) {
                     // concat demuxer: build a list file `file 'path'\n` and feed it.
+                    // The list file is a temp scratch artifact — clean it up no matter
+                    // how this branch exits (success, ffmpeg non-zero, or thrown error).
                     const listPath = join(tmpdir(), `gg-concat-${Date.now()}.txt`);
                     const body = buildConcatListBody(absInputs);
                     writeFileSync(listPath, body, "utf8");
-                    const r = await runFfmpeg(["-f", "concat", "-safe", "0", "-i", listPath, "-c", "copy", outAbs], { signal: ctx.signal });
-                    if (r.code !== 0) {
-                        return err(`ffmpeg concat-demuxer exited ${r.code}`, "sources may differ in codec/res/fps; retry with lossless=false");
+                    try {
+                        const r = await runFfmpeg(["-f", "concat", "-safe", "0", "-i", listPath, "-c", "copy", outAbs], { signal: ctx.signal });
+                        if (r.code !== 0) {
+                            return err(`ffmpeg concat-demuxer exited ${r.code}`, "sources may differ in codec/res/fps; retry with lossless=false");
+                        }
+                        return compact({ ok: true, path: outAbs, mode: "lossless" });
+                    }
+                    finally {
+                        rmSync(listPath, { force: true });
                     }
-                    return compact({ ok: true, path: outAbs, mode: "lossless" });
                 }
                 // Filter-based concat (re-encode).
                 const args = [];