@prestyj/editor 0.7.1

package/dist/tools/grade-skin-tones.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const GradeSkinTonesParams: z.ZodObject<{
+    referenceVideo: z.ZodString;
+    referenceAtSec: z.ZodNumber;
+    targetVideo: z.ZodString;
+    targetAtSec: z.ZodNumber;
+    output: z.ZodString;
+    detail: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+    videoCodec: z.ZodOptional<z.ZodString>;
+    crf: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * grade_skin_tones — file-only skin-tone match across clips. Derives a
+ * vision-tuned grade from REFERENCE vs TARGET frames and bakes it into a
+ * graded output via ffmpeg (colorbalance + selectivecolor + eq). Works on
+ * every host (no NLE required); the agent can then `replace_clip` the
+ * graded file onto the timeline.
+ *
+ * NOT a deterministic match (no ColorChecker). Use when "shots feel off"
+ * (different camera, location, white balance drift). Below confidence 0.4
+ * the grade is unreliable — surface the result and let the user grade
+ * manually.
+ */
+export declare function createGradeSkinTonesTool(cwd: string): AgentTool<typeof GradeSkinTonesParams>;
+export {};
+//# sourceMappingURL=grade-skin-tones.d.ts.map

package/dist/tools/grade-skin-tones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade-skin-tones.d.ts","sourceRoot":"","sources":["../../src/tools/grade-skin-tones.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhD,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;iBAmBxB,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,oBAAoB,CAAC,CAmD5F"}

package/dist/tools/grade-skin-tones.js

@@ -0,0 +1,92 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { extractAtTimes } from "../core/frames.js";
+import { checkFfmpeg } from "../core/media/ffmpeg.js";
+import { applySkinGrade, deriveSkinGrade } from "../core/skin-grade.js";
+const GradeSkinTonesParams = z.object({
+    referenceVideo: z.string().describe("Reference video file (skin look you want)."),
+    referenceAtSec: z.number().min(0).describe("Time in the reference to sample."),
+    targetVideo: z.string().describe("Target video file (clip you want to match)."),
+    targetAtSec: z.number().min(0).describe("Time in the target to sample (face-forward)."),
+    output: z
+        .string()
+        .min(1)
+        .describe("Output graded file (relative resolves to cwd). Re-encoded; audio is copied."),
+    detail: z.enum(["low", "high"]).optional().describe("Vision detail. Default low."),
+    model: z.string().optional().describe("OpenAI model id. Default gpt-4o-mini."),
+    videoCodec: z.string().optional().describe("ffmpeg video codec. Default libx264."),
+    crf: z
+        .number()
+        .int()
+        .min(0)
+        .max(51)
+        .optional()
+        .describe("x264 CRF. Default 18 (visually lossless)."),
+});
+/**
+ * grade_skin_tones — file-only skin-tone match across clips. Derives a
+ * vision-tuned grade from REFERENCE vs TARGET frames and bakes it into a
+ * graded output via ffmpeg (colorbalance + selectivecolor + eq). Works on
+ * every host (no NLE required); the agent can then `replace_clip` the
+ * graded file onto the timeline.
+ *
+ * NOT a deterministic match (no ColorChecker). Use when "shots feel off"
+ * (different camera, location, white balance drift). Below confidence 0.4
+ * the grade is unreliable — surface the result and let the user grade
+ * manually.
+ */
+export function createGradeSkinTonesTool(cwd) {
+    return {
+        name: "grade_skin_tones",
+        description: "File-only skin-tone match: bakes a vision-derived grade (colorbalance + selectivecolor " +
+            "+ eq, tuned for reds/yellows where skin lives) into a new video file. Works in every " +
+            "host. Returns {path, confidence, why, grade}. ALWAYS check `confidence`; below 0.4 " +
+            "means the model is guessing — show the user, don't apply blindly. Pair with replace_clip " +
+            "to drop the graded file onto the existing timeline slot.",
+        parameters: GradeSkinTonesParams,
+        async execute(args, ctx) {
+            if (!checkFfmpeg())
+                return err("ffmpeg not on PATH", "install ffmpeg");
+            if (!process.env.OPENAI_API_KEY) {
+                return err("OPENAI_API_KEY not set", "export OPENAI_API_KEY=...");
+            }
+            try {
+                const refAbs = resolvePath(cwd, args.referenceVideo);
+                const tgtAbs = resolvePath(cwd, args.targetVideo);
+                const outAbs = resolvePath(cwd, args.output);
+                if (outAbs === tgtAbs) {
+                    return err("output and target are identical", "use a different output path");
+                }
+                const [refFrame] = await extractAtTimes(refAbs, [args.referenceAtSec], {
+                    maxWidth: 768,
+                    signal: ctx.signal,
+                });
+                const [tgtFrame] = await extractAtTimes(tgtAbs, [args.targetAtSec], {
+                    maxWidth: 768,
+                    signal: ctx.signal,
+                });
+                const grade = await deriveSkinGrade(refFrame.path, tgtFrame.path, {
+                    detail: args.detail,
+                    model: args.model,
+                    signal: ctx.signal,
+                });
+                await applySkinGrade(tgtAbs, outAbs, grade, {
+                    videoCodec: args.videoCodec,
+                    crf: args.crf,
+                    signal: ctx.signal,
+                });
+                return compact({
+                    path: outAbs,
+                    confidence: grade.confidence,
+                    why: grade.why,
+                    grade,
+                });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=grade-skin-tones.js.map

package/dist/tools/grade-skin-tones.js.map

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

package/dist/tools/host-eval.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const HostEvalParams: z.ZodObject<{
+    code: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Escape hatch — runs arbitrary host-native scripting code with the live NLE
+ * objects pre-bound. Routes to whichever adapter is connected:
+ *
+ *   - Resolve  → Python via the long-lived bridge sidecar
+ *   - Premiere → ExtendScript via the JSX bridge
+ *   - none     → returns `error: not_supported` (no host attached)
+ *
+ * **Use this only when no named tool covers what you need.** The named tools
+ * have validation, output shaping, capability fallbacks, and EDL/FCPXML
+ * bulk-paths this raw eval skips entirely. If a named tool exists for what
+ * you're doing, use the named tool.
+ *
+ * Pre-bound globals on Resolve (Python):
+ *   - `resolve`, `project`, `projectManager`, `mediaPool`, `mediaStorage`
+ *   - `timeline`, `fusion`, `dvr` (the DaVinciResolveScript module)
+ *   - `set_result(value)` — return JSON-serialisable data to the agent
+ *   - `result` — alternative: assign at top level
+ *   - `print(...)` — captured to `stdout`
+ *
+ * Pre-bound globals on Premiere (ExtendScript):
+ *   - `app`, `project`, `sequence`, `qe` (Quality Engineering DOM, undocumented)
+ *   - `setResult(value)` — return JSON-serialisable data
+ *   - `result` — alternative: assign at top level
+ *   - `print(...)` — captured to `stdout`
+ */
+export declare function createHostEvalTool(host: VideoHost): AgentTool<typeof HostEvalParams>;
+export {};
+//# sourceMappingURL=host-eval.d.ts.map

package/dist/tools/host-eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-eval.d.ts","sourceRoot":"","sources":["../../src/tools/host-eval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,QAAA,MAAM,cAAc;;iBAQlB,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,cAAc,CAAC,CAiCpF"}

package/dist/tools/host-eval.js

@@ -0,0 +1,70 @@
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+const HostEvalParams = z.object({
+    code: z
+        .string()
+        .min(1, "code must be a non-empty snippet of host-native scripting code.")
+        .describe("Host-native scripting code. Resolve = Python (DaVinciResolveScript module pre-loaded). " +
+        "Premiere = ExtendScript (Premiere DOM pre-loaded). One snippet per call."),
+});
+/**
+ * Escape hatch — runs arbitrary host-native scripting code with the live NLE
+ * objects pre-bound. Routes to whichever adapter is connected:
+ *
+ *   - Resolve  → Python via the long-lived bridge sidecar
+ *   - Premiere → ExtendScript via the JSX bridge
+ *   - none     → returns `error: not_supported` (no host attached)
+ *
+ * **Use this only when no named tool covers what you need.** The named tools
+ * have validation, output shaping, capability fallbacks, and EDL/FCPXML
+ * bulk-paths this raw eval skips entirely. If a named tool exists for what
+ * you're doing, use the named tool.
+ *
+ * Pre-bound globals on Resolve (Python):
+ *   - `resolve`, `project`, `projectManager`, `mediaPool`, `mediaStorage`
+ *   - `timeline`, `fusion`, `dvr` (the DaVinciResolveScript module)
+ *   - `set_result(value)` — return JSON-serialisable data to the agent
+ *   - `result` — alternative: assign at top level
+ *   - `print(...)` — captured to `stdout`
+ *
+ * Pre-bound globals on Premiere (ExtendScript):
+ *   - `app`, `project`, `sequence`, `qe` (Quality Engineering DOM, undocumented)
+ *   - `setResult(value)` — return JSON-serialisable data
+ *   - `result` — alternative: assign at top level
+ *   - `print(...)` — captured to `stdout`
+ */
+export function createHostEvalTool(host) {
+    return {
+        name: "host_eval",
+        description: "Escape hatch: run host-native scripting code (Python on Resolve, ExtendScript on " +
+            "Premiere) with the NLE DOM pre-bound. Returns {result, stdout?}. ONLY use when no " +
+            "named tool fits — named tools have validation, summarised output, and EDL fallbacks " +
+            "this raw path skips. Prefer set_result(value) (Resolve: Python; Premiere: setResult) " +
+            "to return data; print()/stdout is captured. Resolve scope: resolve, project, " +
+            "projectManager, mediaPool, mediaStorage, timeline, fusion, dvr. Premiere scope: app, " +
+            "project, sequence, qe. Returns error: not_supported when no NLE is attached " +
+            "(host=none) — call host_info first if unsure.",
+        parameters: HostEvalParams,
+        async execute({ code }) {
+            try {
+                if (typeof host.executeCode !== "function") {
+                    return err("not_supported", `host=${host.name} has no scripting bridge. Open Resolve or Premiere, then retry.`);
+                }
+                const out = await host.executeCode(code);
+                // Compact output: omit empty stdout, omit null result if stdout exists.
+                const payload = {};
+                if (out.result !== null && out.result !== undefined)
+                    payload.result = out.result;
+                if (out.stdout)
+                    payload.stdout = out.stdout;
+                if (Object.keys(payload).length === 0)
+                    return "ok";
+                return compact(payload);
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=host-eval.js.map

package/dist/tools/host-eval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-eval.js","sourceRoot":"","sources":["../../src/tools/host-eval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,iEAAiE,CAAC;SACzE,QAAQ,CACP,yFAAyF;QACvF,0EAA0E,CAC7E;CACJ,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAe;IAChD,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,mFAAmF;YACnF,oFAAoF;YACpF,sFAAsF;YACtF,uFAAuF;YACvF,+EAA+E;YAC/E,uFAAuF;YACvF,8EAA8E;YAC9E,+CAA+C;QACjD,UAAU,EAAE,cAAc;QAC1B,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE;YACpB,IAAI,CAAC;gBACH,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;oBAC3C,OAAO,GAAG,CACR,eAAe,EACf,QAAQ,IAAI,CAAC,IAAI,iEAAiE,CACnF,CAAC;gBACJ,CAAC;gBACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBACzC,wEAAwE;gBACxE,MAAM,OAAO,GAA4B,EAAE,CAAC;gBAC5C,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;oBAAE,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;gBACjF,IAAI,GAAG,CAAC,MAAM;oBAAE,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;gBAC5C,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,IAAI,CAAC;gBACnD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;YAC1B,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/host-info.d.ts

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

package/dist/tools/host-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-info.d.ts","sourceRoot":"","sources":["../../src/tools/host-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,QAAA,MAAM,cAAc,gCAAe,CAAC;AAEpC,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,cAAc,CAAC,CA6BpF"}

package/dist/tools/host-info.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { compact } from "../core/format.js";
+const HostInfoParams = z.object({});
+export function createHostInfoTool(host) {
+    return {
+        name: "host_info",
+        description: "Report the connected NLE host and its capabilities. Call FIRST so you know what " +
+            "ops are available before planning. Output is compact JSON.",
+        parameters: HostInfoParams,
+        async execute() {
+            const c = await host.capabilities();
+            // Compact key abbreviations: move/color/audio/ai/import. The agent only
+            // needs to know what's possible — verbose labels just bloat context.
+            // `runtime` and `deprecated` are surfaced so the agent can warn users on
+            // sunset paths (Adobe CEP/ExtendScript end-of-life Sept 2026).
+            return compact({
+                host: host.name,
+                ok: c.isAvailable,
+                why: c.unavailableReason,
+                caps: {
+                    move: c.canMoveClips,
+                    color: c.canScriptColor,
+                    audio: c.canScriptAudio,
+                    ai: c.canTriggerAI,
+                    import: c.preferredImportFormat,
+                },
+                ...(c.runtime ? { runtime: c.runtime } : {}),
+                ...(c.deprecationNotice ? { deprecated: c.deprecationNotice } : {}),
+            });
+        },
+    };
+}
+//# sourceMappingURL=host-info.js.map

package/dist/tools/host-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-info.js","sourceRoot":"","sources":["../../src/tools/host-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEpC,MAAM,UAAU,kBAAkB,CAAC,IAAe;IAChD,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,kFAAkF;YAClF,4DAA4D;QAC9D,UAAU,EAAE,cAAc;QAC1B,KAAK,CAAC,OAAO;YACX,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YACpC,wEAAwE;YACxE,qEAAqE;YACrE,yEAAyE;YACzE,+DAA+D;YAC/D,OAAO,OAAO,CAAC;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,EAAE,EAAE,CAAC,CAAC,WAAW;gBACjB,GAAG,EAAE,CAAC,CAAC,iBAAiB;gBACxB,IAAI,EAAE;oBACJ,IAAI,EAAE,CAAC,CAAC,YAAY;oBACpB,KAAK,EAAE,CAAC,CAAC,cAAc;oBACvB,KAAK,EAAE,CAAC,CAAC,cAAc;oBACvB,EAAE,EAAE,CAAC,CAAC,YAAY;oBAClB,MAAM,EAAE,CAAC,CAAC,qBAAqB;iBAChC;gBACD,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5C,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpE,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,125 @@
+import { describe, expect, it } from "vitest";
+import { NoneAdapter } from "../core/hosts/none/adapter.js";
+import { ResolveAdapter } from "../core/hosts/resolve/adapter.js";
+import { createAddMarkerTool } from "./add-marker.js";
+import { createAppendClipTool } from "./append-clip.js";
+import { createCreateTimelineTool } from "./create-timeline.js";
+import { createCutAtTool } from "./cut-at.js";
+import { createGetMarkersTool } from "./get-markers.js";
+import { createGetTimelineTool } from "./get-timeline.js";
+import { createImportEdlTool } from "./import-edl.js";
+import { createImportSubtitlesTool } from "./import-subtitles.js";
+import { createImportToMediaPoolTool } from "./import-to-media-pool.js";
+import { createOpenPageTool } from "./open-page.js";
+import { createRippleDeleteTool } from "./ripple-delete.js";
+import { createFusionCompTool } from "./fusion-comp.js";
+import { createHostEvalTool } from "./host-eval.js";
+import { createSetClipSpeedTool } from "./set-clip-speed.js";
+/**
+ * Smoke tests for the host-mutation tool wrappers. NoneAdapter rejects with
+ * HostUnsupportedError or HostUnreachableError, which the tool wrappers must
+ * format as `error: ...` strings (never let raw exceptions escape).
+ */
+const ctx = {
+    signal: new AbortController().signal,
+    toolCallId: "t1",
+};
+describe("host-mutation tool wrappers — error formatting against NoneAdapter", () => {
+    it("add_marker returns 'error:' on unreachable host", async () => {
+        const r = await createAddMarkerTool(new NoneAdapter()).execute({ frame: 0, note: "x" }, ctx);
+        expect(typeof r).toBe("string");
+        expect(r).toMatch(/^error:/);
+    });
+    it("cut_at returns 'error:' with EDL fallback hint", async () => {
+        const r = await createCutAtTool(new NoneAdapter()).execute({ track: 1, frame: 30 }, ctx);
+        expect(r).toMatch(/^error:/);
+        expect(r).toMatch(/write_edl/);
+    });
+    it("ripple_delete validates endFrame > startFrame BEFORE calling host", async () => {
+        const r = await createRippleDeleteTool(new NoneAdapter()).execute({ track: 1, startFrame: 100, endFrame: 50 }, ctx);
+        expect(r).toMatch(/endFrame must be > startFrame/);
+    });
+    it("ripple_delete returns 'error:' with EDL hint on unsupported host", async () => {
+        const r = await createRippleDeleteTool(new NoneAdapter()).execute({ track: 1, startFrame: 0, endFrame: 30 }, ctx);
+        expect(r).toMatch(/^error:/);
+        expect(r).toMatch(/write_edl/);
+    });
+    it("append_clip returns 'error:' on unreachable host", async () => {
+        const r = await createAppendClipTool(new NoneAdapter(), "/tmp").execute({ track: 1, mediaPath: "x.mp4" }, ctx);
+        expect(r).toMatch(/^error:/);
+    });
+    it("set_clip_speed returns 'error:' on unsupported host", async () => {
+        const r = await createSetClipSpeedTool(new NoneAdapter()).execute({ clipId: "x", speed: 1.5 }, ctx);
+        expect(r).toMatch(/^error:/);
+    });
+    it("get_timeline returns 'error:' on unreachable host", async () => {
+        const r = await createGetTimelineTool(new NoneAdapter()).execute({}, ctx);
+        expect(r).toMatch(/^error:/);
+    });
+    it("get_markers returns 'error:' on unreachable host", async () => {
+        const r = await createGetMarkersTool(new NoneAdapter()).execute({}, ctx);
+        expect(r).toMatch(/^error:/);
+    });
+    it("create_timeline returns 'error:' on unreachable host", async () => {
+        const r = await createCreateTimelineTool(new NoneAdapter()).execute({ name: "Test", fps: 30 }, ctx);
+        expect(r).toMatch(/^error:/);
+    });
+    it("import_to_media_pool returns 'error:' on unreachable host", async () => {
+        const r = await createImportToMediaPoolTool(new NoneAdapter(), "/tmp").execute({ paths: ["a.mov"] }, ctx);
+        expect(r).toMatch(/^error:/);
+    });
+    it("open_page returns 'error:' on hosts without page concept", async () => {
+        const r = await createOpenPageTool(new NoneAdapter()).execute({ name: "edit" }, ctx);
+        expect(typeof r).toBe("string");
+        // NoneAdapter exposes openPage but it throws — the tool surfaces an error string.
+        expect(r).toMatch(/^error:/);
+    });
+    it("import_subtitles returns 'error:' on unreachable host", async () => {
+        const r = await createImportSubtitlesTool(new NoneAdapter(), "/tmp").execute({ srtPath: "x.srt" }, ctx);
+        expect(r).toMatch(/^error:/);
+    });
+    it("import_edl returns 'error:' on unreachable host", async () => {
+        const r = await createImportEdlTool(new NoneAdapter(), "/tmp").execute({ filePath: "x.edl" }, ctx);
+        expect(r).toMatch(/^error:/);
+    });
+    it("fusion_comp returns 'error: not_supported' on hosts without Fusion", async () => {
+        const r = await createFusionCompTool(new NoneAdapter()).execute({ action: "list_nodes" }, ctx);
+        expect(typeof r).toBe("string");
+        expect(r).toMatch(/^error: not_supported/);
+    });
+    it("host_eval returns 'error: not_supported' when host has no scripting bridge", async () => {
+        // NoneAdapter has no executeCode method — the tool must fail closed
+        // with a clear not_supported error rather than throw.
+        const r = await createHostEvalTool(new NoneAdapter()).execute({ code: "set_result(1)" }, ctx);
+        expect(typeof r).toBe("string");
+        expect(r).toMatch(/^error: not_supported/);
+        // Should hint at the fix.
+        expect(r).toMatch(/Open Resolve or Premiere/);
+    });
+});
+describe("capability cache invalidation", () => {
+    it("ResolveAdapter.capabilities() does not return a cached object across calls", async () => {
+        // The previous design cached `cachedCapabilities` once, so a closed-Resolve
+        // session looked permanently available. We dropped the cache; now each call
+        // produces a fresh object reflecting the latest reachability check.
+        const adapter = new ResolveAdapter();
+        const a = await adapter.capabilities();
+        const b = await adapter.capabilities();
+        expect(a).not.toBe(b); // distinct objects
+        expect(a.canScriptColor).toBe(b.canScriptColor); // values still consistent
+    });
+    it("ResolveAdapter.capabilities() reflects post-shutdown reachability without restart", async () => {
+        // shutdown() kills the bridge. The next capabilities() call must produce
+        // an answer based on a fresh env-check, not on a cached snapshot taken
+        // before shutdown.
+        const adapter = new ResolveAdapter();
+        const before = await adapter.capabilities();
+        adapter.shutdown();
+        const after = await adapter.capabilities();
+        // Whatever the env says now, the second call must have re-evaluated it.
+        expect(typeof after.isAvailable).toBe("boolean");
+        // Same shape, fresh object.
+        expect(after).not.toBe(before);
+    });
+});
+//# sourceMappingURL=host-tools.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host-tools.test.js","sourceRoot":"","sources":["../../src/tools/host-tools.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;GAIG;AAEH,MAAM,GAAG,GAAG;IACV,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM;IACpC,UAAU,EAAE,IAAI;CAC8D,CAAC;AAEjF,QAAQ,CAAC,oEAAoE,EAAE,GAAG,EAAE;IAClF,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,CAAC,GAAG,MAAM,mBAAmB,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;QAC7F,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,CAAC,GAAG,MAAM,eAAe,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QACzF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,CAAC,GAAG,MAAM,sBAAsB,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,OAAO,CAC/D,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,EAC3C,GAAG,CACJ,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,CAAC,GAAG,MAAM,sBAAsB,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,OAAO,CAC/D,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,EACzC,GAAG,CACJ,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,CAAC,GAAG,MAAM,oBAAoB,CAAC,IAAI,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC,OAAO,CACrE,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,EAChC,GAAG,CACJ,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,CAAC,GAAG,MAAM,sBAAsB,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,OAAO,CAC/D,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAC3B,GAAG,CACJ,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,CAAC,GAAG,MAAM,qBAAqB,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC1E,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,CAAC,GAAG,MAAM,oBAAoB,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACzE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,CAAC,GAAG,MAAM,wBAAwB,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,OAAO,CACjE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,EACzB,GAAG,CACJ,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,CAAC,GAAG,MAAM,2BAA2B,CAAC,IAAI,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC,OAAO,CAC5E,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,EACpB,GAAG,CACJ,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,CAAC,GAAG,MAAM,kBAAkB,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC;QACrF,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,kFAAkF;QAClF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,CAAC,GAAG,MAAM,yBAAyB,CAAC,IAAI,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC,OAAO,CAC1E,EAAE,OAAO,EAAE,OAAO,EAAE,EACpB,GAAG,CACJ,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,CAAC,GAAG,MAAM,mBAAmB,CAAC,IAAI,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC,OAAO,CACpE,EAAE,QAAQ,EAAE,OAAO,EAAE,EACrB,GAAG,CACJ,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,CAAC,GAAG,MAAM,oBAAoB,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,GAAG,CAAC,CAAC;QAC/F,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,oEAAoE;QACpE,sDAAsD;QACtD,MAAM,CAAC,GAAG,MAAM,kBAAkB,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,GAAG,CAAC,CAAC;QAC9F,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QAC3C,0BAA0B;QAC1B,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,4EAA4E;QAC5E,4EAA4E;QAC5E,oEAAoE;QACpE,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;QACvC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB;QAC1C,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,0BAA0B;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mFAAmF,EAAE,KAAK,IAAI,EAAE;QACjG,yEAAyE;QACzE,uEAAuE;QACvE,mBAAmB;QACnB,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;QAC5C,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;QAC3C,wEAAwE;QACxE,MAAM,CAAC,OAAO,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjD,4BAA4B;QAC5B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/import-edl.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const ImportEdlParams: z.ZodObject<{
+    filePath: z.ZodString;
+}, z.core.$strip>;
+export declare function createImportEdlTool(host: VideoHost, cwd: string): AgentTool<typeof ImportEdlParams>;
+export {};
+//# sourceMappingURL=import-edl.d.ts.map

package/dist/tools/import-edl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-edl.d.ts","sourceRoot":"","sources":["../../src/tools/import-edl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,QAAA,MAAM,eAAe;;iBAEnB,CAAC;AAEH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,eAAe,CAAC,CAiBnC"}

package/dist/tools/import-edl.js

@@ -0,0 +1,25 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { err } from "../core/format.js";
+const ImportEdlParams = z.object({
+    filePath: z.string().describe("Path to the EDL/FCPXML/AAF file."),
+});
+export function createImportEdlTool(host, cwd) {
+    return {
+        name: "import_edl",
+        description: "Bulk-import a timeline from EDL/FCPXML/AAF. Use after write_edl when the live API " +
+            "can't do per-clip ops (e.g. Resolve has no scriptable razor).",
+        parameters: ImportEdlParams,
+        async execute({ filePath }) {
+            try {
+                const abs = resolvePath(cwd, filePath);
+                await host.importTimeline(abs);
+                return "ok";
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=import-edl.js.map

package/dist/tools/import-edl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-edl.js","sourceRoot":"","sources":["../../src/tools/import-edl.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,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CAClE,CAAC,CAAC;AAEH,MAAM,UAAU,mBAAmB,CACjC,IAAe,EACf,GAAW;IAEX,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,oFAAoF;YACpF,+DAA+D;QACjE,UAAU,EAAE,eAAe;QAC3B,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE;YACxB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;gBACvC,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;gBAC/B,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/import-subtitles.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const ImportSubtitlesParams: z.ZodObject<{
+    srtPath: z.ZodString;
+}, z.core.$strip>;
+export declare function createImportSubtitlesTool(host: VideoHost, cwd: string): AgentTool<typeof ImportSubtitlesParams>;
+export {};
+//# sourceMappingURL=import-subtitles.d.ts.map

package/dist/tools/import-subtitles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-subtitles.d.ts","sourceRoot":"","sources":["../../src/tools/import-subtitles.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,QAAA,MAAM,qBAAqB;;iBAEzB,CAAC;AAEH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,qBAAqB,CAAC,CAsBzC"}

package/dist/tools/import-subtitles.js

@@ -0,0 +1,31 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+const ImportSubtitlesParams = z.object({
+    srtPath: z.string().describe("Path to the .srt file (relative resolves to cwd)."),
+});
+export function createImportSubtitlesTool(host, cwd) {
+    return {
+        name: "import_subtitles",
+        description: "Import an SRT subtitle file into the active timeline. Resolve attaches it to a " +
+            "subtitle track automatically; Premiere imports to the project (drag to a captions " +
+            "track manually). Pair with write_srt to ship captions end-to-end.",
+        parameters: ImportSubtitlesParams,
+        async execute({ srtPath }) {
+            try {
+                const abs = resolvePath(cwd, srtPath);
+                const r = await host.importSubtitles(abs);
+                // Tight response when the host auto-attached cleanly. Otherwise
+                // surface attached=false + note so the agent can tell the user to
+                // drag the SRT onto the captions track manually (Premiere case).
+                if (r.attached && !r.note)
+                    return "ok";
+                return compact({ imported: r.imported, attached: r.attached, note: r.note });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=import-subtitles.js.map

package/dist/tools/import-subtitles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-subtitles.js","sourceRoot":"","sources":["../../src/tools/import-subtitles.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,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;CAClF,CAAC,CAAC;AAEH,MAAM,UAAU,yBAAyB,CACvC,IAAe,EACf,GAAW;IAEX,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,iFAAiF;YACjF,oFAAoF;YACpF,mEAAmE;QACrE,UAAU,EAAE,qBAAqB;QACjC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE;YACvB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBACtC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;gBAC1C,gEAAgE;gBAChE,kEAAkE;gBAClE,iEAAiE;gBACjE,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,IAAI;oBAAE,OAAO,IAAI,CAAC;gBACvC,OAAO,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/E,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/import-to-media-pool.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+import type { VideoHost } from "../core/hosts/types.js";
+declare const ImportToMediaPoolParams: z.ZodObject<{
+    paths: z.ZodArray<z.ZodString>;
+    bin: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function createImportToMediaPoolTool(host: VideoHost, cwd: string): AgentTool<typeof ImportToMediaPoolParams>;
+export {};
+//# sourceMappingURL=import-to-media-pool.d.ts.map

package/dist/tools/import-to-media-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-to-media-pool.d.ts","sourceRoot":"","sources":["../../src/tools/import-to-media-pool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,QAAA,MAAM,uBAAuB;;;iBAG3B,CAAC;AAEH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,OAAO,uBAAuB,CAAC,CAkB3C"}

package/dist/tools/import-to-media-pool.js

@@ -0,0 +1,27 @@
+import { resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+const ImportToMediaPoolParams = z.object({
+    paths: z.array(z.string()).min(1).describe("File paths (relative resolves to cwd)."),
+    bin: z.string().optional().describe("Optional bin/folder name to drop the items into."),
+});
+export function createImportToMediaPoolTool(host, cwd) {
+    return {
+        name: "import_to_media_pool",
+        description: "Import one or more media files into the project's media pool / bins WITHOUT " +
+            "appending to the timeline. Use as the setup step for rough-cut-from-script and " +
+            "multi-source workflows. Use append_clip when you also want it on the timeline.",
+        parameters: ImportToMediaPoolParams,
+        async execute({ paths, bin }) {
+            try {
+                const abs = paths.map((p) => resolvePath(cwd, p));
+                await host.importToMediaPool(abs, bin);
+                return compact({ ok: true, imported: abs.length });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=import-to-media-pool.js.map

package/dist/tools/import-to-media-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-to-media-pool.js","sourceRoot":"","sources":["../../src/tools/import-to-media-pool.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,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACpF,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CACxF,CAAC,CAAC;AAEH,MAAM,UAAU,2BAA2B,CACzC,IAAe,EACf,GAAW;IAEX,OAAO;QACL,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,8EAA8E;YAC9E,iFAAiF;YACjF,gFAAgF;QAClF,UAAU,EAAE,uBAAuB;QACnC,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE;YAC1B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;gBAClD,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBACvC,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YACrD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,GAAG,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}