davinci-resolve-mcp 2.178.0 → 2.180.0

package/CHANGELOG.md

@@ -2,6 +2,35 @@
 
 Release history for the DaVinci Resolve MCP Server. The latest release is summarized in the root README; older entries live here to keep the README focused.
 
+## What's New in v2.180.0 — E126: the sequence picker knows a nested composition from a turnover
+
+### Added
+
+- **`list_sequences` flags nested AAF compositions.** An Avid nested sequence
+  (a composition another composition uses as a clip) listed as a peer of the
+  timeline that uses it, so a "which sequence?" picker offered the inner
+  composition as a turnover of its own. Each AAF sequence now reports
+  `nests` (the compositions it flattens) and `nestedIn` (the sequences that
+  use it); nested compositions still list — their cuts also arrive flattened
+  inside the parent (E125) — but a picker can demote them.
+
+## What's New in v2.179.0 — E125: an Avid nested sequence used as a clip flattens into the parent
+
+### Fixed
+
+- **A nested sequence in an AAF turnover was an unmapped reel.** A
+  SourceClip that references a NAMED CompositionMob is an Avid nested
+  timeline used as a clip; the walker's reference chase stopped at the first
+  named mob and emitted the composition's name as a source reel while its own
+  cuts sat in the same AAF. The walk now descends into the named
+  composition's editorial slot and translates its cuts through the
+  reference's window (source trimmed at each cut's play rate), tagging
+  `fromCompound` — the OTIO Stack flatten (E120) for AAF. Unnamed
+  intermediate compositions (subclips, group clips) keep the reference
+  chase. Render-verified on 19.1.3.7: the flattened turnover conforms and
+  plays the nested sequence's white insert exactly where the parent used it
+  (234 across its 24 frames, picture either side).
+
 ## What's New in v2.178.0 — E124: the manifest and the changelist know a compound when they see one
 
 ### Fixed

package/README.md

@@ -2,7 +2,7 @@
 
 English | [简体中文](README.zh-CN.md)
 
