@assemblyline-agents/ffmpeg 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenEve contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+# @assemblyline-agents/ffmpeg
+
+Official Assembly Line stdio connection for workspace-scoped FFmpeg operations.
+
+FFmpeg is a host executable, not a remote account connection. This package
+bundles a small MCP server that exposes reviewed media operations and launches
+`ffmpeg` or `ffprobe` without a shell. It never exposes arbitrary command-line
+flags to the model.
+
+## Setup
+
+Install FFmpeg on every runtime host:
+
+```sh
+# macOS
+brew install ffmpeg
+
+# Debian/Ubuntu
+apt-get update && apt-get install -y ffmpeg
+
+assembly-line add ffmpeg agent
+```
+
+Enable editing explicitly:
+
+```ts
+import { defineFfmpegConnection } from "@assemblyline-agents/ffmpeg";
+
+export default defineFfmpegConnection({
+  workspaceRoot: "/workspace/media",
+  access: {
+    read: true,
+    write: { approval: "always" }
+  }
+});
+```
+
+The connection exposes:
+
+- `probe_media`
+- `trim_media`
+- `transcode_media`
+- `concat_media`
+- `replace_audio`
+- `extract_frames`
+- `reframe_vertical`
+
+All input and output paths must resolve inside `workspaceRoot`, including
+symlink targets. The deployment owner can select trusted `ffmpegCommand` and
+`ffprobeCommand` paths; agents cannot replace those executables or add
+unreviewed flags.
+
+`concat_media` expects codec-compatible, normalized clips. Transcode source
+clips to a common size, frame rate, codec, and audio layout before stitching
+when they come from different devices or platforms.
+
+`extract_frames` returns paths only by default. Set `previewFrames` explicitly
+(one to twelve) only when the user requests or approves a frame-based
+approximation. Assembly Line never invokes frame sampling as a fallback for native
+video understanding, and agents must not claim that sampled stills are
+equivalent to watching temporal video.

package/dist/frame-preview.d.ts

@@ -0,0 +1,8 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/** Build bounded, evenly sampled MCP image content from an FFmpeg output pattern. */
+export declare function framePreviewResult(outputPattern: string, result: {
+    stdout: string;
+    stderr: string;
+}, previewFrames: number, workspaceRoot: string): CallToolResult;
+export declare function matchingFramePaths(outputPattern: string): string[];
+//# sourceMappingURL=frame-preview.d.ts.map

package/dist/frame-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-preview.d.ts","sourceRoot":"","sources":["../src/frame-preview.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAKzE,qFAAqF;AACrF,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC1C,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GACpB,cAAc,CA+BhB;AAED,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAalE"}

package/dist/frame-preview.js

@@ -0,0 +1,82 @@
+import { readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
+import { basename, dirname, extname, isAbsolute, join, relative } from "node:path";
+const MAX_PREVIEW_FRAME_BYTES = 20 * 1024 * 1024;
+const MAX_PREVIEW_TOTAL_BYTES = 50 * 1024 * 1024;
+/** Build bounded, evenly sampled MCP image content from an FFmpeg output pattern. */
+export function framePreviewResult(outputPattern, result, previewFrames, workspaceRoot) {
+    const root = realpathSync(workspaceRoot);
+    const framePaths = matchingFramePaths(outputPattern).filter((path) => isInside(root, realpathSync(path)));
+    const previewPaths = sampledPaths(framePaths, previewFrames);
+    const images = [];
+    const includedPaths = [];
+    let totalBytes = 0;
+    for (const path of previewPaths) {
+        const size = statSync(path).size;
+        if (size > MAX_PREVIEW_FRAME_BYTES || totalBytes + size > MAX_PREVIEW_TOTAL_BYTES)
+            continue;
+        const mimeType = frameMimeType(path);
+        if (!mimeType)
+            continue;
+        images.push({ type: "image", data: readFileSync(path).toString("base64"), mimeType });
+        includedPaths.push(path);
+        totalBytes += size;
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    outputPattern,
+                    frameCount: framePaths.length,
+                    previewPaths: includedPaths,
+                    stdout: result.stdout,
+                    stderr: result.stderr
+                }, null, 2)
+            },
+            ...images
+        ]
+    };
+}
+export function matchingFramePaths(outputPattern) {
+    const directory = dirname(outputPattern);
+    const filename = basename(outputPattern);
+    const token = /%(?:0([1-9][0-9]*))?d/u.exec(filename);
+    if (!token || token.index === undefined)
+        return [];
+    const before = filename.slice(0, token.index);
+    const after = filename.slice(token.index + token[0].length);
+    const digits = token[1] ? `\\d{${token[1]}}` : "\\d+";
+    const matcher = new RegExp(`^${escapeRegex(before)}${digits}${escapeRegex(after)}$`, "u");
+    return readdirSync(directory)
+        .filter((name) => matcher.test(name))
+        .sort((left, right) => left.localeCompare(right, undefined, { numeric: true }))
+        .map((name) => join(directory, name));
+}
+function sampledPaths(paths, count) {
+    if (count <= 0 || paths.length === 0)
+        return [];
+    if (paths.length <= count)
+        return paths;
+    if (count === 1)
+        return [paths[0]];
+    const indexes = new Set(Array.from({ length: count }, (_, index) => Math.round((index * (paths.length - 1)) / (count - 1))));
+    return [...indexes].map((index) => paths[index]);
+}
+function frameMimeType(path) {
+    const extension = extname(path).toLowerCase();
+    if (extension === ".jpg" || extension === ".jpeg")
+        return "image/jpeg";
+    if (extension === ".png")
+        return "image/png";
+    if (extension === ".webp")
+        return "image/webp";
+    return undefined;
+}
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+}
+function isInside(root, candidate) {
+    const relation = relative(root, candidate);
+    return !relation.startsWith("..") && !isAbsolute(relation);
+}
+//# sourceMappingURL=frame-preview.js.map

