@adobe/exc-app 1.5.10 → 1.5.12-beta

package/webmcp.js

@@ -0,0 +1,82 @@
+"use strict";
+/*************************************************************************
+ * Copyright 2026 Adobe
+ * All Rights Reserved.
+ *
+ * NOTICE: Adobe permits you to use, modify, and distribute this file in
+ * accordance with the terms of the Adobe license agreement accompanying
+ * it. If you have received this file from a source other than Adobe,
+ * then your use, modification, or distribution of it requires the prior
+ * written permission of Adobe.
+ **************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOLS_CHANGE_EVENT = void 0;
+/**
+ * Solution-facing API for WebMCP tool registration.
+ *
+ * Solutions import this module to register browser-side tools that AO2
+ * can invoke. The tool handler functions execute locally in the APP iframe;
+ * only the serializable definition crosses postMessage to Core.
+ *
+ * ***Import:***
+ *
+ * ```typescript
+ * import webmcp from '@adobe/exc-app/webmcp';
+ * ```
+ *
+ * ***Default export:***
+ *
+ * [webmcpApi](../interfaces/webmcp.webmcpapi.md#interface-webmcpapi)
+ *
+ * ***Usage:***
+ *
+ * ```typescript
+ * // Register a custom tool
+ * webmcp.registerTool({
+ *   name: 'getSelectedAssets',
+ *   description: 'Returns the currently selected assets in the DAM',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       includeMetadata: {
+ *         type: 'boolean',
+ *         description: 'Whether to include full metadata'
+ *       }
+ *     }
+ *   },
+ *   execute: async (parameters) => {
+ *     const assets = await myApp.getSelectedAssets(parameters.includeMetadata);
+ *     return { assets };
+ *   }
+ * });
+ *
+ * // Unregister a tool
+ * webmcp.unregisterTool('getSelectedAssets');
+ * ```
+ * @packageDocumentation
+ * @module webmcp
+ */
+const Global_1 = require("./src/Global");
+exports.TOOLS_CHANGE_EVENT = 'change:tools';
+const webmcp = {
+    executeTool: (name, parameters) => {
+        return (0, Global_1.getImpl)('webmcp')().executeTool(name, parameters);
+    },
+    getTools: () => {
+        return (0, Global_1.getImpl)('webmcp')().getTools();
+    },
+    off: (event, handler) => {
+        return (0, Global_1.getImpl)('webmcp')().off(event, handler);
+    },
+    on: (event, handler) => {
+        return (0, Global_1.getImpl)('webmcp')().on(event, handler);
+    },
+    registerTool: (definition) => {
+        return (0, Global_1.getImpl)('webmcp')().registerTool(definition);
+    },
+    unregisterTool: (name, component) => {
+        return (0, Global_1.getImpl)('webmcp')().unregisterTool(name, component);
+    }
+};
+exports.default = webmcp;
+//# sourceMappingURL=webmcp.js.map

package/webmcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp.js","sourceRoot":"","sources":["webmcp.ts"],"names":[],"mappings":";AAAA;;;;;;;;;4EAS4E;;;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,yCAAqC;AAmBxB,QAAA,kBAAkB,GAAG,cAAc,CAAC;AAgKjD,MAAM,MAAM,GAAG;IACb,WAAW,EAAE,CAAC,IAAY,EAAE,UAAgC,EAAE,EAAE;QAC9D,OAAO,IAAA,gBAAO,EAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC3D,CAAC;IACD,QAAQ,EAAE,GAAG,EAAE;QACb,OAAO,IAAA,gBAAO,EAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAA2C,CAAC;IACjF,CAAC;IACD,GAAG,EAAE,CAAC,KAAgC,EAAE,OAA4B,EAAE,EAAE;QACtE,OAAO,IAAA,gBAAO,EAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IACD,EAAE,EAAE,CAAC,KAAgC,EAAE,OAA4B,EAAE,EAAE;QACrE,OAAO,IAAA,gBAAO,EAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IACD,YAAY,EAAE,CAAC,UAA0B,EAAE,EAAE;QAC3C,OAAO,IAAA,gBAAO,EAAC,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IACtD,CAAC;IACD,cAAc,EAAE,CAAC,IAAY,EAAE,SAAkB,EAAE,EAAE;QACnD,OAAO,IAAA,gBAAO,EAAC,QAAQ,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC7D,CAAC;CACW,CAAC;AAEf,kBAAe,MAAM,CAAC"}