@kenkaiiii/gg-editor 0.1.0

package/dist/director/executor.js

@@ -0,0 +1,93 @@
+import { Agent } from "@kenkaiiii/gg-agent";
+import { buildEditorSystemPrompt } from "../system-prompt.js";
+import { createEditorTools } from "../tools/index.js";
+/**
+ * Run a fresh executor agent on a single delegated task. Each call gets a
+ * brand-new Agent — no shared state, no leaked context. The director sees
+ * ONLY the returned ExecutorResult.
+ */
+export async function runExecutor(opts) {
+    const { task, host, cwd, config, onEvent, signal } = opts;
+    const tools = createEditorTools({ host, cwd, dryRun: config.dryRun });
+    const baseSystem = await buildEditorSystemPrompt(host, cwd);
+    const system = baseSystem + executorAddendum();
+    const agent = new Agent({
+        provider: config.provider,
+        model: config.model,
+        system,
+        tools,
+        apiKey: config.apiKey,
+        maxTurns: config.maxExecutorTurns ?? 30,
+        signal,
+    });
+    let lastAssistantText = "";
+    let turns = 0;
+    const usage = { inputTokens: 0, outputTokens: 0 };
+    const toolCalls = [];
+    // We accumulate the most-recent assistant text so we can fall back to it
+    // if the agent stops without an explicit final message.
+    let bufText = "";
+    const stream = agent.prompt(task);
+    for await (const ev of stream) {
+        switch (ev.type) {
+            case "text_delta":
+                bufText += ev.text;
+                onEvent?.("executor_text", ev.text);
+                break;
+            case "tool_call_start":
+                onEvent?.("executor_tool_start", { name: ev.name, args: ev.args });
+                break;
+            case "tool_call_end":
+                toolCalls.push({ name: nameOrUnknown(ev), isError: ev.isError });
+                onEvent?.("executor_tool_end", { isError: ev.isError, result: ev.result });
+                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;
+            case "error":
+                // Surface but don't throw — director should see "executor failed: ..."
+                // and decide whether to retry.
+                lastAssistantText =
+                    (lastAssistantText ? lastAssistantText + "\n\n" : "") +
+                        `[executor error] ${ev.error.message}`;
+                break;
+        }
+    }
+    return {
+        summary: lastAssistantText.trim() || "(executor produced no summary)",
+        turns,
+        usage,
+        toolCalls,
+    };
+}
+function nameOrUnknown(_ev) {
+    // tool_call_end events don't carry the tool name — they reference the
+    // earlier tool_call_start by id. The director only needs error count and
+    // names for diagnostics; using a placeholder is fine for v0.
+    return "tool";
+}
+function executorAddendum() {
+    return `
+
+# You are the Executor in a Director-Executor architecture.
+
+The Director gave you a SPECIFIC task. Do exactly that, no more.
+
+When done, write a ONE-PARAGRAPH summary (≤120 words) of what you accomplished:
+- What was actually changed (timeline ops, files written, markers added)
+- Concrete results (number of cuts, output paths, key timestamps)
+- Anything notable the Director should know for the next step
+
+Do NOT explain HOW you did it — the Director doesn't care about your tool calls. The Director sees your summary, that's all. Make it dense and useful.
+`;
+}
+//# sourceMappingURL=executor.js.map

package/dist/director/executor.js.map

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

package/dist/director/index.d.ts

@@ -0,0 +1,6 @@
+export { buildDirectorAgent } from "./director.js";
+export { buildDirectorSystemPrompt } from "./director-prompt.js";
+export { createDelegateTool } from "./delegate-tool.js";
+export { runExecutor } from "./executor.js";
+export type { DirectorConfig, ExecutorResult } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/director/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/director/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/director/index.js

@@ -0,0 +1,5 @@
+export { buildDirectorAgent } from "./director.js";
+export { buildDirectorSystemPrompt } from "./director-prompt.js";
+export { createDelegateTool } from "./delegate-tool.js";
+export { runExecutor } from "./executor.js";
+//# sourceMappingURL=index.js.map

package/dist/director/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/director/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/director/types.d.ts

