davinci-resolve-mcp 2.33.0 → 2.33.1

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 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.33.1
+
+Clip transcription read-back and more trustworthy auto-sync reporting.
+
+- **Added** `media_pool_item(action="get_transcription")` returns
+  `{text, truncated, status, has_transcription}`. Transcription could previously
+  be triggered but never read back. Resolve's `Transcription` clip property is a
+  preview that ends in an ellipsis when the full transcript is longer, so
+  `truncated` tells callers the returned text is partial.
+- **Changed** Auto-sync audio now verifies linkage by reading each clip's
+  `Synced Audio` property before and after the call and reporting
+  `linked` / `newly_linked` / `already_linked`, instead of trusting
+  `AutoSyncAudio`'s unreliable boolean. The boolean is still returned as
+  `success`, but callers should trust `linked`.
+
 ## What's New in v2.33.0
 
 Fusion node-graph layout and duplication, plus performance and robustness

package/README.md

@@ -1,6 +1,6 @@
 # DaVinci Resolve MCP Server
 
-[![Version](https://img.shields.io/badge/version-2.33.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.33.1-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-32%20(341%20full)-blue.svg)](#server-modes)

package/docs/SKILL.md

@@ -455,7 +455,10 @@ Key actions: `get_name`, `get_metadata(key?)`, `set_metadata(key, value)`,
 `set_clip_color(color)`, `link_proxy(proxy_path)`, `replace_clip(path)`,
 `set_name(name)`, `link_full_resolution_media(path)`,
 `replace_clip_preserve_sub_clip(path)`, `monitor_growing_file`,
-`transcribe_audio(use_speaker_detection?)`, `perform_audio_classification`,
+`transcribe_audio(use_speaker_detection?)`, `clear_transcription`,
+`get_transcription` (read back `{text, truncated, status, has_transcription}`;
+`truncated` flags when Resolve's preview cut the text off),
+`perform_audio_classification`,
 `analyze_for_intellisearch(identify_faces?, is_better_mode?)`, `analyze_for_slate(marker_color?)`,
 `remove_motion_blur(deblur_option?)` (Resolve 21+; AI Extras / confirm-token gated as noted above),
 `get_audio_mapping`, `get_mark_in_out`, `set_mark_in_out`

package/install.py

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

package/src/granular/common.py

@@ -80,7 +80,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "2.33.0"
+VERSION = "2.33.1"
 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 341-tool granular server instead
 """
 
-VERSION = "2.33.0"
+VERSION = "2.33.1"
 
 import base64
 import os
@@ -1173,6 +1173,18 @@ def _requires_method(obj, method_name, min_version):
         return None
     return _err(f"{method_name} requires DaVinci Resolve {min_version}+")
 
+def _is_truncated(text):
+    """True if a transcription preview was cut off.
+
+    Resolve's `Transcription` clip property is a preview that ends with an
+    ellipsis (… or ...) when the full transcript is longer than the property
+    exposes, so the caller knows the returned text is partial.
+    """
+    if not isinstance(text, str):
+        return False
+    t = text.rstrip()
+    return t.endswith("…") or t.endswith("...")
+
 _MARKER_COLORS = [
     "Blue", "Cyan", "Green", "Yellow", "Red", "Pink", "Purple", "Fuchsia",
     "Rose", "Lavender", "Sky", "Mint", "Lemon", "Sand", "Cocoa", "Cream",
@@ -5408,6 +5420,22 @@ def _audio_mapping_report(mp, tl, p: Dict[str, Any]):
     return {"timeline_items": timeline_items, "media_pool_items": clip_rows}
 
 
+def _clip_name(clip):
+    try:
+        return clip.GetName()
+    except Exception:
+        return None
+
+
+def _synced_audio(clip):
+    """Best-effort read of whether a clip currently has synced audio linked."""
+    try:
+        v = clip.GetClipProperty("Synced Audio")
+    except Exception:
+        return False
+    return bool(v) and str(v).strip() not in ("", "None", "0", "Off", "No")
+
+
 def _safe_auto_sync_audio(mp, p: Dict[str, Any]):
     root = mp.GetRootFolder()
     resolved, err = _clips_from_params(root, mp, p)
@@ -5421,7 +5449,26 @@ def _safe_auto_sync_audio(mp, p: Dict[str, Any]):
     settings = _normalize_auto_sync_settings(dict(p.get("settings") or {}), get_resolve())
     if p.get("dry_run", True):
         return _ok(would_auto_sync=True, clips=_clip_summaries(clips), missing=missing, settings=settings)
-    return {"success": bool(mp.AutoSyncAudio(clips, settings)), "count": len(clips), "missing": missing, "settings": settings}
+    # Read-back verification: AutoSyncAudio's boolean return is unreliable, so
+    # capture each clip's "Synced Audio" linkage before and after and report the
+    # delta. Trust `linked`/`newly_linked`, not `success`.
+    before = [_synced_audio(c) for c in clips]
+    ok = bool(mp.AutoSyncAudio(clips, settings))
+    linked, newly_linked, already_linked = [], [], []
+    for c, was in zip(clips, before):
+        name = _clip_name(c)
+        if _synced_audio(c):
+            linked.append(name)
+            (already_linked if was else newly_linked).append(name)
+    return {
+        "success": ok,
+        "linked": linked,
+        "newly_linked": newly_linked,
+        "already_linked": already_linked,
+        "count": len(clips),
+        "missing": missing,
+        "settings": settings,
+    }
 
 
 def _resolve_audio_constant(resolve_obj, name: str, fallback):
@@ -13626,6 +13673,9 @@ def media_pool_item(action: str, params: Optional[Dict[str, Any]] = None) -> Dic
       get_unique_id(clip_id) -> {id}
       transcribe_audio(clip_id, use_speaker_detection?) -> {success}  — use_speaker_detection is Resolve 21+
       clear_transcription(clip_id) -> {success}
+      get_transcription(clip_id) -> {text, truncated, status, has_transcription}
+        Read a clip's transcription. `truncated` flags when Resolve's preview
+        property cut the text off (the full transcript is longer).
       perform_audio_classification(clip_id) -> {success}  — Resolve 21+
       clear_audio_classification(clip_id) -> {success}  — Resolve 21+
       analyze_for_intellisearch(clip_id, identify_faces?, is_better_mode?) -> {success}  — Resolve 21+, AI IntelliSearch Extra
@@ -13827,6 +13877,20 @@ def media_pool_item(action: str, params: Optional[Dict[str, Any]] = None) -> Dic
         return {"success": bool(clip.TranscribeAudio(bool(usd)))}
     elif action == "clear_transcription":
         return {"success": bool(clip.ClearTranscription())}
+    elif action == "get_transcription":
+        raw = clip.GetClipProperty("Transcription")
+        text = raw if isinstance(raw, str) else ("" if raw is None else str(raw))
+        try:
+            status = clip.GetClipProperty("Transcription Status")
+        except Exception:
+            status = None
+        return {
+            "clip_id": p.get("clip_id"),
+            "text": text,
+            "truncated": _is_truncated(text),
+            "status": status or None,
+            "has_transcription": bool(text.strip()),
+        }
     elif action == "perform_audio_classification":
         missing = _requires_method(clip, "PerformAudioClassification", "21.0")
         if missing:
@@ -13905,7 +13969,7 @@ def media_pool_item(action: str, params: Optional[Dict[str, Any]] = None) -> Dic
         return {"success": bool(clip.SetMarkInOut(p["mark_in"], p["mark_out"], p.get("type", "all")))}
     elif action == "clear_mark_in_out":
         return {"success": bool(clip.ClearMarkInOut(p.get("type", "all")))}
-    return _unknown(action, ["get_name","get_metadata","set_metadata","get_third_party_metadata","set_third_party_metadata","get_media_id","get_clip_property","set_clip_property","get_clip_color","set_clip_color","clear_clip_color","link_proxy","unlink_proxy","replace_clip","set_name","link_full_resolution_media","monitor_growing_file","replace_clip_preserve_sub_clip","get_unique_id","transcribe_audio","clear_transcription","perform_audio_classification","clear_audio_classification","analyze_for_intellisearch","analyze_for_slate","remove_motion_blur","get_audio_mapping","get_mark_in_out","set_mark_in_out","clear_mark_in_out","open_in_viewer"])
+    return _unknown(action, ["get_name","get_metadata","set_metadata","get_third_party_metadata","set_third_party_metadata","get_media_id","get_clip_property","set_clip_property","get_clip_color","set_clip_color","clear_clip_color","link_proxy","unlink_proxy","replace_clip","set_name","link_full_resolution_media","monitor_growing_file","replace_clip_preserve_sub_clip","get_unique_id","transcribe_audio","clear_transcription","get_transcription","perform_audio_classification","clear_audio_classification","analyze_for_intellisearch","analyze_for_slate","remove_motion_blur","get_audio_mapping","get_mark_in_out","set_mark_in_out","clear_mark_in_out","open_in_viewer"])
 
 
 # ═══════════════════════════════════════════════════════════════════════════════