@aws-cdk/aws-bedrock-agentcore-alpha 2.225.0-alpha.0 → 2.227.0-alpha.0

package/agentcore/gateway/targets/target-base.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GatewayTargetBase = exports.McpTargetType = exports.GatewayTargetProtocolType = void 0;
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+const aws_cdk_lib_1 = require("aws-cdk-lib");
+const iam = require("aws-cdk-lib/aws-iam");
+/******************************************************************************
+ *                                 ENUM
+ *****************************************************************************/
+/**
+ * Protocol types supported by gateway targets
+ */
+var GatewayTargetProtocolType;
+(function (GatewayTargetProtocolType) {
+    /** Model Context Protocol type */
+    GatewayTargetProtocolType["MCP"] = "MCP";
+})(GatewayTargetProtocolType || (exports.GatewayTargetProtocolType = GatewayTargetProtocolType = {}));
+/**
+ * MCP target types
+ */
+var McpTargetType;
+(function (McpTargetType) {
+    /** OpenAPI schema target type */
+    McpTargetType["OPENAPI_SCHEMA"] = "OPENAPI_SCHEMA";
+    /** Smithy model target type */
+    McpTargetType["SMITHY_MODEL"] = "SMITHY_MODEL";
+    /** Lambda function target type */
+    McpTargetType["LAMBDA"] = "LAMBDA";
+    /** MCP server target type */
+    McpTargetType["MCP_SERVER"] = "MCP_SERVER";
+})(McpTargetType || (exports.McpTargetType = McpTargetType = {}));
+/******************************************************************************
+ *                                Base Class
+ *****************************************************************************/
+/**
+ * Base class for gateway target implementations
+ *
+ * Provides common functionality for all gateway target types including
+ * permission management and property definitions.
+ */
+class GatewayTargetBase extends aws_cdk_lib_1.Resource {
+    static [JSII_RTTI_SYMBOL_1] = { fqn: "@aws-cdk/aws-bedrock-agentcore-alpha.GatewayTargetBase", version: "2.227.0-alpha.0" };
+    /**
+     * Grants IAM actions to the IAM Principal
+     *
+     * @param grantee The principal to grant permissions to
+     * @param actions The IAM actions to grant
+     */
+    grant(grantee, ...actions) {
+        return iam.Grant.addToPrincipal({
+            grantee: grantee,
+            resourceArns: [this.targetArn],
+            actions: actions,
+        });
+    }
+    /**
+     * Grants `Get` and `List` actions on the Gateway Target
+     *
+     * @param grantee The principal to grant read permissions to
+     */
+    grantRead(grantee) {
+        const resourceSpecificGrant = this.grant(grantee, 'bedrock-agentcore:GetGatewayTarget');
+        const allResourceGrant = iam.Grant.addToPrincipal({
+            grantee: grantee,
+            resourceArns: ['*'],
+            actions: ['bedrock-agentcore:ListGatewayTargets'],
+        });
+        // Return combined grant
+        return resourceSpecificGrant.combine(allResourceGrant);
+    }
+    /**
+     * Grants `Create`, `Update`, and `Delete` actions on the Gateway Target
+     *
+     * @param grantee The principal to grant manage permissions to
+     */
+    grantManage(grantee) {
+        return this.grant(grantee, 'bedrock-agentcore:CreateGatewayTarget', 'bedrock-agentcore:UpdateGatewayTarget', 'bedrock-agentcore:DeleteGatewayTarget');
+    }
+}
+exports.GatewayTargetBase = GatewayTargetBase;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFyZ2V0LWJhc2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJ0YXJnZXQtYmFzZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7O0FBQUEsNkNBQWtEO0FBQ2xELDJDQUEyQztBQUkzQzs7K0VBRStFO0FBQy9FOztHQUVHO0FBQ0gsSUFBWSx5QkFHWDtBQUhELFdBQVkseUJBQXlCO0lBQ25DLGtDQUFrQztJQUNsQyx3Q0FBVyxDQUFBO0FBQ2IsQ0FBQyxFQUhXLHlCQUF5Qix5Q0FBekIseUJBQXlCLFFBR3BDO0FBRUQ7O0dBRUc7QUFDSCxJQUFZLGFBU1g7QUFURCxXQUFZLGFBQWE7SUFDdkIsaUNBQWlDO0lBQ2pDLGtEQUFpQyxDQUFBO0lBQ2pDLCtCQUErQjtJQUMvQiw4Q0FBNkIsQ0FBQTtJQUM3QixrQ0FBa0M7SUFDbEMsa0NBQWlCLENBQUE7SUFDakIsNkJBQTZCO0lBQzdCLDBDQUF5QixDQUFBO0FBQzNCLENBQUMsRUFUVyxhQUFhLDZCQUFiLGFBQWEsUUFTeEI7QUF1R0Q7OytFQUUrRTtBQUMvRTs7Ozs7R0FLRztBQUNILE1BQXNCLGlCQUFrQixTQUFRLHNCQUFROztJQWF0RDs7Ozs7T0FLRztJQUNJLEtBQUssQ0FBQyxPQUF1QixFQUFFLEdBQUcsT0FBaUI7UUFDeEQsT0FBTyxHQUFHLENBQUMsS0FBSyxDQUFDLGNBQWMsQ0FBQztZQUM5QixPQUFPLEVBQUUsT0FBTztZQUNoQixZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDO1lBQzlCLE9BQU8sRUFBRSxPQUFPO1NBQ2pCLENBQUMsQ0FBQztLQUNKO0lBRUQ7Ozs7T0FJRztJQUNJLFNBQVMsQ0FBQyxPQUF1QjtRQUN0QyxNQUFNLHFCQUFxQixHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxFQUFFLG9DQUFvQyxDQUFDLENBQUM7UUFFeEYsTUFBTSxnQkFBZ0IsR0FBRyxHQUFHLENBQUMsS0FBSyxDQUFDLGNBQWMsQ0FBQztZQUNoRCxPQUFPLEVBQUUsT0FBTztZQUNoQixZQUFZLEVBQUUsQ0FBQyxHQUFHLENBQUM7WUFDbkIsT0FBTyxFQUFFLENBQUMsc0NBQXNDLENBQUM7U0FDbEQsQ0FBQyxDQUFDO1FBQ0gsd0JBQXdCO1FBQ3hCLE9BQU8scUJBQXFCLENBQUMsT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBQUM7S0FDeEQ7SUFFRDs7OztPQUlHO0lBQ0ksV0FBVyxDQUFDLE9BQXVCO1FBQ3hDLE9BQU8sSUFBSSxDQUFDLEtBQUssQ0FDZixPQUFPLEVBQ1AsdUNBQXVDLEVBQ3ZDLHVDQUF1QyxFQUN2Qyx1Q0FBdUMsQ0FDeEMsQ0FBQztLQUNIOztBQXhESCw4Q0F5REMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBSZXNvdXJjZSwgSVJlc291cmNlIH0gZnJvbSAnYXdzLWNkay1saWInO1xuaW1wb3J0ICogYXMgaWFtIGZyb20gJ2F3cy1jZGstbGliL2F3cy1pYW0nO1xuaW1wb3J0IHsgSUdhdGV3YXkgfSBmcm9tICcuLi9nYXRld2F5LWJhc2UnO1xuaW1wb3J0IHsgSUNyZWRlbnRpYWxQcm92aWRlckNvbmZpZyB9IGZyb20gJy4uL291dGJvdW5kLWF1dGgvY3JlZGVudGlhbC1wcm92aWRlcic7XG5cbi8qKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKipcbiAqICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgRU5VTVxuICoqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqL1xuLyoqXG4gKiBQcm90b2NvbCB0eXBlcyBzdXBwb3J0ZWQgYnkgZ2F0ZXdheSB0YXJnZXRzXG4gKi9cbmV4cG9ydCBlbnVtIEdhdGV3YXlUYXJnZXRQcm90b2NvbFR5cGUge1xuICAvKiogTW9kZWwgQ29udGV4dCBQcm90b2NvbCB0eXBlICovXG4gIE1DUCA9ICdNQ1AnLFxufVxuXG4vKipcbiAqIE1DUCB0YXJnZXQgdHlwZXNcbiAqL1xuZXhwb3J0IGVudW0gTWNwVGFyZ2V0VHlwZSB7XG4gIC8qKiBPcGVuQVBJIHNjaGVtYSB0YXJnZXQgdHlwZSAqL1xuICBPUEVOQVBJX1NDSEVNQSA9ICdPUEVOQVBJX1NDSEVNQScsXG4gIC8qKiBTbWl0aHkgbW9kZWwgdGFyZ2V0IHR5cGUgKi9cbiAgU01JVEhZX01PREVMID0gJ1NNSVRIWV9NT0RFTCcsXG4gIC8qKiBMYW1iZGEgZnVuY3Rpb24gdGFyZ2V0IHR5cGUgKi9cbiAgTEFNQkRBID0gJ0xBTUJEQScsXG4gIC8qKiBNQ1Agc2VydmVyIHRhcmdldCB0eXBlICovXG4gIE1DUF9TRVJWRVIgPSAnTUNQX1NFUlZFUicsXG59XG5cbi8qKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKipcbiAqICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICBJbnRlcmZhY2VcbiAqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKi9cblxuLyoqXG4gKiBJbnRlcmZhY2UgZm9yIEdhdGV3YXlUYXJnZXQgcmVzb3VyY2VzXG4gKlxuICogUmVwcmVzZW50cyBhIHRhcmdldCB0aGF0IGhvc3RzIHRvb2xzIGZvciB0aGUgZ2F0ZXdheS5cbiAqIFRhcmdldHMgY2FuIGJlIExhbWJkYSBmdW5jdGlvbnMsIE9wZW5BUEkgc2NoZW1hcywgb3IgU21pdGh5IG1vZGVscy5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBJR2F0ZXdheVRhcmdldCBleHRlbmRzIElSZXNvdXJjZSB7XG4gIC8qKlxuICAgKiBUaGUgQVJOIG9mIHRoZSBnYXRld2F5IHRhcmdldCByZXNvdXJjZVxuICAgKiBAYXR0cmlidXRlXG4gICAqL1xuICByZWFkb25seSB0YXJnZXRBcm46IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIGlkIG9mIHRoZSBnYXRld2F5IHRhcmdldFxuICAgKiBAYXR0cmlidXRlXG4gICAqL1xuICByZWFkb25seSB0YXJnZXRJZDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgbmFtZSBvZiB0aGUgZ2F0ZXdheSB0YXJnZXRcbiAgICovXG4gIHJlYWRvbmx5IG5hbWU6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIGRlc2NyaXB0aW9uIG9mIHRoZSBnYXRld2F5IHRhcmdldFxuICAgKi9cbiAgcmVhZG9ubHkgZGVzY3JpcHRpb24/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBnYXRld2F5IHRoYXQgdGhpcyB0YXJnZXQgYmVsb25ncyB0b1xuICAgKi9cbiAgcmVhZG9ubHkgZ2F0ZXdheTogSUdhdGV3YXk7XG5cbiAgLyoqXG4gICAqIFRoZSB0YXJnZXQgcHJvdG9jb2xcbiAgICovXG4gIHJlYWRvbmx5IHRhcmdldFByb3RvY29sVHlwZTogR2F0ZXdheVRhcmdldFByb3RvY29sVHlwZTtcblxuICAvKipcbiAgICogVGhlIGNyZWRlbnRpYWwgcHJvdmlkZXIgY29uZmlndXJhdGlvbiBmb3IgdGhlIHRhcmdldFxuICAgKi9cbiAgcmVhZG9ubHkgY3JlZGVudGlhbFByb3ZpZGVyQ29uZmlndXJhdGlvbnM6IElDcmVkZW50aWFsUHJvdmlkZXJDb25maWdbXSB8IHVuZGVmaW5lZDtcblxuICAvKipcbiAgICogVGhlIHN0YXR1cyBvZiB0aGUgZ2F0ZXdheSB0YXJnZXRcbiAgICogQGF0dHJpYnV0ZVxuICAgKi9cbiAgcmVhZG9ubHkgc3RhdHVzPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgc3RhdHVzIHJlYXNvbnMgZm9yIHRoZSBnYXRld2F5IHRhcmdldFxuICAgKiBAYXR0cmlidXRlXG4gICAqL1xuICByZWFkb25seSBzdGF0dXNSZWFzb25zPzogc3RyaW5nW107XG5cbiAgLyoqXG4gICAqIFRpbWVzdGFtcCB3aGVuIHRoZSBnYXRld2F5IHRhcmdldCB3YXMgY3JlYXRlZFxuICAgKiBAYXR0cmlidXRlXG4gICAqL1xuICByZWFkb25seSBjcmVhdGVkQXQ/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRpbWVzdGFtcCB3aGVuIHRoZSBnYXRld2F5IHRhcmdldCB3YXMgbGFzdCB1cGRhdGVkXG4gICAqIEBhdHRyaWJ1dGVcbiAgICovXG4gIHJlYWRvbmx5IHVwZGF0ZWRBdD86IHN0cmluZztcblxuICAvKipcbiAgICogR3JhbnRzIElBTSBhY3Rpb25zIHRvIHRoZSBJQU0gUHJpbmNpcGFsXG4gICAqL1xuICBncmFudChncmFudGVlOiBpYW0uSUdyYW50YWJsZSwgLi4uYWN0aW9uczogc3RyaW5nW10pOiBpYW0uR3JhbnQ7XG5cbiAgLyoqXG4gICAqIEdyYW50cyBgR2V0YCBhbmQgYExpc3RgIGFjdGlvbnMgb24gdGhlIEdhdGV3YXkgVGFyZ2V0XG4gICAqL1xuICBncmFudFJlYWQoZ3JhbnRlZTogaWFtLklHcmFudGFibGUpOiBpYW0uR3JhbnQ7XG5cbiAgLyoqXG4gICAqIEdyYW50cyBgQ3JlYXRlYCwgYFVwZGF0ZWAsIGFuZCBgRGVsZXRlYCBhY3Rpb25zIG9uIHRoZSBHYXRld2F5IFRhcmdldFxuICAgKi9cbiAgZ3JhbnRNYW5hZ2UoZ3JhbnRlZTogaWFtLklHcmFudGFibGUpOiBpYW0uR3JhbnQ7XG59XG5cbi8qKlxuICogSW50ZXJmYWNlIGZvciBNQ1AgZ2F0ZXdheSB0YXJnZXRzXG4gKlxuICogRXh0ZW5kcyB0aGUgYmFzZSBnYXRld2F5IHRhcmdldCBpbnRlcmZhY2Ugd2l0aCBNQ1Atc3BlY2lmaWMgcHJvcGVydGllcy5cbiAqIE1DUCB0YXJnZXRzIGV4cG9zZSB0b29scyB1c2luZyB0aGUgTW9kZWwgQ29udGV4dCBQcm90b2NvbC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBJTWNwR2F0ZXdheVRhcmdldCBleHRlbmRzIElHYXRld2F5VGFyZ2V0IHtcbiAgLyoqXG4gICAqIFRoZSB0eXBlIG9mIHRhcmdldCAoTGFtYmRhLCBPcGVuQVBJLCBvciBTbWl0aHkpXG4gICAqL1xuICByZWFkb25seSB0YXJnZXRUeXBlOiBNY3BUYXJnZXRUeXBlO1xufVxuXG4vKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqXG4gKiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgQmFzZSBDbGFzc1xuICoqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqL1xuLyoqXG4gKiBCYXNlIGNsYXNzIGZvciBnYXRld2F5IHRhcmdldCBpbXBsZW1lbnRhdGlvbnNcbiAqXG4gKiBQcm92aWRlcyBjb21tb24gZnVuY3Rpb25hbGl0eSBmb3IgYWxsIGdhdGV3YXkgdGFyZ2V0IHR5cGVzIGluY2x1ZGluZ1xuICogcGVybWlzc2lvbiBtYW5hZ2VtZW50IGFuZCBwcm9wZXJ0eSBkZWZpbml0aW9ucy5cbiAqL1xuZXhwb3J0IGFic3RyYWN0IGNsYXNzIEdhdGV3YXlUYXJnZXRCYXNlIGV4dGVuZHMgUmVzb3VyY2UgaW1wbGVtZW50cyBJR2F0ZXdheVRhcmdldCB7XG4gIHB1YmxpYyBhYnN0cmFjdCByZWFkb25seSB0YXJnZXRBcm46IHN0cmluZztcbiAgcHVibGljIGFic3RyYWN0IHJlYWRvbmx5IHRhcmdldElkOiBzdHJpbmc7XG4gIHB1YmxpYyBhYnN0cmFjdCByZWFkb25seSBuYW1lOiBzdHJpbmc7XG4gIHB1YmxpYyBhYnN0cmFjdCByZWFkb25seSBkZXNjcmlwdGlvbj86IHN0cmluZztcbiAgcHVibGljIGFic3RyYWN0IHJlYWRvbmx5IGdhdGV3YXk6IElHYXRld2F5O1xuICBwdWJsaWMgYWJzdHJhY3QgcmVhZG9ubHkgY3JlZGVudGlhbFByb3ZpZGVyQ29uZmlndXJhdGlvbnM6IElDcmVkZW50aWFsUHJvdmlkZXJDb25maWdbXSB8IHVuZGVmaW5lZDtcbiAgcHVibGljIGFic3RyYWN0IHJlYWRvbmx5IHN0YXR1cz86IHN0cmluZztcbiAgcHVibGljIGFic3RyYWN0IHJlYWRvbmx5IHN0YXR1c1JlYXNvbnM/OiBzdHJpbmdbXTtcbiAgcHVibGljIGFic3RyYWN0IHJlYWRvbmx5IGNyZWF0ZWRBdD86IHN0cmluZztcbiAgcHVibGljIGFic3RyYWN0IHJlYWRvbmx5IHVwZGF0ZWRBdD86IHN0cmluZztcbiAgcHVibGljIGFic3RyYWN0IHJlYWRvbmx5IHRhcmdldFByb3RvY29sVHlwZTogR2F0ZXdheVRhcmdldFByb3RvY29sVHlwZTtcblxuICAvKipcbiAgICogR3JhbnRzIElBTSBhY3Rpb25zIHRvIHRoZSBJQU0gUHJpbmNpcGFsXG4gICAqXG4gICAqIEBwYXJhbSBncmFudGVlIFRoZSBwcmluY2lwYWwgdG8gZ3JhbnQgcGVybWlzc2lvbnMgdG9cbiAgICogQHBhcmFtIGFjdGlvbnMgVGhlIElBTSBhY3Rpb25zIHRvIGdyYW50XG4gICAqL1xuICBwdWJsaWMgZ3JhbnQoZ3JhbnRlZTogaWFtLklHcmFudGFibGUsIC4uLmFjdGlvbnM6IHN0cmluZ1tdKTogaWFtLkdyYW50IHtcbiAgICByZXR1cm4gaWFtLkdyYW50LmFkZFRvUHJpbmNpcGFsKHtcbiAgICAgIGdyYW50ZWU6IGdyYW50ZWUsXG4gICAgICByZXNvdXJjZUFybnM6IFt0aGlzLnRhcmdldEFybl0sXG4gICAgICBhY3Rpb25zOiBhY3Rpb25zLFxuICAgIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIEdyYW50cyBgR2V0YCBhbmQgYExpc3RgIGFjdGlvbnMgb24gdGhlIEdhdGV3YXkgVGFyZ2V0XG4gICAqXG4gICAqIEBwYXJhbSBncmFudGVlIFRoZSBwcmluY2lwYWwgdG8gZ3JhbnQgcmVhZCBwZXJtaXNzaW9ucyB0b1xuICAgKi9cbiAgcHVibGljIGdyYW50UmVhZChncmFudGVlOiBpYW0uSUdyYW50YWJsZSk6IGlhbS5HcmFudCB7XG4gICAgY29uc3QgcmVzb3VyY2VTcGVjaWZpY0dyYW50ID0gdGhpcy5ncmFudChncmFudGVlLCAnYmVkcm9jay1hZ2VudGNvcmU6R2V0R2F0ZXdheVRhcmdldCcpO1xuXG4gICAgY29uc3QgYWxsUmVzb3VyY2VHcmFudCA9IGlhbS5HcmFudC5hZGRUb1ByaW5jaXBhbCh7XG4gICAgICBncmFudGVlOiBncmFudGVlLFxuICAgICAgcmVzb3VyY2VBcm5zOiBbJyonXSxcbiAgICAgIGFjdGlvbnM6IFsnYmVkcm9jay1hZ2VudGNvcmU6TGlzdEdhdGV3YXlUYXJnZXRzJ10sXG4gICAgfSk7XG4gICAgLy8gUmV0dXJuIGNvbWJpbmVkIGdyYW50XG4gICAgcmV0dXJuIHJlc291cmNlU3BlY2lmaWNHcmFudC5jb21iaW5lKGFsbFJlc291cmNlR3JhbnQpO1xuICB9XG5cbiAgLyoqXG4gICAqIEdyYW50cyBgQ3JlYXRlYCwgYFVwZGF0ZWAsIGFuZCBgRGVsZXRlYCBhY3Rpb25zIG9uIHRoZSBHYXRld2F5IFRhcmdldFxuICAgKlxuICAgKiBAcGFyYW0gZ3JhbnRlZSBUaGUgcHJpbmNpcGFsIHRvIGdyYW50IG1hbmFnZSBwZXJtaXNzaW9ucyB0b1xuICAgKi9cbiAgcHVibGljIGdyYW50TWFuYWdlKGdyYW50ZWU6IGlhbS5JR3JhbnRhYmxlKTogaWFtLkdyYW50IHtcbiAgICByZXR1cm4gdGhpcy5ncmFudChcbiAgICAgIGdyYW50ZWUsXG4gICAgICAnYmVkcm9jay1hZ2VudGNvcmU6Q3JlYXRlR2F0ZXdheVRhcmdldCcsXG4gICAgICAnYmVkcm9jay1hZ2VudGNvcmU6VXBkYXRlR2F0ZXdheVRhcmdldCcsXG4gICAgICAnYmVkcm9jay1hZ2VudGNvcmU6RGVsZXRlR2F0ZXdheVRhcmdldCcsXG4gICAgKTtcbiAgfVxufVxuIl19

