@aws-cdk/aws-bedrock-agentcore-alpha 2.252.0-alpha.0 → 2.253.0-alpha.0

package/lib/evaluation/custom-evaluator.js

@@ -0,0 +1,256 @@
+"use strict";
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Evaluator = void 0;
+const jsiiDeprecationWarnings = require("../../.warnings.jsii.js");
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+/**
+ *  Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
+ *  with the License. A copy of the License is located at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
+ *  OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
+ *  and limitations under the License.
+ */
+const aws_cdk_lib_1 = require("aws-cdk-lib");
+const bedrockagentcore = require("aws-cdk-lib/aws-bedrockagentcore");
+const iam = require("aws-cdk-lib/aws-iam");
+const metadata_resource_1 = require("aws-cdk-lib/core/lib/metadata-resource");
+const prop_injectable_1 = require("aws-cdk-lib/core/lib/prop-injectable");
+const evaluator_base_1 = require("./evaluator-base");
+const validation_helpers_1 = require("./validation-helpers");
+/**
+ * A custom evaluator for Amazon Bedrock AgentCore.
+ *
+ * Custom evaluators enable you to define evaluation logic tailored to your specific
+ * use cases. Supports two evaluation strategies:
+ * - **LLM-as-a-Judge**: Uses a foundation model with custom instructions and a rating scale.
+ * - **Code-based**: Uses a Lambda function for custom evaluation logic.
+ *
+ * Custom evaluators are used with `OnlineEvaluationConfig` via `EvaluatorReference.custom()`.
+ *
+ * @resource AWS::BedrockAgentCore::Evaluator
+ *
+ * @example
+ * // Create a custom LLM-as-a-Judge evaluator
+ * const evaluator = new agentcore.Evaluator(this, 'MyEvaluator', {
+ *   evaluatorName: 'my_custom_evaluator',
+ *   level: agentcore.EvaluationLevel.SESSION,
+ *   evaluatorConfig: agentcore.EvaluatorConfig.llmAsAJudge({
+ *     instructions: 'Evaluate whether the agent response is helpful and accurate.',
+ *     modelId: 'us.anthropic.claude-sonnet-4-6',
+ *     ratingScale: agentcore.EvaluatorRatingScale.categorical([
+ *       { label: 'Good', definition: 'The response is helpful and accurate.' },
+ *       { label: 'Bad', definition: 'The response is not helpful or contains errors.' },
+ *     ]),
+ *   }),
+ * });
+ *
+ * // Use the custom evaluator in an online evaluation configuration
+ * new agentcore.OnlineEvaluationConfig(this, 'MyEvaluation', {
+ *   onlineEvaluationConfigName: 'my_evaluation',
+ *   evaluators: [
+ *     agentcore.EvaluatorReference.builtin(agentcore.BuiltinEvaluator.HELPFULNESS),
+ *     agentcore.EvaluatorReference.custom(evaluator),
+ *   ],
+ *   dataSource: agentcore.DataSourceConfig.fromCloudWatchLogs({
+ *     logGroupNames: ['/aws/bedrock-agentcore/my-agent'],
+ *     serviceNames: ['my-agent.default'],
+ *   }),
+ * });
+ */
+let Evaluator = (() => {
+    let _classDecorators = [prop_injectable_1.propertyInjectable];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = evaluator_base_1.EvaluatorBase;
+    var Evaluator = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            Evaluator = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        static [JSII_RTTI_SYMBOL_1] = { fqn: "@aws-cdk/aws-bedrock-agentcore-alpha.Evaluator", version: "2.253.0-alpha.0" };
+        /** Uniquely identifies this class. */
+        static PROPERTY_INJECTION_ID = '@aws-cdk.aws-bedrock-agentcore-alpha.Evaluator';
+        /**
+         * Import an existing Evaluator by its ID.
+         *
+         * @param scope - The construct scope
+         * @param id - Construct identifier
+         * @param evaluatorId - The evaluator ID to import
+         * @returns An IEvaluator reference
+         */
+        static fromEvaluatorId(scope, id, evaluatorId) {
+            const stack = aws_cdk_lib_1.Stack.of(scope);
+            const evaluatorArn = aws_cdk_lib_1.Arn.format({
+                service: 'bedrock-agentcore',
+                resource: 'evaluator',
+                resourceName: evaluatorId,
+            }, stack);
+            return Evaluator.fromEvaluatorAttributes(scope, id, {
+                evaluatorArn,
+                evaluatorId,
+            });
+        }
+        /**
+         * Import an existing Evaluator by its ARN.
+         *
+         * @param scope - The construct scope
+         * @param id - Construct identifier
+         * @param evaluatorArn - The evaluator ARN to import
+         * @returns An IEvaluator reference
+         */
+        static fromEvaluatorArn(scope, id, evaluatorArn) {
+            const arnParts = aws_cdk_lib_1.Arn.split(evaluatorArn, aws_cdk_lib_1.ArnFormat.SLASH_RESOURCE_NAME);
+            const evaluatorId = arnParts.resourceName;
+            return Evaluator.fromEvaluatorAttributes(scope, id, {
+                evaluatorArn,
+                evaluatorId,
+            });
+        }
+        /**
+         * Import an existing Evaluator from its attributes.
+         *
+         * @param scope - The construct scope
+         * @param id - Construct identifier
+         * @param attrs - The evaluator attributes
+         * @returns An IEvaluator reference
+         */
+        static fromEvaluatorAttributes(scope, id, attrs) {
+            try {
+                jsiiDeprecationWarnings._aws_cdk_aws_bedrock_agentcore_alpha_EvaluatorAttributes(attrs);
+            }
+            catch (error) {
+                if (process.env.JSII_DEBUG !== "1" && error.name === "DeprecationError") {
+                    Error.captureStackTrace(error, this.fromEvaluatorAttributes);
+                }
+                throw error;
+            }
+            class Import extends evaluator_base_1.EvaluatorBase {
+                evaluatorArn = attrs.evaluatorArn;
+                evaluatorId = attrs.evaluatorId;
+                evaluatorName = attrs.evaluatorName ?? attrs.evaluatorId;
+                status = undefined;
+                createdAt = undefined;
+                updatedAt = undefined;
+            }
+            return new Import(scope, id);
+        }
+        /**
+         * The ARN of the evaluator.
+         * @attribute
+         */
+        evaluatorArn;
+        /**
+         * The unique identifier of the evaluator.
+         * @attribute
+         */
+        evaluatorId;
+        /**
+         * The name of the evaluator.
+         * @attribute
+         */
+        evaluatorName;
+        /**
+         * The lifecycle status of the evaluator.
+         * @attribute
+         */
+        status;
+        /**
+         * The timestamp when the evaluator was created.
+         * @attribute
+         */
+        createdAt;
+        /**
+         * The timestamp when the evaluator was last updated.
+         * @attribute
+         */
+        updatedAt;
+        constructor(scope, id, props) {
+            super(scope, id, {
+                physicalName: props.evaluatorName,
+            });
+            try {
+                jsiiDeprecationWarnings._aws_cdk_aws_bedrock_agentcore_alpha_EvaluatorProps(props);
+            }
+            catch (error) {
+                if (process.env.JSII_DEBUG !== "1" && error.name === "DeprecationError") {
+                    Error.captureStackTrace(error, Evaluator);
+                }
+                throw error;
+            }
+            (0, metadata_resource_1.addConstructMetadata)(this, props);
+            (0, validation_helpers_1.throwIfInvalid)(validation_helpers_1.validateEvaluatorName, props.evaluatorName, this);
+            (0, validation_helpers_1.throwIfInvalid)(validation_helpers_1.validateDescription, props.description, this);
+            this.evaluatorName = this.physicalName;
+            const resource = new bedrockagentcore.CfnEvaluator(this, 'Resource', {
+                evaluatorName: this.physicalName,
+                evaluatorConfig: props.evaluatorConfig._bind(),
+                level: props.level.value,
+                description: props.description,
+            });
+            // If code-based, grant the bedrock-agentcore service permission to invoke
+            // the Lambda function, scoped to this specific evaluator for confused deputy prevention.
+            if (props.evaluatorConfig.lambdaFunction) {
+                const stack = aws_cdk_lib_1.Stack.of(this);
+                props.evaluatorConfig.lambdaFunction.addPermission('BedrockAgentCoreEvaluatorInvoke', {
+                    principal: new iam.ServicePrincipal('bedrock-agentcore.amazonaws.com'),
+                    sourceAccount: stack.account,
+                    sourceArn: resource.attrEvaluatorArn,
+                });
+            }
+            this.evaluatorArn = resource.attrEvaluatorArn;
+            this.evaluatorId = resource.attrEvaluatorId;
+            this.status = resource.attrStatus;
+            this.createdAt = resource.attrCreatedAt;
+            this.updatedAt = resource.attrUpdatedAt;
+        }
+        static {
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+    };
+    return Evaluator = _classThis;
+})();
+exports.Evaluator = Evaluator;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3VzdG9tLWV2YWx1YXRvci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbImN1c3RvbS1ldmFsdWF0b3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7Ozs7Ozs7Ozs7O0dBV0c7QUFFSCw2Q0FBb0Q7QUFDcEQscUVBQXFFO0FBQ3JFLDJDQUEyQztBQUMzQyw4RUFBOEU7QUFDOUUsMEVBQTBFO0FBRTFFLHFEQUFrRTtBQUdsRSw2REFJOEI7QUF5QzlCOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0F1Q0c7SUFFVSxTQUFTOzRCQURyQixvQ0FBa0I7Ozs7c0JBQ1ksOEJBQWE7eUJBQXJCLFNBQVEsV0FBYTs7OztZQUE1Qyw2S0F5SkM7Ozs7O1FBeEpDLHNDQUFzQztRQUMvQixNQUFNLENBQVUscUJBQXFCLEdBQzFDLGdEQUFnRCxDQUFDO1FBRW5EOzs7Ozs7O1dBT0c7UUFDSSxNQUFNLENBQUMsZUFBZSxDQUMzQixLQUFnQixFQUNoQixFQUFVLEVBQ1YsV0FBbUI7WUFFbkIsTUFBTSxLQUFLLEdBQUcsbUJBQUssQ0FBQyxFQUFFLENBQUMsS0FBSyxDQUFDLENBQUM7WUFDOUIsTUFBTSxZQUFZLEdBQUcsaUJBQUcsQ0FBQyxNQUFNLENBQzdCO2dCQUNFLE9BQU8sRUFBRSxtQkFBbUI7Z0JBQzVCLFFBQVEsRUFBRSxXQUFXO2dCQUNyQixZQUFZLEVBQUUsV0FBVzthQUMxQixFQUNELEtBQUssQ0FDTixDQUFDO1lBRUYsT0FBTyxTQUFTLENBQUMsdUJBQXVCLENBQUMsS0FBSyxFQUFFLEVBQUUsRUFBRTtnQkFDbEQsWUFBWTtnQkFDWixXQUFXO2FBQ1osQ0FBQyxDQUFDO1NBQ0o7UUFFRDs7Ozs7OztXQU9HO1FBQ0ksTUFBTSxDQUFDLGdCQUFnQixDQUM1QixLQUFnQixFQUNoQixFQUFVLEVBQ1YsWUFBb0I7WUFFcEIsTUFBTSxRQUFRLEdBQUcsaUJB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QUFNLEdBQUcsUUFBUSxDQUFDLFVBQVUsQ0FBQztZQUNsQyxJQUFJLENBQUMsU0FBUyxHQUFHLFFBQVEsQ0FBQyxhQUFhLENBQUM7WUFDeEMsSUFBSSxDQUFDLFNBQVMsR0FBRyxRQUFRLENBQUMsYUFBYSxDQUFDO1NBQ3pDOztZQXhKVSx1REFBUzs7Ozs7QUFBVCw4QkFBUyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogIENvcHlyaWdodCBBbWF6b24uY29tLCBJbmMuIG9yIGl0cyBhZmZpbGlhdGVzLiBBbGwgUmlnaHRzIFJlc2VydmVkLlxuICpcbiAqICBMaWNlbnNlZCB1bmRlciB0aGUgQXBhY2hlIExpY2Vuc2UsIFZlcnNpb24gMi4wICh0aGUgXCJMaWNlbnNlXCIpLiBZb3UgbWF5IG5vdCB1c2UgdGhpcyBmaWxlIGV4Y2VwdCBpbiBjb21wbGlhbmNlXG4gKiAgd2l0aCB0aGUgTGljZW5zZS4gQSBjb3B5IG9mIHRoZSBMaWNlbnNlIGlzIGxvY2F0ZWQgYXRcbiAqXG4gKiAgICAgIGh0dHA6Ly93d3cuYXBhY2hlLm9yZy9saWNlbnNlcy9MSUNFTlNFLTIuMFxuICpcbiAqICBvciBpbiB0aGUgJ2xpY2Vuc2UnIGZpbGUgYWNjb21wYW55aW5nIHRoaXMgZmlsZS4gVGhpcyBmaWxlIGlzIGRpc3RyaWJ1dGVkIG9uIGFuICdBUyBJUycgQkFTSVMsIFdJVEhPVVQgV0FSUkFOVElFU1xuICogIE9SIENPTkRJVElPTlMgT0YgQU5ZIEtJTkQsIGV4cHJlc3Mgb3IgaW1wbGllZC4gU2VlIHRoZSBMaWNlbnNlIGZvciB0aGUgc3BlY2lmaWMgbGFuZ3VhZ2UgZ292ZXJuaW5nIHBlcm1pc3Npb25zXG4gKiAgYW5kIGxpbWl0YXRpb25zIHVuZGVyIHRoZSBMaWNlbnNlLlxuICovXG5cbmltcG9ydCB7IEFybiwgQXJuRm9ybWF0LCBTdGFjayB9IGZyb20gJ2F3cy1jZGstbGliJztcbmltcG9ydCAqIGFzIGJlZHJvY2thZ2VudGNvcmUgZnJvbSAnYXdzLWNkay1saWIvYXdzLWJlZHJvY2thZ2VudGNvcmUnO1xuaW1wb3J0ICogYXMgaWFtIGZyb20gJ2F3cy1jZGstbGliL2F3cy1pYW0nO1xuaW1wb3J0IHsgYWRkQ29uc3RydWN0TWV0YWRhdGEgfSBmcm9tICdhd3MtY2RrLWxpYi9jb3JlL2xpYi9tZXRhZGF0YS1yZXNvdXJjZSc7XG5pbXBvcnQgeyBwcm9wZXJ0eUluamVjdGFibGUgfSBmcm9tICdhd3MtY2RrLWxpYi9jb3JlL2xpYi9wcm9wLWluamVjdGFibGUnO1xuaW1wb3J0IHR5cGUgeyBDb25zdHJ1Y3QgfSBmcm9tICdjb25zdHJ1Y3RzJztcbmltcG9ydCB7IHR5cGUgSUV2YWx1YXRvciwgRXZhbHVhdG9yQmFzZSB9IGZyb20gJy4vZXZhbHVhdG9yLWJhc2UnO1xuaW1wb3J0IHR5cGUgeyBFdmFsdWF0b3JDb25maWcgfSBmcm9tICcuL2V2YWx1YXRvci1jb25maWcnO1xuaW1wb3J0IHR5cGUgeyBFdmFsdWF0aW9uTGV2ZWwsIEV2YWx1YXRvckF0dHJpYnV0ZXMgfSBmcm9tICcuL3R5cGVzJztcbmltcG9ydCB7XG4gIHRocm93SWZJbnZhbGlkLFxuICB2YWxpZGF0ZURlc2NyaXB0aW9uLFxuICB2YWxpZGF0ZUV2YWx1YXRvck5hbWUsXG59IGZyb20gJy4vdmFsaWRhdGlvbi1oZWxwZXJzJztcblxuLyoqXG4gKiBQcm9wZXJ0aWVzIGZvciBjcmVhdGluZyBhbiBFdmFsdWF0b3IuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgRXZhbHVhdG9yUHJvcHMge1xuICAvKipcbiAgICogVGhlIG5hbWUgb2YgdGhlIGV2YWx1YXRvci5cbiAgICpcbiAgICogTXVzdCBiZSB1bmlxdWUgd2l0aGluIHlvdXIgYWNjb3VudC4gVmFsaWQgY2hhcmFjdGVycyBhcmUgYS16LCBBLVosIDAtOSwgXyAodW5kZXJzY29yZSkuXG4gICAqIE11c3Qgc3RhcnQgd2l0aCBhIGxldHRlciBhbmQgY2FuIGJlIHVwIHRvIDQ4IGNoYXJhY3RlcnMgbG9uZy5cbiAgICpcbiAgICogQHBhdHRlcm4gXlthLXpBLVpdW2EtekEtWjAtOV9dezAsNDd9JFxuICAgKi9cbiAgcmVhZG9ubHkgZXZhbHVhdG9yTmFtZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgY29uZmlndXJhdGlvbiB0aGF0IGRlZmluZXMgaG93IHRoZSBldmFsdWF0b3IgYXNzZXNzZXMgYWdlbnQgcGVyZm9ybWFuY2UuXG4gICAqXG4gICAqIFVzZSBgRXZhbHVhdG9yQ29uZmlnLmxsbUFzQUp1ZGdlKClgIGZvciBtb2RlbC1iYXNlZCBldmFsdWF0aW9uIG9yXG4gICAqIGBFdmFsdWF0b3JDb25maWcuY29kZUJhc2VkKClgIGZvciBMYW1iZGEtYmFzZWQgZXZhbHVhdGlvbi5cbiAgICovXG4gIHJlYWRvbmx5IGV2YWx1YXRvckNvbmZpZzogRXZhbHVhdG9yQ29uZmlnO1xuXG4gIC8qKlxuICAgKiBUaGUgbGV2ZWwgYXQgd2hpY2ggdGhlIGV2YWx1YXRvciBhc3Nlc3NlcyBhZ2VudCBwZXJmb3JtYW5jZS5cbiAgICpcbiAgICogRGV0ZXJtaW5lcyB3aGF0IGdyYW51bGFyaXR5IG9mIGRhdGEgdGhlIGV2YWx1YXRvciBvcGVyYXRlcyBvbjpcbiAgICogdG9vbCBjYWxsLCB0cmFjZSAoc2luZ2xlIHJlcXVlc3QtcmVzcG9uc2UpLCBvciBzZXNzaW9uIChmdWxsIGNvbnZlcnNhdGlvbikuXG4gICAqL1xuICByZWFkb25seSBsZXZlbDogRXZhbHVhdGlvbkxldmVsO1xuXG4gIC8qKlxuICAgKiBUaGUgZGVzY3JpcHRpb24gb2YgdGhlIGV2YWx1YXRvci5cbiAgICpcbiAgICogQGRlZmF1bHQgLSBObyBkZXNjcmlwdGlvblxuICAgKiBAbWF4TGVuZ3RoIDIwMFxuICAgKi9cbiAgcmVhZG9ubHkgZGVzY3JpcHRpb24/OiBzdHJpbmc7XG59XG5cbi8qKlxuICogQSBjdXN0b20gZXZhbHVhdG9yIGZvciBBbWF6b24gQmVkcm9jayBBZ2VudENvcmUuXG4gKlxuICogQ3VzdG9tIGV2YWx1YXRvcnMgZW5hYmxlIHlvdSB0byBkZWZpbmUgZXZhbHVhdGlvbiBsb2dpYyB0YWlsb3JlZCB0byB5b3VyIHNwZWNpZmljXG4gKiB1c2UgY2FzZXMuIFN1cHBvcnRzIHR3byBldmFsdWF0aW9uIHN0cmF0ZWdpZXM6XG4gKiAtICoqTExNLWFzLWEtSnVkZ2UqKjogVXNlcyBhIGZvdW5kYXRpb24gbW9kZWwgd2l0aCBjdXN0b20gaW5zdHJ1Y3Rpb25zIGFuZCBhIHJhdGluZyBzY2FsZS5cbiAqIC0gKipDb2RlLWJhc2VkKio6IFVzZXMgYSBMYW1iZGEgZnVuY3Rpb24gZm9yIGN1c3RvbSBldmFsdWF0aW9uIGxvZ2ljLlxuICpcbiAqIEN1c3RvbSBldmFsdWF0b3JzIGFyZSB1c2VkIHdpdGggYE9ubGluZUV2YWx1YXRpb25Db25maWdgIHZpYSBgRXZhbHVhdG9yUmVmZXJlbmNlLmN1c3RvbSgpYC5cbiAqXG4gKiBAcmVzb3VyY2UgQVdTOjpCZWRyb2NrQWdlbnRDb3JlOjpFdmFsdWF0b3JcbiAqXG4gKiBAZXhhbXBsZVxuICogLy8gQ3JlYXRlIGEgY3VzdG9tIExMTS1hcy1hLUp1ZGdlIGV2YWx1YXRvclxuICogY29uc3QgZXZhbHVhdG9yID0gbmV3IGFnZW50Y29yZS5FdmFsdWF0b3IodGhpcywgJ015RXZhbHVhdG9yJywge1xuICogICBldmFsdWF0b3JOYW1lOiAnbXlfY3VzdG9tX2V2YWx1YXRvcicsXG4gKiAgIGxldmVsOiBhZ2VudGNvcmUuRXZhbHVhdGlvbkxldmVsLlNFU1NJT04sXG4gKiAgIGV2YWx1YXRvckNvbmZpZzogYWdlbnRjb3JlLkV2YWx1YXRvckNvbmZpZy5sbG1Bc0FKdWRnZSh7XG4gKiAgICAgaW5zdHJ1Y3Rpb25zOiAnRXZhbHVhdGUgd2hldGhlciB0aGUgYWdlbnQgcmVzcG9uc2UgaXMgaGVscGZ1bCBhbmQgYWNjdXJhdGUuJyxcbiAqICAgICBtb2RlbElkOiAndXMuYW50aHJvcGljLmNsYXVkZS1zb25uZXQtNC02JyxcbiAqICAgICByYXRpbmdTY2FsZTogYWdlbnRjb3JlLkV2YWx1YXRvclJhdGluZ1NjYWxlLmNhdGVnb3JpY2FsKFtcbiAqICAgICAgIHsgbGFiZWw6ICdHb29kJywgZGVmaW5pdGlvbjogJ1RoZSByZXNwb25zZSBpcyBoZWxwZnVsIGFuZCBhY2N1cmF0ZS4nIH0sXG4gKiAgICAgICB7IGxhYmVsOiAnQmFkJywgZGVmaW5pdGlvbjogJ1RoZSByZXNwb25zZSBpcyBub3QgaGVscGZ1bCBvciBjb250YWlucyBlcnJvcnMuJyB9LFxuICogICAgIF0pLFxuICogICB9KSxcbiAqIH0pO1xuICpcbiAqIC8vIFVzZSB0aGUgY3VzdG9tIGV2YWx1YXRvciBpbiBhbiBvbmxpbmUgZXZhbHVhdGlvbiBjb25maWd1cmF0aW9uXG4gKiBuZXcgYWdlbnRjb3JlLk9ubGluZUV2YWx1YXRpb25Db25maWcodGhpcywgJ015RXZhbHVhdGlvbicsIHtcbiAqICAgb25saW5lRXZhbHVhdGlvbkNvbmZpZ05hbWU6ICdteV9ldmFsdWF0aW9uJyxcbiAqICAgZXZhbHVhdG9yczogW1xuICogICAgIGFnZW50Y29yZS5FdmFsdWF0b3JSZWZlcmVuY2UuYnVpbHRpbihhZ2VudGNvcmUuQnVpbHRpbkV2YWx1YXRvci5IRUxQRlVMTkVTUyksXG4gKiAgICAgYWdlbnRjb3JlLkV2YWx1YXRvclJlZmVyZW5jZS5jdXN0b20oZXZhbHVhdG9yKSxcbiAqICAgXSxcbiAqICAgZGF0YVNvdXJjZTogYWdlbnRjb3JlLkRhdGFTb3VyY2VDb25maWcuZnJvbUNsb3VkV2F0Y2hMb2dzKHtcbiAqICAgICBsb2dHcm91cE5hbWVzOiBbJy9hd3MvYmVkcm9jay1hZ2VudGNvcmUvbXktYWdlbnQnXSxcbiAqICAgICBzZXJ2aWNlTmFtZXM6IFsnbXktYWdlbnQuZGVmYXVsdCddLFxuICogICB9KSxcbiAqIH0pO1xuICovXG5AcHJvcGVydHlJbmplY3RhYmxlXG5leHBvcnQgY2xhc3MgRXZhbHVhdG9yIGV4dGVuZHMgRXZhbHVhdG9yQmFzZSB7XG4gIC8qKiBVbmlxdWVseSBpZGVudGlmaWVzIHRoaXMgY2xhc3MuICovXG4gIHB1YmxpYyBzdGF0aWMgcmVhZG9ubHkgUFJPUEVSVFlfSU5KRUNUSU9OX0lEOiBzdHJpbmcgPVxuICAgICdAYXdzLWNkay5hd3MtYmVkcm9jay1hZ2VudGNvcmUtYWxwaGEuRXZhbHVhdG9yJztcblxuICAvKipcbiAgICogSW1wb3J0IGFuIGV4aXN0aW5nIEV2YWx1YXRvciBieSBpdHMgSUQuXG4gICAqXG4gICAqIEBwYXJhbSBzY29wZSAtIFRoZSBjb25zdHJ1Y3Qgc2NvcGVcbiAgICogQHBhcmFtIGlkIC0gQ29uc3RydWN0IGlkZW50aWZpZXJcbiAgICogQHBhcmFtIGV2YWx1YXRvcklkIC0gVGhlIGV2YWx1YXRvciBJRCB0byBpbXBvcnRcbiAgICogQHJldHVybnMgQW4gSUV2YWx1YXRvciByZWZlcmVuY2VcbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgZnJvbUV2YWx1YXRvcklkKFxuICAgIHNjb3BlOiBDb25zdHJ1Y3QsXG4gICAgaWQ6IHN0cmluZyxcbiAgICBldmFsdWF0b3JJZDogc3RyaW5nLFxuICApOiBJRXZhbHVhdG9yIHtcbiAgICBjb25zdCBzdGFjayA9IFN0YWNrLm9mKHNjb3BlKTtcbiAgICBjb25zdCBldmFsdWF0b3JBcm4gPSBBcm4uZm9ybWF0KFxuICAgICAge1xuICAgICAgICBzZXJ2aWNlOiAnYmVkcm9jay1hZ2VudGNvcmUnLFxuICAgICAgICByZXNvdXJjZTogJ2V2YWx1YXRvcicsXG4gICAgICAgIHJlc291cmNlTmFtZTogZXZhbHVhdG9ySWQsXG4gICAgICB9LFxuICAgICAgc3RhY2ssXG4gICAgKTtcblxuICAgIHJldHVybiBFdmFsdWF0b3IuZnJvbUV2YWx1YXRvckF0dHJpYnV0ZXMoc2NvcGUsIGlkLCB7XG4gICAgICBldmFsdWF0b3JBcm4sXG4gICAgICBldmFsdWF0b3JJZCxcbiAgICB9KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBJbXBvcnQgYW4gZXhpc3RpbmcgRXZhbHVhdG9yIGJ5IGl0cyBBUk4uXG4gICAqXG4gICAqIEBwYXJhbSBzY29wZSAtIFRoZSBjb25zdHJ1Y3Qgc2NvcGVcbiAgICogQHBhcmFtIGlkIC0gQ29uc3RydWN0IGlkZW50aWZpZXJcbiAgICogQHBhcmFtIGV2YWx1YXRvckFybiAtIFRoZSBldmFsdWF0b3IgQVJOIHRvIGltcG9ydFxuICAgKiBAcmV0dXJucyBBbiBJRXZhbHVhdG9yIHJlZmVyZW5jZVxuICAgKi9cbiAgcHVibGljIHN0YXRpYyBmcm9tRXZhbHVhdG9yQXJuKFxuICAgIHNjb3BlOiBDb25zdHJ1Y3QsXG4gICAgaWQ6IHN0cmluZyxcbiAgICBldmFsdWF0b3JBcm46IHN0cmluZyxcbiAgKTogSUV2YWx1YXRvciB7XG4gICAgY29uc3QgYXJuUGFydHMgPSBBcm4uc3BsaXQoZXZhbHVhdG9yQXJuLCBBcm5Gb3JtYXQuU0xBU0hfUkVTT1VSQ0VfTkFNRSk7XG4gICAgY29uc3QgZXZhbHVhdG9ySWQgPSBhcm5QYXJ0cy5yZXNvdXJjZU5hbWUhO1xuXG4gICAgcmV0dXJuIEV2YWx1YXRvci5mcm9tRXZhbHVhdG9yQXR0cmlidXRlcyhzY29wZSwgaWQsIHtcbiAgICAgIGV2YWx1YXRvckFybixcbiAgICAgIGV2YWx1YXRvcklkLFxuICAgIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIEltcG9ydCBhbiBleGlzdGluZyBFdmFsdWF0b3IgZnJvbSBpdHMgYXR0cmlidXRlcy5cbiAgICpcbiAgICogQHBhcmFtIHNjb3BlIC0gVGhlIGNvbnN0cnVjdCBzY29wZVxuICAgKiBAcGFyYW0gaWQgLSBDb25zdHJ1Y3QgaWRlbnRpZmllclxuICAgKiBAcGFyYW0gYXR0cnMgLSBUaGUgZXZhbHVhdG9yIGF0dHJpYnV0ZXNcbiAgICogQHJldHVybnMgQW4gSUV2YWx1YXRvciByZWZlcmVuY2VcbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgZnJvbUV2YWx1YXRvckF0dHJpYnV0ZXMoXG4gICAgc2NvcGU6IENvbnN0cnVjdCxcbiAgICBpZDogc3RyaW5nLFxuICAgIGF0dHJzOiBFdmFsdWF0b3JBdHRyaWJ1dGVzLFxuICApOiBJRXZhbHVhdG9yIHtcbiAgICBjbGFzcyBJbXBvcnQgZXh0ZW5kcyBFdmFsdWF0b3JCYXNlIHtcbiAgICAgIHB1YmxpYyByZWFkb25seSBldmFsdWF0b3JBcm4gPSBhdHRycy5ldmFsdWF0b3JBcm47XG4gICAgICBwdWJsaWMgcmVhZG9ubHkgZXZhbHVhdG9ySWQgPSBhdHRycy5ldmFsdWF0b3JJZDtcbiAgICAgIHB1YmxpYyByZWFkb25seSBldmFsdWF0b3JOYW1lID0gYXR0cnMuZXZhbHVhdG9yTmFtZSA/PyBhdHRycy5ldmFsdWF0b3JJZDtcbiAgICAgIHB1YmxpYyByZWFkb25seSBzdGF0dXMgPSB1bmRlZmluZWQ7XG4gICAgICBwdWJsaWMgcmVhZG9ubHkgY3JlYXRlZEF0ID0gdW5kZWZpbmVkO1xuICAgICAgcHVibGljIHJlYWRvbmx5IHVwZGF0ZWRBdCA9IHVuZGVmaW5lZDtcbiAgICB9XG5cbiAgICByZXR1cm4gbmV3IEltcG9ydChzY29wZSwgaWQpO1xuICB9XG5cbiAgLyoqXG4gICAqIFRoZSBBUk4gb2YgdGhlIGV2YWx1YXRvci5cbiAgICogQGF0dHJpYnV0ZVxuICAgKi9cbiAgcHVibGljIHJlYWRvbmx5IGV2YWx1YXRvckFybjogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgdW5pcXVlIGlkZW50aWZpZXIgb2YgdGhlIGV2YWx1YXRvci5cbiAgICogQGF0dHJpYnV0ZVxuICAgKi9cbiAgcHVibGljIHJlYWRvbmx5IGV2YWx1YXRvcklkOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBuYW1lIG9mIHRoZSBldmFsdWF0b3IuXG4gICAqIEBhdHRyaWJ1dGVcbiAgICovXG4gIHB1YmxpYyByZWFkb25seSBldmFsdWF0b3JOYW1lOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBsaWZlY3ljbGUgc3RhdHVzIG9mIHRoZSBldmFsdWF0b3IuXG4gICAqIEBhdHRyaWJ1dGVcbiAgICovXG4gIHB1YmxpYyByZWFkb25seSBzdGF0dXM/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSB0aW1lc3RhbXAgd2hlbiB0aGUgZXZhbHVhdG9yIHdhcyBjcmVhdGVkLlxuICAgKiBAYXR0cmlidXRlXG4gICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgY3JlYXRlZEF0Pzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgdGltZXN0YW1wIHdoZW4gdGhlIGV2YWx1YXRvciB3YXMgbGFzdCB1cGRhdGVkLlxuICAgKiBAYXR0cmlidXRlXG4gICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgdXBkYXRlZEF0Pzogc3RyaW5nO1xuXG4gIGNvbnN0cnVjdG9yKHNjb3BlOiBDb25zdHJ1Y3QsIGlkOiBzdHJpbmcsIHByb3BzOiBFdmFsdWF0b3JQcm9wcykge1xuICAgIHN1cGVyKHNjb3BlLCBpZCwge1xuICAgICAgcGh5c2ljYWxOYW1lOiBwcm9wcy5ldmFsdWF0b3JOYW1lLFxuICAgIH0pO1xuXG4gICAgYWRkQ29uc3RydWN0TWV0YWRhdGEodGhpcywgcHJvcHMpO1xuXG4gICAgdGhyb3dJZkludmFsaWQodmFsaWRhdGVFdmFsdWF0b3JOYW1lLCBwcm9wcy5ldmFsdWF0b3JOYW1lLCB0aGlzKTtcbiAgICB0aHJvd0lmSW52YWxpZCh2YWxpZGF0ZURlc2NyaXB0aW9uLCBwcm9wcy5kZXNjcmlwdGlvbiwgdGhpcyk7XG5cbiAgICB0aGlzLmV2YWx1YXRvck5hbWUgPSB0aGlzLnBoeXNpY2FsTmFtZTtcblxuICAgIGNvbnN0IHJlc291cmNlID0gbmV3IGJlZHJvY2thZ2VudGNvcmUuQ2ZuRXZhbHVhdG9yKHRoaXMsICdSZXNvdXJjZScsIHtcbiAgICAgIGV2YWx1YXRvck5hbWU6IHRoaXMucGh5c2ljYWxOYW1lLFxuICAgICAgZXZhbHVhdG9yQ29uZmlnOiBwcm9wcy5ldmFsdWF0b3JDb25maWcuX2JpbmQoKSxcbiAgICAgIGxldmVsOiBwcm9wcy5sZXZlbC52YWx1ZSxcbiAgICAgIGRlc2NyaXB0aW9uOiBwcm9wcy5kZXNjcmlwdGlvbixcbiAgICB9KTtcblxuICAgIC8vIElmIGNvZGUtYmFzZWQsIGdyYW50IHRoZSBiZWRyb2NrLWFnZW50Y29yZSBzZXJ2aWNlIHBlcm1pc3Npb24gdG8gaW52b2tlXG4gICAgLy8gdGhlIExhbWJkYSBmdW5jdGlvbiwgc2NvcGVkIHRvIHRoaXMgc3BlY2lmaWMgZXZhbHVhdG9yIGZvciBjb25mdXNlZCBkZXB1dHkgcHJldmVudGlvbi5cbiAgICBpZiAocHJvcHMuZXZhbHVhdG9yQ29uZmlnLmxhbWJkYUZ1bmN0aW9uKSB7XG4gICAgICBjb25zdCBzdGFjayA9IFN0YWNrLm9mKHRoaXMpO1xuICAgICAgcHJvcHMuZXZhbHVhdG9yQ29uZmlnLmxhbWJkYUZ1bmN0aW9uLmFkZFBlcm1pc3Npb24oJ0JlZHJvY2tBZ2VudENvcmVFdmFsdWF0b3JJbnZva2UnLCB7XG4gICAgICAgIHByaW5jaXBhbDogbmV3IGlhbS5TZXJ2aWNlUHJpbmNpcGFsKCdiZWRyb2NrLWFnZW50Y29yZS5hbWF6b25hd3MuY29tJyksXG4gICAgICAgIHNvdXJjZUFjY291bnQ6IHN0YWNrLmFjY291bnQsXG4gICAgICAgIHNvdXJjZUFybjogcmVzb3VyY2UuYXR0ckV2YWx1YXRvckFybixcbiAgICAgIH0pO1xuICAgIH1cblxuICAgIHRoaXMuZXZhbHVhdG9yQXJuID0gcmVzb3VyY2UuYXR0ckV2YWx1YXRvckFybjtcbiAgICB0aGlzLmV2YWx1YXRvcklkID0gcmVzb3VyY2UuYXR0ckV2YWx1YXRvcklkO1xuICAgIHRoaXMuc3RhdHVzID0gcmVzb3VyY2UuYXR0clN0YXR1cztcbiAgICB0aGlzLmNyZWF0ZWRBdCA9IHJlc291cmNlLmF0dHJDcmVhdGVkQXQ7XG4gICAgdGhpcy51cGRhdGVkQXQgPSByZXNvdXJjZS5hdHRyVXBkYXRlZEF0O1xuICB9XG59XG4iXX0=