-[![Version](https://img.shields.io/badge/version-2.178.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.180.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
 [![npm](https://img.shields.io/npm/v/davinci-resolve-mcp.svg?label=npm&color=CB3837)](https://www.npmjs.com/package/davinci-resolve-mcp)
 [![API Coverage](https://img.shields.io/badge/API%20Coverage-100%25-brightgreen.svg)](docs/reference/api-coverage.md)
 [![Tools](https://img.shields.io/badge/MCP%20Tools-36%20(353%20full)-blue.svg)](#server-modes)

package/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | 简体中文
 
-[![Version](https://img.shields.io/badge/version-2.178.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.180.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
 [![npm](https://img.shields.io/npm/v/davinci-resolve-mcp.svg?label=npm&color=CB3837)](https://www.npmjs.com/package/davinci-resolve-mcp)
 [![API Coverage](https://img.shields.io/badge/API%20Coverage-100%25-brightgreen.svg)](docs/reference/api-coverage.md)
 [![Tools](https://img.shields.io/badge/MCP%20Tools-36%20(353%20full)-blue.svg)](#服务器模式)
@@ -12,7 +12,7 @@
 [![Python](https://img.shields.io/badge/python-3.10+-green.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-> 本翻译对应 v2.178.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
+> 本翻译对应 v2.180.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
 
 一个 Model Context Protocol (MCP) 服务器，让 AI 助手通过官方脚本 API 控制 DaVinci Resolve Studio（达芬奇）。它提供完整的 API 覆盖，外加带护栏的工作流助手，涵盖剪辑、媒体池整理、渲染设置、审阅标记、调色、Fusion、Fairlight、项目生命周期任务、扩展开发，以及不碰源媒体的媒体分析。
 

package/install.py

@@ -37,7 +37,7 @@ from src.utils.update_check import (
 
 # ─── Version ──────────────────────────────────────────────────────────────────
 
-VERSION = "2.178.0"
+VERSION = "2.180.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.178.0",
+  "version": "2.180.0",
   "description": "NPM bootstrapper for the DaVinci Resolve MCP Server.",
   "license": "MIT",
   "author": "Samuel Gursky <samgursky@gmail.com>",

package/resolve-advanced/server/aaf.mjs

@@ -103,6 +103,9 @@ function sequenceSummary(s) {
     startFrame: s.startFrame ?? null,
     startTimecodeFps: s.startTimecodeFps ?? null,
     startTimecodeDrop: s.startTimecodeDrop ?? null,
+    // E126: a composition another composition uses as a clip is NESTED — a
+    // picker should not offer it as a turnover of its own.
+    nestedIn: Array.isArray(s.nestedIn) ? s.nestedIn : [],
   };
   if (s.unhandled && Object.keys(s.unhandled).length) out.unhandled = s.unhandled;
   return out;

package/resolve-advanced/server/aaf_probe.py

@@ -418,6 +418,35 @@ def _source_position_fields(clip):
     return fields
 
 
+def _nested_named_composition(clip):
+    """(CompositionMob, inner segment) when `clip` references a NAMED CompositionMob
+    whose referenced slot holds editorial content — an Avid nested sequence used as a
+    clip (E125). None for MasterMobs and for the unnamed intermediate compositions
+    that subclips and group clips route through (those keep the reference chase)."""
+    try:
+        mob = getattr(clip, "mob", None)
+    except Exception:
+        return None
+    if mob is None or type(mob).__name__ != "CompositionMob" or not _usable_name(mob):
+        return None
+    try:
+        slot_id = getattr(clip, "slot_id", None)
+        slot = None
+        for candidate in getattr(mob, "slots", []) or []:
+            if slot_id is None or getattr(candidate, "slot_id", None) == slot_id:
+                if _is_editorial_slot(candidate):
+                    slot = candidate
+                    break
+        if slot is None:
+            return None
+        segment = getattr(slot, "segment", None)
+    except Exception:
+        return None
+    if segment is None:
+        return None
+    return mob, segment
+
+
 def _emit_source_clip(clip, *, index, track, rec, fps, transition=None):
     """Turn a SourceClip into a normalized event. Returns (event, length)."""
     try:
@@ -1050,6 +1079,47 @@ def _walk_segment(segment, *, track, fps, rec, state, depth=0, transition=None):
         return declared
 
     if cls == "SourceClip":
+        # NESTED SEQUENCE (E125): a SourceClip that references a NAMED
+        # CompositionMob is an Avid nested timeline used as a clip. Its inner
+        # cuts are right here in the AAF, so flatten them into this record
+        # position through the reference's window (start/length) — the way
+        # OTIO Stacks flatten (E120) — instead of emitting the composition's
+        # NAME as a source reel the bridge cannot map. Unnamed compositions
+        # (subclips, group clips) keep the reference chase.
+        nested = _nested_named_composition(segment)
+        if nested is not None and depth < _MAX_DEPTH:
+            comp_mob, inner_segment = nested
+            state.setdefault("nestedRefs", set()).add(_usable_name(comp_mob))
+            length = _length(segment)
+            try:
+                start = int(getattr(segment, "start", 0) or 0)
+            except Exception:
+                start = 0
+            sub = {"idx": 1, "events": [], "unhandled": state.setdefault("unhandled", {}), "effectsWithoutEvents": state.setdefault("effectsWithoutEvents", {})}
+            _walk_segment(inner_segment, track=track, fps=fps, rec=0, state=sub, depth=depth + 1)
+            first = True
+            for ev in sub["events"]:
+                if ev.get("recIn") is None or ev.get("recOut") is None:
+                    continue
+                a, b = ev["recIn"] - start, ev["recOut"] - start
+                a2, b2 = max(0, a), min(length, b)
+                if b2 <= a2:
+                    continue
+                k = (float(ev.get("speed") or 100) / 100.0) * (-1 if ev.get("reverse") else 1)
+                flat = dict(ev)
+                flat["index"] = state["idx"]
+                flat["recIn"], flat["recOut"] = rec + a2, rec + b2
+                if flat.get("srcIn") is not None:
+                    flat["srcIn"] = int(round(flat["srcIn"] + (a2 - a) * k))
+                if flat.get("srcOut") is not None:
+                    flat["srcOut"] = int(round(flat["srcOut"] - (b - b2) * k))
+                flat["fromCompound"] = _usable_name(comp_mob)
+                if first and transition is not None and not flat.get("transition"):
+                    flat["transition"] = transition
+                first = False
+                state["events"].append(flat)
+                state["idx"] += 1
+            return length
         ev, length = _emit_source_clip(
             segment, index=state["idx"], track=track, rec=rec, fps=fps, transition=transition
         )
@@ -1509,9 +1579,24 @@ def probe(path):
                     # A conform that silently loses 29 titles looks exactly like a
                     # conform that had none. Counted by operation name so it cannot.
                     "effectsWithoutEvents": dict(sorted(state.get("effectsWithoutEvents", {}).items())),
+                    # Compositions this sequence uses as clips (E126): the picker
+                    # should not offer a NESTED sequence as a turnover of its own.
+                    "nests": sorted(state.get("nestedRefs", set())),
+                    "nestedIn": [],
                     "events": events,
                 }
             )
+    # A composition used as a clip by another composition is NESTED in it — flag the
+    # child so a "which sequence?" picker can demote it (it still lists; its cuts also
+    # arrive flattened inside the parent, E125).
+    by_name = {}
+    for seq in sequences:
+        by_name.setdefault(seq["name"], []).append(seq)
+    for parent in sequences:
+        for child_name in parent.get("nests", []):
+            for child in by_name.get(child_name, []):
+                if child is not parent and parent["name"] not in child["nestedIn"]:
+                    child["nestedIn"].append(parent["name"])
     return sequences
 
 

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

@@ -86,7 +86,7 @@ const markerSchema = z.object({
 export const editorialTool = {
   name: 'editorial',
   description:
-    'Editorial integrity (Cluster E) — turnover interchange → normalized events → changelist + conform manifest with TIMING silent-lie guards (flattened retime / dropped J/L-cut audio / framerate-pulldown slip / reverse dropped / transition-handle starvation → flag, skip-not-fake). Report-only (gate: review). Actions: parse_interchange (EDL/OTIO/XMEML natively — incl. Resolve-written OTIO generator clips (a Solid Color is a Clip with a NULL media_reference; it walks as a BL leg with generatorName, and an OTIO GeneratorReference carries its colour) and nested OTIO Stacks (compound clips — Resolve\'s writer nests them with a trim window) FLATTEN into record time with fromCompound on each cut, so Resolve\'s own OTIO exports re-conform (its FCP7 XML writer flattens a compound to ONE media-less clipitem instead — tagged `compound`, which the bridge drops with a reason in unresolvedCompounds unless the sourceMap maps the compound name to a flattened media file), Resolve-written FCP7 -1 junction edges (paired in record order) + Solid Color / Color Matte generators carrying their `fillcolor` (BL legs with `color` → fade-to-white and colour mattes author, E110), XMEML audio-track transitionitems as audio cross-fades on numbered lanes A/A2/…, and CMX FROM/TO CLIP NAME comments over the generic AX reel — + AAF via pyaaf2 (flat sound/picture slots number A/A2/… and V/V2/… in slot order so separate beds keep their lanes; NestedScope layers keep layer numbering) + PRPROJ via gunzip+XML → normalized events incl. span-explicit transitions, BL fade legs, and freezes as zero-speed events (OTIO FreezeFrame, XMEML timeremap 0, PrProj in==out, AAF 0% motion effects); for AAF/PRPROJ pass the file PATH as content; AAF also returns per-sequence startTimecode/startFrame — build the timeline at THAT start, not the Resolve 01:00:00:00 default — and per-clip `geometry` for Avid transform effects), list_sequences (ONE offline picker entry point across xml/edl/otio/drt/drp/aaf/prproj → [{id,name,eventCount}], plus startTimecode/startFrame for AAF), convert_to_interchange (author OTIO/EDL/DRT Resolve CAN import from events or a parsed source; the EDL target writes CMX transition pairs incl. BL fades — the .prproj→Resolve conform bridge, no Premiere needed; editorial timing/transitions survive and per-clip effects/color do not. SPEED/REVERSE survive on the otio (LinearTimeWarp) and edl (M2) targets ONLY — this FLAT drt target flattens every retime to 100% forward and returns `flattened`/`flattenedCount` naming each event that lost one (`flattened` is always present on `drt`, empty when there were none); for a .drt that AUTHORS retimes/dissolves/multi-track/audio, use drt.assemble_from_interchange), turnover_changelist (diff old vs new → moved/retimed/trimmed/replaced/new/gone PLUS the junction diff: transition_added/transition_dropped/transition_changed with fade in/out or dissolve, outgoing/incoming, span and duration/type/pre-roll deltas — zero-length CMX carrier lines and the BL legs that carry fades fold into the junction diff instead of reading as gone/new sources; events pair by closest record position, consumed once, so a source cut twice at two speeds compares instance to instance; + timing flags incl. transition_dropped and dropped_split_audio on any A-track; a compound seen collapsed in one cut and flattened in the other reports compound_collapsed/compound_expanded once, never replaced+gone), conform_manifest (per-event assert: source resolved/handles/retime/reverse/TC-base; BL-aware — black legs need no source, fades no black-side handles, and a fade-out tail requirement lands on the picture source; a compound clipitem fails source_resolved by NAME with the remedy — map it to a flattened file or turn over as OTIO), marker_roundtrip (markers with provenance tags), verify_roundtrip (input events vs re-export events -> pass/mismatches + fitted per-source TC offsets + marker compare w/ markersNotInExport honesty flag; FADE-AWARE: BL/Solid-Color legs merge out as blackSegments and fade-window boundary reshapes are excused into fadeReshapedBoundaries instead of failing; RETIME-AWARE: speed/reverse compare pairwise — EXPORT_OTIO carries an authored Sm2TimeMap back as LinearTimeWarp (measured), so a flattened/lost retime fails as drift geometry alone cannot catch; AUDIO-AWARE: declared audio events compare (a video-only export such as EXPORT_EDL flags audioNotInExport instead of failing) (channel legs deduped, mismatches tagged trackType audio) while the mirrored-A1 export of a video-only turnover stays informational; COLOUR-AWARE: an input generator leg carrying a fillcolor (fade-to-white, colour matte) must come back on the same track over its span with the same colour — Resolve\'s FCP7 writer emits it — else generator-colour fails (generatorColours reports the compare) — pass exportedFormat: an OTIO/EDL re-export cannot carry colour (measured) and reports generatorColourNotInExport instead of failing; COMPOUND-AWARE: an XML re-export that collapsed a compound to one clipitem over cuts the input flattened from that compound reports compoundsCollapsedInExport instead of count/source drift; the conform QC loop-closer). Offline (AAF needs pyaaf2; live AAF/DRP import is on the Python davinci-resolve MCP).',
+    'Editorial integrity (Cluster E) — turnover interchange → normalized events → changelist + conform manifest with TIMING silent-lie guards (flattened retime / dropped J/L-cut audio / framerate-pulldown slip / reverse dropped / transition-handle starvation → flag, skip-not-fake). Report-only (gate: review). Actions: parse_interchange (EDL/OTIO/XMEML natively — incl. Resolve-written OTIO generator clips (a Solid Color is a Clip with a NULL media_reference; it walks as a BL leg with generatorName, and an OTIO GeneratorReference carries its colour) and nested OTIO Stacks (compound clips — Resolve\'s writer nests them with a trim window) FLATTEN into record time with fromCompound on each cut, so Resolve\'s own OTIO exports re-conform (its FCP7 XML writer flattens a compound to ONE media-less clipitem instead — tagged `compound`, which the bridge drops with a reason in unresolvedCompounds unless the sourceMap maps the compound name to a flattened media file), Resolve-written FCP7 -1 junction edges (paired in record order) + Solid Color / Color Matte generators carrying their `fillcolor` (BL legs with `color` → fade-to-white and colour mattes author, E110), XMEML audio-track transitionitems as audio cross-fades on numbered lanes A/A2/…, and CMX FROM/TO CLIP NAME comments over the generic AX reel — + AAF via pyaaf2 (flat sound/picture slots number A/A2/… and V/V2/… in slot order so separate beds keep their lanes; NestedScope layers keep layer numbering; a NESTED SEQUENCE used as a clip — a SourceClip referencing a named CompositionMob — flattens through its reference window with fromCompound, like OTIO Stacks) + PRPROJ via gunzip+XML → normalized events incl. span-explicit transitions, BL fade legs, and freezes as zero-speed events (OTIO FreezeFrame, XMEML timeremap 0, PrProj in==out, AAF 0% motion effects); for AAF/PRPROJ pass the file PATH as content; AAF also returns per-sequence startTimecode/startFrame — build the timeline at THAT start, not the Resolve 01:00:00:00 default — and per-clip `geometry` for Avid transform effects), list_sequences (ONE offline picker entry point across xml/edl/otio/drt/drp/aaf/prproj → [{id,name,eventCount}], plus startTimecode/startFrame for AAF and nestedIn — an AAF composition another composition uses as a clip is NESTED in it; offer the parent, its cuts arrive flattened), convert_to_interchange (author OTIO/EDL/DRT Resolve CAN import from events or a parsed source; the EDL target writes CMX transition pairs incl. BL fades — the .prproj→Resolve conform bridge, no Premiere needed; editorial timing/transitions survive and per-clip effects/color do not. SPEED/REVERSE survive on the otio (LinearTimeWarp) and edl (M2) targets ONLY — this FLAT drt target flattens every retime to 100% forward and returns `flattened`/`flattenedCount` naming each event that lost one (`flattened` is always present on `drt`, empty when there were none); for a .drt that AUTHORS retimes/dissolves/multi-track/audio, use drt.assemble_from_interchange), turnover_changelist (diff old vs new → moved/retimed/trimmed/replaced/new/gone PLUS the junction diff: transition_added/transition_dropped/transition_changed with fade in/out or dissolve, outgoing/incoming, span and duration/type/pre-roll deltas — zero-length CMX carrier lines and the BL legs that carry fades fold into the junction diff instead of reading as gone/new sources; events pair by closest record position, consumed once, so a source cut twice at two speeds compares instance to instance; + timing flags incl. transition_dropped and dropped_split_audio on any A-track; a compound seen collapsed in one cut and flattened in the other reports compound_collapsed/compound_expanded once, never replaced+gone), conform_manifest (per-event assert: source resolved/handles/retime/reverse/TC-base; BL-aware — black legs need no source, fades no black-side handles, and a fade-out tail requirement lands on the picture source; a compound clipitem fails source_resolved by NAME with the remedy — map it to a flattened file or turn over as OTIO), marker_roundtrip (markers with provenance tags), verify_roundtrip (input events vs re-export events -> pass/mismatches + fitted per-source TC offsets + marker compare w/ markersNotInExport honesty flag; FADE-AWARE: BL/Solid-Color legs merge out as blackSegments and fade-window boundary reshapes are excused into fadeReshapedBoundaries instead of failing; RETIME-AWARE: speed/reverse compare pairwise — EXPORT_OTIO carries an authored Sm2TimeMap back as LinearTimeWarp (measured), so a flattened/lost retime fails as drift geometry alone cannot catch; AUDIO-AWARE: declared audio events compare (a video-only export such as EXPORT_EDL flags audioNotInExport instead of failing) (channel legs deduped, mismatches tagged trackType audio) while the mirrored-A1 export of a video-only turnover stays informational; COLOUR-AWARE: an input generator leg carrying a fillcolor (fade-to-white, colour matte) must come back on the same track over its span with the same colour — Resolve\'s FCP7 writer emits it — else generator-colour fails (generatorColours reports the compare) — pass exportedFormat: an OTIO/EDL re-export cannot carry colour (measured) and reports generatorColourNotInExport instead of failing; COMPOUND-AWARE: an XML re-export that collapsed a compound to one clipitem over cuts the input flattened from that compound reports compoundsCollapsedInExport instead of count/source drift; the conform QC loop-closer). Offline (AAF needs pyaaf2; live AAF/DRP import is on the Python davinci-resolve MCP).',
   async handler({ action, args }) {
     if (action === 'parse_interchange') {
       const p = parseSchema.parse(args);

package/src/granular/common.py

@@ -87,7 +87,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "2.178.0"
+VERSION = "2.180.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.178.0"
+VERSION = "2.180.0"
 
 import base64
 import os