fix(mcp): improve takeScreenshot tool description to reduce model confusion

Clarify that the screenshot targets the editor application window (not a web page),
describe the visible UI components and what the live preview panel renders, and
explain that purePreview shows the page as it would appear in a real browser.

Author: abose

src-node/mcp-editor-tools.js

@@ -86,15 +86,18 @@ function createEditorMcpServer(sdkModule, nodeConnector, clarificationAccessors)
 
     const takeScreenshotTool = sdkModule.tool(
         "takeScreenshot",
-        "Take a screenshot of the Phoenix Code editor window. " +
-        "By default returns the screenshot as a PNG image inline. " +
-        "If filePath is specified, saves the screenshot to that file and returns the file path instead. " +
-        "Prefer capturing specific regions instead of the full page: " +
-        "use selector '#panel-live-preview-frame' for the live preview content, " +
-        "or '.editor-holder' for the code editor area. " +
-        "Only omit the selector when you need to see the full application layout. " +
-        "Note: live preview screenshots may include Phoenix toolbox overlays on selected elements " +
-        "and other editor UI elements. Use purePreview=true to temporarily hide these overlays.",
+        "Take a screenshot of the Phoenix Code editor application window or the live preview within it (not a web page). " +
+        "The editor window contains: a toolbar at the top, a file tree sidebar on the left, " +
+        "the code editor area in the center, and optionally a live preview panel on the right " +
+        "that renders the HTML/CSS/JS output of the currently edited file in a browser view. " +
+        "By default captures the entire editor window and returns the screenshot as an inline PNG image. " +
+        "If filePath is specified, saves to that file and returns the path instead. " +
+        "Prefer capturing specific regions using the selector parameter instead of the full window: " +
+        "use '#panel-live-preview-frame' to capture only the live preview content, " +
+        "or '.editor-holder' to capture only the code editor area. " +
+        "Only omit the selector when you need to see the full editor application layout. " +
+        "Note: live preview screenshots may include Phoenix toolbox overlays on selected elements. " +
+        "Use purePreview=true to temporarily hide these overlays and render the page as it would appear in a real browser.",
         {
             selector: z.string().optional().describe("CSS selector to capture a specific element. Use '#panel-live-preview-frame' for the live preview, '.editor-holder' for the code editor."),
             purePreview: z.boolean().optional().describe("When true, temporarily switches to preview mode to hide element highlight overlays and toolboxes before capturing, then restores the previous mode."),