@kenkaiiii/gg-editor 0.1.0

package/dist/tools/write-keyword-captions.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const WriteKeywordCaptionsParams: z.ZodObject<{
+    transcript: z.ZodString;
+    output: z.ZodString;
+    startSec: z.ZodOptional<z.ZodNumber>;
+    endSec: z.ZodOptional<z.ZodNumber>;
+    groupSize: z.ZodOptional<z.ZodNumber>;
+    maxKeywordsPerCue: z.ZodOptional<z.ZodNumber>;
+    minKeywordLen: z.ZodOptional<z.ZodNumber>;
+    gapSec: z.ZodOptional<z.ZodNumber>;
+    fontName: z.ZodOptional<z.ZodString>;
+    fontSize: z.ZodOptional<z.ZodNumber>;
+    primaryColor: z.ZodOptional<z.ZodString>;
+    outlineColor: z.ZodOptional<z.ZodString>;
+    keywordColor: z.ZodOptional<z.ZodString>;
+    keywordFontSize: z.ZodOptional<z.ZodNumber>;
+    marginV: z.ZodOptional<z.ZodNumber>;
+    playResX: z.ZodOptional<z.ZodNumber>;
+    playResY: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * write_keyword_captions — CapCut-style "active word" caption track.
+ *
+ * Runs the keyword heuristic over a word-timestamped transcript and
+ * emits an .ass file where the most content-bearing word per cue is
+ * rendered in a punchier color/scale. Pair with burn_subtitles to
+ * bake into a finished short.
+ *
+ * Defaults are tuned for vertical (1080x1920) bottom-third placement
+ * with white text + yellow keyword pops — the most-used short-form
+ * caption look in 2025-2026.
+ */
+export declare function createWriteKeywordCaptionsTool(cwd: string): AgentTool<typeof WriteKeywordCaptionsParams>;
+export {};
+//# sourceMappingURL=write-keyword-captions.d.ts.map

package/dist/tools/write-keyword-captions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-keyword-captions.d.ts","sourceRoot":"","sources":["../../src/tools/write-keyword-captions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAMrD,QAAA,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;iBAoE9B,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,0BAA0B,CAAC,CA+F9C"}

package/dist/tools/write-keyword-captions.js

@@ -0,0 +1,183 @@
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { buildAss } from "../core/ass.js";
+import { compact, err } from "../core/format.js";
+import { buildKeywordCaptions } from "../core/keyword-captions.js";
+const WriteKeywordCaptionsParams = z.object({
+    transcript: z
+        .string()
+        .describe("Transcript JSON with word-level timings. Run transcribe(wordTimestamps=true) first."),
+    output: z.string().describe("Output .ass path (relative resolves to cwd)."),
+    startSec: z.number().min(0).optional().describe("Optional start of the window. Default 0."),
+    endSec: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Optional end of the window. Default = transcript end."),
+    groupSize: z
+        .number()
+        .int()
+        .min(1)
+        .max(8)
+        .optional()
+        .describe("Words per cue. Default 3 — readable at fast speech rates."),
+    maxKeywordsPerCue: z
+        .number()
+        .int()
+        .min(0)
+        .max(3)
+        .optional()
+        .describe("Max highlighted words per cue. Default 1. 0 disables highlighting."),
+    minKeywordLen: z
+        .number()
+        .int()
+        .min(2)
+        .max(12)
+        .optional()
+        .describe("Minimum letter count to qualify a word as a keyword. Default 5."),
+    gapSec: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Min word gap that forces a new cue. Default 0.4s."),
+    /** Aesthetic knobs. Defaults are tuned for vertical / 9:16 burns. */
+    fontName: z.string().optional().describe("Font family. Default Arial."),
+    fontSize: z.number().int().positive().optional().describe("Default style font size. Default 84."),
+    primaryColor: z
+        .string()
+        .optional()
+        .describe("Default style fill (RRGGBB). Default FFFFFF (white)."),
+    outlineColor: z.string().optional().describe("Default + Keyword outline. Default 000000."),
+    keywordColor: z
+        .string()
+        .optional()
+        .describe("Highlighted word fill (RRGGBB). Default FFEA00 (CapCut yellow)."),
+    keywordFontSize: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Highlighted word size. Default 96 — slightly larger pop."),
+    marginV: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe("Vertical margin in pixels (alignment 1-3 = bottom). Default 220. For 1080x1920 this " +
+        "puts captions in the lower-third sweet spot."),
+    playResX: z.number().int().positive().optional().describe("Canvas width. Default 1080."),
+    playResY: z.number().int().positive().optional().describe("Canvas height. Default 1920."),
+});
+/**
+ * write_keyword_captions — CapCut-style "active word" caption track.
+ *
+ * Runs the keyword heuristic over a word-timestamped transcript and
+ * emits an .ass file where the most content-bearing word per cue is
+ * rendered in a punchier color/scale. Pair with burn_subtitles to
+ * bake into a finished short.
+ *
+ * Defaults are tuned for vertical (1080x1920) bottom-third placement
+ * with white text + yellow keyword pops — the most-used short-form
+ * caption look in 2025-2026.
+ */
+export function createWriteKeywordCaptionsTool(cwd) {
+    return {
+        name: "write_keyword_captions",
+        description: "Emit a CapCut-style word-by-word .ass file where the most content-bearing word per " +
+            "cue is highlighted (color + size pop). The signature look of viral short-form captions. " +
+            "REQUIRES transcribe(wordTimestamps=true). Pair with burn_subtitles to bake in. Defaults " +
+            "tuned for 9:16 vertical burns (white default + yellow keywords, lower-third).",
+        parameters: WriteKeywordCaptionsParams,
+        async execute(args) {
+            try {
+                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 = JSON.parse(raw);
+                }
+                catch (e) {
+                    return err(`transcript is not valid JSON: ${e.message}`);
+                }
+                const lo = args.startSec ?? 0;
+                const hi = args.endSec ?? t.durationSec;
+                if (hi <= lo)
+                    return err("endSec must be > startSec");
+                // Flatten all words within the window. Word-by-word captions
+                // don't care about segment boundaries.
+                const allWords = [];
+                for (const seg of t.segments) {
+                    if (!seg.words)
+                        continue;
+                    for (const w of seg.words) {
+                        if (w.end <= lo || w.start >= hi)
+                            continue;
+                        allWords.push({
+                            start: Math.max(lo, w.start) - lo,
+                            end: Math.min(hi, w.end) - lo,
+                            text: w.text,
+                        });
+                    }
+                }
+                if (allWords.length === 0) {
+                    return err("no word timings in window", "rerun transcribe(wordTimestamps=true) or widen startSec/endSec");
+                }
+                const { cues, styles } = buildKeywordCaptions(allWords, {
+                    groupSize: args.groupSize,
+                    gapSec: args.gapSec,
+                    maxKeywordsPerCue: args.maxKeywordsPerCue,
+                    minKeywordLen: args.minKeywordLen,
+                });
+                // Apply aesthetic overrides onto the returned styles.
+                for (const s of styles) {
+                    if (s.name === "Default") {
+                        if (args.fontName)
+                            s.fontName = args.fontName;
+                        if (args.fontSize)
+                            s.fontSize = args.fontSize;
+                        if (args.primaryColor)
+                            s.primaryColor = args.primaryColor;
+                        if (args.outlineColor)
+                            s.outlineColor = args.outlineColor;
+                        if (args.marginV !== undefined)
+                            s.marginV = args.marginV;
+                    }
+                    else if (s.name === "Keyword") {
+                        if (args.fontName)
+                            s.fontName = args.fontName;
+                        if (args.keywordFontSize)
+                            s.fontSize = args.keywordFontSize;
+                        if (args.keywordColor)
+                            s.primaryColor = args.keywordColor;
+                        if (args.outlineColor)
+                            s.outlineColor = args.outlineColor;
+                        if (args.marginV !== undefined)
+                            s.marginV = args.marginV;
+                    }
+                }
+                const ass = buildAss({
+                    styles,
+                    cues,
+                    playResX: args.playResX ?? 1080,
+                    playResY: args.playResY ?? 1920,
+                    title: "GG Editor — keyword captions",
+                });
+                const outAbs = resolvePath(cwd, args.output);
+                mkdirSync(dirname(outAbs), { recursive: true });
+                writeFileSync(outAbs, ass, "utf8");
+                return compact({ path: outAbs, cues: cues.length });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=write-keyword-captions.js.map

package/dist/tools/write-keyword-captions.js.map

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

package/dist/tools/write-lower-third.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const WriteLowerThirdParams: z.ZodObject<{
+    output: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    items: z.ZodArray<z.ZodObject<{
+        primaryText: z.ZodString;
+        secondaryText: z.ZodOptional<z.ZodString>;
+        startSec: z.ZodNumber;
+        durationSec: z.ZodNumber;
+        fontName: z.ZodOptional<z.ZodString>;
+        primaryColor: z.ZodOptional<z.ZodString>;
+        accentColor: z.ZodOptional<z.ZodString>;
+        position: z.ZodOptional<z.ZodEnum<{
+            "bottom-left": "bottom-left";
+            "bottom-center": "bottom-center";
+            "bottom-right": "bottom-right";
+            "top-left": "top-left";
+            "top-center": "top-center";
+            "top-right": "top-right";
+        }>>;
+        animation: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            fade: "fade";
+            "slide-left": "slide-left";
+            "slide-right": "slide-right";
+        }>>;
+        marginPx: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare function createWriteLowerThirdTool(cwd: string): AgentTool<typeof WriteLowerThirdParams>;
+export {};
+//# sourceMappingURL=write-lower-third.d.ts.map

package/dist/tools/write-lower-third.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-lower-third.d.ts","sourceRoot":"","sources":["../../src/tools/write-lower-third.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAmBrD,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASzB,CAAC;AAEH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,qBAAqB,CAAC,CAqB9F"}

package/dist/tools/write-lower-third.js

@@ -0,0 +1,52 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { buildLowerThirdAss } from "../core/text-overlay.js";
+const LowerThirdSchema = z.object({
+    primaryText: z.string().min(1).describe("Big text — name / topic."),
+    secondaryText: z.string().optional().describe("Small text — title / role."),
+    startSec: z.number().min(0),
+    durationSec: z.number().positive(),
+    fontName: z.string().optional(),
+    primaryColor: z.string().optional().describe("Hex RRGGBB. Default white."),
+    accentColor: z.string().optional().describe("Outline / shadow color. Default black."),
+    position: z
+        .enum(["bottom-left", "bottom-center", "bottom-right", "top-left", "top-center", "top-right"])
+        .optional(),
+    animation: z.enum(["slide-left", "slide-right", "fade", "none"]).optional(),
+    marginPx: z.number().int().min(0).optional(),
+});
+const WriteLowerThirdParams = z.object({
+    output: z.string().describe("Output .ass file path. Pair with burn_subtitles to render."),
+    width: z
+        .number()
+        .int()
+        .positive()
+        .describe("Canvas width in pixels (1920 horizontal, 1080 vertical)."),
+    height: z.number().int().positive(),
+    items: z.array(LowerThirdSchema).min(1),
+});
+export function createWriteLowerThirdTool(cwd) {
+    return {
+        name: "write_lower_third",
+        description: "Write an .ass file containing one or more animated lower-thirds (name + title chyrons). " +
+            "Animations: slide-left/right, fade, none. Pair with burn_subtitles to bake into the " +
+            "video, or import as a subtitle track for in-NLE styling. ASS is universally supported " +
+            "by ffmpeg's subtitles filter (libass).",
+        parameters: WriteLowerThirdParams,
+        async execute({ output, width, height, items }) {
+            try {
+                const ass = buildLowerThirdAss(items, { width, height });
+                const outAbs = resolvePath(cwd, output);
+                mkdirSync(dirname(outAbs), { recursive: true });
+                writeFileSync(outAbs, ass, "utf8");
+                return compact({ ok: true, path: outAbs, items: items.length });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=write-lower-third.js.map

package/dist/tools/write-lower-third.js.map

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

package/dist/tools/write-srt.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const WriteSrtParams: z.ZodObject<{
+    output: z.ZodString;
+    cues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        text: z.ZodString;
+    }, z.core.$strip>>>;
+    words: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        text: z.ZodString;
+    }, z.core.$strip>>>;
+    groupSize: z.ZodOptional<z.ZodNumber>;
+    gapSec: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createWriteSrtTool(cwd: string): AgentTool<typeof WriteSrtParams>;
+export {};
+//# sourceMappingURL=write-srt.d.ts.map

package/dist/tools/write-srt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-srt.d.ts","sourceRoot":"","sources":["../../src/tools/write-srt.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAgBrD,QAAA,MAAM,cAAc;;;;;;;;;;;;;;iBA4BhB,CAAC;AAEL,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,cAAc,CAAC,CA+BhF"}

package/dist/tools/write-srt.js

@@ -0,0 +1,72 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { buildSrt, buildWordLevelSrt } from "../core/srt.js";
+const CueSchema = z.object({
+    start: z.number().min(0).describe("Cue start in seconds."),
+    end: z.number().positive().describe("Cue end in seconds (must be > start)."),
+    text: z.string().describe("Caption text. Multi-line OK."),
+});
+const WordSchema = z.object({
+    start: z.number().min(0),
+    end: z.number().positive(),
+    text: z.string(),
+});
+const WriteSrtParams = z
+    .object({
+    output: z.string().describe("Output .srt path (relative resolves to cwd)."),
+    cues: z
+        .array(CueSchema)
+        .optional()
+        .describe("Sentence-level cues. Use for long-form sidecar captions."),
+    words: z
+        .array(WordSchema)
+        .optional()
+        .describe("Word-level cues. Use for burned-in vertical captions (TikTok / Reels style)."),
+    groupSize: z
+        .number()
+        .int()
+        .min(1)
+        .max(10)
+        .optional()
+        .describe("When using words[], cluster N consecutive words per cue. Default 1."),
+    gapSec: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("When using words[], extend each cue's end up to the next cue's start (closed-caption look). Max gap."),
+})
+    .refine((v) => (v.cues && v.cues.length > 0) || (v.words && v.words.length > 0), {
+    message: "either `cues` or `words` must be provided",
+});
+export function createWriteSrtTool(cwd) {
+    return {
+        name: "write_srt",
+        description: "Write a SubRip (.srt) caption file from a list of cues. Pair with transcribe → " +
+            "import_subtitles to caption a video end-to-end. Captions are non-negotiable for " +
+            "short-form (most viewers watch muted).",
+        parameters: WriteSrtParams,
+        async execute({ output, cues, words, groupSize, gapSec }) {
+            try {
+                const text = words ? buildWordLevelSrt(words, { groupSize, gapSec }) : buildSrt(cues);
+                if (!text) {
+                    return err("no usable cues (all empty / invalid)", "ensure at least one cue has non-empty text and end > start");
+                }
+                const abs = resolvePath(cwd, output);
+                mkdirSync(dirname(abs), { recursive: true });
+                writeFileSync(abs, text, "utf8");
+                return compact({
+                    ok: true,
+                    path: abs,
+                    cues: words ? Math.ceil(words.length / (groupSize ?? 1)) : cues.length,
+                    ...(words ? { mode: "word-level" } : {}),
+                });
+            }
+            catch (e) {
+                return err(e.message, "verify cue end > start and text not empty");
+            }
+        },
+    };
+}
+//# sourceMappingURL=write-srt.js.map

package/dist/tools/write-srt.js.map

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

package/dist/tools/write-title-card.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const WriteTitleCardParams: z.ZodObject<{
+    output: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    items: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        startSec: z.ZodNumber;
+        durationSec: z.ZodNumber;
+        fontName: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodNumber>;
+        color: z.ZodOptional<z.ZodString>;
+        alignment: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>, z.ZodLiteral<7>, z.ZodLiteral<8>, z.ZodLiteral<9>]>>;
+        animation: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            "zoom-in": "zoom-in";
+            "fade-in-out": "fade-in-out";
+            "type-on": "type-on";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare function createWriteTitleCardTool(cwd: string): AgentTool<typeof WriteTitleCardParams>;
+export {};
+//# sourceMappingURL=write-title-card.d.ts.map

package/dist/tools/write-title-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-title-card.d.ts","sourceRoot":"","sources":["../../src/tools/write-title-card.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AA4BrD,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;iBAKxB,CAAC;AAEH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,oBAAoB,CAAC,CAqB5F"}

package/dist/tools/write-title-card.js

@@ -0,0 +1,57 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { buildTitleCardAss } from "../core/text-overlay.js";
+const TitleCardSchema = z.object({
+    text: z.string().min(1),
+    startSec: z.number().min(0),
+    durationSec: z.number().positive(),
+    fontName: z.string().optional(),
+    fontSize: z.number().int().positive().optional(),
+    color: z.string().optional().describe("Hex RRGGBB."),
+    alignment: z
+        .union([
+        z.literal(1),
+        z.literal(2),
+        z.literal(3),
+        z.literal(4),
+        z.literal(5),
+        z.literal(6),
+        z.literal(7),
+        z.literal(8),
+        z.literal(9),
+    ])
+        .optional()
+        .describe("Numpad alignment. 5 = centre, 8 = top-centre, 2 = bottom-centre."),
+    animation: z.enum(["fade-in-out", "zoom-in", "type-on", "none"]).optional(),
+});
+const WriteTitleCardParams = z.object({
+    output: z.string().describe("Output .ass file path."),
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
+    items: z.array(TitleCardSchema).min(1),
+});
+export function createWriteTitleCardTool(cwd) {
+    return {
+        name: "write_title_card",
+        description: "Write an .ass file containing one or more big-type title cards (chapter cards, " +
+            "intro / outro slides, callouts). Animations: fade-in-out, zoom-in, type-on, none. " +
+            "Pair with burn_subtitles to render, or import as a subtitle track. Use this for " +
+            "section breaks; use write_lower_third for name/role chyrons.",
+        parameters: WriteTitleCardParams,
+        async execute({ output, width, height, items }) {
+            try {
+                const ass = buildTitleCardAss(items, { width, height });
+                const outAbs = resolvePath(cwd, output);
+                mkdirSync(dirname(outAbs), { recursive: true });
+                writeFileSync(outAbs, ass, "utf8");
+                return compact({ ok: true, path: outAbs, items: items.length });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=write-title-card.js.map

package/dist/tools/write-title-card.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+export type Frame = number;
+export interface FrameRange {
+    start: Frame;
+    end: Frame;
+}
+export interface ClipInfo {
+    id: string;
+    track: number;
+    trackKind: "video" | "audio";
+    startFrame: Frame;
+    endFrame: Frame;
+    name: string;
+    sourcePath?: string;
+}
+export interface MarkerInfo {
+    frame: Frame;
+    note: string;
+    /**
+     * Color may be a name (Resolve: "Blue", "Red", ...) or a numeric index
+     * (Premiere: 0..7 mapping to green/red/purple/orange/yellow/white/blue/cyan).
+     * Tools that filter by color accept either form.
+     */
+    color?: string | number;
+    durationFrames?: number;
+}
+export interface TimelineState {
+    name: string;
+    frameRate: number;
+    durationFrames: Frame;
+    clips: ClipInfo[];
+    markers: MarkerInfo[];
+}
+/**
+ * Which scripting runtime an adapter is using to talk to the host. Useful for
+ * surfacing deprecation notices (Adobe CEP / ExtendScript end Sept 2026) and
+ * routing version-sensitive ops.
+ *
+ *   - 'uxp'        Adobe UXP plugin (Premiere 25.6+) — the only forward path.
+ *   - 'cep'        Adobe CEP / ExtendScript panel — deprecated, EOL Sept 2026.
+ *   - 'osascript'  macOS AppleScript → ExtendScript fallback. Same EOL.
+ *   - 'native'     Direct API (Resolve Python bridge) — not deprecated.
+ */
+export type HostRuntime = "uxp" | "cep" | "osascript" | "native";
+export interface HostCapabilities {
+    /** Can clips be moved on the timeline (not only appended)? */
+    canMoveClips: boolean;
+    /** Can color grades / nodes be applied via script? */
+    canScriptColor: boolean;
+    /** Can audio mixer / fades be controlled via script? */
+    canScriptAudio: boolean;
+    /** Can AI features (Magic Mask, Voice Isolation, etc.) be triggered? */
+    canTriggerAI: boolean;
+    /** Preferred timeline interchange format for bulk operations. */
+    preferredImportFormat: "edl" | "fcpxml" | "aaf" | "xml";
+    /** Whether the host is reachable right now (process running, API enabled). */
+    isAvailable: boolean;
+    /** Why a host is unavailable, if relevant. */
+    unavailableReason?: string;
+    /**
+     * Active scripting runtime. Resolved lazily — may be undefined before the
+     * first real bridge call (capabilities() probes reachability but doesn't
+     * always commit to a transport).
+     */
+    runtime?: HostRuntime;
+    /**
+     * Free-form deprecation note surfaced to the agent + UI. Set when the active
+     * runtime is on a known sunset path (currently Adobe CEP / ExtendScript,
+     * which Adobe is removing in September 2026).
+     */
+    deprecationNotice?: string;
+}
+export type HostName = "resolve" | "premiere" | "none";
+export interface EditorConfig {
+    /** Forced host, or undefined to auto-detect. */
+    host?: HostName;
+    /** Working directory for media files / EDL output / renders. */
+    cwd: string;
+    /** LLM provider. */
+    provider: "anthropic" | "openai" | "glm" | "moonshot";
+    /** LLM model. */
+    model: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAE3B,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,EAAE,KAAK,CAAC;CACZ;AAID,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,UAAU,EAAE,KAAK,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,KAAK,CAAC;IACtB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAID;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,YAAY,EAAE,OAAO,CAAC;IACtB,sDAAsD;IACtD,cAAc,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,cAAc,EAAE,OAAO,CAAC;IACxB,wEAAwE;IACxE,YAAY,EAAE,OAAO,CAAC;IACtB,iEAAiE;IACjE,qBAAqB,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC;IACxD,8EAA8E;IAC9E,WAAW,EAAE,OAAO,CAAC;IACrB,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAID,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB;IACpB,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAC;IACtD,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// ── Frame & timecode ────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D"}