dcc-mcp-renderdoc 0.2.1__tar.gz → 0.3.1__tar.gz

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

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

dcc_mcp_renderdoc-0.3.1/CHANGELOG.md

@@ -0,0 +1,56 @@
+# Changelog
+
+## [0.3.1](https://github.com/dcc-mcp/dcc-mcp-renderdoc/compare/v0.3.0...v0.3.1) (2026-07-22)
+
+
+### Bug Fixes
+
+* allow long-running frame trigger delays ([#10](https://github.com/dcc-mcp/dcc-mcp-renderdoc/issues/10)) ([3212cf7](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/3212cf7c9f236b28b48bf0d28705e2b1939fbe21))
+* capture relaunched child processes ([39e5603](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/39e5603112c8cad98807da3fee86248dd03fb824))
+
+
+### Documentation
+
+* align agent workflow and branding ([ca8b2cf](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/ca8b2cf955a470a87efde24c12e9ebbdb284633c))
+* document CLI install and updates ([599cc70](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/599cc70445e11c2fc53d2626c24f9912365b87e0))
+
+## [0.3.0](https://github.com/dcc-mcp/dcc-mcp-renderdoc/compare/v0.2.1...v0.3.0) (2026-07-16)
+
+
+### Features
+
+* automate interactive frame capture ([3131ed3](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/3131ed35a5f252993c7a099a05071e73313126c3))
+* default adapter instances to dynamic ports ([#6](https://github.com/dcc-mcp/dcc-mcp-renderdoc/issues/6)) ([b4bd77b](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/b4bd77bfc487755fc1aadc390997be638382ada1))
+
+
+### Bug Fixes
+
+* keep capture diagnostics cross-platform ([a477bfd](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/a477bfd9f32d609f141d6d77d0576a861fd60bf1))
+* report capture target diagnostics ([861c852](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/861c8528b35a13fdd8441a89ede80f967e811839))
+
+## [0.2.1](https://github.com/dcc-mcp/dcc-mcp-renderdoc/compare/v0.2.0...v0.2.1) (2026-07-15)
+
+
+### Bug Fixes
+
+* keep runtime version aligned with package ([b3eb754](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/b3eb754c98416dd1d0b467691949e61bd679cb88))
+
+## [0.2.0](https://github.com/dcc-mcp/dcc-mcp-renderdoc/compare/v0.1.0...v0.2.0) (2026-07-15)
+
+
+### Features
+
+* add RenderDoc MCP adapter ([a324344](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/a324344d5dcab758282c77598f4591076526f44e))
+
+
+### Bug Fixes
+
+* capture a supported OpenGL core context ([7817a6f](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/7817a6fd3a7e683a37348ed4a0582bfe456024b6))
+* include C boolean definitions in smoke target ([a9471ed](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/a9471ed7fef6f663a74ed9c9207ae8231bc5dafc))
+* initialize OpenGL before frame capture ([af3c93c](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/af3c93c2b7fc794769187d7e237596d5c37de97b))
+* target explicit RenderDoc frame capture ([99f1568](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/99f1568e0367c156c6c01106109ea4333e0788f5))
+* trigger a presented frame in RenderDoc smoke ([2d939cb](https://github.com/dcc-mcp/dcc-mcp-renderdoc/commit/2d939cb3432ff6280ac44e56b6f785d1ff98d2ee))
+
+## Changelog
+
+All notable changes to this project will be documented in this file.

{dcc_mcp_renderdoc-0.2.1 → dcc_mcp_renderdoc-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dcc-mcp-renderdoc
-Version: 0.2.1
+Version: 0.3.1
 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
@@ -18,7 +18,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Games/Entertainment
 Requires-Python: >=3.9
-Requires-Dist: dcc-mcp-core<1.0.0,>=0.19.38
+Requires-Dist: dcc-mcp-core<1.0.0,>=0.19.45
 Provides-Extra: dev
 Requires-Dist: build>=1.2; extra == 'dev'
 Requires-Dist: pytest>=8; extra == 'dev'
@@ -28,6 +28,53 @@ Description-Content-Type: text/markdown
 
 # dcc-mcp-renderdoc
 
+<p align="center">
+  <img src="docs/assets/dcc-mcp-renderdoc.svg" alt="DCC-MCP · RENDERDOC" width="600">
+</p>
+
+## Agent workflow
+
+AI agents should use the shared gateway through `dcc-mcp-cli`; IDE users may
+continue to use the MCP endpoint. Prefer typed skills and tools over raw scripts.
+
+### Install or update the CLI
+
+`dcc-mcp-cli` is the preferred control path for every shell-capable agent. If
+it is missing, ask the user before installing the latest official release:
+
+```bash
+# Linux/macOS
+curl -fsSL https://raw.githubusercontent.com/dcc-mcp/dcc-mcp-core/main/scripts/install-cli.sh | sh
+
+# Windows PowerShell
+powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/dcc-mcp/dcc-mcp-core/main/scripts/install-cli.ps1 | iex"
+```
+
+Keep an official build current through the release manifest:
+
+```bash
+dcc-mcp-cli update check
+dcc-mcp-cli update apply
+```
+
+`update apply` downloads and stages the latest CLI for the next launch. It
+does not update a running `dcc-mcp-server`; update that server in its own
+environment.
+
+```bash
+dcc-mcp-cli dcc-types
+dcc-mcp-cli list
+dcc-mcp-cli search --query "<task>" --dcc-type renderdoc
+dcc-mcp-cli describe <tool-slug>
+dcc-mcp-cli call <tool-slug> --json '{"key":"value"}'
+```
+
+`dcc-types` reports release-catalog support; `list` reports live sessions. If a
+tool belongs to an inactive progressive skill, call `dcc-mcp-cli load-skill <skill-name> --dcc-type renderdoc` before retrying. For post-task improvement,
+attach a stable session id with `--meta-json`, query `dcc-mcp-cli stats --range 24h --session-id <task-id>`, then pass the bounded evidence to the
+`review_skill_improvement` prompt from `dcc-mcp-skills-creator`.
+
+
 RenderDoc capture and replay automation for the DCC Model Context Protocol ecosystem.
 
 The adapter is headless-first: it reuses the official `renderdoccmd` executable for capture and
@@ -49,9 +96,15 @@ dcc-mcp-renderdoc
 
 On Windows, set the variable to `renderdoccmd.exe`.
 
+Each adapter instance uses an OS-assigned MCP port and registers it for CLI discovery. Connect
+through the stable gateway at `http://127.0.0.1:9765/mcp`; set
+`DCC_MCP_RENDERDOC_PORT` only when a fixed direct endpoint is required.
+
 ## Agent workflows
 
 - Launch a game or test executable under RenderDoc and wait for a typed `.rdc` capture.
+- Trigger F12 automatically after a configurable delay, with optional child-process window focus.
+- Inject into a visible Windows 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.
 - Export a capture thumbnail for visual review.
 - Export Chrome trace JSON for timeline tooling.
@@ -59,6 +112,11 @@ On Windows, set the variable to `renderdoccmd.exe`.
 The capture tool launches only the explicit executable and arguments supplied by the caller. It
 never invokes a shell. Analysis tools are read-only with respect to the `.rdc` input.
 
+For interactive Windows programs, pass `trigger_after_secs` to `capture_program`. When a launcher
+creates the rendered child process, also pass `trigger_process_name`. Use `capture_process` only
+when the target is already running; late injection may not capture graphics devices created before
+RenderDoc was attached.
+
 ## Real CI
 
 CI discovers the current stable RenderDoc build from the official downloads page. It compiles a
@@ -76,4 +134,3 @@ uv run python tools/lint_skills.py
 
 RenderDoc is an MIT-licensed graphics debugger maintained independently at
 [renderdoc.org](https://renderdoc.org/). This adapter is not affiliated with the RenderDoc project.
-

dcc_mcp_renderdoc-0.3.1/README.md

@@ -0,0 +1,108 @@
+# dcc-mcp-renderdoc
+
+<p align="center">
+  <img src="docs/assets/dcc-mcp-renderdoc.svg" alt="DCC-MCP · RENDERDOC" width="600">
+</p>
+
+## Agent workflow
+
+AI agents should use the shared gateway through `dcc-mcp-cli`; IDE users may
+continue to use the MCP endpoint. Prefer typed skills and tools over raw scripts.
+
+### Install or update the CLI
+
+`dcc-mcp-cli` is the preferred control path for every shell-capable agent. If
+it is missing, ask the user before installing the latest official release:
+
+```bash
+# Linux/macOS
+curl -fsSL https://raw.githubusercontent.com/dcc-mcp/dcc-mcp-core/main/scripts/install-cli.sh | sh
+
+# Windows PowerShell
+powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/dcc-mcp/dcc-mcp-core/main/scripts/install-cli.ps1 | iex"
+```
+
+Keep an official build current through the release manifest:
+
+```bash
+dcc-mcp-cli update check
+dcc-mcp-cli update apply
+```
+
+`update apply` downloads and stages the latest CLI for the next launch. It
+does not update a running `dcc-mcp-server`; update that server in its own
+environment.
+
+```bash
+dcc-mcp-cli dcc-types
+dcc-mcp-cli list
+dcc-mcp-cli search --query "<task>" --dcc-type renderdoc
+dcc-mcp-cli describe <tool-slug>
+dcc-mcp-cli call <tool-slug> --json '{"key":"value"}'
+```
+
+`dcc-types` reports release-catalog support; `list` reports live sessions. If a
+tool belongs to an inactive progressive skill, call `dcc-mcp-cli load-skill <skill-name> --dcc-type renderdoc` before retrying. For post-task improvement,
+attach a stable session id with `--meta-json`, query `dcc-mcp-cli stats --range 24h --session-id <task-id>`, then pass the bounded evidence to the
+`review_skill_improvement` prompt from `dcc-mcp-skills-creator`.
+
+
+RenderDoc capture and replay automation for the DCC Model Context Protocol ecosystem.
+
+The adapter is headless-first: it reuses the official `renderdoccmd` executable for capture and
+conversion, so agents can automate graphics regression triage without keeping the RenderDoc GUI
+open or installing a second bridge.
+
+## Install
+
+```bash
+pip install dcc-mcp-renderdoc
+```
+
+Install RenderDoc separately, then expose its command line tool with either `PATH` or:
+
+```bash
+export DCC_MCP_RENDERDOC_CMD=/opt/renderdoc/bin/renderdoccmd
+dcc-mcp-renderdoc
+```
+
+On Windows, set the variable to `renderdoccmd.exe`.
+
+Each adapter instance uses an OS-assigned MCP port and registers it for CLI discovery. Connect
+through the stable gateway at `http://127.0.0.1:9765/mcp`; set
+`DCC_MCP_RENDERDOC_PORT` only when a fixed direct endpoint is required.
+
+## Agent workflows
+
+- Launch a game or test executable under RenderDoc and wait for a typed `.rdc` capture.
+- Trigger F12 automatically after a configurable delay, with optional child-process window focus.
+- Inject into a visible Windows 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.
+- Export a capture thumbnail for visual review.
+- Export Chrome trace JSON for timeline tooling.
+
+The capture tool launches only the explicit executable and arguments supplied by the caller. It
+never invokes a shell. Analysis tools are read-only with respect to the `.rdc` input.
+
+For interactive Windows programs, pass `trigger_after_secs` to `capture_program`. When a launcher
+creates the rendered child process, also pass `trigger_process_name`. Use `capture_process` only
+when the target is already running; late injection may not capture graphics devices created before
+RenderDoc was attached.
+
+## Real CI
+
+CI discovers the current stable RenderDoc build from the official downloads page. It compiles a
+small OpenGL program, captures a real frame under Xvfb, calls the MCP analysis tool against the
+resulting `.rdc`, and verifies thumbnail and timeline exports.
+
+## Development
+
+```bash
+uv sync --extra dev
+uv run python -m pytest
+uv run ruff check src tests tools
+uv run python tools/lint_skills.py
+```
+
+RenderDoc is an MIT-licensed graphics debugger maintained independently at
+[renderdoc.org](https://renderdoc.org/). This adapter is not affiliated with the RenderDoc project.

{dcc_mcp_renderdoc-0.2.1 → dcc_mcp_renderdoc-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "dcc-mcp-renderdoc"
-version = "0.2.1"
+version = "0.3.1"
 description = "RenderDoc capture and replay automation skills for DCC-MCP"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -21,7 +21,7 @@ classifiers = [
   "Programming Language :: Python :: 3.12",
   "Topic :: Games/Entertainment",
 ]
-dependencies = ["dcc-mcp-core>=0.19.38,<1.0.0"]
+dependencies = ["dcc-mcp-core>=0.19.45,<1.0.0"]
 
 [project.urls]
 Homepage = "https://github.com/dcc-mcp/dcc-mcp-renderdoc"

{dcc_mcp_renderdoc-0.2.1 → dcc_mcp_renderdoc-0.3.1}/release-please-config.json

@@ -1,2 +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"}]}}}
-
+{"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"}]}}}

dcc_mcp_renderdoc-0.3.1/src/dcc_mcp_renderdoc/__version__.py

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