davinci-resolve-mcp 2.113.0 → 2.114.0

package/docs/reference/api-limitations.md

@@ -529,7 +529,7 @@ values, or automation-hostile modal prompts.
 ### MediaTimemapBA keyframes are generation-split; 19.x silently ignores the R21 protobuf form
 
 - **Object:** `Sm2TimeMap (per-clip retime blob)`
-- **Behavior:** Resolve 21 encodes a retimed clip's KeyframesBA as protobuf points; Resolve 19.1.3 encodes it as a keyed-dict of keyed-dict keyframes ({interp, YOut, YIn, Y, XOut, XIn, X}). On import, 19 SILENTLY IGNORES the protobuf form — the clip reads back and plays at 100% with no warning (measured: identical timelines, one per form; protobuf → source 0..96 over 96 frames, keyed → source 0..48 over 96 frames and a live 50% render). The map spans the WHOLE source stretched by 1/speed; the clip's <In>/<Duration> window into it in RECORD frames (srcIn converts by /speed).
+- **Behavior:** Resolve 21 encodes a retimed clip's KeyframesBA as protobuf points; Resolve 19.1.3 encodes it as a keyed-dict of keyed-dict keyframes ({interp, YOut, YIn, Y, XOut, XIn, X}). On import, 19 SILENTLY IGNORES the protobuf form — the clip reads back and plays at 100% with no warning (measured: identical timelines, one per form; protobuf → source 0..96 over 96 frames, keyed → source 0..48 over 96 frames and a live 50% render). The map spans the WHOLE source stretched by 1/speed; the clip's <In>/<Duration> window into it in RECORD frames (srcIn converts by /speed). REVERSE is the same envelope with the Y endpoints swapped - kf0=(0,YMax), kf1=(XMax,0) - and In then measures from the source END: (frames - srcIn - dur*speed)/speed (measured: a reversed srcIn-24 dur-48 cut reads back source 71->23).
 - **Workaround / current handling:** Author retimes for pre-21 hosts with the keyed form (drt.assemble cuts[].speed does this; encoder byte-exact against a live 19.1.3.7 harvest). Treat any cross-generation timemap as unverified until a readback shows the retimed source range.
 - **Tags:** retime, import, silent-failure, drt
 

package/install.py

