@elementor/editor-mcp 3.33.0-159

package/README.md

@@ -0,0 +1,5 @@
+# Editor V4 MCP Server Module
+
+> [!WARNING]
+> This package is under development and not ready for production use.
+

package/dist/index.d.mts

@@ -0,0 +1,33 @@
+import * as _elementor_external_angie_sdk from '@elementor-external/angie-sdk';
+import { AngieMcpSdk } from '@elementor-external/angie-sdk';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export { McpServer, ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ZodRawShape, z, ZodTypeAny } from '@elementor/schema';
+import { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import { ServerRequest, ServerNotification } from '@modelcontextprotocol/sdk/types.js';
+
+declare function init(): Promise<void>;
+
+declare const registerMcp: (mcp: McpServer, name: string) => void;
+declare function activateMcpRegistration(sdk: AngieMcpSdk): Promise<void>;
+/**
+ *
+ * @param namespace The namespace of the MCP server. It should contain only lowercase alphabetic characters.
+ */
+declare const getMCPByDomain: (namespace: string) => MCPRegistryEntry;
+interface MCPRegistryEntry {
+    addTool: <T extends undefined | ZodRawShape = undefined, O extends undefined | ZodRawShape = undefined>(opts: ToolRegistrationOptions<T, O>) => void;
+    setMCPDescription: (description: string) => void;
+}
+type ToolRegistrationOptions<InputArgs extends undefined | ZodRawShape = undefined, OutputSchema extends undefined | ZodRawShape = undefined, ExpectedOutput = OutputSchema extends ZodRawShape ? z.objectOutputType<OutputSchema, ZodTypeAny> : string> = {
+    name: string;
+    description: string;
+    schema?: InputArgs;
+    outputSchema?: OutputSchema;
+    handler: InputArgs extends ZodRawShape ? (args: z.objectOutputType<InputArgs, ZodTypeAny>, extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => ExpectedOutput | Promise<ExpectedOutput> : (args: unknown, extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => ExpectedOutput | Promise<ExpectedOutput>;
+    isDestrcutive?: boolean;
+};
+
+declare const getAngieSdk: () => _elementor_external_angie_sdk.AngieMcpSdk;
+
+export { type MCPRegistryEntry, activateMcpRegistration, getAngieSdk, getMCPByDomain, init, registerMcp };

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import * as _elementor_external_angie_sdk from '@elementor-external/angie-sdk';
+import { AngieMcpSdk } from '@elementor-external/angie-sdk';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export { McpServer, ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ZodRawShape, z, ZodTypeAny } from '@elementor/schema';
+import { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import { ServerRequest, ServerNotification } from '@modelcontextprotocol/sdk/types.js';
+
+declare function init(): Promise<void>;
+
+declare const registerMcp: (mcp: McpServer, name: string) => void;
+declare function activateMcpRegistration(sdk: AngieMcpSdk): Promise<void>;
+/**
+ *
+ * @param namespace The namespace of the MCP server. It should contain only lowercase alphabetic characters.
+ */
+declare const getMCPByDomain: (namespace: string) => MCPRegistryEntry;
+interface MCPRegistryEntry {
+    addTool: <T extends undefined | ZodRawShape = undefined, O extends undefined | ZodRawShape = undefined>(opts: ToolRegistrationOptions<T, O>) => void;
+    setMCPDescription: (description: string) => void;
+}
+type ToolRegistrationOptions<InputArgs extends undefined | ZodRawShape = undefined, OutputSchema extends undefined | ZodRawShape = undefined, ExpectedOutput = OutputSchema extends ZodRawShape ? z.objectOutputType<OutputSchema, ZodTypeAny> : string> = {
+    name: string;
+    description: string;
+    schema?: InputArgs;
+    outputSchema?: OutputSchema;
+    handler: InputArgs extends ZodRawShape ? (args: z.objectOutputType<InputArgs, ZodTypeAny>, extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => ExpectedOutput | Promise<ExpectedOutput> : (args: unknown, extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => ExpectedOutput | Promise<ExpectedOutput>;
+    isDestrcutive?: boolean;
+};
+
+declare const getAngieSdk: () => _elementor_external_angie_sdk.AngieMcpSdk;
+
+export { type MCPRegistryEntry, activateMcpRegistration, getAngieSdk, getMCPByDomain, init, registerMcp };

package/dist/index.js

@@ -0,0 +1,199 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  McpServer: () => import_mcp2.McpServer,
+  activateMcpRegistration: () => activateMcpRegistration,
+  getAngieSdk: () => getAngieSdk,
+  getMCPByDomain: () => getMCPByDomain,
+  init: () => init,
+  registerMcp: () => registerMcp
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/init.ts
+var import_editor_v1_adapters = require("@elementor/editor-v1-adapters");
+var import_angie_sdk = require("@elementor-external/angie-sdk");
+
+// src/mcp-registry.ts
+var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
+
+// src/test-utils/mock-mcp-registry.ts
+var mockMcpRegistry = () => {
+  return {
+    addTool: () => {
+    },
+    setMCPDescription: () => {
+    }
+  };
+};
+
+// src/mcp-registry.ts
+var mcpRegistry = {};
+var mcpDescriptions = {};
+var isMcpRegistrationActivated = typeof globalThis.jest !== "undefined";
+var registerMcp = (mcp, name) => {
+  if (isMcpRegistrationActivated) {
+    throw new Error("MCP Registration is already activated. Cannot register new MCP servers.");
+  }
+  const mcpName = isAlphabet(name);
+  mcpRegistry[mcpName] = mcp;
+};
+async function activateMcpRegistration(sdk2) {
+  if (isMcpRegistrationActivated) {
+    return;
+  }
+  isMcpRegistrationActivated = true;
+  const mcpServerList = Object.entries(mcpRegistry);
+  for await (const entry of mcpServerList) {
+    const [key, mcpServer] = entry;
+    await sdk2.registerServer({
+      name: `editor-${key}`,
+      server: mcpServer,
+      version: "1.0.0",
+      description: mcpDescriptions[key] || key
+    });
+  }
+}
+var isAlphabet = (str) => {
+  const passes = !!str && /^[a-z]+$/.test(str);
+  if (!passes) {
+    throw new Error("Not alphabet");
+  }
+  return str;
+};
+var getMCPByDomain = (namespace) => {
+  const mcpName = `editor-${isAlphabet(namespace)}`;
+  if (typeof globalThis.jest !== "undefined") {
+    return mockMcpRegistry();
+  }
+  if (!mcpRegistry[namespace]) {
+    mcpRegistry[namespace] = new import_mcp.McpServer({
+      name: mcpName,
+      version: "1.0.0"
+    });
+  }
+  const mcpServer = mcpRegistry[namespace];
+  const { addTool } = createToolRegistrator(mcpServer);
+  return {
+    addTool,
+    setMCPDescription: (description) => {
+      mcpDescriptions[namespace] = description;
+    }
+  };
+};
+function createToolRegistrator(server) {
+  function addTool(opts) {
+    const inputSchema = opts.schema ? opts.schema : {};
+    if (isMcpRegistrationActivated) {
+      throw new Error("MCP Registration is already activated. Cannot add new tools.");
+    }
+    const toolCallback = async function(args, extra) {
+      try {
+        const invocationResult = await opts.handler(opts.schema ? args : {}, extra);
+        return {
+          structuredContent: typeof invocationResult === "string" ? void 0 : invocationResult,
+          content: [
+            {
+              type: "text",
+              text: typeof invocationResult === "string" ? invocationResult : JSON.stringify(invocationResult)
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: error.message || "Unknown error"
+            }
+          ]
+        };
+      }
+    };
+    server.registerTool(
+      opts.name,
+      {
+        description: opts.description,
+        inputSchema,
+        outputSchema: opts.outputSchema,
+        title: opts.name,
+        annotations: {
+          destructiveHint: opts.isDestrcutive,
+          readOnlyHint: opts.isDestrcutive ? false : void 0,
+          title: opts.name
+        }
+      },
+      toolCallback
+    );
+  }
+  return {
+    addTool
+  };
+}
+
+// src/init.ts
+var sdk;
+var getSDK = () => {
+  if (typeof globalThis.jest !== "undefined") {
+    return {};
+  }
+  if (!sdk) {
+    sdk = new import_angie_sdk.AngieMcpSdk();
+  }
+  return sdk;
+};
+function init() {
+  if ((0, import_editor_v1_adapters.isExperimentActive)("editor_mcp")) {
+    return getSDK().waitForReady();
+  }
+  return Promise.resolve();
+}
+function startMCPServer() {
+  if ((0, import_editor_v1_adapters.isExperimentActive)("editor_mcp")) {
+    return getSDK().waitForReady().then(() => activateMcpRegistration(sdk));
+  }
+  return Promise.resolve();
+}
+document.addEventListener(
+  "DOMContentLoaded",
+  () => {
+    startMCPServer();
+  },
+  {
+    once: true
+  }
+);
+
+// src/index.ts
+var import_mcp2 = require("@modelcontextprotocol/sdk/server/mcp.js");
+var getAngieSdk = () => getSDK();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  McpServer,
+  activateMcpRegistration,
+  getAngieSdk,
+  getMCPByDomain,
+  init,
+  registerMcp
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/init.ts","../src/mcp-registry.ts","../src/test-utils/mock-mcp-registry.ts"],"sourcesContent":["import { getSDK } from './init';\n\nexport { McpServer, type ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';\nexport { init } from './init';\nexport * from './mcp-registry';\nexport const getAngieSdk = () => getSDK();\n","import { isExperimentActive } from '@elementor/editor-v1-adapters';\nimport { AngieMcpSdk } from '@elementor-external/angie-sdk';\n\nimport { activateMcpRegistration } from './mcp-registry';\n\nlet sdk: AngieMcpSdk;\n\nexport const getSDK = () => {\n\t// @ts-ignore - QUnit fails this\n\tif ( typeof globalThis.jest !== 'undefined' ) {\n\t\treturn {} as unknown as AngieMcpSdk;\n\t}\n\tif ( ! sdk ) {\n\t\tsdk = new AngieMcpSdk();\n\t}\n\treturn sdk;\n};\n\nexport function init() {\n\tif ( isExperimentActive( 'editor_mcp' ) ) {\n\t\treturn getSDK().waitForReady();\n\t}\n\treturn Promise.resolve();\n}\n\nexport function startMCPServer() {\n\tif ( isExperimentActive( 'editor_mcp' ) ) {\n\t\treturn getSDK()\n\t\t\t.waitForReady()\n\t\t\t.then( () => activateMcpRegistration( sdk ) );\n\t}\n\treturn Promise.resolve();\n}\n\ndocument.addEventListener(\n\t'DOMContentLoaded',\n\t() => {\n\t\tstartMCPServer();\n\t},\n\t{\n\t\tonce: true,\n\t}\n);\n","import { type z, type ZodRawShape, type ZodTypeAny } from '@elementor/schema';\nimport { type AngieMcpSdk } from '@elementor-external/angie-sdk';\nimport { McpServer, type ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { type RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport { type ServerNotification, type ServerRequest } from '@modelcontextprotocol/sdk/types.js';\n\nimport { mockMcpRegistry } from './test-utils/mock-mcp-registry';\n\nconst mcpRegistry: { [ namespace: string ]: McpServer } = {};\nconst mcpDescriptions: { [ namespace: string ]: string } = {};\n// @ts-ignore - QUnit fails this\nlet isMcpRegistrationActivated = false || typeof globalThis.jest !== 'undefined';\n\nexport const registerMcp = ( mcp: McpServer, name: string ) => {\n\tif ( isMcpRegistrationActivated ) {\n\t\tthrow new Error( 'MCP Registration is already activated. Cannot register new MCP servers.' );\n\t}\n\tconst mcpName = isAlphabet( name );\n\tmcpRegistry[ mcpName ] = mcp;\n};\n\nexport async function activateMcpRegistration( sdk: AngieMcpSdk ) {\n\tif ( isMcpRegistrationActivated ) {\n\t\treturn;\n\t}\n\tisMcpRegistrationActivated = true;\n\tconst mcpServerList = Object.entries( mcpRegistry );\n\tfor await ( const entry of mcpServerList ) {\n\t\tconst [ key, mcpServer ] = entry;\n\t\tawait sdk.registerServer( {\n\t\t\tname: `editor-${ key }`,\n\t\t\tserver: mcpServer,\n\t\t\tversion: '1.0.0',\n\t\t\tdescription: mcpDescriptions[ key ] || key,\n\t\t} );\n\t}\n}\n\nconst isAlphabet = ( str: string ): string | never => {\n\tconst passes = !! str && /^[a-z]+$/.test( str );\n\tif ( ! passes ) {\n\t\tthrow new Error( 'Not alphabet' );\n\t}\n\treturn str;\n};\n\n/**\n *\n * @param namespace The namespace of the MCP server. It should contain only lowercase alphabetic characters.\n */\nexport const getMCPByDomain = ( namespace: string ): MCPRegistryEntry => {\n\tconst mcpName = `editor-${ isAlphabet( namespace ) }`;\n\t// @ts-ignore - QUnit fails this\n\tif ( typeof globalThis.jest !== 'undefined' ) {\n\t\treturn mockMcpRegistry();\n\t}\n\tif ( ! mcpRegistry[ namespace ] ) {\n\t\tmcpRegistry[ namespace ] = new McpServer( {\n\t\t\tname: mcpName,\n\t\t\tversion: '1.0.0',\n\t\t} );\n\t}\n\tconst mcpServer = mcpRegistry[ namespace ];\n\tconst { addTool } = createToolRegistrator( mcpServer );\n\treturn {\n\t\taddTool,\n\t\tsetMCPDescription: ( description: string ) => {\n\t\t\tmcpDescriptions[ namespace ] = description;\n\t\t},\n\t};\n};\n\nexport interface MCPRegistryEntry {\n\taddTool: < T extends undefined | ZodRawShape = undefined, O extends undefined | ZodRawShape = undefined >(\n\t\topts: ToolRegistrationOptions< T, O >\n\t) => void;\n\tsetMCPDescription: ( description: string ) => void;\n}\n\ntype ToolRegistrationOptions<\n\tInputArgs extends undefined | ZodRawShape = undefined,\n\tOutputSchema extends undefined | ZodRawShape = undefined,\n\tExpectedOutput = OutputSchema extends ZodRawShape ? z.objectOutputType< OutputSchema, ZodTypeAny > : string,\n> = {\n\tname: string;\n\tdescription: string;\n\tschema?: InputArgs;\n\toutputSchema?: OutputSchema;\n\thandler: InputArgs extends ZodRawShape\n\t\t? (\n\t\t\t\targs: z.objectOutputType< InputArgs, ZodTypeAny >,\n\t\t\t\textra: RequestHandlerExtra< ServerRequest, ServerNotification >\n\t\t  ) => ExpectedOutput | Promise< ExpectedOutput >\n\t\t: (\n\t\t\t\targs: unknown,\n\t\t\t\textra: RequestHandlerExtra< ServerRequest, ServerNotification >\n\t\t  ) => ExpectedOutput | Promise< ExpectedOutput >;\n\tisDestrcutive?: boolean;\n};\n\nfunction createToolRegistrator( server: McpServer ) {\n\tfunction addTool< T extends undefined | ZodRawShape = undefined, O extends undefined | ZodRawShape = undefined >(\n\t\topts: ToolRegistrationOptions< T, O >\n\t) {\n\t\tconst inputSchema: ZodRawShape = opts.schema ? opts.schema : {};\n\t\tif ( isMcpRegistrationActivated ) {\n\t\t\tthrow new Error( 'MCP Registration is already activated. Cannot add new tools.' );\n\t\t}\n\t\tconst toolCallback: ToolCallback< typeof inputSchema > = async function ( args, extra ) {\n\t\t\ttry {\n\t\t\t\tconst invocationResult = await opts.handler( opts.schema ? args : {}, extra );\n\t\t\t\treturn {\n\t\t\t\t\tstructuredContent: typeof invocationResult === 'string' ? undefined : invocationResult,\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\t\ttext:\n\t\t\t\t\t\t\t\ttypeof invocationResult === 'string'\n\t\t\t\t\t\t\t\t\t? invocationResult\n\t\t\t\t\t\t\t\t\t: JSON.stringify( invocationResult ),\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t};\n\t\t\t} catch ( error ) {\n\t\t\t\treturn {\n\t\t\t\t\tisError: true,\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\t\ttext: ( error as Error ).message || 'Unknown error',\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t};\n\t\t\t}\n\t\t};\n\t\tserver.registerTool(\n\t\t\topts.name,\n\t\t\t{\n\t\t\t\tdescription: opts.description,\n\t\t\t\tinputSchema,\n\t\t\t\toutputSchema: opts.outputSchema,\n\t\t\t\ttitle: opts.name,\n\t\t\t\tannotations: {\n\t\t\t\t\tdestructiveHint: opts.isDestrcutive,\n\t\t\t\t\treadOnlyHint: opts.isDestrcutive ? false : undefined,\n\t\t\t\t\ttitle: opts.name,\n\t\t\t\t},\n\t\t\t},\n\t\t\ttoolCallback\n\t\t);\n\t}\n\treturn {\n\t\taddTool,\n\t};\n}\n","import { type MCPRegistryEntry } from '../mcp-registry';\n\nexport const mockMcpRegistry = (): MCPRegistryEntry => {\n\treturn {\n\t\taddTool: () => {},\n\t\tsetMCPDescription: () => {},\n\t};\n};\n"],"mappings":"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","names":["sdk","import_mcp"]}

package/dist/index.mjs

@@ -0,0 +1,167 @@
+// src/init.ts
+import { isExperimentActive } from "@elementor/editor-v1-adapters";
+import { AngieMcpSdk } from "@elementor-external/angie-sdk";
+
+// src/mcp-registry.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+// src/test-utils/mock-mcp-registry.ts
+var mockMcpRegistry = () => {
+  return {
+    addTool: () => {
+    },
+    setMCPDescription: () => {
+    }
+  };
+};
+
+// src/mcp-registry.ts
+var mcpRegistry = {};
+var mcpDescriptions = {};
+var isMcpRegistrationActivated = typeof globalThis.jest !== "undefined";
+var registerMcp = (mcp, name) => {
+  if (isMcpRegistrationActivated) {
+    throw new Error("MCP Registration is already activated. Cannot register new MCP servers.");
+  }
+  const mcpName = isAlphabet(name);
+  mcpRegistry[mcpName] = mcp;
+};
+async function activateMcpRegistration(sdk2) {
+  if (isMcpRegistrationActivated) {
+    return;
+  }
+  isMcpRegistrationActivated = true;
+  const mcpServerList = Object.entries(mcpRegistry);
+  for await (const entry of mcpServerList) {
+    const [key, mcpServer] = entry;
+    await sdk2.registerServer({
+      name: `editor-${key}`,
+      server: mcpServer,
+      version: "1.0.0",
+      description: mcpDescriptions[key] || key
+    });
+  }
+}
+var isAlphabet = (str) => {
+  const passes = !!str && /^[a-z]+$/.test(str);
+  if (!passes) {
+    throw new Error("Not alphabet");
+  }
+  return str;
+};
+var getMCPByDomain = (namespace) => {
+  const mcpName = `editor-${isAlphabet(namespace)}`;
+  if (typeof globalThis.jest !== "undefined") {
+    return mockMcpRegistry();
+  }
+  if (!mcpRegistry[namespace]) {
+    mcpRegistry[namespace] = new McpServer({
+      name: mcpName,
+      version: "1.0.0"
+    });
+  }
+  const mcpServer = mcpRegistry[namespace];
+  const { addTool } = createToolRegistrator(mcpServer);
+  return {
+    addTool,
+    setMCPDescription: (description) => {
+      mcpDescriptions[namespace] = description;
+    }
+  };
+};
+function createToolRegistrator(server) {
+  function addTool(opts) {
+    const inputSchema = opts.schema ? opts.schema : {};
+    if (isMcpRegistrationActivated) {
+      throw new Error("MCP Registration is already activated. Cannot add new tools.");
+    }
+    const toolCallback = async function(args, extra) {
+      try {
+        const invocationResult = await opts.handler(opts.schema ? args : {}, extra);
+        return {
+          structuredContent: typeof invocationResult === "string" ? void 0 : invocationResult,
+          content: [
+            {
+              type: "text",
+              text: typeof invocationResult === "string" ? invocationResult : JSON.stringify(invocationResult)
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: error.message || "Unknown error"
+            }
+          ]
+        };
+      }
+    };
+    server.registerTool(
+      opts.name,
+      {
+        description: opts.description,
+        inputSchema,
+        outputSchema: opts.outputSchema,
+        title: opts.name,
+        annotations: {
+          destructiveHint: opts.isDestrcutive,
+          readOnlyHint: opts.isDestrcutive ? false : void 0,
+          title: opts.name
+        }
+      },
+      toolCallback
+    );
+  }
+  return {
+    addTool
+  };
+}
+
+// src/init.ts
+var sdk;
+var getSDK = () => {
+  if (typeof globalThis.jest !== "undefined") {
+    return {};
+  }
+  if (!sdk) {
+    sdk = new AngieMcpSdk();
+  }
+  return sdk;
+};
+function init() {
+  if (isExperimentActive("editor_mcp")) {
+    return getSDK().waitForReady();
+  }
+  return Promise.resolve();
+}
+function startMCPServer() {
+  if (isExperimentActive("editor_mcp")) {
+    return getSDK().waitForReady().then(() => activateMcpRegistration(sdk));
+  }
+  return Promise.resolve();
+}
+document.addEventListener(
+  "DOMContentLoaded",
+  () => {
+    startMCPServer();
+  },
+  {
+    once: true
+  }
+);
+
+// src/index.ts
+import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
+var getAngieSdk = () => getSDK();
+export {
+  McpServer2 as McpServer,
+  activateMcpRegistration,
+  getAngieSdk,
+  getMCPByDomain,
+  init,
+  registerMcp
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/init.ts","../src/mcp-registry.ts","../src/test-utils/mock-mcp-registry.ts","../src/index.ts"],"sourcesContent":["import { isExperimentActive } from '@elementor/editor-v1-adapters';\nimport { AngieMcpSdk } from '@elementor-external/angie-sdk';\n\nimport { activateMcpRegistration } from './mcp-registry';\n\nlet sdk: AngieMcpSdk;\n\nexport const getSDK = () => {\n\t// @ts-ignore - QUnit fails this\n\tif ( typeof globalThis.jest !== 'undefined' ) {\n\t\treturn {} as unknown as AngieMcpSdk;\n\t}\n\tif ( ! sdk ) {\n\t\tsdk = new AngieMcpSdk();\n\t}\n\treturn sdk;\n};\n\nexport function init() {\n\tif ( isExperimentActive( 'editor_mcp' ) ) {\n\t\treturn getSDK().waitForReady();\n\t}\n\treturn Promise.resolve();\n}\n\nexport function startMCPServer() {\n\tif ( isExperimentActive( 'editor_mcp' ) ) {\n\t\treturn getSDK()\n\t\t\t.waitForReady()\n\t\t\t.then( () => activateMcpRegistration( sdk ) );\n\t}\n\treturn Promise.resolve();\n}\n\ndocument.addEventListener(\n\t'DOMContentLoaded',\n\t() => {\n\t\tstartMCPServer();\n\t},\n\t{\n\t\tonce: true,\n\t}\n);\n","import { type z, type ZodRawShape, type ZodTypeAny } from '@elementor/schema';\nimport { type AngieMcpSdk } from '@elementor-external/angie-sdk';\nimport { McpServer, type ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { type RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport { type ServerNotification, type ServerRequest } from '@modelcontextprotocol/sdk/types.js';\n\nimport { mockMcpRegistry } from './test-utils/mock-mcp-registry';\n\nconst mcpRegistry: { [ namespace: string ]: McpServer } = {};\nconst mcpDescriptions: { [ namespace: string ]: string } = {};\n// @ts-ignore - QUnit fails this\nlet isMcpRegistrationActivated = false || typeof globalThis.jest !== 'undefined';\n\nexport const registerMcp = ( mcp: McpServer, name: string ) => {\n\tif ( isMcpRegistrationActivated ) {\n\t\tthrow new Error( 'MCP Registration is already activated. Cannot register new MCP servers.' );\n\t}\n\tconst mcpName = isAlphabet( name );\n\tmcpRegistry[ mcpName ] = mcp;\n};\n\nexport async function activateMcpRegistration( sdk: AngieMcpSdk ) {\n\tif ( isMcpRegistrationActivated ) {\n\t\treturn;\n\t}\n\tisMcpRegistrationActivated = true;\n\tconst mcpServerList = Object.entries( mcpRegistry );\n\tfor await ( const entry of mcpServerList ) {\n\t\tconst [ key, mcpServer ] = entry;\n\t\tawait sdk.registerServer( {\n\t\t\tname: `editor-${ key }`,\n\t\t\tserver: mcpServer,\n\t\t\tversion: '1.0.0',\n\t\t\tdescription: mcpDescriptions[ key ] || key,\n\t\t} );\n\t}\n}\n\nconst isAlphabet = ( str: string ): string | never => {\n\tconst passes = !! str && /^[a-z]+$/.test( str );\n\tif ( ! passes ) {\n\t\tthrow new Error( 'Not alphabet' );\n\t}\n\treturn str;\n};\n\n/**\n *\n * @param namespace The namespace of the MCP server. It should contain only lowercase alphabetic characters.\n */\nexport const getMCPByDomain = ( namespace: string ): MCPRegistryEntry => {\n\tconst mcpName = `editor-${ isAlphabet( namespace ) }`;\n\t// @ts-ignore - QUnit fails this\n\tif ( typeof globalThis.jest !== 'undefined' ) {\n\t\treturn mockMcpRegistry();\n\t}\n\tif ( ! mcpRegistry[ namespace ] ) {\n\t\tmcpRegistry[ namespace ] = new McpServer( {\n\t\t\tname: mcpName,\n\t\t\tversion: '1.0.0',\n\t\t} );\n\t}\n\tconst mcpServer = mcpRegistry[ namespace ];\n\tconst { addTool } = createToolRegistrator( mcpServer );\n\treturn {\n\t\taddTool,\n\t\tsetMCPDescription: ( description: string ) => {\n\t\t\tmcpDescriptions[ namespace ] = description;\n\t\t},\n\t};\n};\n\nexport interface MCPRegistryEntry {\n\taddTool: < T extends undefined | ZodRawShape = undefined, O extends undefined | ZodRawShape = undefined >(\n\t\topts: ToolRegistrationOptions< T, O >\n\t) => void;\n\tsetMCPDescription: ( description: string ) => void;\n}\n\ntype ToolRegistrationOptions<\n\tInputArgs extends undefined | ZodRawShape = undefined,\n\tOutputSchema extends undefined | ZodRawShape = undefined,\n\tExpectedOutput = OutputSchema extends ZodRawShape ? z.objectOutputType< OutputSchema, ZodTypeAny > : string,\n> = {\n\tname: string;\n\tdescription: string;\n\tschema?: InputArgs;\n\toutputSchema?: OutputSchema;\n\thandler: InputArgs extends ZodRawShape\n\t\t? (\n\t\t\t\targs: z.objectOutputType< InputArgs, ZodTypeAny >,\n\t\t\t\textra: RequestHandlerExtra< ServerRequest, ServerNotification >\n\t\t  ) => ExpectedOutput | Promise< ExpectedOutput >\n\t\t: (\n\t\t\t\targs: unknown,\n\t\t\t\textra: RequestHandlerExtra< ServerRequest, ServerNotification >\n\t\t  ) => ExpectedOutput | Promise< ExpectedOutput >;\n\tisDestrcutive?: boolean;\n};\n\nfunction createToolRegistrator( server: McpServer ) {\n\tfunction addTool< T extends undefined | ZodRawShape = undefined, O extends undefined | ZodRawShape = undefined >(\n\t\topts: ToolRegistrationOptions< T, O >\n\t) {\n\t\tconst inputSchema: ZodRawShape = opts.schema ? opts.schema : {};\n\t\tif ( isMcpRegistrationActivated ) {\n\t\t\tthrow new Error( 'MCP Registration is already activated. Cannot add new tools.' );\n\t\t}\n\t\tconst toolCallback: ToolCallback< typeof inputSchema > = async function ( args, extra ) {\n\t\t\ttry {\n\t\t\t\tconst invocationResult = await opts.handler( opts.schema ? args : {}, extra );\n\t\t\t\treturn {\n\t\t\t\t\tstructuredContent: typeof invocationResult === 'string' ? undefined : invocationResult,\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\t\ttext:\n\t\t\t\t\t\t\t\ttypeof invocationResult === 'string'\n\t\t\t\t\t\t\t\t\t? invocationResult\n\t\t\t\t\t\t\t\t\t: JSON.stringify( invocationResult ),\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t};\n\t\t\t} catch ( error ) {\n\t\t\t\treturn {\n\t\t\t\t\tisError: true,\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\t\ttext: ( error as Error ).message || 'Unknown error',\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t};\n\t\t\t}\n\t\t};\n\t\tserver.registerTool(\n\t\t\topts.name,\n\t\t\t{\n\t\t\t\tdescription: opts.description,\n\t\t\t\tinputSchema,\n\t\t\t\toutputSchema: opts.outputSchema,\n\t\t\t\ttitle: opts.name,\n\t\t\t\tannotations: {\n\t\t\t\t\tdestructiveHint: opts.isDestrcutive,\n\t\t\t\t\treadOnlyHint: opts.isDestrcutive ? false : undefined,\n\t\t\t\t\ttitle: opts.name,\n\t\t\t\t},\n\t\t\t},\n\t\t\ttoolCallback\n\t\t);\n\t}\n\treturn {\n\t\taddTool,\n\t};\n}\n","import { type MCPRegistryEntry } from '../mcp-registry';\n\nexport const mockMcpRegistry = (): MCPRegistryEntry => {\n\treturn {\n\t\taddTool: () => {},\n\t\tsetMCPDescription: () => {},\n\t};\n};\n","import { getSDK } from './init';\n\nexport { McpServer, type ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';\nexport { init } from './init';\nexport * from './mcp-registry';\nexport const getAngieSdk = () => getSDK();\n"],"mappings":"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","names":["sdk","McpServer"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@elementor/editor-mcp",
+  "version": "3.33.0-159",
+  "private": false,
+  "author": "Elementor Team",
+  "homepage": "https://elementor.com/",
+  "license": "GPL-3.0-or-later",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elementor/elementor.git",
+    "directory": "packages/core/editor-mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/elementor/elementor/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "README.md",
+    "CHANGELOG.md",
+    "/dist",
+    "/src",
+    "!**/__tests__"
+  ],
+  "scripts": {
+    "build": "tsup --config=../../tsup.build.ts",
+    "dev": "tsup --config=../../tsup.dev.ts"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5"
+  },
+  "dependencies": {
+    "@elementor-external/angie-sdk": "npm:@elementor/angie-sdk@1.0.1",
+    "@elementor/schema": "3.33.0-159",
+    "@modelcontextprotocol/sdk": "1.17.3",
+    "@elementor/store": "3.33.0-159",
+    "@elementor/editor-v1-adapters": "3.33.0-159"
+  }
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+import { getSDK } from './init';
+
+export { McpServer, type ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
+export { init } from './init';
+export * from './mcp-registry';
+export const getAngieSdk = () => getSDK();

package/src/init.ts

@@ -0,0 +1,43 @@
+import { isExperimentActive } from '@elementor/editor-v1-adapters';
+import { AngieMcpSdk } from '@elementor-external/angie-sdk';
+
+import { activateMcpRegistration } from './mcp-registry';
+
+let sdk: AngieMcpSdk;
+
+export const getSDK = () => {
+	// @ts-ignore - QUnit fails this
+	if ( typeof globalThis.jest !== 'undefined' ) {
+		return {} as unknown as AngieMcpSdk;
+	}
+	if ( ! sdk ) {
+		sdk = new AngieMcpSdk();
+	}
+	return sdk;
+};
+
+export function init() {
+	if ( isExperimentActive( 'editor_mcp' ) ) {
+		return getSDK().waitForReady();
+	}
+	return Promise.resolve();
+}
+
+export function startMCPServer() {
+	if ( isExperimentActive( 'editor_mcp' ) ) {
+		return getSDK()
+			.waitForReady()
+			.then( () => activateMcpRegistration( sdk ) );
+	}
+	return Promise.resolve();
+}
+
+document.addEventListener(
+	'DOMContentLoaded',
+	() => {
+		startMCPServer();
+	},
+	{
+		once: true,
+	}
+);

package/src/mcp-registry.ts

@@ -0,0 +1,155 @@
+import { type z, type ZodRawShape, type ZodTypeAny } from '@elementor/schema';
+import { type AngieMcpSdk } from '@elementor-external/angie-sdk';
+import { McpServer, type ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import { type ServerNotification, type ServerRequest } from '@modelcontextprotocol/sdk/types.js';
+
+import { mockMcpRegistry } from './test-utils/mock-mcp-registry';
+
+const mcpRegistry: { [ namespace: string ]: McpServer } = {};
+const mcpDescriptions: { [ namespace: string ]: string } = {};
+// @ts-ignore - QUnit fails this
+let isMcpRegistrationActivated = false || typeof globalThis.jest !== 'undefined';
+
+export const registerMcp = ( mcp: McpServer, name: string ) => {
+	if ( isMcpRegistrationActivated ) {
+		throw new Error( 'MCP Registration is already activated. Cannot register new MCP servers.' );
+	}
+	const mcpName = isAlphabet( name );
+	mcpRegistry[ mcpName ] = mcp;
+};
+
+export async function activateMcpRegistration( sdk: AngieMcpSdk ) {
+	if ( isMcpRegistrationActivated ) {
+		return;
+	}
+	isMcpRegistrationActivated = true;
+	const mcpServerList = Object.entries( mcpRegistry );
+	for await ( const entry of mcpServerList ) {
+		const [ key, mcpServer ] = entry;
+		await sdk.registerServer( {
+			name: `editor-${ key }`,
+			server: mcpServer,
+			version: '1.0.0',
+			description: mcpDescriptions[ key ] || key,
+		} );
+	}
+}
+
+const isAlphabet = ( str: string ): string | never => {
+	const passes = !! str && /^[a-z]+$/.test( str );
+	if ( ! passes ) {
+		throw new Error( 'Not alphabet' );
+	}
+	return str;
+};
+
+/**
+ *
+ * @param namespace The namespace of the MCP server. It should contain only lowercase alphabetic characters.
+ */
+export const getMCPByDomain = ( namespace: string ): MCPRegistryEntry => {
+	const mcpName = `editor-${ isAlphabet( namespace ) }`;
+	// @ts-ignore - QUnit fails this
+	if ( typeof globalThis.jest !== 'undefined' ) {
+		return mockMcpRegistry();
+	}
+	if ( ! mcpRegistry[ namespace ] ) {
+		mcpRegistry[ namespace ] = new McpServer( {
+			name: mcpName,
+			version: '1.0.0',
+		} );
+	}
+	const mcpServer = mcpRegistry[ namespace ];
+	const { addTool } = createToolRegistrator( mcpServer );
+	return {
+		addTool,
+		setMCPDescription: ( description: string ) => {
+			mcpDescriptions[ namespace ] = description;
+		},
+	};
+};
+
+export interface MCPRegistryEntry {
+	addTool: < T extends undefined | ZodRawShape = undefined, O extends undefined | ZodRawShape = undefined >(
+		opts: ToolRegistrationOptions< T, O >
+	) => void;
+	setMCPDescription: ( description: string ) => void;
+}
+
+type ToolRegistrationOptions<
+	InputArgs extends undefined | ZodRawShape = undefined,
+	OutputSchema extends undefined | ZodRawShape = undefined,
+	ExpectedOutput = OutputSchema extends ZodRawShape ? z.objectOutputType< OutputSchema, ZodTypeAny > : string,
+> = {
+	name: string;
+	description: string;
+	schema?: InputArgs;
+	outputSchema?: OutputSchema;
+	handler: InputArgs extends ZodRawShape
+		? (
+				args: z.objectOutputType< InputArgs, ZodTypeAny >,
+				extra: RequestHandlerExtra< ServerRequest, ServerNotification >
+		  ) => ExpectedOutput | Promise< ExpectedOutput >
+		: (
+				args: unknown,
+				extra: RequestHandlerExtra< ServerRequest, ServerNotification >
+		  ) => ExpectedOutput | Promise< ExpectedOutput >;
+	isDestrcutive?: boolean;
+};
+
+function createToolRegistrator( server: McpServer ) {
+	function addTool< T extends undefined | ZodRawShape = undefined, O extends undefined | ZodRawShape = undefined >(
+		opts: ToolRegistrationOptions< T, O >
+	) {
+		const inputSchema: ZodRawShape = opts.schema ? opts.schema : {};
+		if ( isMcpRegistrationActivated ) {
+			throw new Error( 'MCP Registration is already activated. Cannot add new tools.' );
+		}
+		const toolCallback: ToolCallback< typeof inputSchema > = async function ( args, extra ) {
+			try {
+				const invocationResult = await opts.handler( opts.schema ? args : {}, extra );
+				return {
+					structuredContent: typeof invocationResult === 'string' ? undefined : invocationResult,
+					content: [
+						{
+							type: 'text',
+							text:
+								typeof invocationResult === 'string'
+									? invocationResult
+									: JSON.stringify( invocationResult ),
+						},
+					],
+				};
+			} catch ( error ) {
+				return {
+					isError: true,
+					content: [
+						{
+							type: 'text',
+							text: ( error as Error ).message || 'Unknown error',
+						},
+					],
+				};
+			}
+		};
+		server.registerTool(
+			opts.name,
+			{
+				description: opts.description,
+				inputSchema,
+				outputSchema: opts.outputSchema,
+				title: opts.name,
+				annotations: {
+					destructiveHint: opts.isDestrcutive,
+					readOnlyHint: opts.isDestrcutive ? false : undefined,
+					title: opts.name,
+				},
+			},
+			toolCallback
+		);
+	}
+	return {
+		addTool,
+	};
+}

package/src/test-utils/mock-mcp-registry.ts

@@ -0,0 +1,8 @@
+import { type MCPRegistryEntry } from '../mcp-registry';
+
+export const mockMcpRegistry = (): MCPRegistryEntry => {
+	return {
+		addTool: () => {},
+		setMCPDescription: () => {},
+	};
+};