package/lib/evaluation/data-source.d.ts

@@ -0,0 +1,106 @@
+/**
+ *  Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
+ *  with the License. A copy of the License is located at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
+ *  OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
+ *  and limitations under the License.
+ */
+import type { CloudWatchLogsDataSourceConfig, DataSourceConfigBindResult } from './types';
+import type { IBedrockAgentRuntime } from '../runtime/runtime-base';
+import type { IRuntimeEndpoint } from '../runtime/runtime-endpoint-base';
+/**
+ * Configuration for the data source used in online evaluation.
+ *
+ * Use the static factory methods to create data source configurations:
+ * - `DataSourceConfig.fromAgentRuntimeEndpoint()` for AgentCore Runtime (recommended)
+ * - `DataSourceConfig.fromAgentRuntimeEndpointName()` for AgentCore Runtime using endpoint name string
+ * - `DataSourceConfig.fromCloudWatchLogs()` for external agents or custom log groups
+ *
+ * @example
+ * // AgentCore Runtime with default endpoint
+ * declare const runtime: agentcore.Runtime;
+ * const dataSource = agentcore.DataSourceConfig.fromAgentRuntimeEndpoint(runtime);
+ *
+ * @example
+ * // AgentCore Runtime with specific endpoint
+ * declare const runtime: agentcore.Runtime;
+ * const endpoint = runtime.addEndpoint('PROD');
+ * const dataSource = agentcore.DataSourceConfig.fromAgentRuntimeEndpoint(runtime, endpoint);
+ *
+ * @example
+ * // CloudWatch Logs data source (for external agents)
+ * const dataSource = agentcore.DataSourceConfig.fromCloudWatchLogs({
+ *   logGroupNames: ['/aws/my-external-agent/logs'],
+ *   serviceNames: ['my-external-agent'],
+ * });
+ */
+export declare class DataSourceConfig {
+    /**
+     * Creates a CloudWatch Logs data source configuration.
+     *
+     * Use this when your agent traces are stored in CloudWatch Logs,
+     * such as for external agents or when you need to specify log groups directly.
+     *
+     * @param config - The CloudWatch Logs data source configuration
+     * @returns A DataSourceConfig instance
+     *
+     * @example
+     * const dataSource = agentcore.DataSourceConfig.fromCloudWatchLogs({
+     *   logGroupNames: ['/aws/bedrock-agentcore/runtimes/myRuntime-abc123-DEFAULT'],
+     *   serviceNames: ['myRuntime.DEFAULT'],
+     * });
+     */
+    static fromCloudWatchLogs(config: CloudWatchLogsDataSourceConfig): DataSourceConfig;
+    /**
+     * Creates a data source configuration from an AgentCore Runtime and optional endpoint.
+     *
+     * This is the recommended way to configure evaluation for AgentCore Runtime agents.
+     * It automatically derives the CloudWatch log group and service name from the runtime and endpoint.
+     *
+     * @param runtime - The AgentCore Runtime construct
+     * @param endpoint - The RuntimeEndpoint construct. Defaults to 'DEFAULT' endpoint if not provided.
+     * @returns A DataSourceConfig instance
+     *
+     * @example
+     * // Using default endpoint
+     * declare const runtime: agentcore.Runtime;
+     * const dataSource = agentcore.DataSourceConfig.fromAgentRuntimeEndpoint(runtime);
+     *
+     * @example
+     * // Using a specific endpoint
+     * declare const runtime: agentcore.Runtime;
+     * const endpoint = runtime.addEndpoint('PROD');
+     * const dataSource = agentcore.DataSourceConfig.fromAgentRuntimeEndpoint(runtime, endpoint);
+     */
+    static fromAgentRuntimeEndpoint(runtime: IBedrockAgentRuntime, endpoint?: IRuntimeEndpoint): DataSourceConfig;
+    /**
+     * Creates a data source configuration from an AgentCore Runtime and an endpoint name string.
+     *
+     * Use this method when you want to reference an endpoint by name without
+     * having a construct reference. For construct references, prefer `fromAgentRuntimeEndpoint()`.
+     *
+     * @param runtime - The AgentCore Runtime construct
+     * @param endpointName - The name of the runtime endpoint
+     * @returns A DataSourceConfig instance
+     *
+     * @example
+     * declare const runtime: agentcore.Runtime;
+     * const dataSource = agentcore.DataSourceConfig.fromAgentRuntimeEndpointName(runtime, 'PROD');
+     */
+    static fromAgentRuntimeEndpointName(runtime: IBedrockAgentRuntime, endpointName: string): DataSourceConfig;
+    private static buildFromRuntime;
+    /**
+     * The CloudWatch Logs configuration.
+     */
+    readonly cloudWatchLogsConfig: CloudWatchLogsDataSourceConfig;
+    private constructor();
+    /**
+     * Binds the data source configuration to produce the L1 property.
+     */
+    bind(): DataSourceConfigBindResult;
+}

