davinci-resolve-mcp 4.9.2 → 4.9.3

package/CHANGELOG.md

@@ -2,6 +2,48 @@
 
 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.9.3 — .drp bin registry for two or more bins; broader temp-root guard tests
+
+### Fixed
+
+- **`drt(action="assemble_project")` registered no bins when timelines went
+  into two or more of them.** The Master folder's `FieldsBlob` is the
+  subfolder registry, `protobuf{field2: keyedDict{"<i>": binId}, field4:
+  time}`, and field 2's length was written as one raw byte. One bin's dict is
+  95 bytes and fits; two bins' is 182, emitted as `0xb6`, whose continuation
+  bit swallowed the dict's first byte and read back as length 54; three bins'
+  269 was truncated to 13. The archive carried every bin directory while its
+  registry decoded to zero entries. The length is now written with the
+  module's existing length-delimited field writer, which emits the same
+  single byte for one bin, so single-bin output is byte-for-byte unchanged.
+  Found and fixed by @Dev-next-gen (#280).
+
+### Tests
+
+- `resolve-advanced/test/drt-assemble-extract.test.mjs`: two timelines in two
+  bins; the registry's declared length covers exactly the keyed dict, both
+  bin ids are present, and field 4 follows. Fails on v4.9.2.
+- `tests/test_source_media_guard.py` (@AllastorV, #277): broad temp roots
+  (the profile, every ancestor of it, `..` and case variants, the working
+  directory), chosen through `TEMP` / `TMPDIR` / `TMP` and through the real
+  environment, never license a media write or delete; a narrow Windows temp
+  dir is scratch while a `Temp-media` sibling is not; and an explicit
+  `RESOLVE_MCP_SCRATCH` opt-in still applies to a rejected temp root.
+
+### Known gap
+
+- On the 19.x template path (`targetAppVersion: "19.1.3"`) the registry is
+  not written at all: the template's Master `FieldsBlob` already registers its
+  own `000_Archive` bin, so the replacement that targets an empty blob finds
+  nothing. Bins assembled for 19.x stay unregistered whatever their count.
+  Reported in #280; not changed here.
+
+### Validation
+
+- Offline suites green. No live Resolve run: the changed bytes are written
+  only for 21.1-target archives, which this project's 19.1.3.7 host cannot
+  import, and the one-bin blob is unchanged. The guard change is tests only.
+
 ## What's New in v4.9.2 — the source-media guard recognises Windows temp space
 
 ### Fixed

package/README.md

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

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

@@ -472,11 +472,17 @@ export const drtTool = {
         // scan, subfolders are not). Inner format byte-verified against the
         // template harvest: protobuf{field2: keyedDict{"0": binId, ...},
         // field4: time-varint} in the [u32 2][u32 len][0x81][zstd] wrapper.
-        const { zstdRawFrame } = requireCjs('../../vendor/drp-format/timeline-markers-blob.js');
+        const { zstdRawFrame, lenDelim } = requireCjs('../../vendor/drp-format/timeline-markers-blob.js');
         const binIds = [...bins.values()].map((b) => b.id);
         const childDict = encodeKeyedDict({ hdr: 1, entries: binIds.map((id, i) => ({ key: String(i), type: 0x0a, subType: 0, value: id })) });
+        // field 2's length is a protobuf VARINT, not one raw byte: one bin's
+        // dict is 95 bytes and fits, two bins' is 182 and does not, so
+        // `[0x12, 182]` emitted a 0xb6 continuation byte that swallowed the
+        // dict's first byte and read as length 54 — the registry parsed back
+        // empty with neither bin in it. lenDelim() writes the same single byte
+        // for the one-bin case, so that blob is unchanged.
         const inner = Buffer.concat([
-          Buffer.from([0x12, childDict.length]), childDict,
+          lenDelim(2, childDict),
           Buffer.from([0x20]), Buffer.from('b6cba6a90d', 'hex'),
         ]);
         const frame = zstdRawFrame(inner);

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

@@ -156,4 +156,4 @@ function decodeTimelineMarkersBlob(buf) {
   return markers;
 }
 
-module.exports = { encodeTimelineMarkersBlob, decodeTimelineMarkersBlob, MARKER_COLOR_BITS, zstdRawFrame };
+module.exports = { encodeTimelineMarkersBlob, decodeTimelineMarkersBlob, MARKER_COLOR_BITS, zstdRawFrame, lenDelim };

package/src/granular/common.py

@@ -91,7 +91,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "4.9.2"
+VERSION = "4.9.3"
 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.9.2"
+VERSION = "4.9.3"
 
 import base64
 import os