dcc-mcp-renderdoc 0.3.3__tar.gz → 0.4.0__tar.gz

dcc_mcp_renderdoc-0.4.0/.release-please-manifest.json

@@ -0,0 +1,2 @@
+{".":"0.4.0"}
+

{dcc_mcp_renderdoc-0.3.3 → dcc_mcp_renderdoc-0.4.0}/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.4.0](https://github.com/dcc-mcp/dcc-mcp-renderdoc/compare/v0.3.3...v0.4.0) (2026-07-23)
+
+
+### Features
+
+* auto-download RenderDoc runtime ([e380b95](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/e380b95c9cd7f86a031e4634b39740111af507ec))
+
+
+### Bug Fixes
+
+* classify render work by API operation ([f5cf5a6](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/f5cf5a69b31cd4066d47d28c6701262d3c3225ac))
+* reject captures without rendering work ([5799193](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/57991932e74c57e2826ffba10cbb3f433e55dca7))
+
 ## [0.3.3](https://github.com/dcc-mcp/dcc-mcp-renderdoc/compare/v0.3.2...v0.3.3) (2026-07-22)
 
 

{dcc_mcp_renderdoc-0.3.3 → dcc_mcp_renderdoc-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dcc-mcp-renderdoc
-Version: 0.3.3
+Version: 0.4.0
 Summary: RenderDoc capture and replay automation skills for DCC-MCP
 Project-URL: Homepage, https://github.com/dcc-mcp/dcc-mcp-renderdoc
 Project-URL: Repository, https://github.com/dcc-mcp/dcc-mcp-renderdoc
@@ -105,7 +105,8 @@ through the stable gateway at `http://127.0.0.1:9765/mcp`; set
 - Launch a game or test executable under RenderDoc and wait for a typed `.rdc` capture.
 - Trigger a capture through official Target Control after a configurable delay.
 - Inject into a process that had to be launched by a platform client, then trigger and collect a capture.
-- Inspect capture driver, machine identity, chunk version, API-call counts, and representative calls.
+- Reject no-work captures with actionable diagnostics while preserving the `.rdc` artifact.
+- Inspect capture driver, machine identity, chunk version, frame-work and Present counts, and representative calls.
 - Export a capture thumbnail for visual review.
 - Export Chrome trace JSON for timeline tooling.
 

{dcc_mcp_renderdoc-0.3.3 → dcc_mcp_renderdoc-0.4.0}/README.md

@@ -77,7 +77,8 @@ through the stable gateway at `http://127.0.0.1:9765/mcp`; set
 - Launch a game or test executable under RenderDoc and wait for a typed `.rdc` capture.
 - Trigger a capture through official Target Control after a configurable delay.
 - Inject into a process that had to be launched by a platform client, then trigger and collect a capture.
-- Inspect capture driver, machine identity, chunk version, API-call counts, and representative calls.
+- Reject no-work captures with actionable diagnostics while preserving the `.rdc` artifact.
+- Inspect capture driver, machine identity, chunk version, frame-work and Present counts, and representative calls.
 - Export a capture thumbnail for visual review.
 - Export Chrome trace JSON for timeline tooling.
 

{dcc_mcp_renderdoc-0.3.3 → dcc_mcp_renderdoc-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "dcc-mcp-renderdoc"
-version = "0.3.3"
+version = "0.4.0"
 description = "RenderDoc capture and replay automation skills for DCC-MCP"
 readme = "README.md"
 requires-python = ">=3.9"

{dcc_mcp_renderdoc-0.3.3 → dcc_mcp_renderdoc-0.4.0}/release-please-config.json

@@ -1 +1 @@
-{"packages":{".":{"release-type":"python","package-name":"dcc-mcp-renderdoc","changelog-path":"CHANGELOG.md","include-component-in-tag":false,"extra-files":[{"type":"toml","path":"pyproject.toml","jsonpath":"$.project.version"},{"type":"generic","path":"src/dcc_mcp_renderdoc/__version__.py"},{"type":"toml","path":"uv.lock","jsonpath":"$.package[?(@.name=='dcc-mcp-renderdoc')].version"}]}}}
+{"packages":{".":{"release-type":"python","package-name":"dcc-mcp-renderdoc","changelog-path":"CHANGELOG.md","include-component-in-tag":false,"extra-files":[{"type":"toml","path":"pyproject.toml","jsonpath":"$.project.version"},{"type":"generic","path":"src/dcc_mcp_renderdoc/__version__.py"},{"type":"generic","path":"uv.lock"}]}}}

dcc_mcp_renderdoc-0.4.0/src/dcc_mcp_renderdoc/__version__.py

@@ -0,0 +1,3 @@
+"""Package version."""
+
+__version__ = "0.4.0"  # x-release-please-version

dcc_mcp_renderdoc-0.4.0/src/dcc_mcp_renderdoc/downloader.py

@@ -0,0 +1,88 @@
+"""Download and cache the official RenderDoc command-line bundle."""
+
+from __future__ import annotations
+
+import os
+import re
+import shutil
+import sys
+import tarfile
+import urllib.request
+import zipfile
+from pathlib import Path
+
+
+def _cache_root() -> Path:
+    configured = os.environ.get("DCC_MCP_RUNTIME_CACHE")
+    if configured:
+        return Path(configured).expanduser().resolve() / "renderdoc"
+    if os.name == "nt":
+        root = Path(os.environ.get("LOCALAPPDATA", Path.home() / "AppData/Local"))
+        return root / "dcc-mcp/renderdoc"
+    return Path(os.environ.get("XDG_CACHE_HOME", Path.home() / ".cache")) / "dcc-mcp/renderdoc"
+
+
+def _safe_destination(root: Path, member_name: str) -> Path:
+    destination = (root / member_name).resolve()
+    try:
+        destination.relative_to(root.resolve())
+    except ValueError as exc:
+        raise RuntimeError(f"Archive member escapes destination: {member_name}") from exc
+    return destination
+
+
+def _extract(archive: Path, destination: Path) -> None:
+    destination.mkdir(parents=True, exist_ok=True)
+    if zipfile.is_zipfile(archive):
+        with zipfile.ZipFile(archive) as bundle:
+            for member in bundle.infolist():
+                _safe_destination(destination, member.filename)
+            bundle.extractall(destination)
+        return
+    with tarfile.open(archive, "r:gz") as bundle:
+        for member in bundle.getmembers():
+            _safe_destination(destination, member.name)
+            if member.issym() or member.islnk():
+                raise RuntimeError(f"Archive links are not accepted: {member.name}")
+        bundle.extractall(destination)
+
+
+def download_latest() -> Path:
+    request = urllib.request.Request(
+        "https://renderdoc.org/builds", headers={"User-Agent": "dcc-mcp-renderdoc"}
+    )
+    with urllib.request.urlopen(request, timeout=30) as response:
+        html = response.read().decode("utf-8")
+    versions = set(re.findall(r"/stable/([0-9]+\.[0-9]+)/", html))
+    if not versions:
+        raise RuntimeError("No stable RenderDoc versions found on the official builds page")
+    version = max(versions, key=lambda value: tuple(int(part) for part in value.split(".")))
+    if sys.platform == "win32":
+        archive_name, command_name = f"RenderDoc_{version}_64.zip", "renderdoccmd.exe"
+    elif sys.platform.startswith("linux"):
+        archive_name, command_name = f"renderdoc_{version}.tar.gz", "renderdoccmd"
+    else:
+        raise RuntimeError(f"RenderDoc has no supported desktop bundle for {sys.platform}")
+    destination = _cache_root() / version
+    existing = next(destination.rglob(command_name), None) if destination.exists() else None
+    if existing:
+        return existing.resolve()
+    archive = _cache_root() / archive_name
+    _cache_root().mkdir(parents=True, exist_ok=True)
+    try:
+        with (
+            urllib.request.urlopen(
+                f"https://renderdoc.org/stable/{version}/{archive_name}", timeout=120
+            ) as response,
+            archive.open("wb") as stream,
+        ):
+            shutil.copyfileobj(response, stream)
+        _extract(archive, destination)
+    finally:
+        archive.unlink(missing_ok=True)
+    command = next(destination.rglob(command_name), None)
+    if command is None:
+        raise RuntimeError(f"Downloaded bundle did not contain {command_name}")
+    if sys.platform.startswith("linux"):
+        command.chmod(command.stat().st_mode | 0o111)
+    return command.resolve()

{dcc_mcp_renderdoc-0.3.3 → dcc_mcp_renderdoc-0.4.0}/src/dcc_mcp_renderdoc/runtime.py

@@ -16,6 +16,8 @@ from collections import Counter
 from pathlib import Path
 from typing import Any, Iterable, Optional, Sequence
 
+from .downloader import download_latest
+
 
 class RenderDocError(RuntimeError):
     """Raised when a RenderDoc operation cannot satisfy its contract."""
@@ -120,6 +122,17 @@ def resolve_renderdoccmd(explicit: Optional[str] = None) -> Path:
         found = shutil.which(name)
         if found:
             return Path(found).resolve()
+    if os.environ.get("DCC_MCP_RENDERDOC_AUTO_DOWNLOAD", "1").lower() not in {
+        "0",
+        "false",
+        "no",
+    }:
+        try:
+            return download_latest()
+        except (OSError, RuntimeError) as exc:
+            raise RenderDocError(
+                f"RenderDoc was not found and automatic download failed: {exc}"
+            ) from exc
     raise RenderDocError(
         "renderdoccmd was not found; install RenderDoc or set DCC_MCP_RENDERDOC_CMD"
     )
@@ -472,9 +485,11 @@ def capture_program(
             f"before creating its graphics device. {diagnostics}. "
             f"RenderDoc output: {output_detail}"
         )
+    capture_validations = _validate_frame_captures(captures, command=command)
     return {
         "target": str(target),
         "captures": [str(path) for path in captures],
+        "capture_validations": capture_validations,
         "focused_target_window": False,
         "trigger_mode": trigger_mode,
         "stdout": stdout.strip(),
@@ -542,9 +557,11 @@ def capture_process(
             f"capture_program. {diagnostics}. "
             f"RenderDoc output: {output_detail}"
         )
+    capture_validations = _validate_frame_captures(captures, command=command)
     return {
         "process_id": process_id,
         "captures": [str(path) for path in captures],
+        "capture_validations": capture_validations,
         "focused_target_window": False,
         "trigger_mode": "target_control",
         "stdout": stdout.strip(),
@@ -626,6 +643,75 @@ def _child_text(parent: ET.Element, name: str) -> Optional[str]:
     return child.text.strip() if child is not None and child.text else None
 
 
+def _chunk_operation(name: str) -> str:
+    if name.casefold().startswith("internal::"):
+        return ""
+    return name.rsplit("::", 1)[-1].casefold()
+
+
+def _is_draw_or_dispatch_chunk(name: str) -> bool:
+    operation = _chunk_operation(name)
+    if operation.startswith("gldrawbuffer"):
+        return False
+    return operation.startswith(
+        (
+            "draw",
+            "dispatch",
+            "tracerays",
+            "executeindirect",
+            "vkcmddraw",
+            "vkcmddispatch",
+            "vkcmdtracerays",
+            "gldraw",
+            "glmultidraw",
+            "gldispatch",
+        )
+    )
+
+
+def _is_frame_work_chunk(name: str) -> bool:
+    if _is_draw_or_dispatch_chunk(name):
+        return True
+    operation = _chunk_operation(name)
+    if operation.startswith("gl"):
+        clear = operation == "glclear" or operation.startswith(
+            ("glclearbuffer", "glclearnamedframebuffer", "glcleartex")
+        )
+    else:
+        clear = operation != "clearstate" and operation.startswith(("clear", "vkcmdclear"))
+    return clear or operation.startswith(
+        (
+            "copy",
+            "resolve",
+            "blit",
+            "vkcmdcopy",
+            "vkcmdresolve",
+            "vkcmdblit",
+            "glcopy",
+            "glblit",
+            "vkcmdbeginrenderpass",
+            "vkcmdbeginrendering",
+            "vkcmdexecutecommands",
+            "executecommandlist",
+        )
+    )
+
+
+def _is_present_chunk(name: str) -> bool:
+    operation = _chunk_operation(name)
+    return operation.startswith(
+        (
+            "present",
+            "vkqueuepresent",
+            "swapbuffers",
+            "glxswapbuffers",
+            "eglswapbuffers",
+            "wglswapbuffers",
+            "wglswaplayerbuffers",
+        )
+    )
+
+
 def parse_capture_xml(xml_file: str, *, representative_limit: int = 20) -> dict[str, Any]:
     """Parse the stable high-level fields emitted by RenderDoc's XML converter."""
     path = Path(xml_file)
@@ -644,6 +730,9 @@ def parse_capture_xml(xml_file: str, *, representative_limit: int = 20) -> dict[
     thumbnail = header.find("thumbnail")
     names = [chunk.get("name") or "unnamed" for chunk in chunks.findall("chunk")]
     counts = Counter(names)
+    draw_dispatch_count = sum(_is_draw_or_dispatch_chunk(name) for name in names)
+    frame_work_count = sum(_is_frame_work_chunk(name) for name in names)
+    present_count = sum(_is_present_chunk(name) for name in names)
     return {
         "driver": {
             "id": driver.get("id") if driver is not None else None,
@@ -656,6 +745,12 @@ def parse_capture_xml(xml_file: str, *, representative_limit: int = 20) -> dict[
         },
         "chunk_version": chunks.get("version"),
         "chunk_count": len(names),
+        "draw_dispatch_count": draw_dispatch_count,
+        "frame_work_count": frame_work_count,
+        "present_count": present_count,
+        "frame_content_status": (
+            "rendering_commands_present" if frame_work_count else "no_rendering_work"
+        ),
         "chunk_frequencies": [
             {"name": name, "count": count} for name, count in counts.most_common(20)
         ],
@@ -689,6 +784,47 @@ def inspect_capture(
     return {"capture_file": str(capture), "size_bytes": capture.stat().st_size, **details}
 
 
+def _validate_frame_captures(
+    captures: Sequence[Path], *, command: Optional[str]
+) -> list[dict[str, Any]]:
+    validations = []
+    for capture in captures:
+        details = inspect_capture(str(capture), command=command)
+        if details["frame_work_count"] == 0:
+            diagnostics = {
+                "capture_file": details["capture_file"],
+                "driver": details["driver"],
+                "chunk_count": details["chunk_count"],
+                "draw_dispatch_count": details["draw_dispatch_count"],
+                "present_count": details["present_count"],
+                "representative_chunks": details["representative_chunks"],
+            }
+            raise RenderDocError(
+                "RenderDoc capture contains no rendering work (Draw, Dispatch, Clear, Copy, "
+                "Resolve, Blit, render-pass work, or command-list execution) and is not a usable "
+                "frame capture. The .rdc was preserved; retry while the target is actively "
+                "rendering and verify the selected process or child target. "
+                f"diagnostics={json.dumps(diagnostics, sort_keys=True)}"
+            )
+        validations.append(
+            {
+                key: details[key]
+                for key in (
+                    "capture_file",
+                    "size_bytes",
+                    "driver",
+                    "thumbnail",
+                    "chunk_count",
+                    "draw_dispatch_count",
+                    "frame_work_count",
+                    "present_count",
+                    "frame_content_status",
+                )
+            }
+        )
+    return validations
+
+
 def _prepare_output(output_file: str, expected_suffixes: Iterable[str]) -> Path:
     path = Path(output_file).expanduser().resolve()
     if path.suffix.lower() not in set(expected_suffixes):

{dcc_mcp_renderdoc-0.3.3 → dcc_mcp_renderdoc-0.4.0}/src/dcc_mcp_renderdoc/skills/renderdoc-analysis/SKILL.md

@@ -23,3 +23,6 @@ metadata:
 Inspect before exporting. These tools never modify the input `.rdc`; exports require an explicit
 destination path and create its parent directory when needed.
 
+Inspection reports `draw_dispatch_count`, `frame_work_count`, `present_count`, and
+`frame_content_status` so a structurally readable capture with no rendering work is not mistaken
+for a usable frame.

{dcc_mcp_renderdoc-0.3.3 → dcc_mcp_renderdoc-0.4.0}/src/dcc_mcp_renderdoc/skills/renderdoc-analysis/tools.yaml

@@ -1,6 +1,6 @@
 tools:
   - name: inspect_capture
-    description: Convert one .rdc capture to temporary XML and summarize stable header and chunk metadata. Use for offline triage. Not for GPU performance conclusions or high-level drawcall reconstruction.
+    description: Convert one .rdc capture to temporary XML and summarize stable header, chunk metadata, Draw/Dispatch count, frame-work count, Present count, and frame-content status. Use for offline triage and identifying readable but unusable no-work captures. Not for GPU performance conclusions or high-level drawcall reconstruction.
     input_schema:
       type: object
       required: [capture_file]

{dcc_mcp_renderdoc-0.3.3 → dcc_mcp_renderdoc-0.4.0}/src/dcc_mcp_renderdoc/skills/renderdoc-capture/SKILL.md

@@ -32,6 +32,11 @@ The official RenderDoc runtime supports Windows and Linux, not macOS (where this
 Python unit tests only). On headless Linux, run the adapter under Xvfb or provide another working
 X/Wayland display; the official archive does not include Qt's `offscreen` platform plugin.
 
+Capture tools inspect each new `.rdc` before reporting success. A capture with no frame work such
+as Draw, Dispatch, Clear, Copy, Resolve, Blit, render-pass work, or command-list execution is
+rejected with chunk diagnostics while the `.rdc` remains at the requested output path; retry while
+the intended target is actively rendering or correct the selected child process.
+
 Use `capture_process` when Steam or another platform client must launch the target first. It
 injects into the explicit PID, connects to the returned Target Control ident, requests one capture
 after the configured delay, and waits for the resulting file. It never takes foreground focus or

{dcc_mcp_renderdoc-0.3.3 → dcc_mcp_renderdoc-0.4.0}/src/dcc_mcp_renderdoc/skills/renderdoc-capture/tools.yaml

@@ -14,7 +14,7 @@ tools:
       on-success: [renderdoc_capture__capture_program]
       on-failure: [dcc_diagnostics__audit_log]
   - name: capture_program
-    description: Launch one explicit executable under RenderDoc and return newly created .rdc files. With trigger_after_secs, request the frame through official local Target Control without foreground or keyboard input. With hook_children enabled, trigger_process_name first checks the launched target, then follows only its official NewChild messages to select a unique matching child. Use for controlled game or graphics test capture. Not for shell commands or attaching to an existing process.
+    description: Launch one explicit executable under RenderDoc and return newly created .rdc files only when they contain frame work such as Draw, Dispatch, Clear, Copy, Resolve, Blit, render-pass work, or command-list execution. A no-work capture is preserved and reported as a failure with chunk diagnostics. With trigger_after_secs, request the frame through official local Target Control without foreground or keyboard input. With hook_children enabled, trigger_process_name first checks the launched target, then follows only its official NewChild messages to select a unique matching child. Use for controlled game or graphics test capture. Not for shell commands or attaching to an existing process.
     input_schema:
       type: object
       required: [executable, output_template]
@@ -46,7 +46,7 @@ tools:
       on-success: [renderdoc_analysis__inspect_capture, renderdoc_analysis__export_thumbnail]
       on-failure: [dcc_diagnostics__audit_log]
   - name: capture_process
-    description: Inject RenderDoc into one process before it creates its graphics device, request a capture through official local Target Control after a delay, and return the new .rdc file without foreground or keyboard input. Use when a game must be launched by its platform client. Prefer capture_program for an already initialized game; not for process termination.
+    description: Inject RenderDoc into one process before it creates its graphics device, request a capture through official local Target Control after a delay, and return the new .rdc file only when it contains frame work such as Draw, Dispatch, Clear, Copy, Resolve, Blit, render-pass work, or command-list execution. A no-work capture is preserved and reported as a failure with chunk diagnostics. Use when a game must be launched by its platform client. Prefer capture_program for an already initialized game; not for process termination.
     input_schema:
       type: object
       required: [process_id, output_template]

{dcc_mcp_renderdoc-0.3.3 → dcc_mcp_renderdoc-0.4.0}/tests/test_runtime.py

@@ -32,6 +32,23 @@ def _default_target_control_delay(monkeypatch):
     monkeypatch.setattr(runtime.sys, "platform", "win32")
 
 
+@pytest.fixture
+def valid_frame_captures(monkeypatch):
+    monkeypatch.setattr(
+        runtime,
+        "_validate_frame_captures",
+        lambda captures, **_kwargs: [
+            {
+                "capture_file": str(capture),
+                "draw_dispatch_count": 1,
+                "frame_work_count": 1,
+                "frame_content_status": "rendering_commands_present",
+            }
+            for capture in captures
+        ],
+    )
+
+
 def test_parse_capture_xml_summarizes_stable_fields(tmp_path: Path):
     xml_file = tmp_path / "capture.xml"
     xml_file.write_text(
@@ -47,10 +64,90 @@ def test_parse_capture_xml_summarizes_stable_fields(tmp_path: Path):
     assert result["driver"] == {"id": "2", "name": "Vulkan"}
     assert result["thumbnail"] == {"width": 640, "height": 360}
     assert result["chunk_count"] == 3
+    assert result["draw_dispatch_count"] == 2
+    assert result["frame_work_count"] == 2
+    assert result["present_count"] == 1
+    assert result["frame_content_status"] == "rendering_commands_present"
     assert result["chunk_frequencies"][0] == {"name": "vkCmdDraw", "count": 2}
     assert result["representative_chunks"] == ["vkCmdDraw", "vkCmdDraw"]
 
 
+def test_parse_capture_xml_accepts_clear_and_copy_only_frame_work(tmp_path: Path):
+    xml_file = tmp_path / "capture.xml"
+    xml_file.write_text(
+        """<rdc><header><driver id="1">D3D11</driver></header><chunks version="1">
+        <chunk name="ID3D11DeviceContext::ClearRenderTargetView"/>
+        <chunk name="ID3D11DeviceContext::CopyResource"/>
+        <chunk name="IDXGISwapChain::Present"/>
+        </chunks></rdc>""",
+        encoding="utf-8",
+    )
+
+    result = runtime.parse_capture_xml(str(xml_file))
+
+    assert result["draw_dispatch_count"] == 0
+    assert result["frame_work_count"] == 2
+    assert result["frame_content_status"] == "rendering_commands_present"
+
+
+def test_parse_capture_xml_rejects_opengl_state_only_frame(tmp_path: Path):
+    xml_file = tmp_path / "capture.xml"
+    xml_file.write_text(
+        """<rdc><header><driver id="3">OpenGL</driver></header><chunks version="1">
+        <chunk name="glDrawBuffer"/><chunk name="glDrawBuffers"/>
+        <chunk name="glNamedFramebufferDrawBuffer"/>
+        <chunk name="glNamedFramebufferDrawBuffers"/>
+        <chunk name="glClearColor"/><chunk name="glClearDepth"/>
+        <chunk name="glClearStencil"/><chunk name="SwapBuffers"/>
+        </chunks></rdc>""",
+        encoding="utf-8",
+    )
+
+    result = runtime.parse_capture_xml(str(xml_file))
+
+    assert result["draw_dispatch_count"] == 0
+    assert result["frame_work_count"] == 0
+    assert result["present_count"] == 1
+    assert result["frame_content_status"] == "no_rendering_work"
+
+
+def test_parse_capture_xml_accepts_vulkan_render_pass_work(tmp_path: Path):
+    xml_file = tmp_path / "capture.xml"
+    xml_file.write_text(
+        """<rdc><header><driver id="2">Vulkan</driver></header><chunks version="1">
+        <chunk name="vkCmdBeginRenderPass"/><chunk name="vkCmdBeginRendering"/>
+        <chunk name="vkQueuePresentKHR"/>
+        </chunks></rdc>""",
+        encoding="utf-8",
+    )
+
+    result = runtime.parse_capture_xml(str(xml_file))
+
+    assert result["draw_dispatch_count"] == 0
+    assert result["frame_work_count"] == 2
+    assert result["present_count"] == 1
+    assert result["frame_content_status"] == "rendering_commands_present"
+
+
+def test_parse_capture_xml_accepts_explicit_command_list_execution(tmp_path: Path):
+    xml_file = tmp_path / "capture.xml"
+    xml_file.write_text(
+        """<rdc><header><driver id="2">Vulkan</driver></header><chunks version="1">
+        <chunk name="vkCmdExecuteCommands"/>
+        <chunk name="ID3D11DeviceContext::ExecuteCommandList"/>
+        <chunk name="ID3D12CommandQueue::ExecuteCommandLists"/>
+        <chunk name="vkQueuePresentKHR"/>
+        </chunks></rdc>""",
+        encoding="utf-8",
+    )
+
+    result = runtime.parse_capture_xml(str(xml_file))
+
+    assert result["draw_dispatch_count"] == 0
+    assert result["frame_work_count"] == 3
+    assert result["present_count"] == 1
+
+
 def test_resolve_renderdoccmd_prefers_explicit_file(tmp_path: Path):
     executable = tmp_path / "renderdoccmd"
     executable.touch()
@@ -63,8 +160,17 @@ def test_capture_program_uses_argument_vector_and_reports_new_capture(tmp_path,
     observed = {}
 
     def fake_run(arguments, **_kwargs):
-        observed["arguments"] = arguments
-        (tmp_path / "capture_frame1.rdc").write_bytes(b"rdc")
+        if arguments[0] == "capture":
+            observed["arguments"] = arguments
+            (tmp_path / "capture_frame1.rdc").write_bytes(b"rdc")
+        elif arguments[0] == "convert":
+            xml_file = Path(arguments[arguments.index("--output") + 1])
+            xml_file.write_text(
+                """<rdc><header><driver id="2">Vulkan</driver></header><chunks version="1">
+                <chunk name="vkCmdDrawIndexed"/><chunk name="Present"/>
+                </chunks></rdc>""",
+                encoding="utf-8",
+            )
         return CompletedProcess(arguments, 0, "captured", "")
 
     monkeypatch.setattr(runtime, "_run", fake_run)
@@ -76,6 +182,36 @@ def test_capture_program_uses_argument_vector_and_reports_new_capture(tmp_path,
 
     assert observed["arguments"][-3:] == [str(target.resolve()), "--scene", "demo"]
     assert result["captures"] == [str((tmp_path / "capture_frame1.rdc").resolve())]
+    assert result["capture_validations"][0]["draw_dispatch_count"] == 1
+
+
+def test_capture_program_rejects_present_only_capture_and_preserves_rdc(tmp_path, monkeypatch):
+    target = tmp_path / "game.exe"
+    target.touch()
+    capture = tmp_path / "capture_frame1.rdc"
+
+    def fake_run(arguments, **_kwargs):
+        if arguments[0] == "capture":
+            capture.write_bytes(b"rdc")
+        elif arguments[0] == "convert":
+            xml_file = Path(arguments[arguments.index("--output") + 1])
+            xml_file.write_text(
+                """<rdc><header><driver id="1">D3D11</driver></header><chunks version="1">
+                <chunk name="Internal::Drawcall Metadata"/>
+                <chunk name="ID3D11DeviceContext::RSSetViewports"/>
+                <chunk name="ID3D11DeviceContext::ClearState"/>
+                <chunk name="IDXGISwapChain::Present"/>
+                </chunks></rdc>""",
+                encoding="utf-8",
+            )
+        return CompletedProcess(arguments, 0, "", "")
+
+    monkeypatch.setattr(runtime, "_run", fake_run)
+
+    with pytest.raises(runtime.RenderDocError, match="no rendering work"):
+        runtime.capture_program(str(target), str(tmp_path / "capture"))
+
+    assert capture.is_file()
 
 
 def test_non_waiting_launch_accepts_renderdoc_target_id(monkeypatch, tmp_path):
@@ -1395,7 +1531,7 @@ def test_bundled_target_control_is_python36_compatible():
     ast.parse(source, feature_version=(3, 6))
 
 
-def test_capture_program_reuses_target_control_trigger(tmp_path, monkeypatch):
+def test_capture_program_reuses_target_control_trigger(tmp_path, monkeypatch, valid_frame_captures):
     target = tmp_path / "game.exe"
     target.touch()
     capture = tmp_path / "capture_frame1.rdc"
@@ -1453,7 +1589,7 @@ def test_capture_program_rejects_child_name_without_child_hook(tmp_path):
         )
 
 
-def test_capture_process_reuses_target_control_trigger(tmp_path, monkeypatch):
+def test_capture_process_reuses_target_control_trigger(tmp_path, monkeypatch, valid_frame_captures):
     capture = tmp_path / "capture_frame1.rdc"
     observed = {}
     monkeypatch.setattr(
@@ -1494,7 +1630,9 @@ def test_capture_process_reuses_target_control_trigger(tmp_path, monkeypatch):
     assert result["trigger_mode"] == "target_control"
 
 
-def test_capture_process_injects_triggers_and_reports_capture(tmp_path, monkeypatch):
+def test_capture_process_injects_triggers_and_reports_capture(
+    tmp_path, monkeypatch, valid_frame_captures
+):
     observed = {}
     capture = tmp_path / "capture_frame1.rdc"
 
@@ -1522,7 +1660,7 @@ def test_capture_process_injects_triggers_and_reports_capture(tmp_path, monkeypa
 
 
 def test_capture_process_triggers_while_injector_is_running_and_only_stops_injector(
-    tmp_path, monkeypatch
+    tmp_path, monkeypatch, valid_frame_captures
 ):
     started = {}
     target = {"running": True}
@@ -1628,7 +1766,9 @@ def test_capture_process_readiness_timeout_force_stops_only_injector(tmp_path, m
     assert target["running"] is True
 
 
-def test_triggered_program_capture_keeps_controller_alive_until_capture(tmp_path, monkeypatch):
+def test_triggered_program_capture_keeps_controller_alive_until_capture(
+    tmp_path, monkeypatch, valid_frame_captures
+):
     target = tmp_path / "game.exe"
     target.touch()
     command = tmp_path / "renderdoccmd.exe"
@@ -1684,3 +1824,10 @@ def test_triggered_program_capture_keeps_controller_alive_until_capture(tmp_path
 def test_invalid_capture_is_rejected(tmp_path: Path):
     with pytest.raises(runtime.RenderDocError, match="not .rdc"):
         runtime.inspect_capture(str(tmp_path / "missing.rdc"))
+
+
+def test_missing_runtime_can_disable_auto_download(monkeypatch, tmp_path: Path):
+    monkeypatch.setenv("DCC_MCP_RENDERDOC_CMD", str(tmp_path / "missing"))
+    monkeypatch.setenv("DCC_MCP_RENDERDOC_AUTO_DOWNLOAD", "0")
+    with pytest.raises(runtime.RenderDocError, match="does not exist"):
+        runtime.resolve_renderdoccmd()

dcc_mcp_renderdoc-0.3.3/.release-please-manifest.json

@@ -1,2 +0,0 @@
-{".":"0.3.3"}
-

dcc_mcp_renderdoc-0.3.3/src/dcc_mcp_renderdoc/__version__.py

@@ -1,3 +0,0 @@
-"""Package version."""
-
-__version__ = "0.3.3"  # x-release-please-version