package/dist/frame-preview.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { type StdioMcpPluginConnectionOptions } from "@assemblyline-agents/core";
+export interface FfmpegConnectionOptions extends StdioMcpPluginConnectionOptions {
+    /** Directory containing every readable input and writable output. */
+    workspaceRoot?: string;
+    /** Trusted FFmpeg executable selected by the deployment owner. */
+    ffmpegCommand?: string;
+    /** Trusted FFprobe executable selected by the deployment owner. */
+    ffprobeCommand?: string;
+}
+export declare function defineFfmpegConnection(options: FfmpegConnectionOptions): import("@assemblyline-agents/core").McpStdioClientConnectionDefinition;
+export declare const openevePlugin: import("@assemblyline-agents/core").PluginModule;
+//# 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":"AAEA,OAAO,EAIL,KAAK,+BAA+B,EACrC,MAAM,2BAA2B,CAAC;AAKnC,MAAM,WAAW,uBAAwB,SAAQ,+BAA+B;IAC9E,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,0EAuBtE;AAED,eAAO,MAAM,aAAa,kDAA0C,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { connectionPluginMetadata, definePlugin, defineStdioMcpPluginConnection } from "@assemblyline-agents/core";
+const PLUGIN = connectionPluginMetadata("ffmpeg");
+const MCP_SERVER_PATH = fileURLToPath(new URL("./mcp-server.js", import.meta.url));
+export function defineFfmpegConnection(options) {
+    const { workspaceRoot: configuredWorkspaceRoot, ffmpegCommand = "ffmpeg", ffprobeCommand = "ffprobe", ...connection } = options;
+    const workspaceRoot = resolve(configuredWorkspaceRoot ?? connection.cwd ?? process.cwd());
+    const serverArgs = [
+        MCP_SERVER_PATH,
+        "--workspace-root",
+        workspaceRoot,
+        "--ffmpeg-command",
+        ffmpegCommand,
+        "--ffprobe-command",
+        ffprobeCommand
+    ];
+    return defineStdioMcpPluginConnection(PLUGIN, {
+        ...connection,
+        command: connection.command ?? process.execPath,
+        args: connection.args ?? serverArgs,
+        cwd: connection.cwd ?? workspaceRoot
+    });
+}
+export const openevePlugin = definePlugin({ connections: [PLUGIN] });
+//# 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,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,8BAA8B,EAE/B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,GAAG,wBAAwB,CAAC,QAAQ,CAAE,CAAC;AACnD,MAAM,eAAe,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAWnF,MAAM,UAAU,sBAAsB,CAAC,OAAgC;IACrE,MAAM,EACJ,aAAa,EAAE,uBAAuB,EACtC,aAAa,GAAG,QAAQ,EACxB,cAAc,GAAG,SAAS,EAC1B,GAAG,UAAU,EACd,GAAG,OAAO,CAAC;IACZ,MAAM,aAAa,GAAG,OAAO,CAAC,uBAAuB,IAAI,UAAU,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1F,MAAM,UAAU,GAAG;QACjB,eAAe;QACf,kBAAkB;QAClB,aAAa;QACb,kBAAkB;QAClB,aAAa;QACb,mBAAmB;QACnB,cAAc;KACf,CAAC;IACF,OAAO,8BAA8B,CAAC,MAAM,EAAE;QAC5C,GAAG,UAAU;QACb,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ;QAC/C,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,UAAU;QACnC,GAAG,EAAE,UAAU,CAAC,GAAG,IAAI,aAAa;KACrC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}

package/dist/mcp-server.d.ts

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

package/dist/mcp-server.d.ts.map

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

package/dist/mcp-server.js