package/agentcore/gateway/targets/target-configuration.d.ts

@@ -0,0 +1,230 @@
+import { IFunction } from 'aws-cdk-lib/aws-lambda';
+import { Construct } from 'constructs';
+import { IGateway } from '../gateway-base';
+import { ApiSchema } from './schema/api-schema';
+import { ToolSchema } from './schema/tool-schema';
+import { McpTargetType } from './target-base';
+/******************************************************************************
+ *                          Interface
+ *****************************************************************************/
+/**
+ * Configuration returned by binding a target configuration
+ */
+export interface TargetConfigurationConfig {
+    /**
+     * Indicates that the configuration has been successfully bound
+     */
+    readonly bound: boolean;
+}
+/**
+ * Base interface for target configurations
+ */
+export interface ITargetConfiguration {
+    /**
+     * The target type
+     */
+    readonly targetType: McpTargetType;
+    /**
+     * Binds the configuration to a construct scope
+     * Sets up permissions and dependencies
+     */
+    bind(scope: Construct, gateway: IGateway): TargetConfigurationConfig;
+    /**
+     * Renders the configuration as CloudFormation properties
+     * @internal
+     */
+    _render(): any;
+}
+/******************************************************************************
+ *                     MCP Target Configuration Base
+ *****************************************************************************/
+/**
+ * Abstract base class for MCP target configurations
+ * Provides common functionality for all MCP target types
+ */
+export declare abstract class McpTargetConfiguration implements ITargetConfiguration {
+    /**
+     * The target type
+     */
+    abstract readonly targetType: McpTargetType;
+    /**
+     * Binds the configuration to a construct scope
+     * Sets up permissions and dependencies
+     */
+    abstract bind(scope: Construct, gateway: IGateway): TargetConfigurationConfig;
+    /**
+     * Renders the MCP-specific configuration
+     */
+    protected abstract renderMcpConfiguration(): any;
+    /**
+     * Renders the configuration as CloudFormation properties
+     * @internal
+     */
+    _render(): any;
+}
+/******************************************************************************
+ *                     Lambda Target Configuration
+ *****************************************************************************/
+/**
+ * Configuration for Lambda-based MCP targets
+ *
+ * This configuration wraps a Lambda function as MCP tools,
+ * allowing the gateway to invoke the function to provide tool capabilities.
+ */
+export declare class LambdaTargetConfiguration extends McpTargetConfiguration {
+    /**
+     * Create a Lambda target configuration
+     *
+     * @param lambdaFunction The Lambda function to invoke
+     * @param toolSchema The schema defining the tools
+     * @returns A new LambdaTargetConfiguration instance
+     */
+    static create(lambdaFunction: IFunction, toolSchema: ToolSchema): LambdaTargetConfiguration;
+    readonly targetType = McpTargetType.LAMBDA;
+    /**
+     * The Lambda function that implements the MCP server logic
+     */
+    readonly lambdaFunction: IFunction;
+    /**
+     * The tool schema that defines the available tools
+     */
+    readonly toolSchema: ToolSchema;
+    constructor(lambdaFunction: IFunction, toolSchema: ToolSchema);
+    /**
+     * Binds this configuration to a construct scope
+     * Sets up necessary permissions for the gateway to invoke the Lambda function
+     *
+     * @param scope The construct scope
+     * @param gateway The gateway that will use this target
+     */
+    bind(scope: Construct, gateway: IGateway): TargetConfigurationConfig;
+    /**
+     * Renders the MCP-specific configuration
+     */
+    protected renderMcpConfiguration(): any;
+}
+/******************************************************************************
+ *                     OpenAPI Target Configuration
+ *****************************************************************************/
+/**
+ * Configuration for OpenAPI-based MCP targets
+ *
+ * This configuration exposes an OpenAPI/REST API as MCP tools,
+ * allowing the gateway to transform API operations into tool calls.
+ */
+export declare class OpenApiTargetConfiguration extends McpTargetConfiguration {
+    /**
+     * Create an OpenAPI target configuration
+     *
+     * @param apiSchema The OpenAPI schema
+     * @param validateSchema Whether to validate the OpenAPI schema (only applies to inline schemas)
+     * @returns A new OpenApiTargetConfiguration instance
+     */
+    static create(apiSchema: ApiSchema, validateSchema?: boolean): OpenApiTargetConfiguration;
+    readonly targetType = McpTargetType.OPENAPI_SCHEMA;
+    /**
+     * The OpenAPI schema that defines the API
+     */
+    readonly apiSchema: ApiSchema;
+    /**
+     * Whether to validate the OpenAPI schema
+     */
+    private readonly shouldValidateSchema;
+    constructor(apiSchema: ApiSchema, validateSchema?: boolean);
+    /**
+     * Binds this configuration to a construct scope
+     * Sets up necessary permissions for the gateway to access the API schema
+     *
+     * @param scope The construct scope
+     * @param gateway The gateway that will use this target
+     */
+    bind(scope: Construct, gateway: IGateway): TargetConfigurationConfig;
+    /**
+     * Renders the MCP-specific configuration
+     */
+    protected renderMcpConfiguration(): any;
+}
+/******************************************************************************
+ *                     Smithy Target Configuration
+ *****************************************************************************/
+/**
+ * Configuration for Smithy-based MCP targets
+ *
+ * This configuration exposes a Smithy-modeled API as MCP tools,
+ * allowing the gateway to transform Smithy operations into tool calls.
+ */
+export declare class SmithyTargetConfiguration extends McpTargetConfiguration {
+    /**
+     * Create a Smithy target configuration
+     *
+     * @param smithyModel The Smithy model schema
+     * @returns A new SmithyTargetConfiguration instance
+     */
+    static create(smithyModel: ApiSchema): SmithyTargetConfiguration;
+    readonly targetType = McpTargetType.SMITHY_MODEL;
+    /**
+     * The Smithy model that defines the API
+     */
+    readonly smithyModel: ApiSchema;
+    constructor(smithyModel: ApiSchema);
+    /**
+     * Binds this configuration to a construct scope
+     * Sets up necessary permissions for the gateway to access the Smithy model
+     *
+     * @param scope The construct scope
+     * @param gateway The gateway that will use this target
+     */
+    bind(scope: Construct, gateway: IGateway): TargetConfigurationConfig;
+    /**
+     * Renders the MCP-specific configuration
+     */
+    protected renderMcpConfiguration(): any;
+}
+/******************************************************************************
+ *                     MCP Server Target Configuration
+ *****************************************************************************/
+/**
+ * Configuration for MCP Server-based targets
+ *
+ * MCP (Model Context Protocol) servers provide tools, data access, and custom
+ * functions for AI agents. When you configure an MCP server as a gateway target,
+ * the gateway automatically discovers and indexes available tools through
+ * synchronization.
+ */
+export declare class McpServerTargetConfiguration extends McpTargetConfiguration {
+    /**
+     * Create an MCP server target configuration
+     *
+     * @param endpoint The HTTPS endpoint URL of the MCP server
+     * @returns A new McpServerTargetConfiguration instance
+     */
+    static create(endpoint: string): McpServerTargetConfiguration;
+    readonly targetType = McpTargetType.MCP_SERVER;
+    /**
+     * The HTTPS endpoint URL of the MCP server
+     */
+    readonly endpoint: string;
+    constructor(endpoint: string);
+    /**
+     * Binds this configuration to a construct scope
+     * No additional permissions are needed for MCP server targets
+     *
+     * @param _scope The construct scope
+     * @param _gateway The gateway that will use this target
+     */
+    bind(_scope: Construct, _gateway: IGateway): TargetConfigurationConfig;
+    /**
+     * Renders the MCP-specific configuration
+     */
+    protected renderMcpConfiguration(): any;
+    /**
+     * Validates the MCP server endpoint
+     * - Must use HTTPS protocol
+     * - Should be properly URL encoded
+     *
+     * @param endpoint The endpoint URL to validate
+     * @throws ValidationError if the endpoint is invalid
+     * @internal
+     */
+    private validateEndpoint;
+}