@elementor/editor-canvas 4.3.0-1007 → 4.3.0-1008

package/dist/index.js

@@ -5149,16 +5149,22 @@ var initGetPageStructureTool = (reg) => {
   const { addTool } = reg;
   addTool({
     name: "get-page-structure",
-    description: "Returns the Elementor element tree (widgets, containers, and nested content) for a post or page. If no postId is provided, uses the currently open document. Only works for posts saved with Elementor.",
+    description: "Returns a lean Elementor element tree skeleton (id, elType, widgetType, nested elements) for a post or page. If no postId is provided, uses the currently open document. Optionally scope to a subtree with elementId. Set includeContent=true (requires elementId) to also return each node's settings and styles.",
     schema: {
       postId: import_schema4.z.number().optional().describe(
         "WordPress post ID of the Elementor document. If omitted, uses the currently open document."
+      ),
+      elementId: import_schema4.z.string().optional().describe("If provided, returns only the subtree rooted at that element id."),
+      includeContent: import_schema4.z.boolean().optional().describe(
+        "If true, includes each node's settings and styles (same shape build-composition accepts as input). Requires elementId."
       )
     },
     outputSchema: {
-      elements: import_schema4.z.array(import_schema4.z.any()).describe("Root-level Elementor elements for the document.")
+      elements: import_schema4.z.array(import_schema4.z.any()).describe(
+        "Skeleton of Elementor elements (id, elType, widgetType, nested elements). When includeContent is true, each node also includes settings and styles."
+      )
     },
-    handler: async ({ postId }) => {
+    handler: async ({ postId, elementId, includeContent }) => {
       const resolvedPostId = postId ?? (0, import_editor_documents3.getCurrentDocument)()?.id;
       if (!resolvedPostId) {
         throw new Error("No post ID provided and no active document found.");
@@ -5167,7 +5173,9 @@ var initGetPageStructureTool = (reg) => {
         const { data } = await (0, import_http_client8.httpService)().post(MCP_PROXY_URL6, {
           tool: "get-page-structure",
           input: {
-            post_id: resolvedPostId
+            post_id: resolvedPostId,
+            ...elementId ? { element_id: elementId } : {},
+            ...includeContent ? { include_content: true } : {}
           }
         });
         return {

package/dist/index.mjs

@@ -5121,16 +5121,22 @@ var initGetPageStructureTool = (reg) => {
   const { addTool } = reg;
   addTool({
     name: "get-page-structure",
-    description: "Returns the Elementor element tree (widgets, containers, and nested content) for a post or page. If no postId is provided, uses the currently open document. Only works for posts saved with Elementor.",
+    description: "Returns a lean Elementor element tree skeleton (id, elType, widgetType, nested elements) for a post or page. If no postId is provided, uses the currently open document. Optionally scope to a subtree with elementId. Set includeContent=true (requires elementId) to also return each node's settings and styles.",
     schema: {
       postId: z3.number().optional().describe(
         "WordPress post ID of the Elementor document. If omitted, uses the currently open document."
+      ),
+      elementId: z3.string().optional().describe("If provided, returns only the subtree rooted at that element id."),
+      includeContent: z3.boolean().optional().describe(
+        "If true, includes each node's settings and styles (same shape build-composition accepts as input). Requires elementId."
       )
     },
     outputSchema: {
-      elements: z3.array(z3.any()).describe("Root-level Elementor elements for the document.")
+      elements: z3.array(z3.any()).describe(
+        "Skeleton of Elementor elements (id, elType, widgetType, nested elements). When includeContent is true, each node also includes settings and styles."
+      )
     },
-    handler: async ({ postId }) => {
+    handler: async ({ postId, elementId, includeContent }) => {
       const resolvedPostId = postId ?? getCurrentDocument2()?.id;
       if (!resolvedPostId) {
         throw new Error("No post ID provided and no active document found.");
@@ -5139,7 +5145,9 @@ var initGetPageStructureTool = (reg) => {
         const { data } = await httpService7().post(MCP_PROXY_URL6, {
           tool: "get-page-structure",
           input: {
-            post_id: resolvedPostId
+            post_id: resolvedPostId,
+            ...elementId ? { element_id: elementId } : {},
+            ...includeContent ? { include_content: true } : {}
           }
         });
         return {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elementor/editor-canvas",
   "description": "Elementor Editor Canvas",
-  "version": "4.3.0-1007",
+  "version": "4.3.0-1008",
   "private": false,
   "author": "Elementor Team",
   "homepage": "https://elementor.com/",
@@ -37,26 +37,26 @@
     "react-dom": "^18.3.1"
   },
   "dependencies": {
-    "@elementor/editor": "4.3.0-1007",
-    "@elementor/editor-controls": "4.3.0-1007",
-    "@elementor/editor-documents": "4.3.0-1007",
-    "@elementor/editor-elements": "4.3.0-1007",
-    "@elementor/editor-interactions": "4.3.0-1007",
-    "@elementor/editor-mcp": "4.3.0-1007",
-    "@elementor/editor-notifications": "4.3.0-1007",
-    "@elementor/editor-props": "4.3.0-1007",
-    "@elementor/editor-responsive": "4.3.0-1007",
-    "@elementor/editor-styles": "4.3.0-1007",
-    "@elementor/editor-styles-repository": "4.3.0-1007",
-    "@elementor/editor-ui": "4.3.0-1007",
-    "@elementor/editor-v1-adapters": "4.3.0-1007",
-    "@elementor/events": "4.3.0-1007",
-    "@elementor/http-client": "4.3.0-1007",
-    "@elementor/schema": "4.3.0-1007",
-    "@elementor/twing": "4.3.0-1007",
+    "@elementor/editor": "4.3.0-1008",
+    "@elementor/editor-controls": "4.3.0-1008",
+    "@elementor/editor-documents": "4.3.0-1008",
+    "@elementor/editor-elements": "4.3.0-1008",
+    "@elementor/editor-interactions": "4.3.0-1008",
+    "@elementor/editor-mcp": "4.3.0-1008",
+    "@elementor/editor-notifications": "4.3.0-1008",
+    "@elementor/editor-props": "4.3.0-1008",
+    "@elementor/editor-responsive": "4.3.0-1008",
+    "@elementor/editor-styles": "4.3.0-1008",
+    "@elementor/editor-styles-repository": "4.3.0-1008",
+    "@elementor/editor-ui": "4.3.0-1008",
+    "@elementor/editor-v1-adapters": "4.3.0-1008",
+    "@elementor/events": "4.3.0-1008",
+    "@elementor/http-client": "4.3.0-1008",
+    "@elementor/schema": "4.3.0-1008",
+    "@elementor/twing": "4.3.0-1008",
     "@elementor/ui": "1.37.5",
-    "@elementor/utils": "4.3.0-1007",
-    "@elementor/wp-media": "4.3.0-1007",
+    "@elementor/utils": "4.3.0-1008",
+    "@elementor/wp-media": "4.3.0-1008",
     "@floating-ui/react": "^0.27.5",
     "@wordpress/i18n": "^5.13.0",
     "dompurify": "^3.2.6"

package/src/mcp/tools/get-page-structure/tool.ts

@@ -17,8 +17,9 @@ export const initGetPageStructureTool = ( reg: MCPRegistryEntry ) => {
 	addTool( {
 		name: 'get-page-structure',
 		description:
-			'Returns the Elementor element tree (widgets, containers, and nested content) for a post or page. ' +
-			'If no postId is provided, uses the currently open document. Only works for posts saved with Elementor.',
+			'Returns a lean Elementor element tree skeleton (id, elType, widgetType, nested elements) for a post or page. ' +
+			'If no postId is provided, uses the currently open document. Optionally scope to a subtree with elementId. ' +
+			"Set includeContent=true (requires elementId) to also return each node's settings and styles.",
 		schema: {
 			postId: z
 				.number()
@@ -26,11 +27,25 @@ export const initGetPageStructureTool = ( reg: MCPRegistryEntry ) => {
 				.describe(
 					'WordPress post ID of the Elementor document. If omitted, uses the currently open document.'
 				),
+			elementId: z
+				.string()
+				.optional()
+				.describe( 'If provided, returns only the subtree rooted at that element id.' ),
+			includeContent: z
+				.boolean()
+				.optional()
+				.describe(
+					"If true, includes each node's settings and styles (same shape build-composition accepts as input). Requires elementId."
+				),
 		},
 		outputSchema: {
-			elements: z.array( z.any() ).describe( 'Root-level Elementor elements for the document.' ),
+			elements: z
+				.array( z.any() )
+				.describe(
+					'Skeleton of Elementor elements (id, elType, widgetType, nested elements). When includeContent is true, each node also includes settings and styles.'
+				),
 		},
-		handler: async ( { postId } ) => {
+		handler: async ( { postId, elementId, includeContent } ) => {
 			const resolvedPostId = postId ?? getCurrentDocument()?.id;
 
 			if ( ! resolvedPostId ) {
@@ -42,6 +57,8 @@ export const initGetPageStructureTool = ( reg: MCPRegistryEntry ) => {
 					tool: 'get-page-structure',
 					input: {
 						post_id: resolvedPostId,
+						...( elementId ? { element_id: elementId } : {} ),
+						...( includeContent ? { include_content: true } : {} ),
 					},
 				} );