@@ -0,0 +1,216 @@
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { runProcess } from "./process.js";
+import { framePreviewResult } from "./frame-preview.js";
+import { arrayValue, enumValue, evenDimension, integerValue, numberValue, optionalEvenDimension, recordValue, stringValue } from "./tool-input.js";
+import { FFMPEG_TOOLS } from "./tools.js";
+import { MediaWorkspace } from "./workspace.js";
+const options = parseServerOptions(process.argv.slice(2));
+const workspace = new MediaWorkspace(options.workspaceRoot);
+const server = new Server({ name: "openeve-ffmpeg", version: "0.1.0" }, {
+    capabilities: { tools: {} },
+    instructions: "Media operations are typed and restricted to the configured workspace root."
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: FFMPEG_TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+        return await callTool(request.params.name, recordValue(request.params.arguments));
+    }
+    catch (error) {
+        return toolResult({ error: error instanceof Error ? error.message : String(error) }, true);
+    }
+});
+await server.connect(new StdioServerTransport());
+async function callTool(name, input) {
+    if (name === "probe_media") {
+        const inputPath = workspace.input(stringValue(input.inputPath, "inputPath"));
+        const result = await run(options.ffprobeCommand, [
+            "-v", "error",
+            "-show_format",
+            "-show_streams",
+            "-of", "json",
+            inputPath
+        ]);
+        return toolResult(JSON.parse(result.stdout || "{}"));
+    }
+    if (name === "trim_media") {
+        const inputPath = workspace.input(stringValue(input.inputPath, "inputPath"));
+        const outputPath = workspace.output(stringValue(input.outputPath, "outputPath"));
+        const start = numberValue(input.startSeconds, "startSeconds", 0);
+        const duration = numberValue(input.durationSeconds, "durationSeconds", Number.MIN_VALUE);
+        const args = [
+            "-y", "-ss", String(start), "-i", inputPath, "-t", String(duration),
+            "-map", "0:v:0", "-map", "0:a?",
+            "-c:v", "libx264",
+            "-preset", enumValue(input.preset, X264_PRESETS, "medium"),
+            "-crf", String(integerValue(input.crf, "crf", 0, 51, 18)),
+            "-c:a", "aac", "-b:a", "192k", "-movflags", "+faststart",
+            outputPath
+        ];
+        return writeResult(outputPath, await run(options.ffmpegCommand, args));
+    }
+    if (name === "transcode_media") {
+        const inputPath = workspace.input(stringValue(input.inputPath, "inputPath"));
+        const outputPath = workspace.output(stringValue(input.outputPath, "outputPath"));
+        const codec = enumValue(input.codec, ["h264", "h265", "vp9", "prores"], "h264");
+        const width = optionalEvenDimension(input.width, "width", 7680);
+        const height = optionalEvenDimension(input.height, "height", 7680);
+        const video = videoCodecArguments(codec, input);
+        const args = [
+            "-y", "-i", inputPath,
+            "-map", "0:v:0", "-map", "0:a?",
+            ...scaleArguments(width, height),
+            ...video,
+            ...(codec === "prores" ? ["-c:a", "pcm_s16le"] : ["-c:a", "aac", "-b:a", "192k"]),
+            outputPath
+        ];
+        return writeResult(outputPath, await run(options.ffmpegCommand, args));
+    }
+    if (name === "concat_media") {
+        const values = arrayValue(input.inputPaths, "inputPaths", 2, 100);
+        const inputPaths = values.map((value, index) => workspace.input(stringValue(value, `inputPaths[${index}]`)));
+        const outputPath = workspace.output(stringValue(input.outputPath, "outputPath"));
+        const mode = enumValue(input.mode, ["copy", "reencode"], "reencode");
+        const temporary = mkdtempSync(join(tmpdir(), "openeve-ffmpeg-concat-"));
+        const listPath = join(temporary, "inputs.txt");
+        try {
+            writeFileSync(listPath, inputPaths.map((path) => `file '${escapeConcatPath(path)}'`).join("\n"));
+            const args = [
+                "-y", "-f", "concat", "-safe", "0", "-i", listPath,
+                ...(mode === "copy"
+                    ? ["-c", "copy"]
+                    : [
+                        "-c:v", "libx264", "-preset", "medium",
+                        "-crf", String(integerValue(input.crf, "crf", 0, 51, 18)),
+                        "-c:a", "aac", "-b:a", "192k", "-movflags", "+faststart"
+                    ]),
+                outputPath
+            ];
+            return writeResult(outputPath, await run(options.ffmpegCommand, args));
+        }
+        finally {
+            rmSync(temporary, { recursive: true, force: true });
+        }
+    }
+    if (name === "replace_audio") {
+        const videoPath = workspace.input(stringValue(input.videoPath, "videoPath"));
+        const audioPath = workspace.input(stringValue(input.audioPath, "audioPath"));
+        const outputPath = workspace.output(stringValue(input.outputPath, "outputPath"));
+        const volume = input.volume === undefined ? 1 : numberValue(input.volume, "volume", 0, 10);
+        const args = [
+            "-y", "-i", videoPath, "-i", audioPath,
+            "-map", "0:v:0", "-map", "1:a:0",
+            "-c:v", "copy", "-filter:a", `volume=${volume}`,
+            "-c:a", "aac", "-b:a", "192k", "-shortest",
+            outputPath
+        ];
+        return writeResult(outputPath, await run(options.ffmpegCommand, args));
+    }
+    if (name === "extract_frames") {
+        const inputPath = workspace.input(stringValue(input.inputPath, "inputPath"));
+        const patternValue = stringValue(input.outputPattern, "outputPattern");
+        if (!/%(?:0[1-9][0-9]*)?d/u.test(patternValue)) {
+            throw new Error("outputPattern must include a frame counter such as %04d.");
+        }
+        const outputPattern = workspace.outputPattern(patternValue);
+        const args = [
+            "-y",
+            ...(input.startSeconds === undefined ? [] : ["-ss", String(numberValue(input.startSeconds, "startSeconds", 0))]),
+            "-i", inputPath,
+            ...(input.durationSeconds === undefined
+                ? []
+                : ["-t", String(numberValue(input.durationSeconds, "durationSeconds", Number.MIN_VALUE))]),
+            "-vf", `fps=${numberValue(input.fps, "fps", Number.MIN_VALUE, 60)}`,
+            "-q:v", String(integerValue(input.quality, "quality", 2, 31, 2)),
+            outputPattern
+        ];
+        const result = await run(options.ffmpegCommand, args);
+        return framePreviewResult(outputPattern, result, integerValue(input.previewFrames, "previewFrames", 0, 12, 0), workspace.root);
+    }
+    if (name === "reframe_vertical") {
+        const inputPath = workspace.input(stringValue(input.inputPath, "inputPath"));
+        const outputPath = workspace.output(stringValue(input.outputPath, "outputPath"));
+        const width = evenDimension(input.width, "width", 2160, 1080);
+        const height = evenDimension(input.height, "height", 3840, 1920);
+        const focus = enumValue(input.focus, ["left", "center", "right"], "center");
+        const horizontal = focus === "left" ? "0" : focus === "right" ? "iw-ow" : "(iw-ow)/2";
+        const filter = `scale=${width}:${height}:force_original_aspect_ratio=increase,crop=${width}:${height}:${horizontal}:(ih-oh)/2`;
+        const args = [
+            "-y", "-i", inputPath,
+            "-map", "0:v:0", "-map", "0:a?",
+            "-vf", filter,
+            "-c:v", "libx264", "-preset", "medium",
+            "-crf", String(integerValue(input.crf, "crf", 0, 51, 18)),
+            "-c:a", "aac", "-b:a", "192k", "-movflags", "+faststart",
+            outputPath
+        ];
+        return writeResult(outputPath, await run(options.ffmpegCommand, args));
+    }
+    throw new Error(`Unknown FFmpeg tool: ${name}`);
+}
+const X264_PRESETS = [
+    "ultrafast", "superfast", "veryfast", "faster", "fast",
+    "medium", "slow", "slower", "veryslow"
+];
+function videoCodecArguments(codec, input) {
+    if (codec === "prores")
+        return ["-c:v", "prores_ks", "-profile:v", "3"];
+    if (codec === "vp9") {
+        return ["-c:v", "libvpx-vp9", "-crf", String(integerValue(input.crf, "crf", 0, 51, 28)), "-b:v", "0"];
+    }
+    return [
+        "-c:v", codec === "h265" ? "libx265" : "libx264",
+        "-preset", enumValue(input.preset, X264_PRESETS, "medium"),
+        "-crf", String(integerValue(input.crf, "crf", 0, 51, codec === "h265" ? 24 : 18))
+    ];
+}
+function scaleArguments(width, height) {
+    if (width && height) {
+        return ["-vf", `scale=${width}:${height}:force_original_aspect_ratio=decrease,pad=${width}:${height}:(ow-iw)/2:(oh-ih)/2`];
+    }
+    if (width)
+        return ["-vf", `scale=${width}:-2`];
+    if (height)
+        return ["-vf", `scale=-2:${height}`];
+    return [];
+}
+function run(command, args) {
+    return runProcess(command, args, { cwd: workspace.root });
+}
+function writeResult(outputPath, result) {
+    return toolResult({ outputPath, stdout: result.stdout, stderr: result.stderr });
+}
+function parseServerOptions(args) {
+    let workspaceRoot = process.cwd();
+    let ffmpegCommand = "ffmpeg";
+    let ffprobeCommand = "ffprobe";
+    for (let index = 0; index < args.length; index += 2) {
+        const flag = args[index];
+        const value = args[index + 1];
+        if (!flag || value === undefined)
+            throw new Error(`Missing value for ${flag ?? "server option"}.`);
+        if (flag === "--workspace-root")
+            workspaceRoot = value;
+        else if (flag === "--ffmpeg-command")
+            ffmpegCommand = value;
+        else if (flag === "--ffprobe-command")
+            ffprobeCommand = value;
+        else
+            throw new Error(`Unknown FFmpeg MCP server option: ${flag}`);
+    }
+    return { workspaceRoot, ffmpegCommand, ffprobeCommand };
+}
+function escapeConcatPath(value) {
+    return value.replaceAll("'", "'\\''");
+}
+function toolResult(value, isError = false) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(value, null, 2) }],
+        ...(isError ? { isError: true } : {})
+    };
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAW,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EAEvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,WAAW,EACX,WAAW,EACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAQhD,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1D,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;AAC5D,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC5C;IACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;IAC3B,YAAY,EAAE,6EAA6E;CAC5F,CACF,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;AACxF,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IACpF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,UAAU,CAAC,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AAEjD,KAAK,UAAU,QAAQ,CAAC,IAAY,EAAE,KAA8B;IAClE,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QAC7E,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE;YAC/C,IAAI,EAAE,OAAO;YACb,cAAc;YACd,eAAe;YACf,KAAK,EAAE,MAAM;YACb,SAAS;SACV,CAAC,CAAC;QACH,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QAC7E,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;QACjF,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,YAAY,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,eAAe,EAAE,iBAAiB,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACzF,MAAM,IAAI,GAAG;YACX,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC;YACnE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;YAC/B,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC;YAC1D,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YACzD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY;YACxD,UAAU;SACX,CAAC;QACF,OAAO,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QAC7E,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;QACjF,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAU,EAAE,MAAM,CAAC,CAAC;QACzF,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG;YACX,IAAI,EAAE,IAAI,EAAE,SAAS;YACrB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;YAC/B,GAAG,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC;YAChC,GAAG,KAAK;YACR,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YACjF,UAAU;SACX,CAAC;QACF,OAAO,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,cAAc,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7G,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;QACjF,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,CAAU,EAAE,UAAU,CAAC,CAAC;QAC9E,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAC/C,IAAI,CAAC;YACH,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACjG,MAAM,IAAI,GAAG;gBACX,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ;gBAClD,GAAG,CAAC,IAAI,KAAK,MAAM;oBACjB,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC;oBAChB,CAAC,CAAC;wBACE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ;wBACtC,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;wBACzD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY;qBACzD,CAAC;gBACN,UAAU;aACX,CAAC;YACF,OAAO,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC;QACzE,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IACD,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QAC7E,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QAC7E,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3F,MAAM,IAAI,GAAG;YACX,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS;YACtC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;YAChC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,MAAM,EAAE;YAC/C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW;YAC1C,UAAU;SACX,CAAC;QACF,OAAO,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QAC7E,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;QACvE,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG;YACX,IAAI;YACJ,GAAG,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,YAAY,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAChH,IAAI,EAAE,SAAS;YACf,GAAG,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS;gBACrC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,eAAe,EAAE,iBAAiB,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAC5F,KAAK,EAAE,OAAO,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE;YACnE,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;YAChE,aAAa;SACd,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QACtD,OAAO,kBAAkB,CACvB,aAAa,EACb,MAAM,EACN,YAAY,CAAC,KAAK,CAAC,aAAa,EAAE,eAAe,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAC5D,SAAS,CAAC,IAAI,CACf,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,kBAAkB,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QAC7E,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;QACjF,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAU,EAAE,QAAQ,CAAC,CAAC;QACrF,MAAM,UAAU,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;QACtF,MAAM,MAAM,GAAG,SAAS,KAAK,IAAI,MAAM,8CAA8C,KAAK,IAAI,MAAM,IAAI,UAAU,YAAY,CAAC;QAC/H,MAAM,IAAI,GAAG;YACX,IAAI,EAAE,IAAI,EAAE,SAAS;YACrB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;YAC/B,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ;YACtC,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YACzD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY;YACxD,UAAU;SACX,CAAC;QACF,OAAO,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,YAAY,GAAG;IACnB,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM;IACtD,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU;CAC9B,CAAC;AAEX,SAAS,mBAAmB,CAAC,KAAyC,EAAE,KAA8B;IACpG,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC;IACxE,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACxG,CAAC;IACD,OAAO;QACL,MAAM,EAAE,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QAChD,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC;QAC1D,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;KAClF,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAyB,EAAE,MAA0B;IAC3E,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,MAAM,6CAA6C,KAAK,IAAI,MAAM,sBAAsB,CAAC,CAAC;IAC7H,CAAC;IACD,IAAI,KAAK;QAAE,OAAO,CAAC,KAAK,EAAE,SAAS,KAAK,KAAK,CAAC,CAAC;IAC/C,IAAI,MAAM;QAAE,OAAO,CAAC,KAAK,EAAE,YAAY,MAAM,EAAE,CAAC,CAAC;IACjD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,GAAG,CAAC,OAAe,EAAE,IAAc;IAC1C,OAAO,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,WAAW,CAAC,UAAkB,EAAE,MAA0C;IACjF,OAAO,UAAU,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAc;IACxC,IAAI,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAClC,IAAI,aAAa,GAAG,QAAQ,CAAC;IAC7B,IAAI,cAAc,GAAG,SAAS,CAAC;IAC/B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,IAAI,eAAe,GAAG,CAAC,CAAC;QACnG,IAAI,IAAI,KAAK,kBAAkB;YAAE,aAAa,GAAG,KAAK,CAAC;aAClD,IAAI,IAAI,KAAK,kBAAkB;YAAE,aAAa,GAAG,KAAK,CAAC;aACvD,IAAI,IAAI,KAAK,mBAAmB;YAAE,cAAc,GAAG,KAAK,CAAC;;YACzD,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,UAAU,CAAC,KAAc,EAAE,OAAO,GAAG,KAAK;IACjD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtC,CAAC;AACJ,CAAC"}

