@kenkaiiii/gg-editor 0.1.0

package/dist/core/reformat.test.js

@@ -0,0 +1,29 @@
+import { describe, expect, it } from "vitest";
+import { REFORMAT_PRESETS, reformatSpec } from "./reformat.js";
+describe("reformatSpec", () => {
+    it("returns 1080x1920 for 9:16", () => {
+        const s = reformatSpec("9:16");
+        expect(s.width).toBe(1080);
+        expect(s.height).toBe(1920);
+    });
+    it("returns square 1080x1080 for 1:1", () => {
+        expect(reformatSpec("1:1")).toMatchObject({ width: 1080, height: 1080 });
+    });
+    it("returns 1080x1350 for 4:5 portrait", () => {
+        expect(reformatSpec("4:5")).toMatchObject({ width: 1080, height: 1350 });
+    });
+    it("returns 1920x1080 for 16:9", () => {
+        expect(reformatSpec("16:9")).toMatchObject({ width: 1920, height: 1080 });
+    });
+    it("returns 1440x1080 for 4:3", () => {
+        expect(reformatSpec("4:3")).toMatchObject({ width: 1440, height: 1080 });
+    });
+    it("throws on unknown preset", () => {
+        // @ts-expect-error invalid preset for testing
+        expect(() => reformatSpec("bogus")).toThrow(/unknown reformat preset/);
+    });
+    it("exposes a stable preset list", () => {
+        expect(REFORMAT_PRESETS).toEqual(["9:16", "1:1", "4:5", "16:9", "4:3"]);
+    });
+});
+//# sourceMappingURL=reformat.test.js.map

