@prestyj/editor 0.7.1

package/dist/tools/find-viral-moments.test.js

@@ -0,0 +1,144 @@
+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 { createFindViralMomentsTool } from "./find-viral-moments.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("find_viral_moments tool", () => {
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        delete process.env.OPENAI_API_KEY;
+    });
+    it("description names the orchestrator role + downstream tools", () => {
+        const tool = createFindViralMomentsTool("/tmp");
+        expect(tool.description).toMatch(/score_clip|render_multi_format|cut_at/);
+    });
+    it("errors when OPENAI_API_KEY is missing", async () => {
+        delete process.env.OPENAI_API_KEY;
+        const tool = createFindViralMomentsTool("/tmp");
+        const r = await tool.execute({ transcript: "x.json" }, ctx);
+        expect(r).toMatch(/^error:.*OPENAI_API_KEY/);
+    });
+    it("errors on empty transcript", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const dir = mkdtempSync(join(tmpdir(), "gg-fvm-"));
+        writeTranscript(dir, { language: "en", durationSec: 60, segments: [] });
+        const tool = createFindViralMomentsTool(dir);
+        const r = await tool.execute({ transcript: "t.json" }, ctx);
+        expect(r).toMatch(/no segments/);
+    });
+    it("errors on durationRange[1] <= durationRange[0]", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const dir = mkdtempSync(join(tmpdir(), "gg-fvm-"));
+        writeTranscript(dir, {
+            language: "en",
+            durationSec: 60,
+            segments: [{ start: 0, end: 60, text: "hello" }],
+        });
+        const tool = createFindViralMomentsTool(dir);
+        const r = await tool.execute({ transcript: "t.json", durationRange: [60, 20] }, ctx);
+        expect(r).toMatch(/^error:.*durationRange/);
+    });
+    it("returns ranked candidates after proposal+score+dedup", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const dir = mkdtempSync(join(tmpdir(), "gg-fvm-"));
+        writeTranscript(dir, {
+            language: "en",
+            durationSec: 200,
+            segments: Array.from({ length: 10 }, (_, i) => ({
+                start: i * 20,
+                end: (i + 1) * 20,
+                text: `segment ${i} content here`,
+            })),
+        });
+        let call = 0;
+        const proposalContent = JSON.stringify({
+            candidates: [
+                {
+                    startSec: 0,
+                    endSec: 40,
+                    hookLine: "open strong",
+                    suggestedTitle: "Hot take",
+                    suggestedCaption: "watch",
+                    why: "punchy",
+                },
+            ],
+        });
+        const scoreContent = JSON.stringify({
+            hook: 0.9,
+            flow: 0.7,
+            engagement: 0.8,
+            trend: 0.6,
+            why: "good",
+        });
+        vi.stubGlobal("fetch", vi.fn(async (_url, init) => {
+            call++;
+            const body = JSON.parse(init?.body ?? "{}");
+            const sys = body.messages[0]?.content ?? "";
+            const isProposal = sys.includes("short-form-video selector");
+            return {
+                ok: true,
+                status: 200,
+                json: async () => ({
+                    choices: [{ message: { content: isProposal ? proposalContent : scoreContent } }],
+                }),
+                text: async () => "",
+            };
+        }));
+        const tool = createFindViralMomentsTool(dir);
+        const r = await tool.execute({ transcript: "t.json", maxClips: 3, durationRange: [20, 60], scoreThreshold: 30 }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.candidates.length).toBeGreaterThan(0);
+        expect(parsed.candidates[0].score).toBeGreaterThan(0);
+        expect(parsed.candidates[0].suggestedTitle).toBe("Hot take");
+        expect(call).toBeGreaterThan(1); // at least one proposal + one score
+    });
+    it("threshold drops low-scoring candidates", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const dir = mkdtempSync(join(tmpdir(), "gg-fvm-"));
+        writeTranscript(dir, {
+            language: "en",
+            durationSec: 100,
+            segments: [{ start: 0, end: 100, text: "a long discussion about taxes and forms" }],
+        });
+        vi.stubGlobal("fetch", vi.fn(async (_url, init) => {
+            const body = JSON.parse(init?.body ?? "{}");
+            const sys = body.messages[0]?.content ?? "";
+            const isProposal = sys.includes("short-form-video selector");
+            const content = isProposal
+                ? JSON.stringify({
+                    candidates: [
+                        {
+                            startSec: 0,
+                            endSec: 30,
+                            hookLine: "x",
+                            suggestedTitle: "y",
+                            suggestedCaption: "z",
+                            why: "w",
+                        },
+                    ],
+                })
+                : JSON.stringify({ hook: 0.1, flow: 0.1, engagement: 0.1, trend: 0.1, why: "weak" });
+            return {
+                ok: true,
+                status: 200,
+                json: async () => ({ choices: [{ message: { content } }] }),
+                text: async () => "",
+            };
+        }));
+        const tool = createFindViralMomentsTool(dir);
+        const r = await tool.execute({ transcript: "t.json", scoreThreshold: 90 }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.candidates).toEqual([]);
+        expect(parsed.totalScored).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=find-viral-moments.test.js.map

package/dist/tools/find-viral-moments.test.js.map

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

package/dist/tools/fusion-comp.d.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const FusionCompParams: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"list_nodes">;
+    clipId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"add_node">;
+    toolId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    clipId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"delete_node">;
+    name: z.ZodString;
+    clipId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"connect">;
+    fromNode: z.ZodString;
+    toNode: z.ZodString;
+    fromOutput: z.ZodOptional<z.ZodString>;
+    toInput: z.ZodOptional<z.ZodString>;
+    clipId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"set_input">;
+    node: z.ZodString;
+    input: z.ZodString;
+    value: z.ZodUnknown;
+    clipId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"get_input">;
+    node: z.ZodString;
+    input: z.ZodString;
+    clipId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"set_keyframe">;
+    node: z.ZodString;
+    input: z.ZodString;
+    frame: z.ZodNumber;
+    value: z.ZodUnknown;
+    clipId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"set_render_range">;
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+    clipId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "action">;
+export declare function createFusionCompTool(host: VideoHost): AgentTool<typeof FusionCompParams>;
+export {};
+//# sourceMappingURL=fusion-comp.d.ts.map

package/dist/tools/fusion-comp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion-comp.d.ts","sourceRoot":"","sources":["../../src/tools/fusion-comp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAkB,SAAS,EAAE,MAAM,wBAAwB,CAAC;AA0GxE,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BASpB,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,gBAAgB,CAAC,CA4BxF"}

package/dist/tools/fusion-comp.js

@@ -0,0 +1,129 @@
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+/**
+ * fusion_comp — single tool with an `action` discriminator that drives
+ * Resolve's Fusion node graph for motion graphics.
+ *
+ * Why one tool with `action=` instead of one tool per action? Fusion is a
+ * graph editor — every action takes the same comp scope (timeline-clip comp
+ * or active Fusion-page comp), and the agent will typically chain 5-10 of
+ * them per lower-third / title build. Splitting into 8 sibling tools would
+ * 8x the per-tool description tokens for a feature that's effectively one
+ * compound op.
+ *
+ * Resolve only. Premiere has no Fusion equivalent — agents that need motion
+ * graphics on Premiere should render the graphic separately and replace_clip,
+ * or use After Effects via Dynamic Link (out of scope here).
+ *
+ * Common tool IDs the agent will reach for:
+ *   Background, TextPlus, Merge, Transform, ColorCorrector, DeltaKeyer,
+ *   Brightness/Contrast, Glow, Blur.
+ *
+ * Canonical recipe — lower third:
+ *   1. add_node toolId=Background name=BG    (the strap)
+ *   2. add_node toolId=TextPlus  name=TXT     (the text)
+ *   3. add_node toolId=Merge     name=COMP    (composite text over strap)
+ *   4. connect  fromNode=BG  toNode=COMP toInput=Background
+ *   5. connect  fromNode=TXT toNode=COMP toInput=Foreground
+ *   6. set_input node=TXT input=StyledText value="Name · Title"
+ *   7. set_input node=BG  input=TopLeft     value=[0.05, 0.10]
+ */
+const ListNodes = z.object({
+    action: z.literal("list_nodes"),
+    clipId: z
+        .string()
+        .optional()
+        .describe("When set, operate on this clip's first Fusion comp instead of the active Fusion-page comp."),
+});
+const AddNode = z.object({
+    action: z.literal("add_node"),
+    toolId: z
+        .string()
+        .min(1)
+        .describe("Fusion tool ID — e.g. 'TextPlus', 'Background', 'Merge', 'Transform', 'ColorCorrector', 'DeltaKeyer'."),
+    name: z.string().optional().describe("Optional human name for the new node."),
+    clipId: z.string().optional(),
+});
+const DeleteNode = z.object({
+    action: z.literal("delete_node"),
+    name: z.string().min(1),
+    clipId: z.string().optional(),
+});
+const Connect = z.object({
+    action: z.literal("connect"),
+    fromNode: z.string().min(1),
+    toNode: z.string().min(1),
+    fromOutput: z
+        .string()
+        .optional()
+        .describe("Defaults to the main 'Output'. Use for non-default outputs (e.g. 'Mask')."),
+    toInput: z
+        .string()
+        .optional()
+        .describe("Defaults to the main input. For Merge, use 'Background' or 'Foreground' explicitly."),
+    clipId: z.string().optional(),
+});
+const SetInput = z.object({
+    action: z.literal("set_input"),
+    node: z.string().min(1),
+    input: z.string().min(1),
+    value: z.unknown().describe("Number, string, [r,g,b], [x,y], etc. — Fusion input shape."),
+    clipId: z.string().optional(),
+});
+const GetInput = z.object({
+    action: z.literal("get_input"),
+    node: z.string().min(1),
+    input: z.string().min(1),
+    clipId: z.string().optional(),
+});
+const SetKeyframe = z.object({
+    action: z.literal("set_keyframe"),
+    node: z.string().min(1),
+    input: z.string().min(1),
+    frame: z.number().int().min(0),
+    value: z.unknown(),
+    clipId: z.string().optional(),
+});
+const SetRenderRange = z.object({
+    action: z.literal("set_render_range"),
+    start: z.number().int().min(0),
+    end: z.number().int().min(0),
+    clipId: z.string().optional(),
+});
+const FusionCompParams = z.discriminatedUnion("action", [
+    ListNodes,
+    AddNode,
+    DeleteNode,
+    Connect,
+    SetInput,
+    GetInput,
+    SetKeyframe,
+    SetRenderRange,
+]);
+export function createFusionCompTool(host) {
+    return {
+        name: "fusion_comp",
+        description: "Drive a Fusion composition for motion graphics — lower-thirds, title cards, simple " +
+            "comps. Single tool with an `action` discriminator: list_nodes, add_node, delete_node, " +
+            "connect, set_input, get_input, set_keyframe, set_render_range. Operates on the active " +
+            "Fusion-page comp by default, or pass clipId to scope to that clip's first Fusion comp " +
+            "(auto-created if missing). Resolve only — Premiere has no Fusion equivalent. " +
+            "Common tool IDs: Background, TextPlus, Merge, Transform, ColorCorrector, DeltaKeyer. " +
+            "Lower-third recipe: Background + TextPlus + Merge, wire Background→Merge.Background " +
+            "and TextPlus→Merge.Foreground.",
+        parameters: FusionCompParams,
+        async execute(args) {
+            if (typeof host.executeFusionComp !== "function") {
+                return err("not_supported: this host has no Fusion equivalent", "switch to Resolve, or render the graphic separately and use replace_clip");
+            }
+            try {
+                const result = await host.executeFusionComp(args);
+                return compact({ ok: true, result });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=fusion-comp.js.map

package/dist/tools/fusion-comp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion-comp.js","sourceRoot":"","sources":["../../src/tools/fusion-comp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGjD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAC/B,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,4FAA4F,CAC7F;CACJ,CAAC,CAAC;AAEH,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC7B,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,uGAAuG,CACxG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAC7E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2EAA2E,CAAC;IACxF,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qFAAqF,CACtF;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IACxB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;IACzF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IACxB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE;IACtD,SAAS;IACT,OAAO;IACP,UAAU;IACV,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,cAAc;CACf,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAAC,IAAe;IAClD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,qFAAqF;YACrF,wFAAwF;YACxF,wFAAwF;YACxF,wFAAwF;YACxF,+EAA+E;YAC/E,uFAAuF;YACvF,sFAAsF;YACtF,gCAAgC;QAClC,UAAU,EAAE,gBAAgB;QAC5B,KAAK,CAAC,OAAO,CAAC,IAAI;YAChB,IAAI,OAAO,IAAI,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;gBACjD,OAAO,GAAG,CACR,mDAAmD,EACnD,0EAA0E,CAC3E,CAAC;YACJ,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAsB,CAAC,CAAC;gBACpE,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACvC,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/generate-gif.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const GenerateGifParams: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodString;
+    startSec: z.ZodOptional<z.ZodNumber>;
+    durationSec: z.ZodOptional<z.ZodNumber>;
+    fps: z.ZodOptional<z.ZodNumber>;
+    width: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createGenerateGifTool(cwd: string): AgentTool<typeof GenerateGifParams>;
+export {};
+//# sourceMappingURL=generate-gif.d.ts.map

package/dist/tools/generate-gif.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-gif.d.ts","sourceRoot":"","sources":["../../src/tools/generate-gif.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKhD,QAAA,MAAM,iBAAiB;;;;;;;iBAsBrB,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAsFtF"}

package/dist/tools/generate-gif.js

@@ -0,0 +1,111 @@
+import { mkdirSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { checkFfmpeg, runFfmpeg } from "../core/media/ffmpeg.js";
+import { safeResolveOutputPath } from "../core/safe-paths.js";
+const GenerateGifParams = z.object({
+    input: z.string().describe("Source video file."),
+    output: z.string().describe("Output .gif path."),
+    startSec: z.number().min(0).optional().describe("Source-in seconds. Default 0."),
+    durationSec: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Length to capture. Default 5s. Cap at 15s — GIFs balloon fast."),
+    fps: z
+        .number()
+        .int()
+        .min(1)
+        .max(30)
+        .optional()
+        .describe("Output GIF fps. Default 12 (good quality:size ratio for social previews)."),
+    width: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Output width in pixels (height auto). Default 480."),
+});
+export function createGenerateGifTool(cwd) {
+    return {
+        name: "generate_gif",
+        description: "Two-pass GIF generation (palettegen → paletteuse) for high-quality output at small file " +
+            "sizes. Use for social previews, README embeds, Twitter posts. Default 480px @ 12fps for " +
+            "5 seconds. Cap at 15s — GIFs >5MB stop autoplaying on most platforms.",
+        parameters: GenerateGifParams,
+        async execute(args, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const inAbs = resolvePath(cwd, args.input);
+                const resolved = safeResolveOutputPath(cwd, args.output);
+                const outAbs = resolved.path;
+                if (!/\.gif$/i.test(outAbs)) {
+                    return err("output must end in .gif", `got: ${outAbs}`);
+                }
+                const start = args.startSec ?? 0;
+                const dur = args.durationSec ?? 5;
+                const fps = args.fps ?? 12;
+                const width = args.width ?? 480;
+                if (dur > 15) {
+                    return err(`durationSec ${dur} > 15s`, "GIFs over 15s rarely autoplay; use a smaller window");
+                }
+                mkdirSync(dirname(outAbs), { recursive: true });
+                const palettePath = join(tmpdir(), `gg-gif-palette-${Date.now()}.png`);
+                const filterChain = `fps=${fps},scale=${width}:-1:flags=lanczos`;
+                // The palette PNG is a temp scratch artifact between the two ffmpeg
+                // passes — always clean it up, including on early-return / thrown errors.
+                try {
+                    // Pass 1: palettegen
+                    const p1 = await runFfmpeg([
+                        "-ss",
+                        String(start),
+                        "-t",
+                        String(dur),
+                        "-i",
+                        inAbs,
+                        "-vf",
+                        `${filterChain},palettegen=stats_mode=diff`,
+                        palettePath,
+                    ], { signal: ctx.signal });
+                    if (p1.code !== 0)
+                        return err(`palettegen exited ${p1.code}`);
+                    // Pass 2: paletteuse
+                    const p2 = await runFfmpeg([
+                        "-ss",
+                        String(start),
+                        "-t",
+                        String(dur),
+                        "-i",
+                        inAbs,
+                        "-i",
+                        palettePath,
+                        "-lavfi",
+                        `${filterChain} [x]; [x][1:v] paletteuse=dither=bayer:bayer_scale=5:diff_mode=rectangle`,
+                        outAbs,
+                    ], { signal: ctx.signal });
+                    if (p2.code !== 0)
+                        return err(`paletteuse exited ${p2.code}`);
+                    return compact({
+                        ok: true,
+                        path: outAbs,
+                        startSec: start,
+                        durationSec: dur,
+                        fps,
+                        width,
+                        ...(resolved.redirected ? { redirected: true, reason: resolved.reason } : {}),
+                    });
+                }
+                finally {
+                    rmSync(palettePath, { force: true });
+                }
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=generate-gif.js.map

package/dist/tools/generate-gif.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-gif.js","sourceRoot":"","sources":["../../src/tools/generate-gif.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAChF,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,gEAAgE,CAAC;IAC7E,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,2EAA2E,CAAC;IACxF,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;CAClE,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,0FAA0F;YAC1F,0FAA0F;YAC1F,uEAAuE;QACzE,UAAU,EAAE,iBAAiB;QAC7B,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;YACrB,IAAI,CAAC,WAAW,EAAE;gBAAE,OAAO,GAAG,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;YACvE,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC3C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;gBACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC;gBAC7B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC5B,OAAO,GAAG,CAAC,yBAAyB,EAAE,QAAQ,MAAM,EAAE,CAAC,CAAC;gBAC1D,CAAC;gBACD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;gBACjC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;gBAClC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;gBAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC;gBAChC,IAAI,GAAG,GAAG,EAAE,EAAE,CAAC;oBACb,OAAO,GAAG,CACR,eAAe,GAAG,QAAQ,EAC1B,qDAAqD,CACtD,CAAC;gBACJ,CAAC;gBACD,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBACvE,MAAM,WAAW,GAAG,OAAO,GAAG,UAAU,KAAK,mBAAmB,CAAC;gBAEjE,oEAAoE;gBACpE,0EAA0E;gBAC1E,IAAI,CAAC;oBACH,qBAAqB;oBACrB,MAAM,EAAE,GAAG,MAAM,SAAS,CACxB;wBACE,KAAK;wBACL,MAAM,CAAC,KAAK,CAAC;wBACb,IAAI;wBACJ,MAAM,CAAC,GAAG,CAAC;wBACX,IAAI;wBACJ,KAAK;wBACL,KAAK;wBACL,GAAG,WAAW,6BAA6B;wBAC3C,WAAW;qBACZ,EACD,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CACvB,CAAC;oBACF,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC;wBAAE,OAAO,GAAG,CAAC,qBAAqB,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;oBAE9D,qBAAqB;oBACrB,MAAM,EAAE,GAAG,MAAM,SAAS,CACxB;wBACE,KAAK;wBACL,MAAM,CAAC,KAAK,CAAC;wBACb,IAAI;wBACJ,MAAM,CAAC,GAAG,CAAC;wBACX,IAAI;wBACJ,KAAK;wBACL,IAAI;wBACJ,WAAW;wBACX,QAAQ;wBACR,GAAG,WAAW,0EAA0E;wBACxF,MAAM;qBACP,EACD,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CACvB,CAAC;oBACF,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC;wBAAE,OAAO,GAAG,CAAC,qBAAqB,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC9D,OAAO,OAAO,CAAC;wBACb,EAAE,EAAE,IAAI;wBACR,IAAI,EAAE,MAAM;wBACZ,QAAQ,EAAE,KAAK;wBACf,WAAW,EAAE,GAAG;wBAChB,GAAG;wBACH,KAAK;wBACL,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAC9E,CAAC,CAAC;gBACL,CAAC;wBAAS,CAAC;oBACT,MAAM,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvC,CAAC;YACH,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/generate-gif.test.d.ts

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

package/dist/tools/generate-gif.test.d.ts.map

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

package/dist/tools/generate-gif.test.js

@@ -0,0 +1,115 @@
+import { existsSync, mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import * as ffmpegMod from "../core/media/ffmpeg.js";
+import { createGenerateGifTool } from "./generate-gif.js";
+const ctx = {
+    signal: new AbortController().signal,
+    toolCallId: "t1",
+};
+/**
+ * generate_gif runs ffmpeg twice: pass 1 (palettegen) writes a temp .png to
+ * os.tmpdir(); pass 2 (paletteuse) consumes it. The palette is scratch and
+ * MUST be cleaned up no matter how the tool exits. We snoop the palette
+ * path by capturing the LAST positional arg of pass 1 (palettegen output)
+ * or the value following `-i` after the palette is added on pass 2.
+ */
+function palettePathFromPass1Args(args) {
+    // palettegen writes its output as the final positional arg.
+    return args[args.length - 1];
+}
+describe("generate_gif temp-file cleanup", () => {
+    let workDir;
+    beforeEach(() => {
+        vi.restoreAllMocks();
+        workDir = mkdtempSync(join(tmpdir(), "gg-gif-test-"));
+        writeFileSync(join(workDir, "in.mp4"), "");
+        vi.spyOn(ffmpegMod, "checkFfmpeg").mockReturnValue(true);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("removes the palette file after both passes succeed", async () => {
+        let palettePath;
+        let call = 0;
+        vi.spyOn(ffmpegMod, "runFfmpeg").mockImplementation(async (args) => {
+            call++;
+            if (call === 1) {
+                palettePath = palettePathFromPass1Args(args);
+                // Simulate ffmpeg actually creating the file.
+                writeFileSync(palettePath, "");
+            }
+            return { code: 0, stdout: "", stderr: "" };
+        });
+        const tool = createGenerateGifTool(workDir);
+        const r = await tool.execute({ input: "in.mp4", output: "out.gif" }, ctx);
+        expect(r).not.toMatch(/^error:/);
+        expect(palettePath).toBeDefined();
+        expect(palettePath).toMatch(/gg-gif-palette-/);
+        // ffmpeg ran twice (palettegen + paletteuse).
+        expect(call).toBe(2);
+        expect(existsSync(palettePath)).toBe(false);
+    });
+    it("removes the palette file when palettegen (pass 1) fails", async () => {
+        let palettePath;
+        vi.spyOn(ffmpegMod, "runFfmpeg").mockImplementation(async (args) => {
+            palettePath = palettePathFromPass1Args(args);
+            // Simulate a partial palette write before the failure.
+            writeFileSync(palettePath, "");
+            return { code: 1, stdout: "", stderr: "palettegen boom" };
+        });
+        const tool = createGenerateGifTool(workDir);
+        const r = await tool.execute({ input: "in.mp4", output: "out.gif" }, ctx);
+        expect(r).toMatch(/^error: palettegen exited 1/);
+        expect(palettePath).toBeDefined();
+        expect(existsSync(palettePath)).toBe(false);
+    });
+    it("removes the palette file when paletteuse (pass 2) fails", async () => {
+        let palettePath;
+        let call = 0;
+        vi.spyOn(ffmpegMod, "runFfmpeg").mockImplementation(async (args) => {
+            call++;
+            if (call === 1) {
+                palettePath = palettePathFromPass1Args(args);
+                writeFileSync(palettePath, "");
+                return { code: 0, stdout: "", stderr: "" };
+            }
+            return { code: 2, stdout: "", stderr: "paletteuse boom" };
+        });
+        const tool = createGenerateGifTool(workDir);
+        const r = await tool.execute({ input: "in.mp4", output: "out.gif" }, ctx);
+        expect(r).toMatch(/^error: paletteuse exited 2/);
+        expect(call).toBe(2);
+        expect(palettePath).toBeDefined();
+        expect(existsSync(palettePath)).toBe(false);
+    });
+    it("removes the palette file when runFfmpeg throws on pass 1", async () => {
+        let palettePath;
+        vi.spyOn(ffmpegMod, "runFfmpeg").mockImplementation(async (args) => {
+            palettePath = palettePathFromPass1Args(args);
+            writeFileSync(palettePath, "");
+            throw new Error("spawn failed");
+        });
+        const tool = createGenerateGifTool(workDir);
+        const r = await tool.execute({ input: "in.mp4", output: "out.gif" }, ctx);
+        expect(r).toMatch(/^error: spawn failed/);
+        expect(palettePath).toBeDefined();
+        expect(existsSync(palettePath)).toBe(false);
+    });
+    it("rmSync uses force semantics: cleanup is a no-op if the palette never landed on disk", async () => {
+        let palettePath;
+        vi.spyOn(ffmpegMod, "runFfmpeg").mockImplementation(async (args) => {
+            palettePath = palettePathFromPass1Args(args);
+            // Deliberately do NOT write the palette file — simulate ffmpeg failing
+            // before any output. With { force: true } this must not throw.
+            return { code: 1, stdout: "", stderr: "no palette" };
+        });
+        const tool = createGenerateGifTool(workDir);
+        const r = await tool.execute({ input: "in.mp4", output: "out.gif" }, ctx);
+        expect(r).toMatch(/^error: palettegen exited 1/);
+        expect(palettePath).toBeDefined();
+        expect(existsSync(palettePath)).toBe(false);
+    });
+});
+//# sourceMappingURL=generate-gif.test.js.map

package/dist/tools/generate-gif.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-gif.test.js","sourceRoot":"","sources":["../../src/tools/generate-gif.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,GAAG,GAAG;IACV,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM;IACpC,UAAU,EAAE,IAAI;CACgE,CAAC;AAEnF;;;;;;GAMG;AACH,SAAS,wBAAwB,CAAC,IAAc;IAC9C,4DAA4D;IAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,IAAI,OAAe,CAAC;IAEpB,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;QACtD,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3C,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,IAAI,WAA+B,CAAC;QACpC,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,IAAc,EAAE,EAAE;YAC3E,IAAI,EAAE,CAAC;YACP,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,WAAW,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;gBAC7C,8CAA8C;gBAC9C,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAC1B,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,EACtC,GAAyC,CAC1C,CAAC;QAEF,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,CAAC,WAAY,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAChD,8CAA8C;QAC9C,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,CAAC,UAAU,CAAC,WAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,IAAI,WAA+B,CAAC;QACpC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,IAAc,EAAE,EAAE;YAC3E,WAAW,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;YAC7C,uDAAuD;YACvD,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC/B,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAC1B,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,EACtC,GAAyC,CAC1C,CAAC;QAEF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;QACjD,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,CAAC,UAAU,CAAC,WAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,IAAI,WAA+B,CAAC;QACpC,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,IAAc,EAAE,EAAE;YAC3E,IAAI,EAAE,CAAC;YACP,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,WAAW,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;gBAC7C,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;gBAC/B,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YAC7C,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAC1B,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,EACtC,GAAyC,CAC1C,CAAC;QAEF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,CAAC,UAAU,CAAC,WAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,IAAI,WAA+B,CAAC;QACpC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,IAAc,EAAE,EAAE;YAC3E,WAAW,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;YAC7C,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAC1B,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,EACtC,GAAyC,CAC1C,CAAC;QAEF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;QAC1C,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,CAAC,UAAU,CAAC,WAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qFAAqF,EAAE,KAAK,IAAI,EAAE;QACnG,IAAI,WAA+B,CAAC;QACpC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,IAAc,EAAE,EAAE;YAC3E,WAAW,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;YAC7C,uEAAuE;YACvE,+DAA+D;YAC/D,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAC1B,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,EACtC,GAAyC,CAC1C,CAAC;QAEF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;QACjD,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,CAAC,UAAU,CAAC,WAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/generate-outro.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const GenerateOutroParams: z.ZodObject<{
+    output: z.ZodString;
+    durationSec: z.ZodOptional<z.ZodNumber>;
+    channelName: z.ZodOptional<z.ZodString>;
+    ctaText: z.ZodOptional<z.ZodString>;
+    logo: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    fps: z.ZodOptional<z.ZodNumber>;
+    bgColor: z.ZodOptional<z.ZodString>;
+    textColor: z.ZodOptional<z.ZodString>;
+    fontFile: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function createGenerateOutroTool(cwd: string): AgentTool<typeof GenerateOutroParams>;
+export {};
+//# sourceMappingURL=generate-outro.d.ts.map

package/dist/tools/generate-outro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-outro.d.ts","sourceRoot":"","sources":["../../src/tools/generate-outro.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AA2ChD,QAAA,MAAM,mBAAmB;;;;;;;;;;;;iBAkCvB,CAAC;AAEH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,mBAAmB,CAAC,CA+H1F"}