package/dist/process.d.ts

@@ -0,0 +1,9 @@
+export interface ProcessResult {
+    stdout: string;
+    stderr: string;
+}
+export declare function runProcess(command: string, args: string[], options: {
+    cwd: string;
+    timeoutMs?: number;
+}): Promise<ProcessResult>;
+//# sourceMappingURL=process.d.ts.map

package/dist/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C,OAAO,CAAC,aAAa,CAAC,CAuCxB"}

package/dist/process.js

@@ -0,0 +1,43 @@
+import { spawn } from "node:child_process";
+const MAX_CAPTURE_BYTES = 512 * 1024;
+export function runProcess(command, args, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            env: process.env,
+            shell: false,
+            stdio: ["ignore", "pipe", "pipe"]
+        });
+        let stdout = "";
+        let stderr = "";
+        let capturedBytes = 0;
+        const capture = (target, chunk) => {
+            capturedBytes += chunk.byteLength;
+            if (capturedBytes > MAX_CAPTURE_BYTES) {
+                child.kill("SIGKILL");
+                reject(new Error(`Process output exceeded ${MAX_CAPTURE_BYTES} bytes.`));
+                return;
+            }
+            if (target === "stdout")
+                stdout += chunk.toString();
+            else
+                stderr += chunk.toString();
+        };
+        child.stdout.on("data", (chunk) => capture("stdout", chunk));
+        child.stderr.on("data", (chunk) => capture("stderr", chunk));
+        child.once("error", reject);
+        const timeout = setTimeout(() => {
+            child.kill("SIGKILL");
+            reject(new Error(`Process timed out after ${options.timeoutMs ?? 30 * 60_000}ms.`));
+        }, options.timeoutMs ?? 30 * 60_000);
+        child.once("close", (code, signal) => {
+            clearTimeout(timeout);
+            if (code === 0) {
+                resolve({ stdout: stdout.trim(), stderr: stderr.trim() });
+                return;
+            }
+            reject(new Error(`${command} exited with ${code ?? signal ?? "unknown status"}${stderr.trim() ? `: ${stderr.trim()}` : ""}`));
+        });
+    });
+}
+//# sourceMappingURL=process.js.map