@@ -0,0 +1,38 @@
+import type { Usage } from "@kenkaiiii/gg-ai";
+/**
+ * Director-Executor mode — two-agent architecture for long sessions.
+ *
+ * Director plans at a high level; for each step it `delegate`s to a fresh
+ * Executor that has full tool access. Executor returns a structured summary
+ * which is the ONLY thing that enters director context.
+ *
+ * Win: a 100-tool-call edit session collapses to ~5 director turns each
+ * seeing ~50-token summaries instead of accumulated raw tool I/O.
+ */
+export interface ExecutorResult {
+    /** Final summary the executor produced (last assistant message, trimmed). */
+    summary: string;
+    /** How many turns the executor took. */
+    turns: number;
+    /** Token usage. */
+    usage: Usage;
+    /** Tool call count + names — the director uses this to verify expectations. */
+    toolCalls: Array<{
+        name: string;
+        isError: boolean;
+    }>;
+}
+export interface DirectorConfig {
+    /** Provider for both agents. */
+    provider: "anthropic" | "openai" | "glm" | "moonshot";
+    /** Model for both agents (executor can override via tool param). */
+    model: string;
+    apiKey?: string;
+    /** Max executor turns per delegated task. Default 30. */
+    maxExecutorTurns?: number;
+    /** Hard cap on total delegated tasks per director session. Default 20. */
+    maxDelegations?: number;
+    /** Propagate dry-run to all executor tool factories. */
+    dryRun?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/director/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/director/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,KAAK,EAAE,KAAK,CAAC;IACb,+EAA+E;IAC/E,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAC;IACtD,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/director/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/director/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { createEditorTools } from "./tools/index.js";
+export type { CreateEditorToolsOptions } from "./tools/index.js";
+export { createHost, detectHost, HostUnreachableError, HostUnsupportedError, NoneAdapter, PremiereAdapter, ResolveAdapter, } from "./core/hosts/index.js";
+export type { VideoHost } from "./core/hosts/index.js";
+export { createLazyHost } from "./core/hosts/lazy.js";
+export type { LazyHost, LazyHostOptions } from "./core/hosts/lazy.js";
+export { checkFfmpeg, checkFfprobe, probeMedia, runFfmpeg } from "./core/media/ffmpeg.js";
+export type { FfmpegResult, MediaProbe } from "./core/media/ffmpeg.js";
+export { buildEditorSystemPrompt, buildEditorStaticBody, buildEditorHostBlock, spliceHostBlock, } from "./system-prompt.js";
+export type { StaticPromptOptions } from "./system-prompt.js";
+export { AuthStorage, AUTH_FILE, NotLoggedInError, generatePKCE, loginAnthropic, loginOpenAI, refreshAnthropicToken, refreshOpenAIToken, runLogin, runLogout, runStatus, } from "./core/auth/index.js";
+export type { OAuthCredentials, OAuthLoginCallbacks, SupportedAuthProvider, } from "./core/auth/index.js";
+export type { ClipInfo, EditorConfig, Frame, FrameRange, HostCapabilities, HostName, MarkerInfo, TimelineState, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAGjE,OAAO,EACL,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGtE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC1F,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGvE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,EACL,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,QAAQ,EACR,SAAS,EACT,SAAS,GACV,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,KAAK,EACL,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+// Tools
+export { createEditorTools } from "./tools/index.js";
+// Hosts
+export { createHost, detectHost, HostUnreachableError, HostUnsupportedError, NoneAdapter, PremiereAdapter, ResolveAdapter, } from "./core/hosts/index.js";
+export { createLazyHost } from "./core/hosts/lazy.js";
+// Media
+export { checkFfmpeg, checkFfprobe, probeMedia, runFfmpeg } from "./core/media/ffmpeg.js";
+// System prompt
+export { buildEditorSystemPrompt, buildEditorStaticBody, buildEditorHostBlock, spliceHostBlock, } from "./system-prompt.js";
+// Auth (shared with ggcoder via ~/.gg/auth.json)
+export { AuthStorage, AUTH_FILE, NotLoggedInError, generatePKCE, loginAnthropic, loginOpenAI, refreshAnthropicToken, refreshOpenAIToken, runLogin, runLogout, runStatus, } from "./core/auth/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,QAAQ;AACR,OAAO,EACL,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,QAAQ;AACR,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAG1F,gBAAgB;AAChB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,iDAAiD;AACjD,OAAO,EACL,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,QAAQ,EACR,SAAS,EACT,SAAS,GACV,MAAM,sBAAsB,CAAC"}

package/dist/skills.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Bundled skill markdowns. Embedded as TS string constants so they ship in the
+ * compiled package without depending on disk layout. Authored in
+ * src/skills/*.md — regenerate this file by running `node build-skills.mjs`
+ * from the package root if you edit the source markdowns.
+ *
+ * Skills are exposed through the read_skill tool; their descriptions live in
+ * the system prompt. Pattern follows the Anthropic skills convention:
+ * description in the prompt, full content on demand.
+ */
+export interface BundledSkill {
+    name: string;
+    description: string;
+    content: string;
+}
+export declare const SKILLS: Record<string, BundledSkill>;
+export declare const SKILL_NAMES: string[];
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAkoBD,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA+B/C,CAAC;AAEF,eAAO,MAAM,WAAW,UAAsB,CAAC"}