davinci-resolve-mcp 2.216.1 → 2.217.0

package/CHANGELOG.md

@@ -2,6 +2,47 @@
 
 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.217.0 — native Resolve 21.1 speed and fade setters, registered as the mutations they are
+
+Contributed by @legionsound (#208), live-validated on Studio 21.1.0.14.
+
+### Added
+
+- **`timeline_item set_speed` and `set_fades`**, with granular twins
+  `set_timeline_item_speed` / `set_timeline_item_fades`, calling 21.1's native
+  `SetSpeed` and `SetFades`. Each takes an `options` dictionary — `Percentage`
+  (finite number, zero freezes), `PitchCorrection`, `StretchKeyframesToFit`,
+  `RippleTimeline` (strict booleans; ripple defaults to false) and `FadeIn` /
+  `FadeOut` (non-negative integer frames). Unknown keys, non-finite numbers,
+  non-boolean flags and fractional or negative fades are refused before any
+  write; valid partial dictionaries are forwarded unchanged, including zero
+  and false; a native `False` stays `success: false`; a build without the
+  method returns the 21.1 floor error — confirmed here on Studio 19.1.3.7 for
+  both. The legacy retime interface is untouched. Granular count 365 → 367;
+  generated rules, docs, version floors and the read/write report updated.
+  The contributor's frame evidence: at 50% speed the exported timeline-2s
+  frame matched the untreated 1s frame pixel-for-pixel; with 24-frame fades
+  the first and last exported frames were black and the interior frame
+  unchanged. Reverse, freeze, ripple, keyframe stretching and audio pitch are
+  not claimed validated. See `docs/reference/resolve211-speed-fades.md`.
+
+### Changed
+
+- **On landing, both actions are registered in the destructive registry**
+  beside `set_retime`, `set_transform` and the other item setters. As
+  contributed, the risk classifier did not recognise them
+  (`recognised: false, destructive: false`), so safe mode, the dry-run
+  refusal, the security audit and the operation log would all have skipped
+  a call that changes a clip's speed — and, with `RippleTimeline: true`,
+  moves every clip after it. A test now pins both as recognised, destructive
+  writes.
+
+### Validation
+
+- The PR's offline contracts, the registry test, full offline suite, drift
+  guards and the advanced Node suite. Positive behaviour is the contributor's
+  21.1 measurement; the version-floor refusal is measured on 19.1.3.7.
+
 ## What's New in v2.216.1 — ValidateDCTL's layout sensitivity is in the API ledger
 
 ### Documentation

package/README.md

@@ -2,10 +2,10 @@
 
 English | [简体中文](README.zh-CN.md)
 
-[![Version](https://img.shields.io/badge/version-2.216.1-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.217.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(365%20full)-blue.svg)](#server-modes)
+[![Tools](https://img.shields.io/badge/MCP%20Tools-36%20(367%20full)-blue.svg)](#server-modes)
 [![Advanced](https://img.shields.io/badge/Advanced%20(offline)-18%20tools-blueviolet.svg)](#server-modes)
 [![Tested](https://img.shields.io/badge/Live%20Tested-93.6%25-green.svg)](docs/reference/api-coverage.md#test-results)
 [![DaVinci Resolve](https://img.shields.io/badge/DaVinci%20Resolve-18.5+-darkred.svg)](https://www.blackmagicdesign.com/products/davinciresolve)
@@ -133,7 +133,7 @@ The command starts a loopback-only server and opens the control panel in your br
 | Mode | Entry point | Tools | Best for |
 |------|-------------|-------|----------|
 | Compound | `src/server.py` | 36 | Default mode for most assistants. Related Resolve operations are grouped behind action parameters to keep context usage low. |
-| Full / granular | `src/server.py --full` or `src/resolve_mcp_server.py` | 365 | Power users who want one MCP tool per Resolve API method. |
+| Full / granular | `src/server.py --full` or `src/resolve_mcp_server.py` | 367 | Power users who want one MCP tool per Resolve API method. |
 
 The compound server is recommended unless you specifically need the granular one-tool-per-method surface.
 
@@ -365,7 +365,7 @@ The default server is a local stdio process launched by your MCP client; it does
 
 | Metric | Value |
 |--------|-------|
-| MCP Tools | **36** compound / **365** granular (live server) |
+| MCP Tools | **36** compound / **367** granular (live server) |
 | Advanced (offline) tools | **18** — .drp/.drt/.drx + DB authoring, no Resolve running |
 | Kernel Actions | **136** guarded workflow actions across 9 compound tools |
 | API Methods Covered | **361/361** (100%) |

package/README.zh-CN.md

@@ -2,17 +2,17 @@
 
 [English](README.md) | 简体中文
 
-[![Version](https://img.shields.io/badge/version-2.216.1-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.217.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(365%20full)-blue.svg)](#服务器模式)
+[![Tools](https://img.shields.io/badge/MCP%20Tools-36%20(367%20full)-blue.svg)](#服务器模式)
 [![Advanced](https://img.shields.io/badge/Advanced%20(offline)-18%20tools-blueviolet.svg)](#服务器模式)
 [![Tested](https://img.shields.io/badge/Live%20Tested-93.6%25-green.svg)](docs/reference/api-coverage.md#test-results)
 [![DaVinci Resolve](https://img.shields.io/badge/DaVinci%20Resolve-18.5+-darkred.svg)](https://www.blackmagicdesign.com/products/davinciresolve)
 [![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.216.1 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
+> 本翻译对应 v2.217.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
 
 一个 Model Context Protocol (MCP) 服务器，让 AI 助手通过官方脚本 API 控制 DaVinci Resolve Studio（达芬奇）。它提供完整的 API 覆盖，外加带护栏的工作流助手，涵盖剪辑、媒体池整理、渲染设置、审阅标记、调色、Fusion、Fairlight、项目生命周期任务、扩展开发，以及不碰源媒体的媒体分析。
 
@@ -88,7 +88,7 @@ venv/bin/python -m src.control_panel
 | 模式 | 入口 | 工具数 | 适合谁 |
 |------|------|--------|--------|
 | Compound（复合） | `src/server.py` | 36 | 大多数助手的默认模式。相关的 Resolve 操作按 action 参数分组，压低上下文占用。 |
-| Full / granular（细粒度） | `src/server.py --full` 或 `src/resolve_mcp_server.py` | 365 | 想要"一个 Resolve API 方法 = 一个 MCP 工具"的重度用户。 |
+| Full / granular（细粒度） | `src/server.py --full` 或 `src/resolve_mcp_server.py` | 367 | 想要"一个 Resolve API 方法 = 一个 MCP 工具"的重度用户。 |
 
 除非你明确需要一方法一工具的细粒度界面，否则推荐复合模式。
 
@@ -226,7 +226,7 @@ DRX 调色写入**针对 Resolve Studio 做过实机校准**：调色参数默
 
 | 指标 | 数值 |
 |------|------|
-| MCP 工具 | **36** 复合 / **365** 细粒度（实时服务器） |
+| MCP 工具 | **36** 复合 / **367** 细粒度（实时服务器） |
 | Advanced（离线）工具 | **18**——.drp/.drt/.drx + 数据库创作，无需 Resolve 运行 |
 | 内核 action | 9 个复合工具下 **136** 个带护栏的工作流 action |
 | API 方法覆盖 | **361/361**（100%） |

package/docs/SKILL.md

@@ -345,7 +345,7 @@ to the user as verified.
 | Mode | Entry point | Tool count | Use when |
 |---|---|---|---|
 | Compound (default) | `src/server.py` | 36 tools | Most workflows — keeps context lean |
-| Granular (full) | `src/server.py --full` | 365 tools | Power users needing one tool per API method |
+| Granular (full) | `src/server.py --full` | 367 tools | Power users needing one tool per API method |
 
 Resolve 21.1 adds [twelve read-only discovery controls](reference/resolve211-read-controls.md)
 for edition, presets, audio formats/codecs, normalization modes, speed, fades
@@ -2479,3 +2479,5 @@ setups:
 | `Timeline.AnalyzeDolbyVision` | HDR / Dolby Vision content |
 
 The full API reference is in `docs/reference/resolve_scripting_api.txt`.
+
+Native Resolve 21.1 speed and fade setters: see [speed/fades](reference/resolve211-speed-fades.md) for options, version guards and contributor validation limits.

package/docs/contributing.md

@@ -64,7 +64,7 @@ davinci-resolve-mcp/
 ├── install.py                    # Universal installer (macOS/Windows/Linux)
 ├── src/
 │   ├── server.py                # Compound MCP server — 36 tools (default)
-│   ├── resolve_mcp_server.py    # Thin full-server entrypoint — 365 tools
+│   ├── resolve_mcp_server.py    # Thin full-server entrypoint — 367 tools
 │   ├── granular/                # Modular full-server implementation
 │   └── utils/                   # Platform detection, Resolve connection helpers
 ├── tests/                       # offline suite (test_*.py) + live harnesses (live_*.py):

package/docs/install.md

@@ -144,7 +144,7 @@ The MCP server comes in two modes:
 | Mode | File | Tools | Best For |
 |------|------|-------|----------|
 | **Compound** (default) | `src/server.py` | 36 | Most users — fast, clean, low context usage |
-| **Full** | `src/resolve_mcp_server.py` | 365 | Power users who want one tool per API method |
+| **Full** | `src/resolve_mcp_server.py` | 367 | Power users who want one tool per API method |
 
 The compound server's `timeline_item` tool includes dedicated actions for common workflows:
 
@@ -159,7 +159,7 @@ The compound server's `timeline_item` tool includes dedicated actions for common
 
 The installer uses the compound server by default. To use the full server:
 ```bash
-python src/server.py --full    # Launch full 365-tool server
+python src/server.py --full    # Launch full 367-tool server
 # Or point your MCP config directly at src/resolve_mcp_server.py
 ```
 

package/docs/reference/api-coverage.md

@@ -25,7 +25,7 @@ Every non-deprecated method in the bundled legacy README is represented. This
 does not claim complete coverage of the newer Resolve 21.1 typed API. The
 default compound server exposes **36 tools** that group related operations by
 action parameter, keeping LLM context windows lean. The full granular server
-provides **365 individual tools** for power users. The legacy coverage spans
+provides **367 individual tools** for power users. The legacy coverage spans
 13 API object classes. MCP-level kernel actions are tracked separately in
 [Kernel Action Coverage](../kernels/README.md).
 
@@ -629,3 +629,5 @@ Every method in the DaVinci Resolve Scripting API and its test status. Methods a
 | 5 | `GetPostClipNodeGraph()` | ✅ | Returns Graph object |
 
 ---
+
+Native speed and fade setters in both interfaces are documented in [Resolve 21.1 speed/fades](resolve211-speed-fades.md), including sampled video validation and unverified cases.

package/docs/reference/readwrite-symmetry.md

@@ -2,8 +2,8 @@
 
 # Read/Write Symmetry Audit
 
-- write-style action occurrences scanned: **117**
-- write-style action occurrences with a matching read: **71**
+- write-style action occurrences scanned: **119**
+- write-style action occurrences with a matching read: **73**
 - distinct high-signal `set_` actions without a direct/known readback: **4**
 
 ## High-signal gaps — `set_` with no direct/known readback

package/docs/reference/resolve211-speed-fades.md

@@ -0,0 +1,59 @@
+# Native Resolve 21.1 speed and fades
+
+Compound `timeline_item` now accepts `set_speed` and `set_fades`, with an
+`options` dictionary and the existing track/item locators. Granular mode exposes
+`set_timeline_item_speed` and `set_timeline_item_fades` with the same dictionary.
+These call native SetSpeed/SetFades, require callable methods and the 21.1 floor,
+and return the native boolean as success. They do not replace legacy retime tools.
+
+Speed options: Percentage (finite number; zero means freeze), PitchCorrection,
+StretchKeyframesToFit and RippleTimeline (strict booleans). Native RippleTimeline
+and StretchKeyframesToFit defaults are false. Omitted options are not synthesized.
+No undocumented speed bounds are imposed; Resolve decides whether a finite speed
+is supported for the target clip. Freeze, reverse, ripple and pitch behavior are
+not claimed live-validated by this contribution.
+
+Fade options: FadeIn and/or FadeOut, non-negative integer frame counts as defined
+by the shipped FadeInfo stub. GetFades may return floats, so callers round-trip
+integral readback values by explicitly converting to integers. Fractional setter
+values are refused. Partial dictionaries are forwarded unchanged to Resolve.
+Empty dictionaries, unknown keys and malformed types return errors before writes.
+
+Example: `timeline_item("set_speed", {"options": {"Percentage": 50,
+"RippleTimeline": false}, "track_type": "video", "track_index": 1,
+"item_index": 0})`. For a one-second fade on a 24 fps clip, use
+`{"options": {"FadeIn": 24, "FadeOut": 24}}` with `set_fades`.
+
+## Contributor validation
+
+Contributor-validated on macOS Studio **21.1.0.14** using synthetic media in a
+disposable project. Both interfaces changed speed to 50% and fades to 24 frames
+with matching native readback. Resolve-exported stills at timeline 2s after the
+speed change matched the untreated source-at-1s export pixel-for-pixel, while
+untreated timeline 2s differed. Fade start and final frame were black; the interior frame matched
+the untreated frame exactly. This verifies these sampled video results, not an
+entire rendered movie, audio pitch/volume, retimed keyframes, ripple edits or
+other clip types. The native setters restore their original values after testing.
+
+`tests/live_resolve211_speed_fades.py OUTPUT_DIR` enforces the named scratch
+fixture before writes and exports the comparison frames. It requires a 24 fps,
+zero-start timeline with one six-second synthetic test-pattern.mov video clip.
+Do not run it on production media. Unit contracts cover both layers, native
+failure, absent methods, invalid options, explicit false/zero and partial fields.
+
+Synthetic fixture creation (outside Resolve, no source media involved):
+
+```sh
+ffmpeg -f lavfi -i 'testsrc2=size=640x360:rate=24:duration=6' \
+  -f lavfi -i 'sine=frequency=440:sample_rate=48000:duration=6' \
+  -c:v prores_ks -profile:v 0 -pix_fmt yuv422p10le -c:a pcm_s16le \
+  test-pattern.mov
+```
+
+Create a disposable project named `Codex Speed Fades Validation 20260909`, set
+640x360 and 24 fps, create a timeline starting at 00:00:00:00, and append this
+clip once. The fixture name is deliberately explicit to make accidental writes
+to an unrelated project fail. Compare decoded RGB pixels of the exported PNGs;
+speed50_2s should equal baseline_1s, fade_2s should equal baseline_2s, and
+fade_0s/fade_end should be black for each interface. The test exports stills;
+it does not submit render jobs or establish whole-movie/audio acceptance.

package/install.py

@@ -37,7 +37,7 @@ from src.utils.update_check import (
 
 # ─── Version ──────────────────────────────────────────────────────────────────
 
-VERSION = "2.216.1"
+VERSION = "2.217.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
@@ -1543,7 +1543,7 @@ def verify_resolve_connection(python_path, api_path, lib_path):
 
 def print_banner():
     title = f"DaVinci Resolve MCP Server — Installer v{VERSION}"
-    subtitle = "36 compound · 365 full · 3 platforms"
+    subtitle = "36 compound · 367 full · 3 platforms"
     print()
     print(bold("  ╔══════════════════════════════════════════════════════╗"))
     print(bold(f"  ║{title:^54}║"))

package/package.json

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

package/src/granular/common.py

@@ -87,7 +87,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "2.216.1"
+VERSION = "2.217.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/granular/resolve_211.py

@@ -1,6 +1,7 @@
-"""Read-only discovery added to the typed Resolve 21.1 API surface."""
+"""Native Resolve 21.1 discovery and editing controls."""
+from src.utils.resolve211_edits import validate_edit_options
 from src.granular.common import (
-    mcp, READ_ONLY_TOOL, get_resolve, get_current_project,
+    mcp, READ_ONLY_TOOL, WRITE_TOOL, get_resolve, get_current_project,
     _get_timeline, _get_timeline_item, _requires_method, has_method,
 )
 
@@ -146,3 +147,37 @@ def get_timeline_item_use_timeline_for_output_blanking(track_type: str = "video"
     if missing:
         return missing
     return {"use_timeline": item.GetUseTimelineForOutputBlanking()}
+
+
+@mcp.tool(annotations=WRITE_TOOL)
+def set_timeline_item_speed(options: dict, track_type: str = "video", track_index: int = 1, item_index: int = 0) -> dict:
+    """Set native 21.1 Percentage, PitchCorrection, StretchKeyframesToFit and/or RippleTimeline. Percentage 0 freezes; RippleTimeline defaults false."""
+    error = validate_edit_options("set_speed", options)
+    if error:
+        return {"error": error}
+    if track_type not in ("video", "audio") or track_index < 1 or item_index < 0:
+        return {"error": "Use video/audio, a 1-based track index and a non-negative item index"}
+    item, error = _get_timeline_item(track_type, track_index, item_index)
+    if error:
+        return error
+    missing = _requires_method(item, "SetSpeed", "21.1")
+    if missing:
+        return missing
+    return {"success": bool(item.SetSpeed(dict(options)))}
+
+
+@mcp.tool(annotations=WRITE_TOOL)
+def set_timeline_item_fades(options: dict, track_type: str = "video", track_index: int = 1, item_index: int = 0) -> dict:
+    """Set native 21.1 FadeIn and/or FadeOut as non-negative integer frame durations. Omitted fields remain native defaults/current state."""
+    error = validate_edit_options("set_fades", options)
+    if error:
+        return {"error": error}
+    if track_type not in ("video", "audio") or track_index < 1 or item_index < 0:
+        return {"error": "Use video/audio, a 1-based track index and a non-negative item index"}
+    item, error = _get_timeline_item(track_type, track_index, item_index)
+    if error:
+        return error
+    missing = _requires_method(item, "SetFades", "21.1")
+    if missing:
+        return missing
+    return {"success": bool(item.SetFades(dict(options)))}

package/src/resolve_mcp_server.py

@@ -34,7 +34,7 @@ from src.utils.update_check import start_background_update_check
 if __name__ == "__main__":
     try:
         start_background_update_check(VERSION, project_dir, logger)
-        logger.info(f"Starting DaVinci Resolve MCP Server v{VERSION} (365 granular tools)")
+        logger.info(f"Starting DaVinci Resolve MCP Server v{VERSION} (367 granular tools)")
         run_fastmcp_stdio(mcp)
     except KeyboardInterrupt:
         logger.info("Server shutdown requested")

package/src/server.py

@@ -8,10 +8,10 @@ Each tool groups related operations via an 'action' parameter.
 
 Usage:
     python src/server.py              # Start the MCP server
-    python src/server.py --full       # Start the 365-tool granular server instead
+    python src/server.py --full       # Start the 367-tool granular server instead
 """
 
-VERSION = "2.216.1"
+VERSION = "2.217.0"
 
 import base64
 import os
@@ -42,6 +42,8 @@ for p in [current_dir, project_dir]:
     if p not in sys.path:
         sys.path.insert(0, p)
 
+from src.utils.resolve211_edits import validate_edit_options
+
 # Platform-specific Resolve paths
 from src.utils.cdl import normalize_cdl_payload
 from src.utils import resolve_writes as _resolve_writes
@@ -26272,6 +26274,8 @@ def timeline_item(action: str, params: Optional[Dict[str, Any]] = None) -> Dict[
     Identify by track_type, track_index, item_index (item_index is 0-BASED: 0 = first clip; track_index is 1-based).
 
     Actions:
+      set_speed(options, ...) -> {success} — native 21.1 speed options; RippleTimeline defaults false.
+      set_fades(options, ...) -> {success} — native 21.1 FadeIn/FadeOut integer frames.
       get_speed(...) -> {speed} — documented on Resolve 21.1+.
       get_fades(...) -> {fades} — documented on Resolve 21.1+. Native frame durations.
       get_output_blanking(...) -> {blanking} — documented on Resolve 21.1+. Pixel coordinates; empty on a clip inheriting timeline blanking.
@@ -26326,6 +26330,21 @@ def timeline_item(action: str, params: Optional[Dict[str, Any]] = None) -> Dict[
     if err:
         return err
 
+    if action in ("set_speed", "set_fades"):
+        options = p.get("options")
+        error = validate_edit_options(action, options)
+        if error:
+            return _err(error)
+        if action == "set_speed":
+            missing = _requires_method(item, "SetSpeed", "21.1")
+            if missing:
+                return missing
+            return {"success": bool(item.SetSpeed(dict(options)))}
+        missing = _requires_method(item, "SetFades", "21.1")
+        if missing:
+            return missing
+        return {"success": bool(item.SetFades(dict(options)))}
+
     if action == "get_speed":
         missing = _requires_method(item, "GetSpeed", "21.1")
         if missing:
@@ -26522,7 +26541,7 @@ def timeline_item(action: str, params: Optional[Dict[str, Any]] = None) -> Dict[
             return _err(f"Invalid interpolation. Must be one of: {', '.join(valid)}")
         return {"success": bool(item.SetKeyframeInterpolation(p["property"], p["frame"], p["interpolation"]))}
 
-    return _unknown(action, ["get_speed","get_fades","get_output_blanking","get_use_timeline_for_output_blanking","get_name","get_property","set_property","get_duration","get_start","get_end","get_source_start_frame","get_source_end_frame","get_source_start_time","get_source_end_time","get_left_offset","get_right_offset","set_clip_enabled","get_clip_enabled","update_sidecar","get_unique_id","get_media_pool_item","get_stereo_convergence","get_stereo_left_window","get_stereo_right_window","get_linked_items","get_track_type_and_index","get_source_audio_mapping","load_burnin_preset","set_name","get_voice_isolation_state","set_voice_isolation_state","get_retime","set_retime","get_transform","set_transform","get_crop","set_crop","get_composite","set_composite","get_audio","set_audio","get_keyframes","add_keyframe","modify_keyframe","delete_keyframe","set_keyframe_interpolation"])
+    return _unknown(action, ["set_speed","set_fades","get_speed","get_fades","get_output_blanking","get_use_timeline_for_output_blanking","get_name","get_property","set_property","get_duration","get_start","get_end","get_source_start_frame","get_source_end_frame","get_source_start_time","get_source_end_time","get_left_offset","get_right_offset","set_clip_enabled","get_clip_enabled","update_sidecar","get_unique_id","get_media_pool_item","get_stereo_convergence","get_stereo_left_window","get_stereo_right_window","get_linked_items","get_track_type_and_index","get_source_audio_mapping","load_burnin_preset","set_name","get_voice_isolation_state","set_voice_isolation_state","get_retime","set_retime","get_transform","set_transform","get_crop","set_crop","get_composite","set_composite","get_audio","set_audio","get_keyframes","add_keyframe","modify_keyframe","delete_keyframe","set_keyframe_interpolation"])
 
 
 # ═══════════════════════════════════════════════════════════════════════════════
@@ -32644,9 +32663,9 @@ if __name__ == "__main__":
     start_background_update_check(VERSION, project_dir, logger, env=_setup_update_env())
     _install_threaded_tool_dispatch(mcp)
 
-    # Support --full flag to run the 365-tool granular server instead
+    # Support --full flag to run the 367-tool granular server instead
     if "--full" in sys.argv:
-        logger.info("Starting full 365-tool granular server...")
+        logger.info("Starting full 367-tool granular server...")
         sys.argv = [arg for arg in sys.argv if arg != "--full"]
         from src.granular import mcp as granular_mcp
 

package/src/utils/destructive_hook.py

@@ -147,6 +147,12 @@ DESTRUCTIVE_ACTIONS_BY_TOOL: Dict[str, FrozenSet[str]] = {
         "set_retime",
         "set_composite",
         "set_audio",
+        # Native 21.1 setters (#208). Registered on landing: as contributed the
+        # classifier did not recognise them, so safe mode, the dry-run refusal,
+        # the audit log and the operation log all skipped a call that rewrites a
+        # clip's speed — and, with RippleTimeline true, moves every clip after it.
+        "set_speed",
+        "set_fades",
     }),
     "timeline_item_markers": frozenset({
         "add",

package/src/utils/execution_lifecycle.py

@@ -271,6 +271,11 @@ class RiskClassificationHook(LifecycleHook):
         # whatever the caller passed; `set_retime` changes duration and sync.
         ("timeline_item", "set_property"),
         ("timeline_item", "set_retime"),
+        # Native 21.1 setters (#208): `set_speed` changes duration and, with
+        # RippleTimeline true, moves every clip after it; `set_fades` rewrites
+        # how the clip's edges render. Existing content altered, not deleted.
+        ("timeline_item", "set_speed"),
+        ("timeline_item", "set_fades"),
         # Pool reorganisation: clips and bins move, nothing is destroyed, but
         # paths other work depends on change underneath it.
         ("media_pool", "move_clips"),

package/src/utils/resolve211_edits.py

@@ -0,0 +1,26 @@
+"""Validate native 21.1 editing dictionaries without guessing undocumented bounds."""
+import math
+
+
+def validate_edit_options(action, options):
+    if not isinstance(options, dict) or not options:
+        return "options must be a non-empty dictionary"
+    allowed = ({"Percentage", "PitchCorrection", "StretchKeyframesToFit", "RippleTimeline"}
+               if action == "set_speed" else {"FadeIn", "FadeOut"})
+    if set(options) - allowed:
+        return "Unknown options: " + ", ".join(sorted(map(str, set(options) - allowed)))
+    for key, value in options.items():
+        if key in {"PitchCorrection", "StretchKeyframesToFit", "RippleTimeline"}:
+            if type(value) is not bool:
+                return key + " must be a boolean"
+        elif action == "set_fades":
+            if type(value) is not int or value < 0:
+                return key + " must be a non-negative integer number of frames"
+        else:
+            try:
+                finite = type(value) in (int, float) and math.isfinite(value)
+            except OverflowError:
+                finite = False
+            if not finite:
+                return key + " must be a finite number"
+    return None

package/src/utils/resolve_versions.py

@@ -225,6 +225,8 @@ _EVIDENCE_GATES: List[Dict[str, Any]] = [
 # disagree, which is what keeps the two from drifting apart again.
 
 CODE_FLOORS: Dict[str, str] = {
+    "TimelineItem.SetSpeed": "21.1",
+    "TimelineItem.SetFades": "21.1",
     # Documented in the shipped 21.1 scripting CHANGELOG; read-only contributor
     # validation on Studio 21.1.0.14. No claim of a live older-build bisect.
     "Resolve.GetKeyboardPresetList": "21.1",