package/dist/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,iBAAiB,GAAG,GAAG,GAAG,IAAI,CAAC;AAOrC,MAAM,UAAU,UAAU,CACxB,OAAe,EACf,IAAc,EACd,OAA4C;IAE5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACjC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,MAAM,OAAO,GAAG,CAAC,MAA2B,EAAE,KAAa,EAAQ,EAAE;YACnE,aAAa,IAAI,KAAK,CAAC,UAAU,CAAC;YAClC,IAAI,aAAa,GAAG,iBAAiB,EAAE,CAAC;gBACtC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACtB,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA2B,iBAAiB,SAAS,CAAC,CAAC,CAAC;gBACzE,OAAO;YACT,CAAC;YACD,IAAI,MAAM,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;;gBAC/C,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAClC,CAAC,CAAC;QACF,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QACrE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtB,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA2B,OAAO,CAAC,SAAS,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC;QACtF,CAAC,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YACnC,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC1D,OAAO;YACT,CAAC;YACD,MAAM,CAAC,IAAI,KAAK,CACd,GAAG,OAAO,gBAAgB,IAAI,IAAI,MAAM,IAAI,gBAAgB,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3G,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tool-input.d.ts

@@ -0,0 +1,9 @@
+export declare function recordValue(value: unknown): Record<string, unknown>;
+export declare function stringValue(value: unknown, name: string): string;
+export declare function arrayValue(value: unknown, name: string, minimum: number, maximum: number): unknown[];
+export declare function numberValue(value: unknown, name: string, minimum: number, maximum?: number): number;
+export declare function integerValue(value: unknown, name: string, minimum: number, maximum: number, fallback?: number): number;
+export declare function evenDimension(value: unknown, name: string, maximum: number, fallback: number): number;
+export declare function optionalEvenDimension(value: unknown, name: string, maximum: number): number | undefined;
+export declare function enumValue<T extends string>(value: unknown, allowed: readonly T[], fallback: T): T;
+//# sourceMappingURL=tool-input.d.ts.map