package/lib/evaluation/data-source.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataSourceConfig = void 0;
+const jsiiDeprecationWarnings = require("../../.warnings.jsii.js");
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+const validation_helpers_1 = require("./validation-helpers");
+/**
+ * Configuration for the data source used in online evaluation.
+ *
+ * Use the static factory methods to create data source configurations:
+ * - `DataSourceConfig.fromAgentRuntimeEndpoint()` for AgentCore Runtime (recommended)
+ * - `DataSourceConfig.fromAgentRuntimeEndpointName()` for AgentCore Runtime using endpoint name string
+ * - `DataSourceConfig.fromCloudWatchLogs()` for external agents or custom log groups
+ *
+ * @example
+ * // AgentCore Runtime with default endpoint
+ * declare const runtime: agentcore.Runtime;
+ * const dataSource = agentcore.DataSourceConfig.fromAgentRuntimeEndpoint(runtime);
+ *
+ * @example
+ * // AgentCore Runtime with specific endpoint
+ * declare const runtime: agentcore.Runtime;
+ * const endpoint = runtime.addEndpoint('PROD');
+ * const dataSource = agentcore.DataSourceConfig.fromAgentRuntimeEndpoint(runtime, endpoint);
+ *
+ * @example
+ * // CloudWatch Logs data source (for external agents)
+ * const dataSource = agentcore.DataSourceConfig.fromCloudWatchLogs({
+ *   logGroupNames: ['/aws/my-external-agent/logs'],
+ *   serviceNames: ['my-external-agent'],
+ * });
+ */
+class DataSourceConfig {
+    static [JSII_RTTI_SYMBOL_1] = { fqn: "@aws-cdk/aws-bedrock-agentcore-alpha.DataSourceConfig", version: "2.253.0-alpha.0" };
+    /**
+     * Creates a CloudWatch Logs data source configuration.
+     *
+     * Use this when your agent traces are stored in CloudWatch Logs,
+     * such as for external agents or when you need to specify log groups directly.
+     *
+     * @param config - The CloudWatch Logs data source configuration
+     * @returns A DataSourceConfig instance
+     *
+     * @example
+     * const dataSource = agentcore.DataSourceConfig.fromCloudWatchLogs({
+     *   logGroupNames: ['/aws/bedrock-agentcore/runtimes/myRuntime-abc123-DEFAULT'],
+     *   serviceNames: ['myRuntime.DEFAULT'],
+     * });
+     */
+    static fromCloudWatchLogs(config) {
+        try {
+            jsiiDeprecationWarnings._aws_cdk_aws_bedrock_agentcore_alpha_CloudWatchLogsDataSourceConfig(config);
+        }
+        catch (error) {
+            if (process.env.JSII_DEBUG !== "1" && error.name === "DeprecationError") {
+                Error.captureStackTrace(error, this.fromCloudWatchLogs);
+            }
+            throw error;
+        }
+        (0, validation_helpers_1.throwIfInvalid)(validation_helpers_1.validateLogGroupNames, config.logGroupNames);
+        (0, validation_helpers_1.throwIfInvalid)(validation_helpers_1.validateServiceNames, config.serviceNames);
+        return new DataSourceConfig({
+            logGroupNames: config.logGroupNames,
+            serviceNames: config.serviceNames,
+        });
+    }
+    /**
+     * Creates a data source configuration from an AgentCore Runtime and optional endpoint.
+     *
+     * This is the recommended way to configure evaluation for AgentCore Runtime agents.
+     * It automatically derives the CloudWatch log group and service name from the runtime and endpoint.
+     *
+     * @param runtime - The AgentCore Runtime construct
+     * @param endpoint - The RuntimeEndpoint construct. Defaults to 'DEFAULT' endpoint if not provided.
+     * @returns A DataSourceConfig instance
+     *
+     * @example
+     * // Using default endpoint
+     * declare const runtime: agentcore.Runtime;
+     * const dataSource = agentcore.DataSourceConfig.fromAgentRuntimeEndpoint(runtime);
+     *
+     * @example
+     * // Using a specific endpoint
+     * declare const runtime: agentcore.Runtime;
+     * const endpoint = runtime.addEndpoint('PROD');
+     * const dataSource = agentcore.DataSourceConfig.fromAgentRuntimeEndpoint(runtime, endpoint);
+     */
+    static fromAgentRuntimeEndpoint(runtime, endpoint) {
+        try {
+            jsiiDeprecationWarnings._aws_cdk_aws_bedrock_agentcore_alpha_IBedrockAgentRuntime(runtime);
+            jsiiDeprecationWarnings._aws_cdk_aws_bedrock_agentcore_alpha_IRuntimeEndpoint(endpoint);
+        }
+        catch (error) {
+            if (process.env.JSII_DEBUG !== "1" && error.name === "DeprecationError") {
+                Error.captureStackTrace(error, this.fromAgentRuntimeEndpoint);
+            }
+            throw error;
+        }
+        const endpointName = endpoint?.endpointName ?? 'DEFAULT';
+        return DataSourceConfig.buildFromRuntime(runtime, endpointName);
+    }
+    /**
+     * Creates a data source configuration from an AgentCore Runtime and an endpoint name string.
+     *
+     * Use this method when you want to reference an endpoint by name without
+     * having a construct reference. For construct references, prefer `fromAgentRuntimeEndpoint()`.
+     *
+     * @param runtime - The AgentCore Runtime construct
+     * @param endpointName - The name of the runtime endpoint
+     * @returns A DataSourceConfig instance
+     *
+     * @example
+     * declare const runtime: agentcore.Runtime;
+     * const dataSource = agentcore.DataSourceConfig.fromAgentRuntimeEndpointName(runtime, 'PROD');
+     */
+    static fromAgentRuntimeEndpointName(runtime, endpointName) {
+        try {
+            jsiiDeprecationWarnings._aws_cdk_aws_bedrock_agentcore_alpha_IBedrockAgentRuntime(runtime);
+        }
+        catch (error) {
+            if (process.env.JSII_DEBUG !== "1" && error.name === "DeprecationError") {
+                Error.captureStackTrace(error, this.fromAgentRuntimeEndpointName);
+            }
+            throw error;
+        }
+        return DataSourceConfig.buildFromRuntime(runtime, endpointName);
+    }
+    static buildFromRuntime(runtime, endpointName) {
+        const logGroupName = `/aws/bedrock-agentcore/runtimes/${runtime.agentRuntimeId}-${endpointName}`;
+        const serviceName = `${runtime.agentRuntimeName}.${endpointName}`;
+        return new DataSourceConfig({
+            logGroupNames: [logGroupName],
+            serviceNames: [serviceName],
+        });
+    }
+    /**
+     * The CloudWatch Logs configuration.
+     */
+    cloudWatchLogsConfig;
+    constructor(config) {
+        this.cloudWatchLogsConfig = config;
+    }
+    /**
+     * Binds the data source configuration to produce the L1 property.
+     */
+    bind() {
+        return {
+            cloudWatchLogs: {
+                logGroupNames: this.cloudWatchLogsConfig.logGroupNames,
+                serviceNames: this.cloudWatchLogsConfig.serviceNames,
+            },
+        };
+    }
+}
+exports.DataSourceConfig = DataSourceConfig;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGF0YS1zb3VyY2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJkYXRhLXNvdXJjZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQWNBLDZEQUFtRztBQUluRzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQXlCRztBQUNILE1BQWEsZ0JBQWdCOztJQUMzQjs7Ozs7Ozs7Ozs7Ozs7T0FjRztJQUNJLE1BQU0sQ0FBQyxrQkFBa0IsQ0FBQyxNQUFzQzs7Ozs7Ozs7OztRQUNyRSxJQUFBLG1DQUFjLEVBQUMsMENBQXFCLEVBQUUsTUFBTSxDQUFDLGFBQWEsQ0FBQyxDQUFDO1FBQzVELElBQUEsbUNBQWMsRUFBQyx5Q0FBb0IsRUFBRSxNQUFNLENBQUMsWUFBWSxDQUFDLENBQUM7UUFDMUQsT0FBTyxJQUFJLGdCQUFnQixDQUFDO1lBQzFCLGFBQWEsRUFBRSxNQUFNLENBQUMsYUFBYTtZQUNuQyxZQUFZLEVBQUUsTUFBTSxDQUFDLFlBQVk7U0FDbEMsQ0FBQyxDQUFDO0tBQ0o7SUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7T0FvQkc7SUFDSSxNQUFNLENBQUMsd0JBQXdCLENBQ3BDLE9BQTZCLEVBQzdCLFFBQTJCOzs7Ozs7Ozs7OztRQUUzQixNQUFNLFlBQVksR0FBRyxRQUFRLEVBQUUsWUFBWSxJQUFJLFNBQVMsQ0FBQztRQUV6RCxPQUFPLGdCQUFnQixDQUFDLGdCQUFnQixDQUFDLE9BQU8sRUFBRSxZQUFZLENBQUMsQ0FBQztLQUNqRTtJQUVEOzs7Ozs7Ozs7Ozs7O09BYUc7SUFDSSxNQUFNLENBQUMsNEJBQTRCLENBQ3hDLE9BQTZCLEVBQzdCLFlBQW9COzs7Ozs7Ozs7O1FBRXBCLE9BQU8sZ0JBQWdCLENBQUMsZ0JBQWdCLENBQUMsT0FBTyxFQUFFLFlBQVksQ0FBQyxDQUFDO0tBQ2pFO0lBRU8sTUFBTSxDQUFDLGdCQUFnQixDQUM3QixPQUE2QixFQUM3QixZQUFvQjtRQUVwQixNQUFNLFlBQVksR0FBRyxtQ0FBbUMsT0FBTyxDQUFDLGNBQWMsSUFBSSxZQUFZLEVBQUUsQ0FBQztRQUNqRyxNQUFNLFdBQVcsR0FBRyxHQUFHLE9BQU8sQ0FBQyxnQkFBZ0IsSUFBSSxZQUFZLEVBQUUsQ0FBQztRQUVsRSxPQUFPLElBQUksZ0JBQWdCLENBQUM7WUFDMUIsYUFBYSxFQUFFLENBQUMsWUFBWSxDQUFDO1lBQzdCLFlBQVksRUFBRSxDQUFDLFdBQVcsQ0FBQztTQUM1QixDQUFDLENBQUM7S0FDSjtJQUVEOztPQUVHO0lBQ2Esb0JBQW9CLENBQWlDO0lBRXJFLFlBQW9CLE1BQXNDO1FBQ3hELElBQUksQ0FBQyxvQkFBb0IsR0FBRyxNQUFNLENBQUM7S0FDcEM7SUFFRDs7T0FFRztJQUNJLElBQUk7UUFDVCxPQUFPO1lBQ0wsY0FBYyxFQUFFO2dCQUNkLGFBQWEsRUFBRSxJQUFJLENBQUMsb0JBQW9CLENBQUMsYUFBYTtnQkFDdEQsWUFBWSxFQUFFLElBQUksQ0FBQyxvQkFBb0IsQ0FBQyxZQUFZO2FBQ3JEO1NBQ0YsQ0FBQztLQUNIOztBQTVHSCw0Q0E2R0MiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqICBDb3B5cmlnaHQgQW1hem9uLmNvbSwgSW5jLiBvciBpdHMgYWZmaWxpYXRlcy4gQWxsIFJpZ2h0cyBSZXNlcnZlZC5cbiAqXG4gKiAgTGljZW5zZWQgdW5kZXIgdGhlIEFwYWNoZSBMaWNlbnNlLCBWZXJzaW9uIDIuMCAodGhlIFwiTGljZW5zZVwiKS4gWW91IG1heSBub3QgdXNlIHRoaXMgZmlsZSBleGNlcHQgaW4gY29tcGxpYW5jZVxuICogIHdpdGggdGhlIExpY2Vuc2UuIEEgY29weSBvZiB0aGUgTGljZW5zZSBpcyBsb2NhdGVkIGF0XG4gKlxuICogICAgICBodHRwOi8vd3d3LmFwYWNoZS5vcmcvbGljZW5zZXMvTElDRU5TRS0yLjBcbiAqXG4gKiAgb3IgaW4gdGhlICdsaWNlbnNlJyBmaWxlIGFjY29tcGFueWluZyB0aGlzIGZpbGUuIFRoaXMgZmlsZSBpcyBkaXN0cmlidXRlZCBvbiBhbiAnQVMgSVMnIEJBU0lTLCBXSVRIT1VUIFdBUlJBTlRJRVNcbiAqICBPUiBDT05ESVRJT05TIE9GIEFOWSBLSU5ELCBleHByZXNzIG9yIGltcGxpZWQuIFNlZSB0aGUgTGljZW5zZSBmb3IgdGhlIHNwZWNpZmljIGxhbmd1YWdlIGdvdmVybmluZyBwZXJtaXNzaW9uc1xuICogIGFuZCBsaW1pdGF0aW9ucyB1bmRlciB0aGUgTGljZW5zZS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IENsb3VkV2F0Y2hMb2dzRGF0YVNvdXJjZUNvbmZpZywgRGF0YVNvdXJjZUNvbmZpZ0JpbmRSZXN1bHQgfSBmcm9tICcuL3R5cGVzJztcbmltcG9ydCB7IHRocm93SWZJbnZhbGlkLCB2YWxpZGF0ZUxvZ0dyb3VwTmFtZXMsIHZhbGlkYXRlU2VydmljZU5hbWVzIH0gZnJvbSAnLi92YWxpZGF0aW9uLWhlbHBlcnMnO1xuaW1wb3J0IHR5cGUgeyBJQmVkcm9ja0FnZW50UnVudGltZSB9IGZyb20gJy4uL3J1bnRpbWUvcnVudGltZS1iYXNlJztcbmltcG9ydCB0eXBlIHsgSVJ1bnRpbWVFbmRwb2ludCB9IGZyb20gJy4uL3J1bnRpbWUvcnVudGltZS1lbmRwb2ludC1iYXNlJztcblxuLyoqXG4gKiBDb25maWd1cmF0aW9uIGZvciB0aGUgZGF0YSBzb3VyY2UgdXNlZCBpbiBvbmxpbmUgZXZhbHVhdGlvbi5cbiAqXG4gKiBVc2UgdGhlIHN0YXRpYyBmYWN0b3J5IG1ldGhvZHMgdG8gY3JlYXRlIGRhdGEgc291cmNlIGNvbmZpZ3VyYXRpb25zOlxuICogLSBgRGF0YVNvdXJjZUNvbmZpZy5mcm9tQWdlbnRSdW50aW1lRW5kcG9pbnQoKWAgZm9yIEFnZW50Q29yZSBSdW50aW1lIChyZWNvbW1lbmRlZClcbiAqIC0gYERhdGFTb3VyY2VDb25maWcuZnJvbUFnZW50UnVudGltZUVuZHBvaW50TmFtZSgpYCBmb3IgQWdlbnRDb3JlIFJ1bnRpbWUgdXNpbmcgZW5kcG9pbnQgbmFtZSBzdHJpbmdcbiAqIC0gYERhdGFTb3VyY2VDb25maWcuZnJvbUNsb3VkV2F0Y2hMb2dzKClgIGZvciBleHRlcm5hbCBhZ2VudHMgb3IgY3VzdG9tIGxvZyBncm91cHNcbiAqXG4gKiBAZXhhbXBsZVxuICogLy8gQWdlbnRDb3JlIFJ1bnRpbWUgd2l0aCBkZWZhdWx0IGVuZHBvaW50XG4gKiBkZWNsYXJlIGNvbnN0IHJ1bnRpbWU6IGFnZW50Y29yZS5SdW50aW1lO1xuICogY29uc3QgZGF0YVNvdXJjZSA9IGFnZW50Y29yZS5EYXRhU291cmNlQ29uZmlnLmZyb21BZ2VudFJ1bnRpbWVFbmRwb2ludChydW50aW1lKTtcbiAqXG4gKiBAZXhhbXBsZVxuICogLy8gQWdlbnRDb3JlIFJ1bnRpbWUgd2l0aCBzcGVjaWZpYyBlbmRwb2ludFxuICogZGVjbGFyZSBjb25zdCBydW50aW1lOiBhZ2VudGNvcmUuUnVudGltZTtcbiAqIGNvbnN0IGVuZHBvaW50ID0gcnVudGltZS5hZGRFbmRwb2ludCgnUFJPRCcpO1xuICogY29uc3QgZGF0YVNvdXJjZSA9IGFnZW50Y29yZS5EYXRhU291cmNlQ29uZmlnLmZyb21BZ2VudFJ1bnRpbWVFbmRwb2ludChydW50aW1lLCBlbmRwb2ludCk7XG4gKlxuICogQGV4YW1wbGVcbiAqIC8vIENsb3VkV2F0Y2ggTG9ncyBkYXRhIHNvdXJjZSAoZm9yIGV4dGVybmFsIGFnZW50cylcbiAqIGNvbnN0IGRhdGFTb3VyY2UgPSBhZ2VudGNvcmUuRGF0YVNvdXJjZUNvbmZpZy5mcm9tQ2xvdWRXYXRjaExvZ3Moe1xuICogICBsb2dHcm91cE5hbWVzOiBbJy9hd3MvbXktZXh0ZXJuYWwtYWdlbnQvbG9ncyddLFxuICogICBzZXJ2aWNlTmFtZXM6IFsnbXktZXh0ZXJuYWwtYWdlbnQnXSxcbiAqIH0pO1xuICovXG5leHBvcnQgY2xhc3MgRGF0YVNvdXJjZUNvbmZpZyB7XG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgQ2xvdWRXYXRjaCBMb2dzIGRhdGEgc291cmNlIGNvbmZpZ3VyYXRpb24uXG4gICAqXG4gICAqIFVzZSB0aGlzIHdoZW4geW91ciBhZ2VudCB0cmFjZXMgYXJlIHN0b3JlZCBpbiBDbG91ZFdhdGNoIExvZ3MsXG4gICAqIHN1Y2ggYXMgZm9yIGV4dGVybmFsIGFnZW50cyBvciB3aGVuIHlvdSBuZWVkIHRvIHNwZWNpZnkgbG9nIGdyb3VwcyBkaXJlY3RseS5cbiAgICpcbiAgICogQHBhcmFtIGNvbmZpZyAtIFRoZSBDbG91ZFdhdGNoIExvZ3MgZGF0YSBzb3VyY2UgY29uZmlndXJhdGlvblxuICAgKiBAcmV0dXJucyBBIERhdGFTb3VyY2VDb25maWcgaW5zdGFuY2VcbiAgICpcbiAgICogQGV4YW1wbGVcbiAgICogY29uc3QgZGF0YVNvdXJjZSA9IGFnZW50Y29yZS5EYXRhU291cmNlQ29uZmlnLmZyb21DbG91ZFdhdGNoTG9ncyh7XG4gICAqICAgbG9nR3JvdXBOYW1lczogWycvYXdzL2JlZHJvY2stYWdlbnRjb3JlL3J1bnRpbWVzL215UnVudGltZS1hYmMxMjMtREVGQVVMVCddLFxuICAgKiAgIHNlcnZpY2VOYW1lczogWydteVJ1bnRpbWUuREVGQVVMVCddLFxuICAgKiB9KTtcbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgZnJvbUNsb3VkV2F0Y2hMb2dzKGNvbmZpZzogQ2xvdWRXYXRjaExvZ3NEYXRhU291cmNlQ29uZmlnKTogRGF0YVNvdXJjZUNvbmZpZyB7XG4gICAgdGhyb3dJZkludmFsaWQodmFsaWRhdGVMb2dHcm91cE5hbWVzLCBjb25maWcubG9nR3JvdXBOYW1lcyk7XG4gICAgdGhyb3dJZkludmFsaWQodmFsaWRhdGVTZXJ2aWNlTmFtZXMsIGNvbmZpZy5zZXJ2aWNlTmFtZXMpO1xuICAgIHJldHVybiBuZXcgRGF0YVNvdXJjZUNvbmZpZyh7XG4gICAgICBsb2dHcm91cE5hbWVzOiBjb25maWcubG9nR3JvdXBOYW1lcyxcbiAgICAgIHNlcnZpY2VOYW1lczogY29uZmlnLnNlcnZpY2VOYW1lcyxcbiAgICB9KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgZGF0YSBzb3VyY2UgY29uZmlndXJhdGlvbiBmcm9tIGFuIEFnZW50Q29yZSBSdW50aW1lIGFuZCBvcHRpb25hbCBlbmRwb2ludC5cbiAgICpcbiAgICogVGhpcyBpcyB0aGUgcmVjb21tZW5kZWQgd2F5IHRvIGNvbmZpZ3VyZSBldmFsdWF0aW9uIGZvciBBZ2VudENvcmUgUnVudGltZSBhZ2VudHMuXG4gICAqIEl0IGF1dG9tYXRpY2FsbHkgZGVyaXZlcyB0aGUgQ2xvdWRXYXRjaCBsb2cgZ3JvdXAgYW5kIHNlcnZpY2UgbmFtZSBmcm9tIHRoZSBydW50aW1lIGFuZCBlbmRwb2ludC5cbiAgICpcbiAgICogQHBhcmFtIHJ1bnRpbWUgLSBUaGUgQWdlbnRDb3JlIFJ1bnRpbWUgY29uc3RydWN0XG4gICAqIEBwYXJhbSBlbmRwb2ludCAtIFRoZSBSdW50aW1lRW5kcG9pbnQgY29uc3RydWN0LiBEZWZhdWx0cyB0byAnREVGQVVMVCcgZW5kcG9pbnQgaWYgbm90IHByb3ZpZGVkLlxuICAgKiBAcmV0dXJucyBBIERhdGFTb3VyY2VDb25maWcgaW5zdGFuY2VcbiAgICpcbiAgICogQGV4YW1wbGVcbiAgICogLy8gVXNpbmcgZGVmYXVsdCBlbmRwb2ludFxuICAgKiBkZWNsYXJlIGNvbnN0IHJ1bnRpbWU6IGFnZW50Y29yZS5SdW50aW1lO1xuICAgKiBjb25zdCBkYXRhU291cmNlID0gYWdlbnRjb3JlLkRhdGFTb3VyY2VDb25maWcuZnJvbUFnZW50UnVudGltZUVuZHBvaW50KHJ1bnRpbWUpO1xuICAgKlxuICAgKiBAZXhhbXBsZVxuICAgKiAvLyBVc2luZyBhIHNwZWNpZmljIGVuZHBvaW50XG4gICAqIGRlY2xhcmUgY29uc3QgcnVudGltZTogYWdlbnRjb3JlLlJ1bnRpbWU7XG4gICAqIGNvbnN0IGVuZHBvaW50ID0gcnVudGltZS5hZGRFbmRwb2ludCgnUFJPRCcpO1xuICAgKiBjb25zdCBkYXRhU291cmNlID0gYWdlbnRjb3JlLkRhdGFTb3VyY2VDb25maWcuZnJvbUFnZW50UnVudGltZUVuZHBvaW50KHJ1bnRpbWUsIGVuZHBvaW50KTtcbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgZnJvbUFnZW50UnVudGltZUVuZHBvaW50KFxuICAgIHJ1bnRpbWU6IElCZWRyb2NrQWdlbnRSdW50aW1lLFxuICAgIGVuZHBvaW50PzogSVJ1bnRpbWVFbmRwb2ludCxcbiAgKTogRGF0YVNvdXJjZUNvbmZpZyB7XG4gICAgY29uc3QgZW5kcG9pbnROYW1lID0gZW5kcG9pbnQ/LmVuZHBvaW50TmFtZSA/PyAnREVGQVVMVCc7XG5cbiAgICByZXR1cm4gRGF0YVNvdXJjZUNvbmZpZy5idWlsZEZyb21SdW50aW1lKHJ1bnRpbWUsIGVuZHBvaW50TmFtZSk7XG4gIH1cblxuICAvKipcbiAgICogQ3JlYXRlcyBhIGRhdGEgc291cmNlIGNvbmZpZ3VyYXRpb24gZnJvbSBhbiBBZ2VudENvcmUgUnVudGltZSBhbmQgYW4gZW5kcG9pbnQgbmFtZSBzdHJpbmcuXG4gICAqXG4gICAqIFVzZSB0aGlzIG1ldGhvZCB3aGVuIHlvdSB3YW50IHRvIHJlZmVyZW5jZSBhbiBlbmRwb2ludCBieSBuYW1lIHdpdGhvdXRcbiAgICogaGF2aW5nIGEgY29uc3RydWN0IHJlZmVyZW5jZS4gRm9yIGNvbnN0cnVjdCByZWZlcmVuY2VzLCBwcmVmZXIgYGZyb21BZ2VudFJ1bnRpbWVFbmRwb2ludCgpYC5cbiAgICpcbiAgICogQHBhcmFtIHJ1bnRpbWUgLSBUaGUgQWdlbnRDb3JlIFJ1bnRpbWUgY29uc3RydWN0XG4gICAqIEBwYXJhbSBlbmRwb2ludE5hbWUgLSBUaGUgbmFtZSBvZiB0aGUgcnVudGltZSBlbmRwb2ludFxuICAgKiBAcmV0dXJucyBBIERhdGFTb3VyY2VDb25maWcgaW5zdGFuY2VcbiAgICpcbiAgICogQGV4YW1wbGVcbiAgICogZGVjbGFyZSBjb25zdCBydW50aW1lOiBhZ2VudGNvcmUuUnVudGltZTtcbiAgICogY29uc3QgZGF0YVNvdXJjZSA9IGFnZW50Y29yZS5EYXRhU291cmNlQ29uZmlnLmZyb21BZ2VudFJ1bnRpbWVFbmRwb2ludE5hbWUocnVudGltZSwgJ1BST0QnKTtcbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgZnJvbUFnZW50UnVudGltZUVuZHBvaW50TmFtZShcbiAgICBydW50aW1lOiBJQmVkcm9ja0FnZW50UnVudGltZSxcbiAgICBlbmRwb2ludE5hbWU6IHN0cmluZyxcbiAgKTogRGF0YVNvdXJjZUNvbmZpZyB7XG4gICAgcmV0dXJuIERhdGFTb3VyY2VDb25maWcuYnVpbGRGcm9tUnVudGltZShydW50aW1lLCBlbmRwb2ludE5hbWUpO1xuICB9XG5cbiAgcHJpdmF0ZSBzdGF0aWMgYnVpbGRGcm9tUnVudGltZShcbiAgICBydW50aW1lOiBJQmVkcm9ja0FnZW50UnVudGltZSxcbiAgICBlbmRwb2ludE5hbWU6IHN0cmluZyxcbiAgKTogRGF0YVNvdXJjZUNvbmZpZyB7XG4gICAgY29uc3QgbG9nR3JvdXBOYW1lID0gYC9hd3MvYmVkcm9jay1hZ2VudGNvcmUvcnVudGltZXMvJHtydW50aW1lLmFnZW50UnVudGltZUlkfS0ke2VuZHBvaW50TmFtZX1gO1xuICAgIGNvbnN0IHNlcnZpY2VOYW1lID0gYCR7cnVudGltZS5hZ2VudFJ1bnRpbWVOYW1lfS4ke2VuZHBvaW50TmFtZX1gO1xuXG4gICAgcmV0dXJuIG5ldyBEYXRhU291cmNlQ29uZmlnKHtcbiAgICAgIGxvZ0dyb3VwTmFtZXM6IFtsb2dHcm91cE5hbWVdLFxuICAgICAgc2VydmljZU5hbWVzOiBbc2VydmljZU5hbWVdLFxuICAgIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIFRoZSBDbG91ZFdhdGNoIExvZ3MgY29uZmlndXJhdGlvbi5cbiAgICovXG4gIHB1YmxpYyByZWFkb25seSBjbG91ZFdhdGNoTG9nc0NvbmZpZzogQ2xvdWRXYXRjaExvZ3NEYXRhU291cmNlQ29uZmlnO1xuXG4gIHByaXZhdGUgY29uc3RydWN0b3IoY29uZmlnOiBDbG91ZFdhdGNoTG9nc0RhdGFTb3VyY2VDb25maWcpIHtcbiAgICB0aGlzLmNsb3VkV2F0Y2hMb2dzQ29uZmlnID0gY29uZmlnO1xuICB9XG5cbiAgLyoqXG4gICAqIEJpbmRzIHRoZSBkYXRhIHNvdXJjZSBjb25maWd1cmF0aW9uIHRvIHByb2R1Y2UgdGhlIEwxIHByb3BlcnR5LlxuICAgKi9cbiAgcHVibGljIGJpbmQoKTogRGF0YVNvdXJjZUNvbmZpZ0JpbmRSZXN1bHQge1xuICAgIHJldHVybiB7XG4gICAgICBjbG91ZFdhdGNoTG9nczoge1xuICAgICAgICBsb2dHcm91cE5hbWVzOiB0aGlzLmNsb3VkV2F0Y2hMb2dzQ29uZmlnLmxvZ0dyb3VwTmFtZXMsXG4gICAgICAgIHNlcnZpY2VOYW1lczogdGhpcy5jbG91ZFdhdGNoTG9nc0NvbmZpZy5zZXJ2aWNlTmFtZXMsXG4gICAgICB9LFxuICAgIH07XG4gIH1cbn1cbiJdfQ==

