davinci-resolve-mcp 4.15.0 → 4.15.2

package/CHANGELOG.md

@@ -2,6 +2,62 @@
 
 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 v4.15.2 — Bridge installer and large marker blobs
+
+Two contributor fixes.
+
+### Fixed
+
+- **The bridge installer no longer writes into Blackmagic Disk Speed Test's
+  sandbox container** (#315, thanks @gatezh). The macOS installer treats every
+  `com.blackmagic-design.*` container as a possible sandboxed Resolve and
+  excludes the known helpers by name, but Disk Speed Test was missing from
+  that list. The installer copied the bridge scripts and a copy of
+  `bridge.json`, auth token included, into a container Resolve never reads,
+  and the inflated canary count told users to expect 4 Scripts-menu entries
+  where Resolve shows 2. Files already written there are harmless apart from
+  the token copy and can be deleted by hand from
+  `~/Library/Containers/com.blackmagic-design.DiskSpeedTest/Data/Library/Application Support/`.
+- **Marker blobs over 128 KiB are now valid zstd** (#313, thanks
+  @Dev-next-gen). `drt.assemble` wrote timeline and clip markers as one raw
+  zstd block. The format caps a block at 128 KiB, so past that size the
+  reference decoder rejected the frame, and past 2 MiB assemble threw. The
+  writer now splits the payload into blocks of at most 128 KiB. Output up to
+  128 KiB is byte-identical to before. The same writer also builds the bin
+  registry blob, which gets the same fix.
+
+### Validation
+
+- Each PR was tested with `main` merged in: the full Python suite for #315
+  (only the 4 known worktree path artifacts failed), and the advanced Node
+  suite from a fresh `npm ci` for #313 (1,202 tests, 0 failures).
+- #313's frames checked against the reference `zstd` decoder: rejected above
+  128 KiB before the fix, accepted at every size up to 2.3 MB after it.
+- How Resolve's own importer treats a marker blob over 128 KiB was not
+  measured. The fix makes the frames spec-valid; it is reported, not
+  live-verified.
+
+## What's New in v4.15.1 — Frame captures arrive as images on Python 3.10
+
+### Fixed
+
+- **`timeline_frame` and `timeline_markers get_thumbnail_image` return their
+  image again on Python 3.10** (#314). Both tools are declared `-> Any`. On
+  Python 3.10, FastMCP inferred a `{"result": ...}` output schema from that
+  annotation and then failed to serialize the image, so every capture
+  succeeded in Resolve and reached the client as "Unable to serialize unknown
+  type". Python 3.11 and later infer no schema, which hid the bug from CI and
+  the direct-call unit tests. Both tools now opt out of structured output;
+  their dict results still arrive as JSON text. Reported by @jo-nike.
+
+### Validation
+
+- New `tests/test_image_tool_structured_output.py` calls both tools through
+  `mcp.call_tool`. One case imports the server with Python 3.10's schema
+  inference forced, so it fails without the fix on any Python.
+- Full offline suite and release static checks. No Resolve scripting
+  behaviour changed; live Resolve test not required.
+
 ## What's New in v4.15.0 — Conform-session fixes, Python doctor, restart hint
 
 Six gaps a real conform session hit on Resolve Studio 19.1.3.7, each measured

package/README.md

@@ -2,7 +2,7 @@
 
 English | [简体中文](README.zh-CN.md)
 
-[![Version](https://img.shields.io/badge/version-4.15.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-4.15.2-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-37%20(390%20full)-blue.svg)](#server-modes)

package/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | 简体中文
 
-[![Version](https://img.shields.io/badge/version-4.15.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-4.15.2-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-37%20(390%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)
 
-> 本翻译对应 v4.15.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
+> 本翻译对应 v4.15.2 版 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 = "4.15.0"
+VERSION = "4.15.2"
 # 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": "4.15.0",
+  "version": "4.15.2",
   "description": "NPM bootstrapper for the DaVinci Resolve MCP Server.",
   "license": "MIT",
   "author": "Samuel Gursky <samgursky@gmail.com>",

package/resolve-advanced/vendor/drp-format/timeline-markers-blob.js

@@ -65,7 +65,7 @@ function encodeMarkerEntry(m) {
   return lenDelim(1, Buffer.concat([varField(1, m.frame), lenDelim(2, wrapped)]));
 }
 
-/** zstd single-segment frame with one RAW block (no compression). */
+/** zstd single-segment frame of RAW blocks (no compression), 128 KiB per block at most. */
 function zstdRawFrame(payload) {
   const magic = Buffer.from([0x28, 0xb5, 0x2f, 0xfd]);
   let header;
@@ -76,9 +76,17 @@ function zstdRawFrame(payload) {
     header[0] = 0xa0; // single-segment, 4-byte FCS
     header.writeUInt32LE(payload.length, 1);
   }
-  const block = Buffer.alloc(3);
-  block.writeUIntLE((payload.length << 3) | 1, 0, 3); // last=1, type=raw
-  return Buffer.concat([magic, header, block, payload]);
+  // RFC 8878 caps every block at 128 KiB; libzstd rejects a larger raw block as corrupt.
+  const blocks = [];
+  let o = 0;
+  do {
+    const size = Math.min(payload.length - o, 128 * 1024);
+    const block = Buffer.alloc(3);
+    block.writeUIntLE((size << 3) | (o + size === payload.length ? 1 : 0), 0, 3); // type=raw
+    blocks.push(block, payload.subarray(o, o + size));
+    o += size;
+  } while (o < payload.length);
+  return Buffer.concat([magic, header, ...blocks]);
 }
 
 function zstdRawInflate(buf) {

package/scripts/install_resolve_bridge.py

@@ -80,8 +80,9 @@ _SANDBOX_MARKER = "com.blackmagic-design."
 #: NOT used outside a sandbox: on a normal install this is genuinely Fusion's
 #: own tree and has nothing to do with Resolve.
 _SANDBOX_FALLBACK_SUFFIX = "Library/Application Support/Fusion/Scripts/Utility"
-#: Containers that are not Resolve (RAW Player, Speed Test, the IO XPC helper).
-_NON_RESOLVE_CONTAINERS = ("BlackmagicRaw", "IOXPC")
+#: Containers that are not Resolve (RAW Player, RAW Speed Test, Disk Speed Test,
+#: the IO XPC helper).
+_NON_RESOLVE_CONTAINERS = ("BlackmagicRaw", "DiskSpeedTest", "IOXPC")
 
 #: Windows Scripts/Utility trees, per Blackmagic's own README
 #: (docs/reference/resolve_scripting_api.txt, "Specific user"/"All users").

package/src/granular/common.py

@@ -91,7 +91,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "4.15.0"
+VERSION = "4.15.2"
 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 377-tool granular server instead
 """
 
-VERSION = "4.15.0"
+VERSION = "4.15.2"
 
 import base64
 import os
@@ -28116,7 +28116,10 @@ def timeline(action: str, params: Optional[Dict[str, Any]] = None) -> Dict[str,
 # TOOL 16: timeline_markers
 # ═══════════════════════════════════════════════════════════════════════════════
 
-@mcp.tool()
+# structured_output=False: these tools return an MCP Image. On Python 3.10 FastMCP
+# infers a {"result": ...} schema from `-> Any` and fails to serialize the Image
+# (issue #314); 3.11+ infers none, which hides the bug.
+@mcp.tool(structured_output=False)
 @_guard_missing_params
 @_destructive_op("timeline_markers")
 def timeline_markers(action: str, params: Optional[Dict[str, Any]] = None) -> Any:
@@ -28265,7 +28268,10 @@ def timeline_markers(action: str, params: Optional[Dict[str, Any]] = None) -> An
 # TOOL 17: timeline_frame
 # ═══════════════════════════════════════════════════════════════════════════════
 
-@mcp.tool()
+# structured_output=False: these tools return an MCP Image. On Python 3.10 FastMCP
+# infers a {"result": ...} schema from `-> Any` and fails to serialize the Image
+# (issue #314); 3.11+ infers none, which hides the bug.
+@mcp.tool(structured_output=False)
 @_guard_missing_params
 def timeline_frame(action: str, params: Optional[Dict[str, Any]] = None) -> Any:
     """See what Resolve is rendering — capture a timeline frame as a viewable image.