package/dist/tool-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-input.d.ts","sourceRoot":"","sources":["../src/tool-input.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAInE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAKpG;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,SAA0B,GAChC,MAAM,CAKR;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAMR;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIrG;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvG;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAMjG"}

package/dist/tool-input.js

@@ -0,0 +1,48 @@
+export function recordValue(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+export function stringValue(value, name) {
+    if (typeof value !== "string" || !value.trim())
+        throw new Error(`${name} must be a non-empty string.`);
+    return value;
+}
+export function arrayValue(value, name, minimum, maximum) {
+    if (!Array.isArray(value) || value.length < minimum || value.length > maximum) {
+        throw new Error(`${name} must contain ${minimum} to ${maximum} items.`);
+    }
+    return value;
+}
+export function numberValue(value, name, minimum, maximum = Number.MAX_SAFE_INTEGER) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value < minimum || value > maximum) {
+        throw new Error(`${name} must be a number from ${minimum} to ${maximum}.`);
+    }
+    return value;
+}
+export function integerValue(value, name, minimum, maximum, fallback) {
+    if (value === undefined && fallback !== undefined)
+        return fallback;
+    if (typeof value !== "number" || !Number.isInteger(value) || value < minimum || value > maximum) {
+        throw new Error(`${name} must be an integer from ${minimum} to ${maximum}.`);
+    }
+    return value;
+}
+export function evenDimension(value, name, maximum, fallback) {
+    const dimension = integerValue(value, name, 16, maximum, fallback);
+    if (dimension % 2 !== 0)
+        throw new Error(`${name} must be even.`);
+    return dimension;
+}
+export function optionalEvenDimension(value, name, maximum) {
+    return value === undefined ? undefined : evenDimension(value, name, maximum, 16);
+}
+export function enumValue(value, allowed, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== "string" || !allowed.includes(value)) {
+        throw new Error(`Value must be one of: ${allowed.join(", ")}.`);
+    }
+    return value;
+}
+//# sourceMappingURL=tool-input.js.map

