davinci-resolve-mcp 2.93.3 → 2.94.0

package/CHANGELOG.md

@@ -2,6 +2,46 @@
 
 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.94.0
+
+Adds four delivery targets for deliverable classes the table did not cover:
+image sequences for web/graphics, animated web assets, and an HTTP Live
+Streaming package. All 32 targets resolve live on Studio 21.0.4.5.
+
+### Added
+
+- **`png_sequence`** — PNG frames for web and motion-graphics handoff. Resolve
+  exposes **RGB only** (no alpha codec), so the target says so and points at
+  `dpx_sequence` (`RGBA 8 bits`) or `prores4444_master` when transparency is
+  actually needed. Alias: `png`.
+- **`gif_animated`** — looping animated GIF. No audio track at all, so
+  `ExportAudio` is False rather than merely unpinned. Its QC projection uses
+  ffprobe values measured on a generated file (`container: gif`, `codec: gif`).
+  Alias: `gif`.
+- **`webp_animated`** — looping animated WebP. Ships with **no QC projection**:
+  the reference machine's ffmpeg has only the `webp_pipe` still-image demuxer, so
+  a rendered animated WebP could not be probed and the ffprobe values are
+  unmeasured. `qc_skip_reason` says exactly that. Guessing `webp`/`webp` would
+  have produced QC failures about vocabulary rather than about the deliverable —
+  the same trap as mp4 reporting its container as `mov`. Alias: `webp`.
+- **`hls_h264`** — HTTP Live Streaming package (`.m3u8` playlist plus segments),
+  in the `package` tier alongside IMF and DCP. Bitrate ladders, variant playlists
+  and encryption keys are not expressible as a render target. Aliases: `hls`,
+  `streaming`.
+
+### Notes
+
+- PNG, WebP and HLS are **not render formats on Resolve 19.x**. These targets
+  resolve on 21.x and fail loudly with the machine's available list on older
+  builds, which is the designed behavior rather than a regression.
+- Deliberately **not** added, having checked the full 21.0.4.5 matrix: container
+  swaps that duplicate existing capability (MKV carries the same ProRes and
+  H.264/H.265 codecs already covered), standalone JPEG 2000 (the same essence the
+  IMF/DCP targets reach), and legacy formats (AVI, Cineon, MJ2, Panasonic AVC
+  8K). All remain reachable via a `format_candidates` override or a user target.
+- `braw`, `mts` and `wav` expose zero codecs and reject every codec value, so no
+  target is possible for them at all.
+
 ## What's New in v2.93.3
 
 Re-verifies the delivery-target table and the two recorded render API

package/README.md

@@ -2,7 +2,7 @@
 
 English | [简体中文](README.zh-CN.md)
 