package/lib/evaluation/evaluator-base.d.ts

@@ -0,0 +1,82 @@
+/**
+ *  Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
+ *  with the License. A copy of the License is located at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
+ *  OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
+ *  and limitations under the License.
+ */
+import { Resource, type IResource, type ResourceProps } from 'aws-cdk-lib';
+import type { IEvaluatorRef, EvaluatorReference as L1EvaluatorReference } from 'aws-cdk-lib/aws-bedrockagentcore';
+import * as iam from 'aws-cdk-lib/aws-iam';
+import type { Construct } from 'constructs';
+/**
+ * Interface for Evaluator resources.
+ */
+export interface IEvaluator extends IResource, IEvaluatorRef {
+    /**
+     * The ARN of the evaluator.
+     * @attribute
+     */
+    readonly evaluatorArn: string;
+    /**
+     * The unique identifier of the evaluator.
+     * @attribute
+     */
+    readonly evaluatorId: string;
+    /**
+     * The name of the evaluator.
+     * @attribute
+     */
+    readonly evaluatorName: string;
+    /**
+     * The lifecycle status of the evaluator (CREATING, ACTIVE, FAILED, DELETING).
+     * @attribute
+     */
+    readonly status?: string;
+    /**
+     * The timestamp when the evaluator was created.
+     * @attribute
+     */
+    readonly createdAt?: string;
+    /**
+     * The timestamp when the evaluator was last updated.
+     * @attribute
+     */
+    readonly updatedAt?: string;
+    /**
+     * Grant the given principal identity permissions to perform actions on this evaluator.
+     */
+    grant(grantee: iam.IGrantable, ...actions: string[]): iam.Grant;
+}
+/**
+ * Abstract base class for Evaluator.
+ * Contains methods and attributes valid for evaluators either created with CDK or imported.
+ */
+export declare abstract class EvaluatorBase extends Resource implements IEvaluator {
+    abstract readonly evaluatorArn: string;
+    abstract readonly evaluatorId: string;
+    abstract readonly evaluatorName: string;
+    abstract readonly status?: string;
+    abstract readonly createdAt?: string;
+    abstract readonly updatedAt?: string;
+    constructor(scope: Construct, id: string, props?: ResourceProps);
+    /**
+     * A reference to this Evaluator resource.
+     */
+    get evaluatorRef(): L1EvaluatorReference;
+    /**
+     * Grants IAM actions to the IAM Principal.
+     *
+     * [disable-awslint:no-grants]
+     *
+     * @param grantee - The IAM principal to grant permissions to
+     * @param actions - The actions to grant
+     * @returns An IAM Grant object representing the granted permissions
+     */
+    grant(grantee: iam.IGrantable, ...actions: string[]): iam.Grant;
+}