package/dist/tool-input.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const FFMPEG_TOOLS: Tool[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,eAAO,MAAM,YAAY,EAAE,IAAI,EA0H9B,CAAC"}

package/dist/tools.js

@@ -0,0 +1,124 @@
+export const FFMPEG_TOOLS = [
+    {
+        name: "probe_media",
+        description: "Inspect media streams, codecs, dimensions, frame rates, duration, and container metadata.",
+        inputSchema: {
+            type: "object",
+            required: ["inputPath"],
+            properties: { inputPath: { type: "string", minLength: 1 } },
+            additionalProperties: false
+        }
+    },
+    {
+        name: "trim_media",
+        description: "Create a precisely trimmed H.264/AAC clip from a workspace media file.",
+        inputSchema: {
+            type: "object",
+            required: ["inputPath", "outputPath", "startSeconds", "durationSeconds"],
+            properties: {
+                inputPath: { type: "string" },
+                outputPath: { type: "string" },
+                startSeconds: { type: "number", minimum: 0 },
+                durationSeconds: { type: "number", exclusiveMinimum: 0 },
+                crf: { type: "integer", minimum: 0, maximum: 51 },
+                preset: {
+                    type: "string",
+                    enum: ["ultrafast", "superfast", "veryfast", "faster", "fast", "medium", "slow", "slower", "veryslow"]
+                }
+            },
+            additionalProperties: false
+        }
+    },
+    {
+        name: "transcode_media",
+        description: "Transcode video to a reviewed codec, optionally resizing and padding to exact dimensions.",
+        inputSchema: {
+            type: "object",
+            required: ["inputPath", "outputPath"],
+            properties: {
+                inputPath: { type: "string" },
+                outputPath: { type: "string" },
+                codec: { type: "string", enum: ["h264", "h265", "vp9", "prores"] },
+                width: { type: "integer", minimum: 16, maximum: 7680 },
+                height: { type: "integer", minimum: 16, maximum: 7680 },
+                crf: { type: "integer", minimum: 0, maximum: 51 },
+                preset: {
+                    type: "string",
+                    enum: ["ultrafast", "superfast", "veryfast", "faster", "fast", "medium", "slow", "slower", "veryslow"]
+                }
+            },
+            additionalProperties: false
+        }
+    },
+    {
+        name: "concat_media",
+        description: "Stitch two or more normalized media clips in order using FFmpeg's concat demuxer.",
+        inputSchema: {
+            type: "object",
+            required: ["inputPaths", "outputPath"],
+            properties: {
+                inputPaths: { type: "array", minItems: 2, maxItems: 100, items: { type: "string" } },
+                outputPath: { type: "string" },
+                mode: { type: "string", enum: ["copy", "reencode"] },
+                crf: { type: "integer", minimum: 0, maximum: 51 }
+            },
+            additionalProperties: false
+        }
+    },
+    {
+        name: "replace_audio",
+        description: "Replace a video's audio track with a workspace audio file and stop at the shorter stream.",
+        inputSchema: {
+            type: "object",
+            required: ["videoPath", "audioPath", "outputPath"],
+            properties: {
+                videoPath: { type: "string" },
+                audioPath: { type: "string" },
+                outputPath: { type: "string" },
+                volume: { type: "number", minimum: 0, maximum: 10 }
+            },
+            additionalProperties: false
+        }
+    },
+    {
+        name: "extract_frames",
+        description: "Extract a numbered image sequence from a video at a controlled frame rate.",
+        inputSchema: {
+            type: "object",
+            required: ["inputPath", "outputPattern", "fps"],
+            properties: {
+                inputPath: { type: "string" },
+                outputPattern: { type: "string", description: "Workspace path containing a printf counter such as frames/frame-%04d.jpg." },
+                fps: { type: "number", exclusiveMinimum: 0, maximum: 60 },
+                startSeconds: { type: "number", minimum: 0 },
+                durationSeconds: { type: "number", exclusiveMinimum: 0 },
+                quality: { type: "integer", minimum: 2, maximum: 31 },
+                previewFrames: {
+                    type: "integer",
+                    minimum: 0,
+                    maximum: 12,
+                    description: "Explicit opt-in: return this many evenly sampled frames as model-visible images. Defaults to 0. Never use this as a silent substitute for native video understanding."
+                }
+            },
+            additionalProperties: false
+        }
+    },
+    {
+        name: "reframe_vertical",
+        description: "Create a 9:16-style vertical crop with a controlled horizontal focus.",
+        inputSchema: {
+            type: "object",
+            required: ["inputPath", "outputPath"],
+            properties: {
+                inputPath: { type: "string" },
+                outputPath: { type: "string" },
+                width: { type: "integer", minimum: 16, maximum: 2160 },
+                height: { type: "integer", minimum: 16, maximum: 3840 },
+                focus: { type: "string", enum: ["left", "center", "right"] },
+                crf: { type: "integer", minimum: 0, maximum: 51 }
+            },
+            additionalProperties: false
+        }
+    }
+];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/workspace.d.ts

@@ -0,0 +1,11 @@
+export declare class MediaWorkspace {
+    readonly root: string;
+    constructor(root: string);
+    input(value: string, name?: string): string;
+    output(value: string, name?: string): string;
+    outputPattern(value: string): string;
+    private lexical;
+    private assertInside;
+    private existingAncestor;
+}
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAaA,qBAAa,cAAc;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM;IAIxB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAc,GAAG,MAAM;IAQhD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAe,GAAG,MAAM;IAWlD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAQpC,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,gBAAgB;CASzB"}

package/dist/workspace.js

@@ -0,0 +1,59 @@
+import { existsSync, mkdirSync, realpathSync } from "node:fs";
+import { dirname, isAbsolute, relative, resolve } from "node:path";
+import { matchingFramePaths } from "./frame-preview.js";
+export class MediaWorkspace {
+    root;
+    constructor(root) {
+        this.root = realpathSync(resolve(root));
+    }
+    input(value, name = "inputPath") {
+        const candidate = this.lexical(value, name);
+        if (!existsSync(candidate))
+            throw new Error(`${name} does not exist: ${value}`);
+        const real = realpathSync(candidate);
+        this.assertInside(real, name);
+        return real;
+    }
+    output(value, name = "outputPath") {
+        const candidate = this.lexical(value, name);
+        if (existsSync(candidate))
+            this.assertInside(realpathSync(candidate), name);
+        const parent = dirname(candidate);
+        const existingAncestor = this.existingAncestor(parent);
+        this.assertInside(realpathSync(existingAncestor), name);
+        mkdirSync(parent, { recursive: true });
+        this.assertInside(realpathSync(parent), name);
+        return candidate;
+    }
+    outputPattern(value) {
+        const pattern = this.output(value, "outputPattern");
+        for (const existingPath of matchingFramePaths(pattern)) {
+            this.assertInside(realpathSync(existingPath), "outputPattern");
+        }
+        return pattern;
+    }
+    lexical(value, name) {
+        if (!value.trim())
+            throw new Error(`${name} must be a non-empty path.`);
+        const candidate = resolve(this.root, value);
+        this.assertInside(candidate, name);
+        return candidate;
+    }
+    assertInside(candidate, name) {
+        const relation = relative(this.root, candidate);
+        if (relation.startsWith("..") || isAbsolute(relation)) {
+            throw new Error(`${name} must stay inside ${this.root}.`);
+        }
+    }
+    existingAncestor(value) {
+        let candidate = value;
+        while (!existsSync(candidate)) {
+            const parent = dirname(candidate);
+            if (parent === candidate)
+                break;
+            candidate = parent;
+        }
+        return candidate;
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@assemblyline-agents/ffmpeg",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "@assemblyline-agents/core": "0.1.0"
+  },
+  "description": "Official OpenEve workspace-scoped FFmpeg connection plugin.",
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jasonbadeaux/openeve.git",
+    "directory": "packages/ffmpeg"
+  },
+  "bugs": {
+    "url": "https://github.com/jasonbadeaux/openeve/issues"
+  },
+  "homepage": "https://github.com/jasonbadeaux/openeve#readme",
+  "author": "OpenEve contributors",
+  "keywords": [
+    "openeve",
+    "ai",
+    "agents",
+    "ffmpeg",
+    "video",
+    "audio",
+    "media",
+    "plugin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/skills/ffmpeg/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: ffmpeg
+description: Inspect, trim, normalize, stitch, re-audio, extract, and vertically reframe media with typed FFmpeg tools.
+---
+# FFmpeg
+
+Use `probe_media` before editing unfamiliar media. Record the duration, video
+dimensions, frame rate, codecs, audio layout, and rotation metadata so edits
+are based on the actual streams.
+
+For a social recut:
+
+1. Build a paper edit with source paths and exact in/out seconds.
+2. Trim each selected beat to a new clip.
+3. Normalize clips from different sources with `transcode_media`.
+4. Stitch normalized clips in narrative order with `concat_media`.
+5. Replace or add the intended audio track.
+6. Use `reframe_vertical` for a 9:16 delivery.
+
+Prefer native video understanding for review. If the selected model cannot
+process video natively, say so and stop; do not silently approximate the video
+with sampled frames. Call `extract_frames` with an explicit `previewFrames`
+value only when the user specifically requests or approves a frame-based
+review. Its default is zero, so ordinary frame extraction returns paths only.
+
+Prefer short shots with a clear visual purpose. Keep the hook readable in the
+first seconds, preserve speech boundaries, and avoid jump cuts that clip words
+or gestures. Do not claim to have watched a video when only still frames were
+provided, and do not treat sampled frames as equivalent to temporal review.
+
+Every editing tool writes files and requires the connection's configured write
+authority. Never attempt to escape the media workspace or work around the typed
+operations with arbitrary FFmpeg flags. Do not remove watermarks, attribution,
+or rights-management signals, and only transform media the user is authorized
+to use.