@@ -37,7 +37,7 @@ from src.utils.update_check import (
 
 # ─── Version ──────────────────────────────────────────────────────────────────
 
-VERSION = "2.113.0"
+VERSION = "2.114.0"
 # Only hard floor: mcp[cli] requires Python 3.10+. There is no upper bound —
 # Resolve's scripting bridge loads into newer interpreters on recent builds
 # (Python 3.14 verified against Resolve Studio 20.3.2). Older Resolve builds

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "davinci-resolve-mcp",
-  "version": "2.113.0",
+  "version": "2.114.0",
   "description": "NPM bootstrapper for the DaVinci Resolve MCP Server.",
   "license": "MIT",
   "author": "Samuel Gursky <samgursky@gmail.com>",

package/resolve-advanced/server/author-interchange.mjs

@@ -202,9 +202,8 @@ export function eventsToOTIO(events, opts = {}) {
  * timeline runs 24fps with origin 86400, so rec/src frames convert as
  * round(frames × 24 / nominalFps). Placement anchors the EARLIEST video
  * event at the origin. Honesty ledger in the returned report: flattened
- * reverse retimes (forward constant speeds are AUTHORED as real Sm2TimeMaps
- * — r19 keyed form, render/readback-verified; reverse flattens with the
- * reason), authored vs
+ * zero-speed freezes (constant retimes — forward AND reverse — are AUTHORED
+ * as real Sm2TimeMaps, r19 keyed form, readback/render-verified), authored vs
  * dropped transitions (cross-dissolves are AUTHORED when the predecessor
  * abuts the cut and both sides have handle media — render-verified on
  * 19.1.3.7; otherwise dropped with the reason, as a cut at the boundary),
@@ -258,15 +257,17 @@ export function eventsToAssembleSpec(events, opts = {}) {
     const vTrack = trackNum(e.track);
     const cut = { startFrame: recIn, durationFrames, srcIn: toTl(e.srcIn ?? 0, e.fps), ...(vTrack > 1 ? { track: vTrack } : {}) };
     if ((e.speed ?? 100) !== 100 || e.reverse) {
-      if (e.reverse || !(e.speed > 0)) {
-        // Reverse needs a descending timemap (not yet measured) — flatten, with the reason.
-        flattenedRetimes.push({ index: e.index, source: e.source, speed: e.speed, reverse: !!e.reverse, reason: 'reverse not supported — played forward at 100%' });
+      const spd = Math.abs(e.speed ?? 100);
+      if (!(spd > 0)) {
+        flattenedRetimes.push({ index: e.index, source: e.source, speed: e.speed, reverse: !!e.reverse, reason: 'zero speed (freeze) not supported — played forward at 100%' });
       } else {
-        // Forward constant speed: authored as a real Sm2TimeMap on the cut
-        // (r19 keyed form; render/readback-verified on 19.1.3.7). Audio for
-        // retimed cuts is video-only downstream.
-        cut.speed = e.speed / 100;
-        authoredRetimes.push({ index: e.index, source: e.source, speed: e.speed });
+        // Constant speed, forward or reverse: authored as a real Sm2TimeMap
+        // on the cut (r19 keyed form; readback/render-verified on 19.1.3.7 —
+        // reverse reads back source 71→23 for a srcIn-24 dur-48 cut). Audio
+        // for retimed cuts is video-only downstream.
+        if (spd !== 100) cut.speed = spd / 100;
+        if (e.reverse) cut.reverse = true;
+        authoredRetimes.push({ index: e.index, source: e.source, speed: spd, ...(e.reverse ? { reverse: true } : {}) });
       }
     }
     if (e.transition) {

package/resolve-advanced/server/tools/drt.mjs

@@ -46,7 +46,7 @@ const assembleSchema = z.object({
   spec: z
     .object({})
     .passthrough()
-    .describe("assembleTimeline spec: { timelineName?, media?: {mediaFilePath, spec:{width,height,frameCount,fps}, cuts:[{startFrame,durationFrames,srcIn?,track? (1-based video track; >1 = video-only, render-verified stacking),speed? (forward constant retime, e.g. 0.5; video-only; render-verified on 19)}]} | [same, ...] (multi-source needs media_pool.capture_media_template run once per file), elements?: [{type:'title'|'generator', track, startFrame, durationFrames?, text?, generatorName? ('Solid Color'|'SMPTE Color Bar'|'Grey Scale' render-verified on 19), ...}], transitions? }. startFrame is timeline-absolute (origin 86400)."),
+    .describe("assembleTimeline spec: { timelineName?, media?: {mediaFilePath, spec:{width,height,frameCount,fps}, cuts:[{startFrame,durationFrames,srcIn?,track? (1-based video track; >1 = video-only, render-verified stacking),speed?/reverse? (constant retime, e.g. 0.5, forward or backwards; video-only; readback+render-verified on 19)}]} | [same, ...] (multi-source needs media_pool.capture_media_template run once per file), elements?: [{type:'title'|'generator', track, startFrame, durationFrames?, text?, generatorName? ('Solid Color'|'SMPTE Color Bar'|'Grey Scale' render-verified on 19), ...}], transitions? }. startFrame is timeline-absolute (origin 86400)."),
   outputPath: z.string().describe('Absolute path where the importable .drt will be written'),
   targetAppVersion: z
     .union([z.string(), z.number()])

package/resolve-advanced/vendor/drp-format/assemble-timeline.js

@@ -114,19 +114,28 @@ async function assembleTimeline(spec = {}) {
     sources.forEach((src, i) => {
       (src.cuts || []).forEach((cut) => {
         const out = mediaRefs[i] ? { ...cut, mediaRef: mediaRefs[i] } : { ...cut };
-        if (cut.speed !== undefined && cut.speed !== 1) {
+        if (cut.reverse || (cut.speed !== undefined && cut.speed !== 1)) {
           // Constant-speed retime (forward only). The Sm2TimeMap spans the
           // whole source stretched by 1/speed; the clip windows into it with
           // RECORD-domain In/Duration (measured live on 19.1.3.7), so the
           // source-domain srcIn converts by /speed here.
-          if (!(cut.speed > 0)) throw new RangeError('assembleTimeline: cut.speed must be > 0 (reverse not supported)');
+          const speed = cut.speed ?? 1;
+          if (!(speed > 0)) throw new RangeError('assembleTimeline: cut.speed must be > 0 (use cut.reverse for backwards)');
           const fps = Math.round(src.spec.fps || 24);
           out.timemap = buildConstantSpeedTimemapKeyed({
-            speed: cut.speed, sourceFrames: src.spec.frameCount, fps,
-            uniqueId: randomUUID(),
+            speed, sourceFrames: src.spec.frameCount, fps,
+            uniqueId: randomUUID(), reverse: !!cut.reverse,
           }).toString('hex');
-          out.srcIn = Math.round((cut.srcIn ?? 0) / cut.speed);
+          // Record-domain In. Forward: srcIn/speed. Reverse: the clip plays
+          // source [srcIn, srcIn + dur*speed) BACKWARDS — the map descends
+          // from the source tail, so In measures from the END:
+          // (sourceFrames - srcIn - dur*speed)/speed  (measured live: In=0
+          // on a reversed full-speed clip reads back source 191→143).
+          out.srcIn = cut.reverse
+            ? Math.round((src.spec.frameCount - (cut.srcIn ?? 0) - cut.durationFrames * speed) / speed)
+            : Math.round((cut.srcIn ?? 0) / speed);
           delete out.speed;
+          delete out.reverse;
         }
         allCuts.push(out);
       });

package/resolve-advanced/vendor/drp-format/media-timemap.js

@@ -227,8 +227,8 @@ function buildConstantSpeedTimemap({ speed, sourceDurationSec, uniqueId, recordD
  * @param {string} p.uniqueId     - fresh uuid (bare, no braces).
  * @returns {Buffer}
  */
-function buildConstantSpeedTimemapKeyed({ speed, sourceFrames, fps = 24, uniqueId }) {
-  if (!(speed > 0)) throw new RangeError('buildConstantSpeedTimemapKeyed: speed must be > 0 (reverse not supported here)');
+function buildConstantSpeedTimemapKeyed({ speed, sourceFrames, fps = 24, uniqueId, reverse = false }) {
+  if (!(speed > 0)) throw new RangeError('buildConstantSpeedTimemapKeyed: speed must be > 0 (pass reverse:true for backwards)');
   if (!Number.isInteger(sourceFrames) || sourceFrames < 1) throw new TypeError('buildConstantSpeedTimemapKeyed: sourceFrames must be a positive integer');
   const YMax = (sourceFrames - 1) / fps;
   const XMax = (sourceFrames / speed - 1) / fps;
@@ -241,9 +241,13 @@ function buildConstantSpeedTimemapKeyed({ speed, sourceFrames, fps = 24, uniqueI
     { key: 'XIn', type: T_DOUBLE, subType: 0, value: 0 },
     { key: 'X', type: T_DOUBLE, subType: 0, value: X },
   ] }).toString('hex');
+  // Reverse (harvested from a live 19.1.3.7 -100% XMEML retime): the SAME
+  // envelope with the Y endpoints swapped — kf0=(0, YMax), kf1=(XMax, 0),
+  // a descending line. Forward keeps kf1 Y = XMax*speed (harvest: +half-frame
+  // convention falls out of the arithmetic, byte-exact either way).
   const keyframes = encodeKeyedDict({ hdr: 1, entries: [
-    { key: '1', type: T_BYTES, subType: 0, value: kf(XMax, XMax * speed) },
-    { key: '0', type: T_BYTES, subType: 0, value: kf(0, 0) },
+    { key: '1', type: T_BYTES, subType: 0, value: reverse ? kf(XMax, 0) : kf(XMax, XMax * speed) },
+    { key: '0', type: T_BYTES, subType: 0, value: reverse ? kf(0, YMax) : kf(0, 0) },
   ] }).toString('hex');
   return encodeKeyedDict({ hdr: 1, entries: [
     { key: 'YMax', type: T_DOUBLE, subType: 0, value: YMax },

package/src/granular/common.py

@@ -87,7 +87,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "2.113.0"
+VERSION = "2.114.0"
 logger = logging.getLogger("davinci-resolve-mcp")
 logger.info(f"Starting DaVinci Resolve MCP Server v{VERSION}")
 logger.info(f"Detected platform: {get_platform()}")

package/src/server.py

@@ -11,7 +11,7 @@ Usage:
     python src/server.py --full       # Start the 353-tool granular server instead
 """
 
-VERSION = "2.113.0"
+VERSION = "2.114.0"
 
 import base64
 import os

package/src/utils/api_truth.py

@@ -1927,7 +1927,11 @@ API_TRUTH: List[Dict[str, Any]] = [
                    "source 0..48 over 96 frames and a live 50% render). "
                    "The map spans the WHOLE source stretched by 1/speed; "
                    "the clip's <In>/<Duration> window into it in RECORD "
-                   "frames (srcIn converts by /speed).",
+                   "frames (srcIn converts by /speed). REVERSE is the same "
+                   "envelope with the Y endpoints swapped - kf0=(0,YMax), "
+                   "kf1=(XMax,0) - and In then measures from the source "
+                   "END: (frames - srcIn - dur*speed)/speed (measured: a "
+                   "reversed srcIn-24 dur-48 cut reads back source 71->23).",
         "recommended": "Author retimes for pre-21 hosts with the keyed "
                        "form (drt.assemble cuts[].speed does this; encoder "
                        "byte-exact against a live 19.1.3.7 harvest). Treat "