-[![Version](https://img.shields.io/badge/version-2.93.3-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.94.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-34%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.93.3-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.94.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-34%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.93.3 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
+> 本翻译对应 v2.94.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
 
 一个 Model Context Protocol (MCP) 服务器，让 AI 助手通过官方脚本 API 控制 DaVinci Resolve Studio（达芬奇）。它提供完整的 API 覆盖，外加带护栏的工作流助手，涵盖剪辑、媒体池整理、渲染设置、审阅标记、调色、Fusion、Fairlight、项目生命周期任务、扩展开发，以及不碰源媒体的媒体分析。
 

package/install.py

@@ -36,7 +36,7 @@ from src.utils.update_check import (
 
 # ─── Version ──────────────────────────────────────────────────────────────────
 
-VERSION = "2.93.3"
+VERSION = "2.94.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.93.3",
+  "version": "2.94.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.93.3"
+VERSION = "2.94.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.93.3"
+VERSION = "2.94.0"
 
 import base64
 import os

package/src/utils/delivery_targets.py

@@ -110,9 +110,11 @@ major-version upgrade.
 
 Two findings changed between the builds and should not be treated as fixed facts:
 
-- **PNG.** Not a render format on 19.1.3.7; it *is* one on 21.0.4.5 (along with
-  `jpg` and `webp`). There is still no `png_sequence` target, but the reason is
-  now "not added", not "impossible".
+- **PNG, WebP and HLS.** Not render formats on 19.1.3.7; they *are* on 21.0.4.5.
+  `png_sequence`, `webp_animated` and `hls_h264` therefore resolve on 21.x and
+  fail loudly on 19.x, which is the correct behavior rather than a regression.
+  PNG exposes RGB only — no alpha codec — so it does not replace `dpx_sequence`
+  for transparency.
 - **Zero-codec formats.** `wav` and `gif` on 19.x; `braw`, `mts` and `wav` on
   21.x — `gif` gained codecs, BRAW and MTS lost them. `wav` is the constant, so
   an audio-only WAV target remains inexpressible through
@@ -578,6 +580,63 @@ DELIVERY_TARGETS: Dict[str, DeliveryTarget] = {
         ("RGB 16 bits", "RGB16", "RGB 8 bits"),
         "TIFF frames for stills-oriented or archival handoff.",
     ),
+    "png_sequence": _sequence(
+        "png_sequence", "PNG image sequence", ("PNG", "png"),
+        ("RGB16", "RGB 16 bits", "RGB8", "RGB 8 bits"),
+        "PNG frames for web and motion-graphics handoff.",
+        notes=(
+            "RGB ONLY — Resolve exposes no alpha PNG codec (21.0.4.5 offers just "
+            "'RGB 16 bits' / 'RGB 8 bits'). For transparency use dpx_sequence "
+            "('RGBA 8 bits') or prores4444_master.",
+            "PNG is not a render format on Resolve 19.x; this target resolves on 21.x+.",
+        ),
+    ),
+    # ── Animated web assets ─────────────────────────────────────────────────
+    # Not _web(): that helper pins mp4 and requires a raster. These carry no
+    # audio track at all, so export_audio is False rather than merely unpinned.
+    "gif_animated": DeliveryTarget(
+        id="gif_animated",
+        label="Animated GIF",
+        describe="Looping animated GIF for web/social placement. No audio.",
+        tier="web",
+        format_candidates=("GIF", "gif"),
+        codec_candidates=("Animated_GIF", "Animated GIF"),
+        qc_container="gif",
+        qc_codec="gif",
+        export_audio=False,
+        verified=_VERIFIED,
+        source="Live matrix: GIF render format; ffprobe values measured on a generated .gif.",
+        notes=(
+            "GIF carries no audio and is palette-limited to 256 colours; prefer "
+            "webp_animated where the destination supports it.",
+            "Raster and rate inherit the timeline — set them explicitly for a "
+            "placement with a fixed spec.",
+        ),
+    ),
+    "webp_animated": DeliveryTarget(
+        id="webp_animated",
+        label="Animated WebP",
+        describe="Looping animated WebP for web placement. No audio.",
+        tier="web",
+        format_candidates=("WebP", "webp"),
+        codec_candidates=("Animated_WEBP", "Animated WebP"),
+        export_audio=False,
+        # No QC projection on purpose — see qc_skip_reason. Guessing "webp"/"webp"
+        # would produce failures that say nothing about the deliverable, which is
+        # the exact trap the mp4-reports-as-mov case taught.
+        qc_skip_reason=(
+            "ffprobe container/codec values for animated WebP are unverified: the "
+            "reference machine's ffmpeg has only the webp_pipe still-image demuxer, "
+            "so a rendered animated WebP could not be probed. Measure and fill in "
+            "qc_container/qc_codec on a build with full WebP support."
+        ),
+        verified=_VERIFIED,
+        source="Live matrix: WebP render format (ffprobe side unmeasured).",
+        notes=(
+            "WebP carries no audio track.",
+            "WebP is not a render format on Resolve 19.x; this target resolves on 21.x+.",
+        ),
+    ),
     # ── Broadcast / Avid handoff ────────────────────────────────────────────
     "dnxhr_hq_mxf_opatom": DeliveryTarget(
         id="dnxhr_hq_mxf_opatom",
@@ -644,6 +703,17 @@ DELIVERY_TARGETS: Dict[str, DeliveryTarget] = {
             "need a human. easyDCP variants exist on this install too.",
         ),
     ),
+    "hls_h264": _package(
+        "hls_h264", "HLS package (H.264)",
+        ("HLS", "m3u8"), ("H264", "H.264"),
+        "HTTP Live Streaming package: an .m3u8 playlist plus its segment files.",
+        notes=(
+            "HLS is a PACKAGE: a playlist plus segments, not one file. Bitrate ladders, "
+            "variant playlists and encryption keys are not expressible as a render target "
+            "— this selects the format/codec only.",
+            "HLS is not a render format on Resolve 19.x; this target resolves on 21.x+.",
+        ),
+    ),
 }
 
 VALID_TARGETS = frozenset(DELIVERY_TARGETS)
@@ -676,6 +746,11 @@ TARGET_ALIASES: Dict[str, str] = {
     "dnx_master": "dnxhr_hqx_master",
     "avid": "dnxhr_hq_mxf_opatom",
     "vfx": "exr_sequence",
+    "png": "png_sequence",
+    "gif": "gif_animated",
+    "webp": "webp_animated",
+    "hls": "hls_h264",
+    "streaming": "hls_h264",
 }
 
 #: Fields a caller may override per call. Deliberately excludes id/label/tier/