breakpoint-mcp 1.28.0 → 1.29.0

package/dist/index.js

@@ -41,7 +41,7 @@ async function main() {
     // so long jobs (export/import/headless script) support poll/await/cancel.
     // D3: also advertise resources.subscribe so clients can subscribe to
     // godot://… resources and receive notifications/resources/updated.
-    const server = new McpServer({ name: "breakpoint-mcp", version: "1.28.0" }, { capabilities: { ...TASK_CAPABILITIES, ...RESOURCE_CAPABILITIES }, taskStore });
+    const server = new McpServer({ name: "breakpoint-mcp", version: "1.29.0" }, { capabilities: { ...TASK_CAPABILITIES, ...RESOURCE_CAPABILITIES }, taskStore });
     // B1: enforce frozen output schemas on every structured tool. Must run before
     // any register*Tools call — it wraps server.registerTool.
     applyOutputSchemas(server);

package/dist/tools/editor/introspection.js

@@ -1,5 +1,27 @@
 import { z } from "zod";
 import { fail } from "./common.js";
+/**
+ * Smallest edge, in pixels, a captured editor viewport may have and still be a
+ * frame rather than a placeholder.
+ *
+ * Godot does not tear down the main-screen tab you are not looking at — it
+ * collapses that tab's SubViewport to its minimum size and keeps rendering it.
+ * `get_texture().get_image()` therefore still succeeds, and the capture returns
+ * a real, valid, **2x2** PNG: correct magic bytes, correct mime, an 81-byte
+ * payload, and a note reading "Captured 2d viewport (2x2)". Every layer above
+ * reports success, and an assistant then *looks at* four pixels and reasons
+ * about the scene from them.
+ *
+ * Measured on Godot 4.7 (session 144), four editor boots, real Metal hardware:
+ * with the Script or 3D tab active, `viewport=2d` returned 2x2/81B; with the 2D
+ * tab active it returned 1297x492/3.6KB. A fresh editor with no saved layout —
+ * the CI condition — boots on the **3D** tab, and opening a `Node2D` scene does
+ * not switch it. So the degenerate case is the DEFAULT, not the exception.
+ *
+ * 8px is deliberately far below any real viewport and far above the collapsed
+ * one: it separates the two populations without guessing at a "reasonable" size.
+ */
+const MIN_RENDERED_VIEWPORT_PX = 8;
 /** Editor selection, ClassDB / docs lookups, and viewport screenshot. */
 export function registerIntrospectionTools(server, call, bridge) {
     server.registerTool("selection_get", { title: "Get selection", description: "Return the paths of the nodes currently selected in the editor.", inputSchema: {} }, async () => call("selection.get"));
@@ -53,11 +75,21 @@ export function registerIntrospectionTools(server, call, bridge) {
     server.registerTool("screenshot_editor", {
         title: "Screenshot editor viewport",
         description: "Capture the 2D or 3D editor viewport as a PNG and return it as image content so the assistant can see the scene. " +
-            "Requires the matching editor tab (2D/3D) to be active and rendered.",
+            "Requires the matching editor tab (2D/3D) to be active: Godot collapses the inactive tab's viewport to a few " +
+            "pixels, and this tool returns a viewport_not_rendered error rather than that placeholder frame.",
         inputSchema: { viewport: z.enum(["2d", "3d"]).optional().describe("Which viewport (default 3d)") },
     }, async ({ viewport }) => {
         try {
             const r = (await bridge.request("screenshot.editor_viewport", { viewport: viewport ?? "3d" }));
+            if (r.width < MIN_RENDERED_VIEWPORT_PX || r.height < MIN_RENDERED_VIEWPORT_PX) {
+                return fail({
+                    code: "viewport_not_rendered",
+                    message: `The ${r.viewport} editor viewport measured ${r.width}x${r.height} — a collapsed viewport, not a rendered ` +
+                        `frame. Godot keeps the inactive main-screen tab's viewport alive at its minimum size, so the capture ` +
+                        `"succeeds" and returns a placeholder image. Switch the editor to the ${r.viewport.toUpperCase()} tab ` +
+                        `(opening a scene does NOT switch it), then retry — or capture the viewport whose tab is active.`,
+                });
+            }
             return {
                 content: [
                     { type: "image", data: r.base64, mimeType: r.mime },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "breakpoint-mcp",
-  "version": "1.28.0",
+  "version": "1.29.0",
   "description": "MCP server exposing Godot to AI coding assistants over the Model Context Protocol — developed and tested with Claude — across four planes (CLI, live editor, LSP+DAP, runtime) with elicitation-gated destructive tools, long jobs on the formal MCP task model, captured console output, and MCP resources.",
   "type": "module",
   "license": "MIT",