@kenkaiiii/gg-editor 0.6.7 → 0.7.1

package/dist/tools/rewrite-hook.js

@@ -0,0 +1,65 @@
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { HOOK_PATTERNS, runHookRewrite } from "../core/hook-rewrite.js";
+const RewriteHookParams = z.object({
+    currentHook: z
+        .string()
+        .describe("The failing hook line. Pass an empty string when no hook exists yet."),
+    videoTopic: z.string().min(1).describe("One-line description of the video."),
+    transcriptExcerpt: z
+        .string()
+        .optional()
+        .describe("200-500 char excerpt from the transcript for tone context. Helps the LLM match the " +
+        "creator's voice when picking power words."),
+    pattern: z
+        .enum(HOOK_PATTERNS)
+        .optional()
+        .describe("Target pattern from the `viral-hook-patterns` skill. 'auto' (default) lets the LLM " +
+        "pick the closest fit. Force a specific pattern when the user asked for it by name."),
+    model: z.string().optional().describe("OpenAI model. Default gpt-4o-mini."),
+});
+/**
+ * rewrite_hook — propose 3 hook rewrites using a viral pattern.
+ *
+ * The agent surfaces the candidates to the user — does NOT auto-apply
+ * (we don't generate footage). Use when `analyze_hook` returns score
+ * < 60 or when the user says "the opener feels weak."
+ */
+export function createRewriteHookTool(_cwd) {
+    return {
+        name: "rewrite_hook",
+        description: "Rewrite a hook using one of the 12 viral hook patterns from the `viral-hook-patterns` " +
+            "skill. Pass `pattern='auto'` to let the LLM pick the closest fit; pass a specific " +
+            "pattern name to force it. Returns 3 candidate rewrites with rationale. Use when " +
+            "`analyze_hook` returns score < 60, or when the user says 'the opener feels weak'. " +
+            "The agent should surface the candidates to the user — does NOT auto-apply (we don't " +
+            "generate footage). Pair with `read_skill('viral-hook-patterns')` for the full pattern " +
+            "library.",
+        parameters: RewriteHookParams,
+        async execute(args, ctx) {
+            try {
+                if (!process.env.OPENAI_API_KEY) {
+                    return err("OPENAI_API_KEY not set", "export OPENAI_API_KEY=...");
+                }
+                const result = await runHookRewrite({
+                    currentHook: args.currentHook,
+                    videoTopic: args.videoTopic,
+                    transcriptExcerpt: args.transcriptExcerpt,
+                    pattern: args.pattern ?? "auto",
+                }, { model: args.model, signal: ctx.signal });
+                if (result.candidates.length === 0) {
+                    return err("model returned no usable candidates", "retry or pass a more specific topic");
+                }
+                return compact({
+                    candidates: result.candidates,
+                    chosenPattern: result.chosenPattern,
+                    why: result.why,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=rewrite-hook.js.map

package/dist/tools/rewrite-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrite-hook.js","sourceRoot":"","sources":["../../src/tools/rewrite-hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAExE,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,CAAC,sEAAsE,CAAC;IACnF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC5E,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qFAAqF;QACnF,2CAA2C,CAC9C;IACH,OAAO,EAAE,CAAC;SACP,IAAI,CAAC,aAAa,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CACP,qFAAqF;QACnF,oFAAoF,CACvF;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CAC5E,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,wFAAwF;YACxF,oFAAoF;YACpF,kFAAkF;YAClF,oFAAoF;YACpF,sFAAsF;YACtF,wFAAwF;YACxF,UAAU;QACZ,UAAU,EAAE,iBAAiB;QAC7B,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;YACrB,IAAI,CAAC;gBACH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;oBAChC,OAAO,GAAG,CAAC,wBAAwB,EAAE,2BAA2B,CAAC,CAAC;gBACpE,CAAC;gBAED,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC;oBACE,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;oBACzC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,MAAM;iBAChC,EACD,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAC1C,CAAC;gBAEF,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACnC,OAAO,GAAG,CAAC,qCAAqC,EAAE,qCAAqC,CAAC,CAAC;gBAC3F,CAAC;gBAED,OAAO,OAAO,CAAC;oBACb,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,GAAG,EAAE,MAAM,CAAC,GAAG;iBAChB,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/score-clip.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+import type { Transcript } from "../core/whisper.js";
+declare const ScoreClipParams: z.ZodObject<{
+    transcript: z.ZodString;
+    startSec: z.ZodNumber;
+    endSec: z.ZodNumber;
+    framePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    model: z.ZodOptional<z.ZodString>;
+    detail: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+    }>>;
+}, z.core.$strip>;
+/**
+ * score_clip — virality rubric for an arbitrary transcript window.
+ *
+ * Generalises `analyze_hook` past the t<3s checkpoint. Used as the
+ * ranking primitive for `find_viral_moments` and as a gate before
+ * rendering Shorts.
+ */
+export declare function createScoreClipTool(cwd: string): AgentTool<typeof ScoreClipParams>;
+/**
+ * Extract the transcript text inside [startSec, endSec). Joins matching
+ * segments with single spaces — punctuation already lives inside the
+ * segment text. Exported for tests.
+ */
+export declare function sliceTranscriptText(t: Transcript, startSec: number, endSec: number): string;
+export {};
+//# sourceMappingURL=score-clip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"score-clip.d.ts","sourceRoot":"","sources":["../../src/tools/score-clip.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,QAAA,MAAM,eAAe;;;;;;;;;;iBAqBnB,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,eAAe,CAAC,CAoElF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAO3F"}

package/dist/tools/score-clip.js

@@ -0,0 +1,109 @@
+import { readFileSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { scoreClipInternal } from "../core/clip-scoring.js";
+import { compact, err } from "../core/format.js";
+import { parseTranscript } from "../core/whisper.js";
+const ScoreClipParams = z.object({
+    transcript: z
+        .string()
+        .describe("Path to a transcript JSON written by `transcribe`. Segments are required; word-level " +
+        "timings are not."),
+    startSec: z.number().min(0).describe("Window start in seconds (inclusive)."),
+    endSec: z.number().min(0).describe("Window end in seconds (exclusive)."),
+    framePaths: z
+        .array(z.string())
+        .optional()
+        .describe("Optional sampled frame paths (.jpg/.png). Use 1-3 for visual signal. Omit for " +
+        "transcript-only scoring (cheap path)."),
+    model: z.string().optional().describe("OpenAI model. Default gpt-4o-mini."),
+    detail: z
+        .enum(["low", "high"])
+        .optional()
+        .describe("Vision detail. Default low (cheap, ~85 tok/img)."),
+});
+/**
+ * score_clip — virality rubric for an arbitrary transcript window.
+ *
+ * Generalises `analyze_hook` past the t<3s checkpoint. Used as the
+ * ranking primitive for `find_viral_moments` and as a gate before
+ * rendering Shorts.
+ */
+export function createScoreClipTool(cwd) {
+    return {
+        name: "score_clip",
+        description: "Score a clip's virality potential 0-100 across hook, flow, engagement, and trend " +
+            "dimensions. Generalises `analyze_hook` (which only covers t<3s) to arbitrary windows. " +
+            "ONE LLM call per clip. Use as the ranking primitive for `find_viral_moments` and as a " +
+            "gate before rendering Shorts. Surface the `why` to the user — it tells them what to fix.",
+        parameters: ScoreClipParams,
+        async execute(args, ctx) {
+            try {
+                if (!process.env.OPENAI_API_KEY) {
+                    return err("OPENAI_API_KEY not set", "export OPENAI_API_KEY=...");
+                }
+                if (args.endSec <= args.startSec) {
+                    return err("endSec must be > startSec");
+                }
+                const transcriptAbs = resolvePath(cwd, args.transcript);
+                let raw;
+                try {
+                    raw = readFileSync(transcriptAbs, "utf8");
+                }
+                catch (e) {
+                    return err(`cannot read transcript ${transcriptAbs}: ${e.message}`, "verify the transcript JSON exists");
+                }
+                let t;
+                try {
+                    t = parseTranscript(raw);
+                }
+                catch (e) {
+                    return err(e.message);
+                }
+                if (t.segments.length === 0) {
+                    return err("transcript has no segments", "rerun transcribe(...)");
+                }
+                const text = sliceTranscriptText(t, args.startSec, args.endSec);
+                if (!text) {
+                    return err("no transcript text in window", "verify [startSec, endSec) overlaps real segments");
+                }
+                const framePaths = (args.framePaths ?? []).map((p) => resolvePath(cwd, p));
+                const score = await scoreClipInternal(text, args.startSec, args.endSec, framePaths, {
+                    model: args.model,
+                    detail: args.detail,
+                    signal: ctx.signal,
+                });
+                return compact({
+                    score: score.score,
+                    hook: round2(score.hook),
+                    flow: round2(score.flow),
+                    engagement: round2(score.engagement),
+                    trend: round2(score.trend),
+                    why: score.why,
+                    durationSec: +score.durationSec.toFixed(2),
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+/**
+ * Extract the transcript text inside [startSec, endSec). Joins matching
+ * segments with single spaces — punctuation already lives inside the
+ * segment text. Exported for tests.
+ */
+export function sliceTranscriptText(t, startSec, endSec) {
+    const parts = [];
+    for (const seg of t.segments) {
+        if (seg.end <= startSec || seg.start >= endSec)
+            continue;
+        parts.push(seg.text.trim());
+    }
+    return parts.join(" ").trim();
+}
+function round2(n) {
+    return +n.toFixed(2);
+}
+//# sourceMappingURL=score-clip.js.map

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

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

package/dist/tools/score-clip.test.d.ts

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

package/dist/tools/score-clip.test.d.ts.map

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

package/dist/tools/score-clip.test.js

@@ -0,0 +1,110 @@
+import { mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { createScoreClipTool, sliceTranscriptText } from "./score-clip.js";
+const ctx = {
+    signal: new AbortController().signal,
+    toolCallId: "t1",
+};
+function writeTranscript(dir, payload) {
+    const p = join(dir, "t.json");
+    writeFileSync(p, JSON.stringify(payload), "utf8");
+    return p;
+}
+describe("score_clip tool", () => {
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        delete process.env.OPENAI_API_KEY;
+    });
+    it("has a non-empty description naming the next-call hooks", () => {
+        const tool = createScoreClipTool("/tmp");
+        expect(tool.description.length).toBeGreaterThan(80);
+        expect(tool.description).toMatch(/find_viral_moments|virality/i);
+    });
+    it("errors when OPENAI_API_KEY is missing", async () => {
+        delete process.env.OPENAI_API_KEY;
+        const tool = createScoreClipTool("/tmp");
+        const r = await tool.execute({ transcript: "no.json", startSec: 0, endSec: 10 }, ctx);
+        expect(r).toMatch(/^error:.*OPENAI_API_KEY/);
+    });
+    it("errors when endSec <= startSec", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const tool = createScoreClipTool("/tmp");
+        const r = await tool.execute({ transcript: "no.json", startSec: 5, endSec: 5 }, ctx);
+        expect(r).toMatch(/^error:.*startSec/);
+    });
+    it("errors when transcript file is missing", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const tool = createScoreClipTool("/tmp");
+        const r = await tool.execute({ transcript: "no/such/file.json", startSec: 0, endSec: 10 }, ctx);
+        expect(r).toMatch(/^error:.*cannot read/);
+    });
+    it("errors on transcript with no segments", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const dir = mkdtempSync(join(tmpdir(), "gg-sc-"));
+        writeTranscript(dir, { language: "en", durationSec: 10, segments: [] });
+        const tool = createScoreClipTool(dir);
+        const r = await tool.execute({ transcript: "t.json", startSec: 0, endSec: 5 }, ctx);
+        expect(r).toMatch(/^error:.*no segments/);
+    });
+    it("returns a JSON-shaped success when LLM responds correctly", async () => {
+        process.env.OPENAI_API_KEY = "k";
+        const dir = mkdtempSync(join(tmpdir(), "gg-sc-"));
+        writeTranscript(dir, {
+            language: "en",
+            durationSec: 60,
+            segments: [
+                { start: 0, end: 30, text: "this is a strong hook line about money" },
+                { start: 30, end: 60, text: "and the payoff lands cleanly" },
+            ],
+        });
+        vi.stubGlobal("fetch", vi.fn(async () => ({
+            ok: true,
+            status: 200,
+            json: async () => ({
+                choices: [
+                    {
+                        message: {
+                            content: JSON.stringify({
+                                hook: 0.9,
+                                flow: 0.7,
+                                engagement: 0.8,
+                                trend: 0.6,
+                                why: "tight",
+                            }),
+                        },
+                    },
+                ],
+            }),
+            text: async () => "",
+        })));
+        const tool = createScoreClipTool(dir);
+        const r = await tool.execute({ transcript: "t.json", startSec: 0, endSec: 60 }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.score).toBeGreaterThan(0);
+        expect(parsed.score).toBeLessThanOrEqual(100);
+        expect(parsed.hook).toBe(0.9);
+        expect(parsed.durationSec).toBe(60);
+        expect(parsed.why).toBeDefined();
+    });
+});
+describe("sliceTranscriptText", () => {
+    it("includes overlapping segments and trims", () => {
+        const text = sliceTranscriptText({
+            language: "en",
+            durationSec: 30,
+            segments: [
+                { start: 0, end: 10, text: "  alpha " },
+                { start: 10, end: 20, text: " beta" },
+                { start: 20, end: 30, text: "gamma" },
+            ],
+        }, 5, 18);
+        // overlaps [0,10] and [10,20]; not [20,30]
+        expect(text).toBe("alpha beta");
+    });
+    it("returns empty when nothing overlaps", () => {
+        expect(sliceTranscriptText({ language: "en", durationSec: 10, segments: [{ start: 0, end: 5, text: "x" }] }, 6, 10)).toBe("");
+    });
+});
+//# sourceMappingURL=score-clip.test.js.map

package/dist/tools/score-clip.test.js.map

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

package/dist/tools/search-tools.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+/**
+ * search_tools — meta-tool. With ~85+ named tools the agent can wind up
+ * scanning the system prompt to remember a tool's exact name; this is
+ * a token-cheap shortcut: pass a query, get back the top matches with
+ * their one-line descriptions.
+ *
+ * The factory receives a *getter* so we can reflect over the live tool
+ * registry as it stands at agent-construction time. We avoid a circular
+ * import by accepting the tool list directly.
+ */
+declare const SearchToolsParams: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export interface SearchableTool {
+    name: string;
+    description: string;
+}
+/**
+ * Score a tool against a query. Higher = better match. Pure function so the
+ * algorithm can be tuned + tested without booting the agent.
+ *
+ * Heuristic:
+ *   +5 per query word that appears in the tool name
+ *   +1 per query word that appears in the description
+ *   +3 if the query is a substring of the name
+ *   normalize: lowercase, strip non-alphanumerics
+ */
+export declare function scoreToolMatch(query: string, tool: SearchableTool): number;
+export declare function createSearchToolsTool(getTools: () => SearchableTool[]): AgentTool<typeof SearchToolsParams>;
+export {};
+//# sourceMappingURL=search-tools.d.ts.map

package/dist/tools/search-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-tools.d.ts","sourceRoot":"","sources":["../../src/tools/search-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;;;;;;;GASG;AAEH,QAAA,MAAM,iBAAiB;;;iBASrB,CAAC;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAe1E;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,cAAc,EAAE,GAC/B,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAkCrC"}

package/dist/tools/search-tools.js

@@ -0,0 +1,86 @@
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+/**
+ * search_tools — meta-tool. With ~85+ named tools the agent can wind up
+ * scanning the system prompt to remember a tool's exact name; this is
+ * a token-cheap shortcut: pass a query, get back the top matches with
+ * their one-line descriptions.
+ *
+ * The factory receives a *getter* so we can reflect over the live tool
+ * registry as it stands at agent-construction time. We avoid a circular
+ * import by accepting the tool list directly.
+ */
+const SearchToolsParams = z.object({
+    query: z
+        .string()
+        .min(1)
+        .describe("What you're looking for. Free text — matches against tool names AND descriptions. " +
+        "E.g. 'silence', 'youtube metadata', 'caption emoji'."),
+    limit: z.number().int().min(1).max(20).optional().describe("Max results. Default 8."),
+});
+/**
+ * Score a tool against a query. Higher = better match. Pure function so the
+ * algorithm can be tuned + tested without booting the agent.
+ *
+ * Heuristic:
+ *   +5 per query word that appears in the tool name
+ *   +1 per query word that appears in the description
+ *   +3 if the query is a substring of the name
+ *   normalize: lowercase, strip non-alphanumerics
+ */
+export function scoreToolMatch(query, tool) {
+    const q = query.toLowerCase().trim();
+    if (q.length === 0)
+        return 0;
+    const nameLc = tool.name.toLowerCase();
+    const descLc = tool.description.toLowerCase();
+    let score = 0;
+    if (nameLc.includes(q.replace(/\s+/g, "_")))
+        score += 3;
+    if (nameLc.includes(q))
+        score += 3;
+    const words = q.split(/[^a-z0-9]+/).filter((w) => w.length >= 2);
+    for (const w of words) {
+        if (nameLc.includes(w))
+            score += 5;
+        if (descLc.includes(w))
+            score += 1;
+    }
+    return score;
+}
+export function createSearchToolsTool(getTools) {
+    return {
+        name: "search_tools",
+        description: "Find tools by query — fuzzy-matches against names and descriptions. Use when you need a " +
+            "capability and aren't sure which tool exposes it. Returns top matches with their one-line " +
+            "descriptions. Cheap (no LLM, no I/O). Token-savvy alternative to re-scanning the system " +
+            "prompt.",
+        parameters: SearchToolsParams,
+        async execute({ query, limit }) {
+            try {
+                const tools = getTools().filter((t) => t.name !== "search_tools");
+                const max = Math.min(limit ?? 8, 20);
+                const scored = tools
+                    .map((t) => ({ tool: t, score: scoreToolMatch(query, t) }))
+                    .filter((s) => s.score > 0)
+                    .sort((a, b) => b.score - a.score)
+                    .slice(0, max);
+                if (scored.length === 0) {
+                    return compact({ matches: [], note: "no tools matched — try a broader query" });
+                }
+                return compact({
+                    matches: scored.map((s) => ({
+                        name: s.tool.name,
+                        description: s.tool.description,
+                        score: s.score,
+                    })),
+                    total: scored.length,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=search-tools.js.map

package/dist/tools/search-tools.js.map

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

package/dist/tools/search-tools.test.d.ts

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

package/dist/tools/search-tools.test.d.ts.map

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

package/dist/tools/search-tools.test.js

@@ -0,0 +1,60 @@
+import { describe, expect, it } from "vitest";
+import { createSearchToolsTool, scoreToolMatch } from "./search-tools.js";
+const FAKE_TOOLS = [
+    { name: "detect_silence", description: "ffmpeg silencedetect → frame-aligned KEEP ranges" },
+    { name: "trim_dead_air", description: "Trim leading/trailing or all silence in one call" },
+    { name: "write_srt", description: "SubRip caption writer (sentence + word-level)" },
+    { name: "burn_subtitles", description: "Hardcode .srt or .ass into a video" },
+    {
+        name: "generate_youtube_metadata",
+        description: "Title, description, tags, chapters from a transcript",
+    },
+];
+const ctx = {
+    signal: new AbortController().signal,
+    toolCallId: "t1",
+};
+describe("scoreToolMatch", () => {
+    it("ranks exact name substring highest", () => {
+        expect(scoreToolMatch("silence", FAKE_TOOLS[0])).toBeGreaterThan(scoreToolMatch("silence", FAKE_TOOLS[2]));
+    });
+    it("returns 0 when no overlap", () => {
+        expect(scoreToolMatch("rocket", FAKE_TOOLS[0])).toBe(0);
+    });
+    it("rewards multi-word queries", () => {
+        const single = scoreToolMatch("youtube", FAKE_TOOLS[4]);
+        const multi = scoreToolMatch("youtube metadata", FAKE_TOOLS[4]);
+        expect(multi).toBeGreaterThan(single);
+    });
+    it("handles empty query", () => {
+        expect(scoreToolMatch("", FAKE_TOOLS[0])).toBe(0);
+    });
+});
+describe("search_tools tool", () => {
+    const tool = createSearchToolsTool(() => FAKE_TOOLS);
+    it("returns matches in score order", async () => {
+        const r = await tool.execute({ query: "silence" }, ctx);
+        expect(typeof r).toBe("string");
+        const parsed = JSON.parse(r);
+        expect(parsed.matches[0].name).toBe("detect_silence");
+    });
+    it("limits results", async () => {
+        const r = await tool.execute({ query: "the" }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.matches.length).toBeLessThanOrEqual(8);
+    });
+    it("returns empty matches with a note on miss", async () => {
+        const r = await tool.execute({ query: "blockchain ethereum" }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.matches).toEqual([]);
+        expect(parsed.note).toBeTruthy();
+    });
+    it("excludes itself from results", async () => {
+        const tools = [...FAKE_TOOLS, { name: "search_tools", description: "Find tools by query" }];
+        const t = createSearchToolsTool(() => tools);
+        const r = await t.execute({ query: "tools" }, ctx);
+        const parsed = JSON.parse(r);
+        expect(parsed.matches.find((m) => m.name === "search_tools")).toBeUndefined();
+    });
+});
+//# sourceMappingURL=search-tools.test.js.map

package/dist/tools/search-tools.test.js.map

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

package/dist/tools/snap-cuts-to-beats.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import type { AgentTool } from "@kenkaiiii/gg-agent";
+declare const SnapCutsToBeatsParams: z.ZodObject<{
+    audio: z.ZodString;
+    cutPoints: z.ZodArray<z.ZodNumber>;
+    toleranceSec: z.ZodOptional<z.ZodNumber>;
+    sampleRate: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * snap_cuts_to_beats — the music-driven cut primitive. CapCut ships this
+ * as "Auto Beat" and it's the single biggest reason their music shorts
+ * feel snappy. We expose it as a pure data tool: in → cut points; out →
+ * beat-aligned cut points. The agent then feeds the result to cut_at /
+ * add_sfx_at_cuts / punch_in for the actual edit.
+ */
+export declare function createSnapCutsToBeatsTool(cwd: string): AgentTool<typeof SnapCutsToBeatsParams>;
+export {};
+//# sourceMappingURL=snap-cuts-to-beats.d.ts.map

package/dist/tools/snap-cuts-to-beats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snap-cuts-to-beats.d.ts","sourceRoot":"","sources":["../../src/tools/snap-cuts-to-beats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKrD,QAAA,MAAM,qBAAqB;;;;;iBAmCzB,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,qBAAqB,CAAC,CAwE9F"}