@prestyj/editor 0.7.1

package/dist/tools/generate-outro.js

@@ -0,0 +1,175 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname, 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 { safeResolveOutputPath } from "../core/safe-paths.js";
+import { escapeDrawtextValue } from "./compose-thumbnail.js";
+/**
+ * generate_outro — render a 3-7s end-screen card from the channel's brand
+ * kit (logo + channel name + CTA). Designed for the "every video ends the
+ * same way" creator workflow: drop in a `.ezcoder/brand.json` once, then every
+ * outro picks up the right typography / logo / CTA automatically.
+ *
+ * Implementation is intentionally minimal — one ffmpeg call:
+ *   - Solid background (brand.colors.primary or black)
+ *   - Optional logo overlay (brand.logo) at top-centre
+ *   - Channel name (large) + CTA text (smaller) drawn underneath
+ *   - Audio: silent stereo (so concat_videos round-trips cleanly)
+ *
+ * The output is a flat .mp4 ready for `concat_videos` to splice onto the
+ * end of the main render. For Resolve-native motion text, the user can
+ * still author a Fusion comp; this tool just gives them a one-call default.
+ */
+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",
+];
+function pickSystemFont() {
+    for (const p of SYSTEM_FONT_GUESSES) {
+        try {
+            if (existsSync(p))
+                return p;
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    return undefined;
+}
+const GenerateOutroParams = z.object({
+    output: z.string().describe("Output video path. Default container .mp4."),
+    durationSec: z.number().min(1).max(15).optional().describe("Outro length. Default 5s."),
+    channelName: z
+        .string()
+        .optional()
+        .describe("Channel name (large headline). Defaults to brand.json channelName."),
+    ctaText: z
+        .string()
+        .optional()
+        .describe("CTA line below the channel name. Defaults to brand.json ctaText, then 'Subscribe'."),
+    logo: z
+        .string()
+        .optional()
+        .describe("Path to logo PNG. Defaults to brand.json logo. Optional — outro still renders without."),
+    width: z.number().int().positive().optional().describe("Output width. Default 1920."),
+    height: z.number().int().positive().optional().describe("Output height. Default 1080."),
+    fps: z.number().positive().optional().describe("Default 30."),
+    bgColor: z
+        .string()
+        .optional()
+        .describe("Background hex (RRGGBB, no #). Defaults to brand.colors.primary, then '111111' (near-black)."),
+    textColor: z.string().optional().describe("Foreground text colour. Default 'white'."),
+    fontFile: z
+        .string()
+        .optional()
+        .describe("Path to a TTF/OTF font for ffmpeg drawtext. Defaults to brand.fonts.heading, then a system " +
+        "font (Helvetica on macOS, DejaVu on Linux, Arial on Windows)."),
+});
+export function createGenerateOutroTool(cwd) {
+    return {
+        name: "generate_outro",
+        description: "Render a 3–7s outro card from the channel's brand kit (logo + channel name + CTA). Auto-loads " +
+            "<cwd>/.ezcoder/brand.json — no args needed in the common case. Output is a flat .mp4 ready for " +
+            "concat_videos to splice onto the end of a main render. Pair with `concat_videos([main, outro])`.",
+        parameters: GenerateOutroParams,
+        async execute(args, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            try {
+                const brand = loadBrandKit(cwd);
+                const channelName = args.channelName ?? brand?.channelName ?? "";
+                const ctaText = args.ctaText ?? brand?.ctaText ?? "Subscribe";
+                const logoRel = args.logo ?? brand?.logo;
+                const logoAbs = logoRel ? resolvePath(cwd, logoRel) : undefined;
+                if (logoAbs && !existsSync(logoAbs)) {
+                    return err(`logo file not found: ${logoAbs}`, "fix the brand.json logo path or pass logo='' to skip");
+                }
+                const width = args.width ?? 1920;
+                const height = args.height ?? 1080;
+                const fps = args.fps ?? 30;
+                const dur = args.durationSec ?? 5;
+                const bgColor = args.bgColor ?? brand?.colors?.primary ?? "111111";
+                const textColor = args.textColor ?? "white";
+                const fontPath = (args.fontFile && resolvePath(cwd, args.fontFile)) ||
+                    (brand?.fonts?.heading && existsSync(resolvePath(cwd, brand.fonts.heading))
+                        ? resolvePath(cwd, brand.fonts.heading)
+                        : undefined) ||
+                    pickSystemFont();
+                if (!fontPath) {
+                    return err("no font available for drawtext", "set fontFile or brand.fonts.heading to a TTF path");
+                }
+                const resolved = safeResolveOutputPath(cwd, args.output);
+                const outAbs = resolved.path;
+                mkdirSync(dirname(outAbs), { recursive: true });
+                // Build filter: solid colour source, optional logo overlay, drawtext lines.
+                // The agent's outro is intentionally simple — one headline + one CTA + optional centre logo.
+                const escapedName = escapeDrawtextValue(channelName);
+                const escapedCta = escapeDrawtextValue(ctaText);
+                const headlineSize = Math.round(Math.min(width, height) * 0.08);
+                const ctaSize = Math.round(headlineSize * 0.5);
+                const drawHeadline = channelName
+                    ? `drawtext=fontfile=${escapeFilterPath(fontPath)}:text='${escapedName}':fontsize=${headlineSize}:fontcolor=${textColor}:x=(w-text_w)/2:y=(h-text_h)/2-text_h*0.3`
+                    : "";
+                const drawCta = ctaText
+                    ? `drawtext=fontfile=${escapeFilterPath(fontPath)}:text='${escapedCta}':fontsize=${ctaSize}:fontcolor=${textColor}:x=(w-text_w)/2:y=(h+text_h)/2+text_h*0.6`
+                    : "";
+                const drawChain = [drawHeadline, drawCta].filter(Boolean).join(",");
+                const ffArgs = [
+                    "-f",
+                    "lavfi",
+                    "-t",
+                    String(dur),
+                    "-i",
+                    `color=c=0x${bgColor}:s=${width}x${height}:r=${fps}`,
+                    "-f",
+                    "lavfi",
+                    "-t",
+                    String(dur),
+                    "-i",
+                    "anullsrc=channel_layout=stereo:sample_rate=48000",
+                ];
+                if (logoAbs)
+                    ffArgs.push("-i", logoAbs);
+                let filter;
+                if (logoAbs) {
+                    // logo: scale to ~20% width, overlay top-centre
+                    const logoScale = Math.round(width * 0.2);
+                    filter = `[2:v]scale=${logoScale}:-1[logo];[0:v][logo]overlay=(W-w)/2:H*0.12${drawChain ? `,${drawChain}` : ""}[v]`;
+                }
+                else {
+                    filter = `[0:v]${drawChain || "null"}[v]`;
+                }
+                ffArgs.push("-filter_complex", filter, "-map", "[v]", "-map", "1:a", "-c:v", "libx264", "-pix_fmt", "yuv420p", "-crf", "20", "-c:a", "aac", "-b:a", "192k", outAbs);
+                const r = await runFfmpeg(ffArgs, { signal: ctx.signal });
+                if (r.code !== 0)
+                    return err(`ffmpeg exited ${r.code}`, "check that the font and logo paths are readable");
+                return compact({
+                    ok: true,
+                    path: outAbs,
+                    durationSec: dur,
+                    width,
+                    height,
+                    fps,
+                    channelName: channelName || undefined,
+                    ctaText,
+                    logo: logoAbs,
+                    fontFile: fontPath,
+                    brandKitLoaded: brand !== null,
+                    ...(resolved.redirected ? { redirected: true, reason: resolved.reason } : {}),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+function escapeFilterPath(p) {
+    return p.replace(/\\/g, "\\\\").replace(/:/g, "\\:").replace(/'/g, "\\'");
+}
+//# sourceMappingURL=generate-outro.js.map

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

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

package/dist/tools/generate-youtube-metadata.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const GenerateYouTubeMetadataParams: z.ZodObject<{
+    transcript: z.ZodString;
+    channelStyle: z.ZodOptional<z.ZodString>;
+    videoTopic: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function createGenerateYouTubeMetadataTool(cwd: string): AgentTool<typeof GenerateYouTubeMetadataParams>;
+/**
+ * Build a channel-style hint from the brand kit when the caller didn't
+ * pass `channelStyle` explicitly. Returns undefined when the kit is
+ * missing the bare minimum (no channelName) so the LLM falls back to
+ * inferring tone purely from the transcript.
+ *
+ * Pure — exported for testing.
+ */
+export declare function buildChannelStyleFromBrand(brand: {
+    channelName?: string;
+    subscribeUrl?: string;
+} | null): string | undefined;
+export {};
+//# sourceMappingURL=generate-youtube-metadata.d.ts.map

package/dist/tools/generate-youtube-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-youtube-metadata.d.ts","sourceRoot":"","sources":["../../src/tools/generate-youtube-metadata.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAOhD,QAAA,MAAM,6BAA6B;;;;;iBAgBjC,CAAC;AAEH,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,6BAA6B,CAAC,CAgEjD;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAC5D,MAAM,GAAG,SAAS,CASpB"}

package/dist/tools/generate-youtube-metadata.js

@@ -0,0 +1,103 @@
+import { readFileSync } 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 { generateMetadata } from "../core/youtube-metadata.js";
+import { parseTranscript } from "../core/whisper.js";
+const GenerateYouTubeMetadataParams = z.object({
+    transcript: z
+        .string()
+        .describe("Path to a transcript JSON written by `transcribe`. Segments required."),
+    channelStyle: z
+        .string()
+        .optional()
+        .describe("One-paragraph description of the channel's voice (e.g. 'sharp tech opinion, 1st-person, " +
+        "no fluff'). Helps the LLM match tone in titles + description."),
+    videoTopic: z
+        .string()
+        .optional()
+        .describe("Optional human hint, e.g. 'this is part 2 of the GPU shortage series'."),
+    model: z.string().optional().describe("OpenAI model. Default gpt-4o-mini."),
+});
+export function createGenerateYouTubeMetadataTool(cwd) {
+    return {
+        name: "generate_youtube_metadata",
+        description: "Generate complete YouTube metadata from a transcript: 3 candidate titles (hook-driven, " +
+            "≤70 chars), description with timestamps, 15 tags, chapter markers from real topic " +
+            "shifts (5-15, first at 00:00, ≥30s apart), and 3-5 hashtags. ONE LLM call. ALWAYS run " +
+            "before declaring a YouTube long-form done — uploads without metadata don't rank. " +
+            "Requires `transcribe` first.",
+        parameters: GenerateYouTubeMetadataParams,
+        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(...)");
+                }
+                // Brand-kit fallback: when channelStyle isn't passed, build a minimal
+                // "<Channel> (channel)" hint plus the subscribeUrl so the LLM has
+                // some channel context to lean on.
+                const brand = loadBrandKit(cwd);
+                const brandStyle = buildChannelStyleFromBrand(brand);
+                const channelStyle = args.channelStyle ?? brandStyle;
+                const brandKitLoaded = brand !== null;
+                const m = await generateMetadata(t, {
+                    model: args.model,
+                    channelStyle,
+                    videoTopic: args.videoTopic,
+                    signal: ctx.signal,
+                });
+                return compact({
+                    titles: m.titles,
+                    description: m.description,
+                    tags: m.tags,
+                    chapters: m.chapters.map((c) => ({ atSec: +c.atSec.toFixed(2), title: c.title })),
+                    hashtags: m.hashtags,
+                    brandKitLoaded,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+/**
+ * Build a channel-style hint from the brand kit when the caller didn't
+ * pass `channelStyle` explicitly. Returns undefined when the kit is
+ * missing the bare minimum (no channelName) so the LLM falls back to
+ * inferring tone purely from the transcript.
+ *
+ * Pure — exported for testing.
+ */
+export function buildChannelStyleFromBrand(brand) {
+    if (!brand)
+        return undefined;
+    const name = brand.channelName?.trim();
+    if (!name)
+        return undefined;
+    const parts = [`${name} (channel)`];
+    if (brand.subscribeUrl?.trim()) {
+        parts.push(`Subscribe link: ${brand.subscribeUrl.trim()}`);
+    }
+    return parts.join(" — ");
+}
+//# sourceMappingURL=generate-youtube-metadata.js.map

package/dist/tools/generate-youtube-metadata.js.map

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

package/dist/tools/generate-youtube-metadata.test.d.ts

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

package/dist/tools/generate-youtube-metadata.test.d.ts.map

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

package/dist/tools/generate-youtube-metadata.test.js

@@ -0,0 +1,118 @@
+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 { createGenerateYouTubeMetadataTool } from "./generate-youtube-metadata.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("generate_youtube_metadata tool", () => {
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        delete process.env.OPENAI_API_KEY;
+    });
+    it("description names YouTube + chapters + ranking + ALWAYS-pre-publish", () => {
+        const tool = createGenerateYouTubeMetadataTool("/tmp");
+        expect(tool.description).toMatch(/YouTube/i);
+        expect(tool.description).toMatch(/chapter/i);
+        expect(tool.description).toMatch(/ALWAYS|rank/i);
+    });
+    it("errors when OPENAI_API_KEY is missing", async () => {
+        delete process.env.OPENAI_API_KEY;
+        const tool = createGenerateYouTubeMetadataTool("/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 = createGenerateYouTubeMetadataTool("/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-yt-"));
+        writeTranscript(dir, { language: "en", durationSec: 10, segments: [] });
+        const tool = createGenerateYouTubeMetadataTool(dir);
+        const r = await tool.execute({ transcript: "t.json" }, ctx);
+        expect(r).toMatch(/no segments/);
+    });
+    it("returns parseable JSON on success and drops chapters for short videos", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const dir = mkdtempSync(join(tmpdir(), "gg-yt-"));
+        writeTranscript(dir, {
+            language: "en",
+            durationSec: 120, // < 5 min → chapters dropped
+            segments: [{ start: 0, end: 120, text: "hello world" }],
+        });
+        vi.stubGlobal("fetch", vi.fn(async () => ({
+            ok: true,
+            status: 200,
+            json: async () => ({
+                choices: [
+                    {
+                        message: {
+                            content: JSON.stringify({
+                                titles: ["one", "two", "three"],
+                                description: "the desc",
+                                tags: ["tech"],
+                                chapters: [{ atSec: 0, title: "Intro" }],
+                                hashtags: ["#x"],
+                            }),
+                        },
+                    },
+                ],
+            }),
+            text: async () => "",
+        })));
+        const tool = createGenerateYouTubeMetadataTool(dir);
+        const r = await tool.execute({ transcript: "t.json" }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.titles).toHaveLength(3);
+        expect(parsed.chapters).toEqual([]);
+    });
+    it("uses json_object response format and temperature 0", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const dir = mkdtempSync(join(tmpdir(), "gg-yt-"));
+        writeTranscript(dir, {
+            language: "en",
+            durationSec: 60,
+            segments: [{ start: 0, end: 60, text: "x" }],
+        });
+        let captured;
+        vi.stubGlobal("fetch", vi.fn(async (_u, init) => {
+            captured = JSON.parse(init?.body ?? "{}");
+            return {
+                ok: true,
+                status: 200,
+                json: async () => ({
+                    choices: [
+                        {
+                            message: {
+                                content: JSON.stringify({
+                                    titles: ["a", "b", "c"],
+                                    description: "x",
+                                    tags: [],
+                                    chapters: [],
+                                    hashtags: [],
+                                }),
+                            },
+                        },
+                    ],
+                }),
+                text: async () => "",
+            };
+        }));
+        const tool = createGenerateYouTubeMetadataTool(dir);
+        await tool.execute({ transcript: "t.json" }, ctx);
+        expect(captured?.response_format).toEqual({ type: "json_object" });
+        expect(captured?.temperature).toBe(0);
+    });
+});
+//# sourceMappingURL=generate-youtube-metadata.test.js.map

package/dist/tools/generate-youtube-metadata.test.js.map

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

package/dist/tools/get-markers.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const GetMarkersParams: z.ZodObject<{
+    full: z.ZodOptional<z.ZodBoolean>;
+    color: z.ZodOptional<z.ZodString>;
+    contains: z.ZodOptional<z.ZodString>;
+    startFrame: z.ZodOptional<z.ZodNumber>;
+    endFrame: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createGetMarkersTool(host: VideoHost): AgentTool<typeof GetMarkersParams>;
+export {};
+//# sourceMappingURL=get-markers.d.ts.map

package/dist/tools/get-markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-markers.d.ts","sourceRoot":"","sources":["../../src/tools/get-markers.ts"],"names":[],"mappings":"AAAA,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;AAGxD,QAAA,MAAM,gBAAgB;;;;;;iBAgBpB,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,gBAAgB,CAAC,CA8CxF"}

package/dist/tools/get-markers.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { compact, err, summarizeList } from "../core/format.js";
+import { RESOLVE_TO_PREMIERE_INDEX } from "../core/marker-colors.js";
+const GetMarkersParams = z.object({
+    full: z
+        .boolean()
+        .optional()
+        .describe("Return all markers (no summarization). Pass when total is small."),
+    color: z
+        .string()
+        .optional()
+        .describe("Filter by marker color (case-insensitive, e.g. 'red' / 'green' / 'purple'). " +
+        "Premiere returns numeric color indices; Resolve returns names. The filter matches " +
+        "either by string equality or by the Resolve color name → Premiere index map."),
+    contains: z.string().optional().describe("Substring filter on marker note (case-insensitive)."),
+    startFrame: z.number().int().min(0).optional().describe("Lower frame bound (inclusive)."),
+    endFrame: z.number().int().min(0).optional().describe("Upper frame bound (exclusive)."),
+});
+export function createGetMarkersTool(host) {
+    return {
+        name: "get_markers",
+        description: "Read existing markers from the active timeline. Call at session start to see prior " +
+            "editorial decisions. Filter by color, note substring, or frame range so you don't " +
+            "blow context on unrelated markers.",
+        parameters: GetMarkersParams,
+        async execute({ full, color, contains, startFrame, endFrame }) {
+            try {
+                const all = await host.getMarkers();
+                const needle = contains?.toLowerCase();
+                const wantColor = color?.toLowerCase();
+                const wantIndex = wantColor !== undefined ? RESOLVE_TO_PREMIERE_INDEX[wantColor] : undefined;
+                const filtered = all.filter((m) => {
+                    if (startFrame !== undefined && m.frame < startFrame)
+                        return false;
+                    if (endFrame !== undefined && m.frame >= endFrame)
+                        return false;
+                    if (needle && !(m.note ?? "").toLowerCase().includes(needle))
+                        return false;
+                    if (wantColor !== undefined) {
+                        const c = m.color;
+                        if (typeof c === "string") {
+                            if (c.toLowerCase() !== wantColor)
+                                return false;
+                        }
+                        else if (typeof c === "number") {
+                            if (wantIndex === undefined || c !== wantIndex)
+                                return false;
+                        }
+                        else {
+                            return false;
+                        }
+                    }
+                    return true;
+                });
+                if (full)
+                    return compact({ markers: filtered, total: filtered.length });
+                const s = summarizeList(filtered, 20);
+                return compact({
+                    total: s.total,
+                    omitted: s.omitted,
+                    head: s.head,
+                    tail: s.tail,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=get-markers.js.map

package/dist/tools/get-markers.js.map

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

package/dist/tools/get-timeline.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const GetTimelineParams: z.ZodObject<{
+    full: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function createGetTimelineTool(host: VideoHost): AgentTool<typeof GetTimelineParams>;
+export {};
+//# sourceMappingURL=get-timeline.d.ts.map

package/dist/tools/get-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-timeline.d.ts","sourceRoot":"","sources":["../../src/tools/get-timeline.ts"],"names":[],"mappings":"AAAA,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,iBAAiB;;iBAKrB,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAiC1F"}

package/dist/tools/get-timeline.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { compact, err, summarizeList } from "../core/format.js";
+const GetTimelineParams = z.object({
+    full: z
+        .boolean()
+        .optional()
+        .describe("Return all clips/markers (no summarization). Bloats context — use sparingly."),
+});
+export function createGetTimelineTool(host) {
+    return {
+        name: "get_timeline",
+        description: "Read the current timeline: name, fps, duration (frames), clips, markers. " +
+            "Long timelines are summarized (head + tail) by default; pass full=true to get everything.",
+        parameters: GetTimelineParams,
+        async execute({ full }) {
+            try {
+                const t = await host.getTimeline();
+                if (full) {
+                    return compact({
+                        name: t.name,
+                        fps: t.frameRate,
+                        dur: t.durationFrames,
+                        clips: t.clips,
+                        markers: t.markers,
+                    });
+                }
+                const cs = summarizeList(t.clips, 20);
+                const ms = summarizeList(t.markers, 20);
+                return compact({
+                    name: t.name,
+                    fps: t.frameRate,
+                    dur: t.durationFrames,
+                    clips: { total: cs.total, omitted: cs.omitted, head: cs.head, tail: cs.tail },
+                    markers: { total: ms.total, omitted: ms.omitted, head: ms.head, tail: ms.tail },
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=get-timeline.js.map

package/dist/tools/get-timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-timeline.js","sourceRoot":"","sources":["../../src/tools/get-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGhE,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC;SACJ,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;CAC5F,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CAAC,IAAe;IACnD,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,2EAA2E;YAC3E,2FAA2F;QAC7F,UAAU,EAAE,iBAAiB;QAC7B,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE;YACpB,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;gBACnC,IAAI,IAAI,EAAE,CAAC;oBACT,OAAO,OAAO,CAAC;wBACb,IAAI,EAAE,CAAC,CAAC,IAAI;wBACZ,GAAG,EAAE,CAAC,CAAC,SAAS;wBAChB,GAAG,EAAE,CAAC,CAAC,cAAc;wBACrB,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,OAAO,EAAE,CAAC,CAAC,OAAO;qBACnB,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACtC,MAAM,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACxC,OAAO,OAAO,CAAC;oBACb,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,GAAG,EAAE,CAAC,CAAC,SAAS;oBAChB,GAAG,EAAE,CAAC,CAAC,cAAc;oBACrB,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;oBAC7E,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;iBAChF,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,GAAG,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}