@assemblyline-agents/ffmpeg 5.0.10 → 6.0.0

package/README.md

@@ -21,20 +21,22 @@ apt-get update && apt-get install -y ffmpeg
 assembly-line add ffmpeg agent
 ```
 
-The generated connection enables every reviewed media operation without
-requiring an approval surface:
-
-```ts
-import { defineFfmpegConnection } from "@assemblyline-agents/ffmpeg";
-
-export default defineFfmpegConnection({
-  workspaceRoot: "/workspace/media"
-});
+The selected plugin enables every reviewed media operation. Require approval
+for editing operations with typed connection exceptions:
+
+```yaml
+capabilities:
+  ffmpeg:
+    connections:
+      ffmpeg:
+        approval:
+          trim_media: always
+          transcode_media: always
+          concat_media: always
+          replace_audio: always
+          reframe_vertical: always
 ```
 
-Set `access: "approval-required"` if editing operations should pause for
-approval.
-
 The connection exposes:
 
 - `probe_media`
@@ -45,7 +47,7 @@ The connection exposes:
 - `extract_frames`
 - `reframe_vertical`
 
-All input and output paths must resolve inside `workspaceRoot`, including
+All input and output paths must resolve inside the plugin-owned workspace root, including
 symlink targets. The deployment owner can select trusted `ffmpegCommand` and
 `ffprobeCommand` paths; agents cannot replace those executables or add
 unreviewed flags.
@@ -54,8 +56,8 @@ unreviewed flags.
 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
+`extract_frames` returns paths only by default. A custom plugin implementation
+may set `previewFrames` from one through twelve 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/ai.assemblyline/connections/ffmpeg.json

@@ -0,0 +1,51 @@
+{
+  "kind": "ffmpeg",
+  "role": "connection",
+  "packageName": "@assemblyline-agents/ffmpeg",
+  "helper": "defineFfmpegConnection",
+  "protocol": "mcp",
+  "transport": "stdio",
+  "provider": "ffmpeg",
+  "description": "Workspace-scoped media inspection, trimming, transcoding, stitching, audio replacement, frame extraction, and vertical reframing through FFmpeg.",
+  "capabilities": [
+    "mcp",
+    "live-tools",
+    "stdio"
+  ],
+  "scopes": [],
+  "subject": "environment",
+  "tools": {
+    "allow": [
+      "probe_media",
+      "trim_media",
+      "transcode_media",
+      "concat_media",
+      "replace_audio",
+      "extract_frames",
+      "reframe_vertical"
+    ]
+  },
+  "readToolPatterns": [
+    "probe_media"
+  ],
+  "writeToolPatterns": [
+    "trim_media",
+    "transcode_media",
+    "concat_media",
+    "replace_audio",
+    "extract_frames",
+    "reframe_vertical"
+  ],
+  "setup": [
+    {
+      "kind": "connection",
+      "name": "ffmpeg-developer-configuration",
+      "required": true,
+      "message": "Install ffmpeg and ffprobe on the Assembly Line runtime host. The plugin keeps all media paths inside its configured workspace root and exposes typed operations instead of arbitrary FFmpeg flags."
+    }
+  ],
+  "requiredConfig": [],
+  "optionalConfig": [],
+  "requiredCredentials": [],
+  "optionalCredentials": []
+}

package/ai.assemblyline/index.cjs

@@ -0,0 +1,9 @@
+module.exports = {
+  "connections": {
+    "ffmpeg": {
+      "contract": "./ai.assemblyline/connections/ffmpeg.json",
+      "definition": "@assemblyline-agents/ffmpeg",
+      "factory": "defineFfmpegConnection"
+    }
+  }
+};

package/dist/index.d.ts.map

@@ -1 +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,2IAuBtE;AAED,eAAO,MAAM,kBAAkB,kDAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,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,2IAuBtE;AAED,eAAO,MAAM,kBAAkB,kDAA0C,CAAC"}

package/dist/index.js

@@ -1,7 +1,8 @@
+import connectionContract_ffmpeg from "../ai.assemblyline/connections/ffmpeg.json" with { type: "json" };
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { connectionPluginMetadata, definePlugin, defineStdioMcpPluginConnection } from "@assemblyline-agents/core";
-const PLUGIN = connectionPluginMetadata("ffmpeg");
+import { definePlugin, defineStdioMcpPluginConnection } from "@assemblyline-agents/core";
+const PLUGIN = connectionContract_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;

package/dist/index.js.map

@@ -1 +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,kBAAkB,GAAG,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,yBAAyB,MAAM,4CAA4C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACzG,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,8BAA8B,EAE/B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,GAAG,yBAAgE,CAAC;AAChF,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,kBAAkB,GAAG,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assemblyline-agents/ffmpeg",
-  "version": "5.0.10",
+  "version": "6.0.0",
   "type": "module",
   "exports": {
     ".": {
@@ -10,11 +10,13 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@assemblyline-agents/core": "5.0.10"
+    "@assemblyline-agents/core": "6.0.0"
   },
   "description": "Official Assembly Line workspace-scoped FFmpeg connection plugin.",
   "files": [
-    "dist"
+    "dist",
+    "plugin.json",
+    "ai.assemblyline"
   ],
   "engines": {
     "node": ">=22.19.0"

package/plugin.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "ffmpeg",
+  "version": "6.0.0",
+  "description": "Official Assembly Line workspace-scoped FFmpeg connection plugin.",
+  "extensions": {
+    "ai.assemblyline": {
+      "entry": "./ai.assemblyline/index.cjs"
+    }
+  }
+}