package/dist/core/reformat.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reformat.test.js","sourceRoot":"","sources":["../../src/core/reformat.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE/D,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,8CAA8C;QAC9C,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/reorder.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Timeline reordering — turn a current TimelineState + an agent-supplied
+ * permutation into a list of FCPXML events that the host can re-import.
+ *
+ * Why this exists: neither Resolve nor Premiere expose a scriptable "move
+ * clip from index N to index M" call. The portable workaround is to rebuild
+ * the timeline as FCPXML and import it. This module is the pure, testable
+ * core of that workaround.
+ *
+ * Ordering rules:
+ *   - Only video clips are reorderable (audio rides along with each video
+ *     clip's underlying asset). Audio-only timelines are out of scope here.
+ *   - `newOrder` is a list of clip IDs in the desired new order. Clips not
+ *     listed keep their original relative order and stack at the end.
+ *   - Throws if newOrder references a clipId that doesn't exist on the
+ *     current timeline (typo guard — silently dropping is worse).
+ */
+import type { TimelineState } from "../types.js";
+import type { FcpxmlEvent } from "./fcpxml.js";
+export interface ReorderInput {
+    /** Current timeline state from host.getTimeline(). */
+    current: TimelineState;
+    /**
+     * Desired new order, as a list of clipIds. IDs not present here keep their
+     * original relative order and append at the end.
+     */
+    newOrder: string[];
+    /**
+     * Map from clipId to absolute source media path. Required because
+     * TimelineState's ClipInfo has an OPTIONAL sourcePath — when the host
+     * adapter can't resolve it (e.g. CEP fallback), the agent supplies it.
+     * If a ClipInfo already has sourcePath, the map entry is optional.
+     */
+    sourcePathByClipId?: Record<string, string>;
+}
+/**
+ * Build the FcpxmlEvent[] list for the reordered timeline. Each event maps
+ * to one video clip in the new order. Sequential record offsets are computed
+ * by the FCPXML emitter (we don't pre-compute them here — that's its job).
+ */
+export declare function reorderToEvents(input: ReorderInput): FcpxmlEvent[];
+//# sourceMappingURL=reorder.d.ts.map

package/dist/core/reorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reorder.d.ts","sourceRoot":"","sources":["../../src/core/reorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAY,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,OAAO,EAAE,aAAa,CAAC;IACvB;;;OAGG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,EAAE,CA6DlE"}

package/dist/core/reorder.js

@@ -0,0 +1,80 @@
+/**
+ * Timeline reordering — turn a current TimelineState + an agent-supplied
+ * permutation into a list of FCPXML events that the host can re-import.
+ *
+ * Why this exists: neither Resolve nor Premiere expose a scriptable "move
+ * clip from index N to index M" call. The portable workaround is to rebuild
+ * the timeline as FCPXML and import it. This module is the pure, testable
+ * core of that workaround.
+ *
+ * Ordering rules:
+ *   - Only video clips are reorderable (audio rides along with each video
+ *     clip's underlying asset). Audio-only timelines are out of scope here.
+ *   - `newOrder` is a list of clip IDs in the desired new order. Clips not
+ *     listed keep their original relative order and stack at the end.
+ *   - Throws if newOrder references a clipId that doesn't exist on the
+ *     current timeline (typo guard — silently dropping is worse).
+ */
+/**
+ * Build the FcpxmlEvent[] list for the reordered timeline. Each event maps
+ * to one video clip in the new order. Sequential record offsets are computed
+ * by the FCPXML emitter (we don't pre-compute them here — that's its job).
+ */
+export function reorderToEvents(input) {
+    const { current, newOrder, sourcePathByClipId = {} } = input;
+    // Filter to video-track clips only; audio-only timelines aren't supported
+    // by this rebuild path. Order by track then start so the input is stable.
+    const videoClips = current.clips
+        .filter((c) => c.trackKind === "video")
+        .sort((a, b) => a.track - b.track || a.startFrame - b.startFrame);
+    const byId = new Map();
+    for (const c of videoClips)
+        byId.set(c.id, c);
+    // Validate newOrder
+    for (const id of newOrder) {
+        if (!byId.has(id)) {
+            throw new Error(`reorder: clipId not found on current timeline: ${id}`);
+        }
+    }
+    const seen = new Set();
+    const ordered = [];
+    // First the explicitly-listed IDs, in the supplied order.
+    for (const id of newOrder) {
+        if (seen.has(id))
+            continue;
+        seen.add(id);
+        ordered.push(byId.get(id));
+    }
+    // Then anything not mentioned, preserving its original position relative
+    // to other unmentioned clips.
+    for (const c of videoClips) {
+        if (!seen.has(c.id)) {
+            seen.add(c.id);
+            ordered.push(c);
+        }
+    }
+    // Map each clip to an FcpxmlEvent. The reel = the source path so multiple
+    // clips from the same source share an asset in the emitted FCPXML.
+    return ordered.map((c, i) => {
+        const sourcePath = sourcePathByClipId[c.id] ?? c.sourcePath;
+        if (!sourcePath) {
+            throw new Error(`reorder: missing sourcePath for clip ${c.id}; pass sourcePathByClipId or ensure host returns it`);
+        }
+        const dur = c.endFrame - c.startFrame;
+        if (dur <= 0) {
+            throw new Error(`reorder: clip ${c.id} has non-positive duration`);
+        }
+        return {
+            reel: sourcePath,
+            sourcePath,
+            // Record-time start/end on the OLD timeline. We treat the original
+            // record start as the source-in for the rebuilt timeline so the clip
+            // body stays identical; offset on the spine is recomputed by the
+            // FCPXML emitter.
+            sourceInFrame: c.startFrame,
+            sourceOutFrame: c.endFrame,
+            clipName: c.name || `clip ${i + 1}`,
+        };
+    });
+}
+//# sourceMappingURL=reorder.js.map

package/dist/core/reorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reorder.js","sourceRoot":"","sources":["../../src/core/reorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAsBH;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAmB;IACjD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC;IAE7D,0EAA0E;IAC1E,0EAA0E;IAC1E,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK;SAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC;SACtC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IAEpE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,UAAU;QAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAE9C,oBAAoB;IACpB,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,kDAAkD,EAAE,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,0DAA0D;IAC1D,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAC3B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,CAAC;IAC9B,CAAC;IACD,yEAAyE;IACzE,8BAA8B;IAC9B,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,mEAAmE;IACnE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,UAAU,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC;QAC5D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,wCAAwC,CAAC,CAAC,EAAE,qDAAqD,CAClG,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC;QACtC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,EAAE,4BAA4B,CAAC,CAAC;QACrE,CAAC;QACD,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,UAAU;YACV,mEAAmE;YACnE,qEAAqE;YACrE,iEAAiE;YACjE,kBAAkB;YAClB,aAAa,EAAE,CAAC,CAAC,UAAU;YAC3B,cAAc,EAAE,CAAC,CAAC,QAAQ;YAC1B,QAAQ,EAAE,CAAC,CAAC,IAAI,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE;SACpC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/reorder.test.d.ts

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

package/dist/core/reorder.test.d.ts.map

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

package/dist/core/reorder.test.js

@@ -0,0 +1,88 @@
+import { describe, expect, it } from "vitest";
+import { reorderToEvents } from "./reorder.js";
+function makeTimeline() {
+    return {
+        name: "test",
+        frameRate: 30,
+        durationFrames: 300,
+        clips: [
+            {
+                id: "c1",
+                track: 1,
+                trackKind: "video",
+                startFrame: 0,
+                endFrame: 60,
+                name: "first",
+                sourcePath: "/a.mov",
+            },
+            {
+                id: "c2",
+                track: 1,
+                trackKind: "video",
+                startFrame: 60,
+                endFrame: 120,
+                name: "second",
+                sourcePath: "/b.mov",
+            },
+            {
+                id: "c3",
+                track: 1,
+                trackKind: "video",
+                startFrame: 120,
+                endFrame: 180,
+                name: "third",
+                sourcePath: "/c.mov",
+            },
+        ],
+        markers: [],
+    };
+}
+describe("reorderToEvents", () => {
+    it("identity reorder preserves original sequence", () => {
+        const t = makeTimeline();
+        const events = reorderToEvents({ current: t, newOrder: ["c1", "c2", "c3"] });
+        expect(events.map((e) => e.clipName)).toEqual(["first", "second", "third"]);
+    });
+    it("full reverse reorder", () => {
+        const t = makeTimeline();
+        const events = reorderToEvents({ current: t, newOrder: ["c3", "c2", "c1"] });
+        expect(events.map((e) => e.clipName)).toEqual(["third", "second", "first"]);
+    });
+    it("partial reorder appends missing clips at the end in original order", () => {
+        const t = makeTimeline();
+        const events = reorderToEvents({ current: t, newOrder: ["c2"] });
+        // c2 first, then c1 + c3 in their original order.
+        expect(events.map((e) => e.clipName)).toEqual(["second", "first", "third"]);
+    });
+    it("throws when newOrder references unknown clipId", () => {
+        const t = makeTimeline();
+        expect(() => reorderToEvents({ current: t, newOrder: ["c1", "no-such"] })).toThrow(/not found/);
+    });
+    it("ignores audio-track clips entirely", () => {
+        const t = makeTimeline();
+        t.clips.push({
+            id: "audioOnly",
+            track: 1,
+            trackKind: "audio",
+            startFrame: 0,
+            endFrame: 100,
+            name: "voice",
+            sourcePath: "/voice.wav",
+        });
+        const events = reorderToEvents({ current: t, newOrder: ["c1", "c2", "c3"] });
+        expect(events).toHaveLength(3);
+        expect(events.find((e) => e.reel === "/voice.wav")).toBeUndefined();
+    });
+    it("uses sourcePathByClipId override when ClipInfo lacks sourcePath", () => {
+        const t = makeTimeline();
+        t.clips[0].sourcePath = undefined;
+        const events = reorderToEvents({
+            current: t,
+            newOrder: ["c1"],
+            sourcePathByClipId: { c1: "/override.mov" },
+        });
+        expect(events[0].reel).toBe("/override.mov");
+        expect(events[0].sourcePath).toBe("/override.mov");
+    });
+});
+//# sourceMappingURL=reorder.test.js.map

package/dist/core/reorder.test.js.map

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

package/dist/core/review.d.ts

@@ -0,0 +1,38 @@
+import type { Usage } from "@kenkaiiii/gg-ai";
+import type { VideoHost } from "./hosts/types.js";
+export interface ReviewFlag {
+    severity: "ok" | "warn" | "block";
+    note: string;
+}
+export interface ReviewOptions {
+    /** What the edit is FOR. The reviewer measures against this. */
+    intent: string;
+    /** Optional aspects to focus on. */
+    focus?: Array<"pacing" | "takes" | "audio" | "captions" | "hook" | "color">;
+    host: VideoHost;
+    cwd: string;
+    config: {
+        provider: "anthropic" | "openai" | "glm" | "moonshot";
+        model: string;
+        apiKey: string;
+        maxTurns?: number;
+    };
+    signal?: AbortSignal;
+}
+export interface ReviewResult {
+    critique: string;
+    flags: ReviewFlag[];
+    turns: number;
+    usage: Usage;
+}
+export declare function runReview(opts: ReviewOptions): Promise<ReviewResult>;
+/**
+ * Parse the trailing ```json {...} ``` block out of the final assistant message.
+ * The text BEFORE the JSON block becomes the critique. On parse failure, the
+ * whole message is returned as critique with empty flags.
+ */
+export declare function parseReviewMessage(text: string): {
+    critique: string;
+    flags: ReviewFlag[];
+};
+//# sourceMappingURL=review.d.ts.map

package/dist/core/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/core/review.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAyBlD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,KAAK,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAC5E,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE;QACN,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAC;QACtD,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;CACd;AA6BD,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAmD1E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CA2B1F"}

package/dist/core/review.js

@@ -0,0 +1,128 @@
+import { Agent } from "@kenkaiiii/gg-agent";
+import { createEditorTools } from "../tools/index.js";
+/**
+ * Self-critique pass over the timeline + transcripts.
+ *
+ * Runs a fresh Agent with a READ-ONLY subset of editor tools and a critique
+ * prompt. The reviewer inspects the current state against the user's stated
+ * intent and returns a one-paragraph critique + a structured flags array.
+ *
+ * Token cost: a sub-agent over many turns can burn context; we cap at
+ * maxTurns=10 by default.
+ */
+/** Tools the reviewer is allowed to call. Strictly read-only. */
+const READ_ONLY_TOOL_NAMES = new Set([
+    "host_info",
+    "get_timeline",
+    "get_markers",
+    "read_transcript",
+    "score_shot",
+    "probe_media",
+    "read_skill",
+]);
+const REVIEW_SYSTEM = `You are the GG Editor REVIEWER — a read-only critic of an edit-in-progress.
+
+Your job: read the timeline + relevant transcripts/media, measure them against the stated INTENT, and write a tight critique.
+
+You have READ-ONLY tools (host_info, get_timeline, get_markers, read_transcript, score_shot, probe_media, read_skill). You CANNOT mutate the timeline or write files. Don't try.
+
+Process:
+1. Call host_info, get_timeline, get_markers to read state.
+2. If there's a transcript, read targeted windows (NEVER full dumps).
+3. Optionally score a few shots.
+4. Form an opinion. Be concrete: timestamps, clip ids, specific issues.
+
+OUTPUT FORMAT — your final assistant message must end with this EXACT structure:
+
+<one paragraph of critique, ≤200 words, plain prose>
+
+\`\`\`json
+{"flags":[{"severity":"ok|warn|block","note":"..."}, ...]}
+\`\`\`
+
+severity:
+- ok: nothing wrong; affirmation of a good editorial choice
+- warn: needs attention but not blocking (filler still present, caption typo)
+- block: ship-stopper (wrong take kept, missing captions on long-form, hook missing)
+
+Be direct. Don't praise the work just to be nice. If it's good, say "ok". If it's not, say what's wrong.`;
+export async function runReview(opts) {
+    const { intent, focus, host, cwd, config, signal } = opts;
+    // Build the read-only tool subset by name-allowlist filter.
+    const allTools = createEditorTools({ host, cwd });
+    const tools = allTools.filter((t) => READ_ONLY_TOOL_NAMES.has(t.name));
+    const userPrompt = [
+        `INTENT: ${intent}`,
+        focus && focus.length > 0 ? `FOCUS: ${focus.join(", ")}` : null,
+        "",
+        "Inspect the current edit and produce a one-paragraph critique followed by the flags JSON block as instructed.",
+    ]
+        .filter(Boolean)
+        .join("\n");
+    const agent = new Agent({
+        provider: config.provider,
+        model: config.model,
+        system: REVIEW_SYSTEM,
+        tools,
+        apiKey: config.apiKey,
+        maxTurns: config.maxTurns ?? 10,
+        signal,
+    });
+    let bufText = "";
+    let lastAssistantText = "";
+    let turns = 0;
+    const usage = { inputTokens: 0, outputTokens: 0 };
+    for await (const ev of agent.prompt(userPrompt)) {
+        switch (ev.type) {
+            case "text_delta":
+                bufText += ev.text;
+                break;
+            case "turn_end":
+                turns += 1;
+                if (bufText.trim().length > 0)
+                    lastAssistantText = bufText;
+                bufText = "";
+                usage.inputTokens = (usage.inputTokens ?? 0) + (ev.usage.inputTokens ?? 0);
+                usage.outputTokens = (usage.outputTokens ?? 0) + (ev.usage.outputTokens ?? 0);
+                break;
+            case "agent_done":
+                if (bufText.trim().length > 0)
+                    lastAssistantText = bufText;
+                break;
+        }
+    }
+    const parsed = parseReviewMessage(lastAssistantText);
+    return { ...parsed, turns, usage };
+}
+/**
+ * Parse the trailing ```json {...} ``` block out of the final assistant message.
+ * The text BEFORE the JSON block becomes the critique. On parse failure, the
+ * whole message is returned as critique with empty flags.
+ */
+export function parseReviewMessage(text) {
+    const trimmed = text.trim();
+    // Match trailing ```json ... ``` block (allow trailing whitespace after fence).
+    const fenceRe = /```json\s*([\s\S]*?)\s*```\s*$/;
+    const m = fenceRe.exec(trimmed);
+    if (!m) {
+        return { critique: trimmed, flags: [] };
+    }
+    try {
+        const parsed = JSON.parse(m[1]);
+        const flags = Array.isArray(parsed.flags)
+            ? parsed.flags
+                .filter((f) => typeof f === "object" &&
+                f !== null &&
+                typeof f.severity === "string" &&
+                typeof f.note === "string")
+                .filter((f) => f.severity === "ok" || f.severity === "warn" || f.severity === "block")
+                .map((f) => ({ severity: f.severity, note: f.note }))
+            : [];
+        const critique = trimmed.slice(0, m.index).trim();
+        return { critique, flags };
+    }
+    catch {
+        return { critique: trimmed, flags: [] };
+    }
+}
+//# sourceMappingURL=review.js.map

package/dist/core/review.js.map

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

package/dist/core/review.test.d.ts

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

package/dist/core/review.test.d.ts.map

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

package/dist/core/review.test.js

@@ -0,0 +1,76 @@
+import { describe, expect, it } from "vitest";
+import { parseReviewMessage } from "./review.js";
+describe("parseReviewMessage", () => {
+    it("extracts critique and flags from a well-formed message", () => {
+        const text = `The edit keeps too many filler words around 02:13–02:30 and the hook lacks energy.
+
+\`\`\`json
+{"flags":[{"severity":"warn","note":"filler at 02:13"},{"severity":"block","note":"missing captions"}]}
+\`\`\``;
+        const r = parseReviewMessage(text);
+        expect(r.critique).toContain("filler words");
+        expect(r.critique).not.toContain("```");
+        expect(r.flags).toHaveLength(2);
+        expect(r.flags[0]).toEqual({ severity: "warn", note: "filler at 02:13" });
+        expect(r.flags[1]).toEqual({ severity: "block", note: "missing captions" });
+    });
+    it("returns whole message as critique with empty flags on no JSON block", () => {
+        const text = "Looks fine to me.";
+        const r = parseReviewMessage(text);
+        expect(r.critique).toBe("Looks fine to me.");
+        expect(r.flags).toEqual([]);
+    });
+    it("falls back gracefully on malformed JSON", () => {
+        const text = "Bad block follows.\n\n```json\n{not valid\n```";
+        const r = parseReviewMessage(text);
+        expect(r.critique).toContain("Bad block follows");
+        expect(r.flags).toEqual([]);
+    });
+    it("drops flags with unknown severity", () => {
+        const text = `Ok.
+
+\`\`\`json
+{"flags":[{"severity":"warn","note":"a"},{"severity":"nope","note":"b"}]}
+\`\`\``;
+        const r = parseReviewMessage(text);
+        expect(r.flags).toEqual([{ severity: "warn", note: "a" }]);
+    });
+    it("tolerates trailing whitespace after the JSON fence", () => {
+        // LLMs sometimes append a blank line after the closing fence.
+        const text = [
+            "Looks tight.",
+            "",
+            "```json",
+            '{"flags":[{"severity":"ok","note":"good pacing"}]}',
+            "```",
+            "  ",
+            "",
+        ].join("\n");
+        const r = parseReviewMessage(text);
+        expect(r.flags).toEqual([{ severity: "ok", note: "good pacing" }]);
+    });
+    it("drops flags missing required fields", () => {
+        const text = [
+            "x",
+            "",
+            "```json",
+            '{"flags":[{"severity":"warn"},{"note":"orphan note"},{"severity":"warn","note":"keep"}]}',
+            "```",
+        ].join("\n");
+        const r = parseReviewMessage(text);
+        expect(r.flags).toEqual([{ severity: "warn", note: "keep" }]);
+    });
+    it("handles empty flags array", () => {
+        const text = ["All clear.", "", "```json", '{"flags":[]}', "```"].join("\n");
+        const r = parseReviewMessage(text);
+        expect(r.flags).toEqual([]);
+        expect(r.critique).toBe("All clear.");
+    });
+    it("handles missing flags key entirely", () => {
+        // Some models emit { } without the flags key.
+        const text = `summary\n\n\`\`\`json\n{}\n\`\`\``;
+        const r = parseReviewMessage(text);
+        expect(r.flags).toEqual([]);
+    });
+});
+//# sourceMappingURL=review.test.js.map

package/dist/core/review.test.js.map

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

package/dist/core/sessions.d.ts

@@ -0,0 +1,40 @@
+import type { Message } from "@kenkaiiii/gg-ai";
+/**
+ * Minimal session persistence for `ggeditor continue`.
+ *
+ * Each TUI run writes its rolling message buffer to ~/.gg/editor/last.json
+ * after every turn. `ggeditor continue` reads this file and hydrates a new
+ * Agent with the prior messages.
+ *
+ * No multi-session support yet — just "the most recent conversation". Pairs
+ * with the `priorMessages` option added to gg-agent.
+ */
+export declare const SESSIONS_DIR: string;
+export declare const LAST_SESSION_FILE: string;
+export interface PersistedSession {
+    /** Format version for future compatibility. */
+    v: 1;
+    /** ISO timestamp of the last update. */
+    updatedAt: string;
+    /** Provider used for this session. */
+    provider: string;
+    /** Model used for this session. */
+    model: string;
+    /** Working directory at start. */
+    cwd: string;
+    /** Host name in use ("resolve" / "premiere" / "none"). */
+    host: string;
+    /** Full message buffer EXCLUDING the system prompt. */
+    messages: Message[];
+}
+export declare function saveSession(snapshot: Omit<PersistedSession, "v" | "updatedAt">): Promise<void>;
+export declare function loadLastSession(): Promise<PersistedSession | null>;
+export declare function hasLastSession(): Promise<boolean>;
+/**
+ * Drop the system message from a saved messages array. Saved sessions
+ * intentionally exclude the system prompt (which gets rebuilt fresh per run
+ * to reflect current host caps), but if a future format change includes it,
+ * we strip it defensively.
+ */
+export declare function stripSystem(messages: Message[]): Message[];
+//# sourceMappingURL=sessions.d.ts.map

package/dist/core/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/core/sessions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;;;;;;;;GASG;AAEH,eAAO,MAAM,YAAY,QAA2C,CAAC;AACrE,eAAO,MAAM,iBAAiB,QAAuC,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,CAAC,EAAE,CAAC,CAAC;IACL,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,GAAG,GAAG,WAAW,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAUxE;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAE1D"}

package/dist/core/sessions.js

@@ -0,0 +1,61 @@
+import { existsSync } from "node:fs";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+/**
+ * Minimal session persistence for `ggeditor continue`.
+ *
+ * Each TUI run writes its rolling message buffer to ~/.gg/editor/last.json
+ * after every turn. `ggeditor continue` reads this file and hydrates a new
+ * Agent with the prior messages.
+ *
+ * No multi-session support yet — just "the most recent conversation". Pairs
+ * with the `priorMessages` option added to gg-agent.
+ */
+export const SESSIONS_DIR = path.join(os.homedir(), ".gg", "editor");
+export const LAST_SESSION_FILE = path.join(SESSIONS_DIR, "last.json");
+export async function saveSession(snapshot) {
+    await fs.mkdir(SESSIONS_DIR, { recursive: true });
+    const payload = {
+        v: 1,
+        updatedAt: new Date().toISOString(),
+        ...snapshot,
+    };
+    // Atomic write so an interrupted save doesn't leave a half-file.
+    const tmp = `${LAST_SESSION_FILE}.${process.pid}.tmp`;
+    try {
+        await fs.writeFile(tmp, JSON.stringify(payload, null, 2), "utf8");
+        await fs.rename(tmp, LAST_SESSION_FILE);
+    }
+    catch (e) {
+        await fs.unlink(tmp).catch(() => { });
+        throw e;
+    }
+}
+export async function loadLastSession() {
+    if (!existsSync(LAST_SESSION_FILE))
+        return null;
+    const raw = await fs.readFile(LAST_SESSION_FILE, "utf8");
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed.v !== 1)
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export async function hasLastSession() {
+    return existsSync(LAST_SESSION_FILE);
+}
+/**
+ * Drop the system message from a saved messages array. Saved sessions
+ * intentionally exclude the system prompt (which gets rebuilt fresh per run
+ * to reflect current host caps), but if a future format change includes it,
+ * we strip it defensively.
+ */
+export function stripSystem(messages) {
+    return messages.filter((m) => m.role !== "system");
+}
+//# sourceMappingURL=sessions.js.map