@kenkaiiii/gg-editor 0.1.0

package/dist/tools/read-transcript.test.js

@@ -0,0 +1,136 @@
+import { mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { describe, expect, it } from "vitest";
+import { createReadTranscriptTool } from "./read-transcript.js";
+/**
+ * Filter combinations for read_transcript. The tool is the agent's main
+ * pull-only-what-you-need lever — wrong filtering blows the context budget.
+ */
+function makeTranscriptFile(t) {
+    const dir = mkdtempSync(join(tmpdir(), "gg-rt-"));
+    const path = join(dir, "transcript.json");
+    writeFileSync(path, JSON.stringify(t), "utf8");
+    return { dir, path };
+}
+const TX = {
+    language: "en",
+    durationSec: 120,
+    segments: [
+        { start: 0, end: 5, text: "Hello, welcome to the show.", speaker: "SPEAKER_00" },
+        { start: 5, end: 10, text: "Today we discuss authentication.", speaker: "SPEAKER_00" },
+        { start: 10, end: 20, text: "Auth is a deep topic.", speaker: "SPEAKER_01" },
+        { start: 20, end: 30, text: "Yeah, OAuth and OIDC.", speaker: "SPEAKER_00" },
+        { start: 30, end: 40, text: "Let's wrap with closing thoughts.", speaker: "SPEAKER_01" },
+    ],
+};
+const ctx = {
+    signal: new AbortController().signal,
+    toolCallId: "t1",
+};
+describe("read_transcript", () => {
+    it("returns all segments when no filter supplied", async () => {
+        const { dir } = makeTranscriptFile(TX);
+        const tool = createReadTranscriptTool(dir);
+        const r = await tool.execute({ path: "transcript.json" }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.totalMatched).toBe(5);
+        expect(parsed.returned).toBe(5);
+    });
+    it("filters by [startSec, endSec) interval", async () => {
+        const { dir } = makeTranscriptFile(TX);
+        const tool = createReadTranscriptTool(dir);
+        // Segments fully outside [10, 30) should be excluded; partial overlaps
+        // included. End is exclusive so seg [10,20] is in; seg [20,30] is in
+        // (start=20 < endSec=30); seg [30,40] is OUT (start >= endSec).
+        const r = await tool.execute({ path: "transcript.json", startSec: 10, endSec: 30 }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.totalMatched).toBe(2);
+    });
+    it("filters by case-insensitive substring", async () => {
+        const { dir } = makeTranscriptFile(TX);
+        const tool = createReadTranscriptTool(dir);
+        const r = await tool.execute({ path: "transcript.json", contains: "AUTH" }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.totalMatched).toBe(3);
+    });
+    it("filters by speaker (case-insensitive)", async () => {
+        const { dir } = makeTranscriptFile(TX);
+        const tool = createReadTranscriptTool(dir);
+        const r = await tool.execute({ path: "transcript.json", speaker: "speaker_00" }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.totalMatched).toBe(3);
+    });
+    it("intersects multiple filters (range + speaker + contains)", async () => {
+        const { dir } = makeTranscriptFile(TX);
+        const tool = createReadTranscriptTool(dir);
+        // SPEAKER_00 segments containing "auth" inside [0, 30)
+        const r = await tool.execute({
+            path: "transcript.json",
+            speaker: "SPEAKER_00",
+            contains: "auth",
+            startSec: 0,
+            endSec: 30,
+        }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.totalMatched).toBe(2);
+    });
+    it("respects limit and surfaces truncated=true", async () => {
+        const { dir } = makeTranscriptFile(TX);
+        const tool = createReadTranscriptTool(dir);
+        const r = await tool.execute({ path: "transcript.json", limit: 2 }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.returned).toBe(2);
+        expect(parsed.truncated).toBe(true);
+    });
+    it("returns surface-level error on missing path", async () => {
+        const tool = createReadTranscriptTool("/nonexistent");
+        const r = await tool.execute({ path: "missing.json" }, ctx);
+        expect(r).toMatch(/^error:/);
+    });
+    it("includes speaker in compact output when present", async () => {
+        const { dir } = makeTranscriptFile(TX);
+        const tool = createReadTranscriptTool(dir);
+        const r = await tool.execute({ path: "transcript.json", contains: "Hello" }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.segments[0].speaker).toBe("SPEAKER_00");
+    });
+    it("omits speaker when transcript has no labels", async () => {
+        const noSpeaker = {
+            language: "en",
+            durationSec: 5,
+            segments: [{ start: 0, end: 5, text: "Hi" }],
+        };
+        const { dir } = makeTranscriptFile(noSpeaker);
+        const tool = createReadTranscriptTool(dir);
+        const r = await tool.execute({ path: "transcript.json" }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.segments[0].speaker).toBeUndefined();
+    });
+    it("includes word-level timing only when includeWords=true", async () => {
+        const withWords = {
+            language: "en",
+            durationSec: 1,
+            segments: [
+                {
+                    start: 0,
+                    end: 1,
+                    text: "hi there",
+                    words: [
+                        { start: 0, end: 0.4, text: "hi" },
+                        { start: 0.5, end: 1, text: "there" },
+                    ],
+                },
+            ],
+        };
+        const { dir } = makeTranscriptFile(withWords);
+        const tool = createReadTranscriptTool(dir);
+        const r1 = await tool.execute({ path: "transcript.json" }, ctx);
+        const p1 = JSON.parse(r1);
+        expect(p1.segments[0].words).toBeUndefined();
+        const r2 = await tool.execute({ path: "transcript.json", includeWords: true }, ctx);
+        const p2 = JSON.parse(r2);
+        expect(p2.segments[0].words).toHaveLength(2);
+    });
+});
+//# sourceMappingURL=read-transcript.test.js.map

package/dist/tools/read-transcript.test.js.map

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

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

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const ReformatTimelineParams: z.ZodObject<{
+    output: z.ZodString;
+    preset: z.ZodEnum<{
+        "9:16": "9:16";
+        "1:1": "1:1";
+        "4:5": "4:5";
+        "16:9": "16:9";
+        "4:3": "4:3";
+    }>;
+    title: z.ZodString;
+    frameRate: z.ZodNumber;
+    events: z.ZodArray<z.ZodObject<{
+        reel: z.ZodString;
+        sourcePath: z.ZodString;
+        sourceInFrame: z.ZodNumber;
+        sourceOutFrame: z.ZodNumber;
+        clipName: z.ZodOptional<z.ZodString>;
+        sourceDurationFrames: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare function createReformatTimelineTool(cwd: string): AgentTool<typeof ReformatTimelineParams>;
+export {};
+//# sourceMappingURL=reformat-timeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reformat-timeline.d.ts","sourceRoot":"","sources":["../../src/tools/reformat-timeline.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAcrD,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;iBAQ1B,CAAC;AAEH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,sBAAsB,CAAC,CAmChG"}

package/dist/tools/reformat-timeline.js

@@ -0,0 +1,60 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { buildFcpxml } from "../core/fcpxml.js";
+import { compact, err } from "../core/format.js";
+import { reformatSpec } from "../core/reformat.js";
+const EventSchema = z.object({
+    reel: z.string(),
+    sourcePath: z.string(),
+    sourceInFrame: z.number().int().min(0),
+    sourceOutFrame: z.number().int().min(1),
+    clipName: z.string().optional(),
+    sourceDurationFrames: z.number().int().positive().optional(),
+});
+const ReformatTimelineParams = z.object({
+    output: z.string().describe("Output .fcpxml path (relative resolves to cwd)."),
+    preset: z
+        .enum(["9:16", "1:1", "4:5", "16:9", "4:3"])
+        .describe("Target aspect ratio. 9:16 for TikTok/Reels/Shorts."),
+    title: z.string(),
+    frameRate: z.number().positive(),
+    events: z.array(EventSchema).min(1),
+});
+export function createReformatTimelineTool(cwd) {
+    return {
+        name: "reformat_timeline",
+        description: "Generate an FCPXML preset for a target aspect ratio (9:16 / 1:1 / 4:5 / 16:9 / 4:3). " +
+            "Pair with import_edl to land a vertical/square version of an existing edit. The host " +
+            "(Resolve Studio Smart Reframe / Premiere Auto Reframe) handles the per-clip reframe " +
+            "after import. Output is one-line confirmation only.",
+        parameters: ReformatTimelineParams,
+        async execute({ output, preset, title, frameRate, events }) {
+            try {
+                const spec = reformatSpec(preset);
+                const text = buildFcpxml({
+                    title: `${title} [${spec.label}]`,
+                    frameRate,
+                    width: spec.width,
+                    height: spec.height,
+                    events,
+                });
+                const abs = resolvePath(cwd, output);
+                mkdirSync(dirname(abs), { recursive: true });
+                writeFileSync(abs, text, "utf8");
+                return compact({
+                    ok: true,
+                    path: abs,
+                    preset: spec.preset,
+                    width: spec.width,
+                    height: spec.height,
+                    events: events.length,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=reformat-timeline.js.map

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

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

package/dist/tools/render.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const RenderParams: z.ZodObject<{
+    preset: z.ZodString;
+    output: z.ZodString;
+}, z.core.$strip>;
+export declare function createRenderTool(host: VideoHost, cwd: string): AgentTool<typeof RenderParams>;
+export {};
+//# sourceMappingURL=render.d.ts.map

package/dist/tools/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/tools/render.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,QAAA,MAAM,YAAY;;;iBAGhB,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,YAAY,CAAC,CAiB7F"}

package/dist/tools/render.js

@@ -0,0 +1,26 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { err } from "../core/format.js";
+const RenderParams = z.object({
+    preset: z.string().describe("Host-specific preset name."),
+    output: z.string(),
+});
+export function createRenderTool(host, cwd) {
+    return {
+        name: "render",
+        description: "Render the current timeline to a file using a host preset. Blocks until done. " +
+            "Don't render until the edit is finalised.",
+        parameters: RenderParams,
+        async execute({ preset, output }) {
+            try {
+                const abs = resolvePath(cwd, output);
+                await host.render({ preset, output: abs });
+                return `ok:${abs}`;
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=render.js.map

package/dist/tools/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/tools/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGxC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACzD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAAC,IAAe,EAAE,GAAW;IAC3D,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,gFAAgF;YAChF,2CAA2C;QAC7C,UAAU,EAAE,YAAY;QACxB,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE;YAC9B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBACrC,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;gBAC3C,OAAO,MAAM,GAAG,EAAE,CAAC;YACrB,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/reorder-timeline.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const ReorderTimelineParams: z.ZodObject<{
+    newOrder: z.ZodArray<z.ZodString>;
+    sourcePathByClipId: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    fcpxmlOutput: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function createReorderTimelineTool(host: VideoHost, cwd: string): AgentTool<typeof ReorderTimelineParams>;
+export {};
+//# sourceMappingURL=reorder-timeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reorder-timeline.d.ts","sourceRoot":"","sources":["../../src/tools/reorder-timeline.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGxD,QAAA,MAAM,qBAAqB;;;;;iBAqBzB,CAAC;AAEH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,qBAAqB,CAAC,CAqCzC"}

package/dist/tools/reorder-timeline.js

@@ -0,0 +1,65 @@
+import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { buildFcpxml } from "../core/fcpxml.js";
+import { compact, err } from "../core/format.js";
+import { reorderToEvents } from "../core/reorder.js";
+const ReorderTimelineParams = z.object({
+    newOrder: z
+        .array(z.string())
+        .min(1)
+        .describe("Clip IDs in the desired new order. IDs not listed keep their original relative " +
+        "order and append at the end. Use get_timeline first to discover IDs."),
+    sourcePathByClipId: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe("Optional clipId → source path overrides. Required only when the host's " +
+        "ClipInfo.sourcePath is missing for some clips (rare; CEP fallback)."),
+    fcpxmlOutput: z
+        .string()
+        .optional()
+        .describe("Optional .fcpxml output path. Defaults to a tempfile we then importTimeline()."),
+    /** Skip the host import. Useful for diagnostics. */
+    dryRun: z.boolean().optional(),
+});
+export function createReorderTimelineTool(host, cwd) {
+    return {
+        name: "reorder_timeline",
+        description: "Reorder video clips on the active timeline by rebuilding it from FCPXML. Neither " +
+            "Resolve nor Premiere expose a scriptable 'move clip' op, so we emit a permuted " +
+            "FCPXML and import_timeline it. DESTRUCTIVE: replaces the active timeline. Use " +
+            "clone_timeline first if you need a safety net. Audio-only timelines unsupported.",
+        parameters: ReorderTimelineParams,
+        async execute({ newOrder, sourcePathByClipId, fcpxmlOutput, dryRun }) {
+            try {
+                const current = await host.getTimeline();
+                const events = reorderToEvents({
+                    current,
+                    newOrder,
+                    sourcePathByClipId,
+                });
+                const xml = buildFcpxml({
+                    title: current.name || "Reordered",
+                    frameRate: current.frameRate,
+                    events,
+                });
+                const outAbs = fcpxmlOutput
+                    ? resolvePath(cwd, fcpxmlOutput)
+                    : join(mkdtempSync(join(tmpdir(), "gg-reorder-")), "reorder.fcpxml");
+                if (fcpxmlOutput)
+                    mkdirSync(dirname(outAbs), { recursive: true });
+                writeFileSync(outAbs, xml, "utf8");
+                if (dryRun) {
+                    return compact({ ok: true, path: outAbs, events: events.length, dryRun: true });
+                }
+                await host.importTimeline(outAbs);
+                return compact({ ok: true, path: outAbs, events: events.length });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=reorder-timeline.js.map

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

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

package/dist/tools/replace-clip.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const ReplaceClipParams: z.ZodObject<{
+    clipId: z.ZodString;
+    mediaPath: z.ZodString;
+}, z.core.$strip>;
+export declare function createReplaceClipTool(host: VideoHost, cwd: string): AgentTool<typeof ReplaceClipParams>;
+export {};
+//# sourceMappingURL=replace-clip.d.ts.map

package/dist/tools/replace-clip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-clip.d.ts","sourceRoot":"","sources":["../../src/tools/replace-clip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,QAAA,MAAM,iBAAiB;;;iBAGrB,CAAC;AAEH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAmBrC"}

package/dist/tools/replace-clip.js

@@ -0,0 +1,28 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+const ReplaceClipParams = z.object({
+    clipId: z.string().min(1).describe("Clip id from get_timeline."),
+    mediaPath: z.string().min(1).describe("New source media (relative resolves to cwd)."),
+});
+export function createReplaceClipTool(host, cwd) {
+    return {
+        name: "replace_clip",
+        description: "Swap a clip's underlying media reference (e.g. updated render of a lower-third, " +
+            "graphic, or animation) without changing its in/out timing or grade. Common workflow: " +
+            "you ship a draft, the motion designer updates the file, this tool drops the new file " +
+            "into the same timeline slot. Falls back with a clear error on hosts that don't expose it.",
+        parameters: ReplaceClipParams,
+        async execute({ clipId, mediaPath }) {
+            try {
+                const abs = resolvePath(cwd, mediaPath);
+                await host.replaceClip(clipId, abs);
+                return compact({ ok: true, clipId, mediaPath: abs });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=replace-clip.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replace-clip.js","sourceRoot":"","sources":["../../src/tools/replace-clip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAChE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CACtF,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CACnC,IAAe,EACf,GAAW;IAEX,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,kFAAkF;YAClF,uFAAuF;YACvF,uFAAuF;YACvF,2FAA2F;QAC7F,UAAU,EAAE,iBAAiB;QAC7B,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE;YACjC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBACxC,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBACpC,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YACvD,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/review-edit.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const ReviewEditParams: z.ZodObject<{
+    intent: z.ZodString;
+    focus: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        audio: "audio";
+        color: "color";
+        pacing: "pacing";
+        takes: "takes";
+        captions: "captions";
+        hook: "hook";
+    }>>>;
+}, z.core.$strip>;
+export interface ReviewEditConfig {
+    provider: "anthropic" | "openai" | "glm" | "moonshot";
+    model: string;
+    apiKey: string;
+    maxTurns?: number;
+}
+export declare function createReviewEditTool(host: VideoHost, cwd: string, config: ReviewEditConfig): AgentTool<typeof ReviewEditParams>;
+export {};
+//# sourceMappingURL=review-edit.d.ts.map

package/dist/tools/review-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-edit.d.ts","sourceRoot":"","sources":["../../src/tools/review-edit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKxD,QAAA,MAAM,gBAAgB;;;;;;;;;;iBAYpB,CAAC;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAC;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,gBAAgB,GACvB,SAAS,CAAC,OAAO,gBAAgB,CAAC,CA8BpC"}

package/dist/tools/review-edit.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { runReview } from "../core/review.js";
+const FocusEnum = z.enum(["pacing", "takes", "audio", "captions", "hook", "color"]);
+const ReviewEditParams = z.object({
+    intent: z
+        .string()
+        .min(10)
+        .describe("What the edit is FOR. The reviewer measures against this. " +
+        "Examples: 'tight 90s podcast clip about decision fatigue, captioned for IG'."),
+    focus: z
+        .array(FocusEnum)
+        .optional()
+        .describe("Optional aspects to focus on: pacing/takes/audio/captions/hook/color."),
+});
+export function createReviewEditTool(host, cwd, config) {
+    return {
+        name: "review_edit",
+        description: "Self-critique pass over the current edit. Spawns a fresh READ-ONLY reviewer " +
+            "agent that inspects the timeline, markers, and transcripts against the stated intent " +
+            "and returns a one-paragraph critique + a flags array (severity: ok/warn/block). " +
+            "Use BEFORE rendering on important edits. Token-expensive (~10 reviewer turns) — call sparingly.",
+        parameters: ReviewEditParams,
+        async execute({ intent, focus }, ctx) {
+            try {
+                const r = await runReview({
+                    intent,
+                    focus,
+                    host,
+                    cwd,
+                    config,
+                    signal: ctx.signal,
+                });
+                return compact({
+                    critique: r.critique,
+                    flags: r.flags,
+                    turns: r.turns,
+                    tokens: { in: r.usage.inputTokens ?? 0, out: r.usage.outputTokens ?? 0 },
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=review-edit.js.map

package/dist/tools/review-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-edit.js","sourceRoot":"","sources":["../../src/tools/review-edit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEpF,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CACP,4DAA4D;QAC1D,8EAA8E,CACjF;IACH,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,SAAS,CAAC;SAChB,QAAQ,EAAE;SACV,QAAQ,CAAC,uEAAuE,CAAC;CACrF,CAAC,CAAC;AASH,MAAM,UAAU,oBAAoB,CAClC,IAAe,EACf,GAAW,EACX,MAAwB;IAExB,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,8EAA8E;YAC9E,uFAAuF;YACvF,kFAAkF;YAClF,iGAAiG;QACnG,UAAU,EAAE,gBAAgB;QAC5B,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG;YAClC,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC;oBACxB,MAAM;oBACN,KAAK;oBACL,IAAI;oBACJ,GAAG;oBACH,MAAM;oBACN,MAAM,EAAE,GAAG,CAAC,MAAM;iBACnB,CAAC,CAAC;gBACH,OAAO,OAAO,CAAC;oBACb,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,EAAE;iBACzE,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"}

package/dist/tools/ripple-delete.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const RippleDeleteParams: z.ZodObject<{
+    track: z.ZodNumber;
+    startFrame: z.ZodNumber;
+    endFrame: z.ZodNumber;
+}, z.core.$strip>;
+export declare function createRippleDeleteTool(host: VideoHost): AgentTool<typeof RippleDeleteParams>;
+export {};
+//# sourceMappingURL=ripple-delete.d.ts.map

package/dist/tools/ripple-delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ripple-delete.d.ts","sourceRoot":"","sources":["../../src/tools/ripple-delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,QAAA,MAAM,kBAAkB;;;;iBAItB,CAAC;AAEH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,kBAAkB,CAAC,CAiB5F"}

package/dist/tools/ripple-delete.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { err } from "../core/format.js";
+const RippleDeleteParams = z.object({
+    track: z.number().int().min(1),
+    startFrame: z.number().int().min(0),
+    endFrame: z.number().int().min(1),
+});
+export function createRippleDeleteTool(host) {
+    return {
+        name: "ripple_delete",
+        description: "Delete a frame range on a track AND close the gap. " +
+            "If unsupported, build a fresh EDL with write_edl + import_edl.",
+        parameters: RippleDeleteParams,
+        async execute({ track, startFrame, endFrame }) {
+            if (endFrame <= startFrame)
+                return err("endFrame must be > startFrame");
+            try {
+                await host.rippleDelete(track, { start: startFrame, end: endFrame });
+                return "ok";
+            }
+            catch (e) {
+                return err(e.message, "use write_edl + import_edl");
+            }
+        },
+    };
+}
+//# sourceMappingURL=ripple-delete.js.map

package/dist/tools/ripple-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ripple-delete.js","sourceRoot":"","sources":["../../src/tools/ripple-delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGxC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAClC,CAAC,CAAC;AAEH,MAAM,UAAU,sBAAsB,CAAC,IAAe;IACpD,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,qDAAqD;YACrD,gEAAgE;QAClE,UAAU,EAAE,kBAAkB;QAC9B,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE;YAC3C,IAAI,QAAQ,IAAI,UAAU;gBAAE,OAAO,GAAG,CAAC,+BAA+B,CAAC,CAAC;YACxE,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACrE,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,GAAG,CAAE,CAAW,CAAC,OAAO,EAAE,4BAA4B,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/save-project.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const SaveProjectParams: z.ZodObject<{}, z.core.$strip>;
+export declare function createSaveProjectTool(host: VideoHost): AgentTool<typeof SaveProjectParams>;
+export {};
+//# sourceMappingURL=save-project.d.ts.map

package/dist/tools/save-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-project.d.ts","sourceRoot":"","sources":["../../src/tools/save-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,QAAA,MAAM,iBAAiB,gCAAe,CAAC;AAEvC,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAiB1F"}

package/dist/tools/save-project.js

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import { err } from "../core/format.js";
+const SaveProjectParams = z.object({});
+export function createSaveProjectTool(host) {
+    return {
+        name: "save_project",
+        description: "Save the host project. Resolve calls ProjectManager.SaveProject(); Premiere calls " +
+            "app.project.save(). Use after a sequence of edits the user is happy with so a host " +
+            "crash doesn't lose work. Call AFTER clone_timeline when you want a checkpoint.",
+        parameters: SaveProjectParams,
+        async execute() {
+            try {
+                await host.saveProject();
+                return "ok";
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=save-project.js.map

package/dist/tools/save-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-project.js","sourceRoot":"","sources":["../../src/tools/save-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGxC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEvC,MAAM,UAAU,qBAAqB,CAAC,IAAe;IACnD,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,oFAAoF;YACpF,qFAAqF;YACrF,gFAAgF;QAClF,UAAU,EAAE,iBAAiB;QAC7B,KAAK,CAAC,OAAO;YACX,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;gBACzB,OAAO,IAAI,CAAC;YACd,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/score-shot.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const ScoreShotParams: z.ZodObject<{
+    input: z.ZodString;
+    times: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    intervalSec: z.ZodOptional<z.ZodNumber>;
+    startSec: z.ZodOptional<z.ZodNumber>;
+    endSec: z.ZodOptional<z.ZodNumber>;
+    detail: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+    maxFrames: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createScoreShotTool(cwd: string): AgentTool<typeof ScoreShotParams>;
+export {};
+//# sourceMappingURL=score-shot.d.ts.map

package/dist/tools/score-shot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score-shot.d.ts","sourceRoot":"","sources":["../../src/tools/score-shot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAMrD,QAAA,MAAM,eAAe;;;;;;;;;;;;iBA4BnB,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,eAAe,CAAC,CA0FlF"}