@memberjunction/core-entities 2.81.0 → 2.83.0

package/dist/generated/entity_subclasses.js

@@ -1220,6 +1220,11 @@ if this limit is exceeded.`),
     *   * Fail
     *   * Warn
         * * Description: Determines how to handle StartingPayloadValidation failures. Fail = reject invalid input, Warn = log warning but proceed.`),
+    DefaultPromptEffortLevel: zod_1.z.number().nullable().describe(`
+        * * Field Name: DefaultPromptEffortLevel
+        * * Display Name: Default Prompt Effort Level
+        * * SQL Data Type: int
+        * * Description: Default effort level for all prompts executed by this agent (1-100, where 1=minimal effort, 100=maximum effort). Takes precedence over individual prompt EffortLevel settings but can be overridden by runtime parameters. Inherited by sub-agents unless explicitly overridden.`),
     Parent: zod_1.z.string().nullable().describe(`
         * * Field Name: Parent
         * * Display Name: Parent
@@ -1805,6 +1810,11 @@ exports.AIPromptSchema = zod_1.z.object({
         * * SQL Data Type: nvarchar(50)
         * * Default Value: All
         * * Description: Types of errors that should trigger failover. Options: All, NetworkOnly, RateLimitOnly, ServiceErrorOnly`),
+    EffortLevel: zod_1.z.number().nullable().describe(`
+        * * Field Name: EffortLevel
+        * * Display Name: Effort Level
+        * * SQL Data Type: int
+        * * Description: Effort level for this specific prompt (1-100, where 1=minimal effort, 100=maximum effort). Higher values request more thorough reasoning and analysis. Can be overridden by agent DefaultPromptEffortLevel or runtime parameters.`),
     Template: zod_1.z.string().describe(`
         * * Field Name: Template
         * * Display Name: Template
@@ -7593,6 +7603,11 @@ each time the agent processes a prompt step.`),
         * * SQL Data Type: bit
         * * Default Value: 0
         * * Description: Indicates whether verbose logging was enabled during this agent execution. When true, detailed decision-making and execution flow was logged.`),
+    EffortLevel: zod_1.z.number().nullable().describe(`
+        * * Field Name: EffortLevel
+        * * Display Name: Effort Level
+        * * SQL Data Type: int
+        * * Description: Effort level that was actually used during this agent run execution (1-100, where 1=minimal effort, 100=maximum effort). This is the resolved effort level after applying the precedence hierarchy: runtime override > agent default > prompt defaults.`),
     Agent: zod_1.z.string().nullable().describe(`
         * * Field Name: Agent
         * * Display Name: Agent
@@ -8848,6 +8863,11 @@ exports.AIPromptRunSchema = zod_1.z.object({
         * * Display Name: Model Specific Response Details
         * * SQL Data Type: nvarchar(MAX)
         * * Description: JSON field containing provider-specific response metadata and details not captured in standard fields. Structure varies by AI provider.`),
+    EffortLevel: zod_1.z.number().nullable().describe(`
+        * * Field Name: EffortLevel
+        * * Display Name: Effort Level
+        * * SQL Data Type: int
+        * * Description: Effort level that was actually used during this prompt run execution (1-100, where 1=minimal effort, 100=maximum effort). This is the resolved effort level after applying the precedence hierarchy: runtime override > agent default > prompt default > provider default.`),
     Prompt: zod_1.z.string().describe(`
         * * Field Name: Prompt
         * * Display Name: Prompt
@@ -15451,6 +15471,7 @@ let AIAgentEntity = class AIAgentEntity extends core_1.BaseEntity {
     }
     /**
     * Validate() method override for AI Agents entity. This is an auto-generated method that invokes the generated validators for this entity for the following fields:
+    * * DefaultPromptEffortLevel: This rule ensures that the DefaultPromptEffortLevel must always be a value between 1 and 100, inclusive.
     * * MaxExecutionsPerRun: This rule ensures that the maximum number of executions per run can either be left blank (unspecified) or, if provided, it must be a positive number greater than zero.
     * * MinExecutionsPerRun: This rule ensures that if the minimum executions per run value is provided, it must be zero or greater.
     * * Table-Level: This rule ensures that if context compression is enabled, all related settings (message threshold, prompt ID, and message retention count) must be specified. If context compression is not enabled, these settings may be left unspecified.
@@ -15462,6 +15483,7 @@ let AIAgentEntity = class AIAgentEntity extends core_1.BaseEntity {
     */
     Validate() {
         const result = super.Validate();
+        this.ValidateDefaultPromptEffortLevelWithinRange(result);
         this.ValidateMaxExecutionsPerRunIsNullOrPositive(result);
         this.ValidateMinExecutionsPerRunIsNonNegative(result);
         this.ValidateEnableContextCompressionRequiresContextFields(result);
@@ -15470,6 +15492,17 @@ let AIAgentEntity = class AIAgentEntity extends core_1.BaseEntity {
         return result;
     }
     /**
+    * This rule ensures that the DefaultPromptEffortLevel must always be a value between 1 and 100, inclusive.
+    * @param result - the ValidationResult object to add any errors or warnings to
+    * @public
+    * @method
+    */
+    ValidateDefaultPromptEffortLevelWithinRange(result) {
+        if (this.DefaultPromptEffortLevel < 1 || this.DefaultPromptEffortLevel > 100) {
+            result.Errors.push(new core_1.ValidationErrorInfo("DefaultPromptEffortLevel", "DefaultPromptEffortLevel must be between 1 and 100.", this.DefaultPromptEffortLevel, core_1.ValidationErrorType.Failure));
+        }
+    }
+    /**
     * This rule ensures that the maximum number of executions per run can either be left blank (unspecified) or, if provided, it must be a positive number greater than zero.
     * @param result - the ValidationResult object to add any errors or warnings to
     * @public
@@ -15984,6 +16017,18 @@ if this limit is exceeded.
         this.Set('StartingPayloadValidationMode', value);
     }
     /**
+    * * Field Name: DefaultPromptEffortLevel
+    * * Display Name: Default Prompt Effort Level
+    * * SQL Data Type: int
+    * * Description: Default effort level for all prompts executed by this agent (1-100, where 1=minimal effort, 100=maximum effort). Takes precedence over individual prompt EffortLevel settings but can be overridden by runtime parameters. Inherited by sub-agents unless explicitly overridden.
+    */
+    get DefaultPromptEffortLevel() {
+        return this.Get('DefaultPromptEffortLevel');
+    }
+    set DefaultPromptEffortLevel(value) {
+        this.Set('DefaultPromptEffortLevel', value);
+    }
+    /**
     * * Field Name: Parent
     * * Display Name: Parent
     * * SQL Data Type: nvarchar(255)
@@ -16711,6 +16756,7 @@ let AIPromptEntity = class AIPromptEntity extends core_1.BaseEntity {
     * Validate() method override for AI Prompts entity. This is an auto-generated method that invokes the generated validators for this entity for the following fields:
     * * CacheSimilarityThreshold: This rule ensures that if a cache similarity threshold is provided, it must be a value between 0 and 1, inclusive. If no value is provided, that's also allowed.
     * * CacheTTLSeconds: This rule ensures that if the cache expiration time in seconds is provided, it must be greater than zero.
+    * * EffortLevel: This rule ensures that the EffortLevel must be a value between 1 and 100, inclusive.
     * * FailoverErrorScope: This rule ensures that the FailoverErrorScope field can only be set to 'ServiceErrorOnly', 'RateLimitOnly', 'NetworkOnly', 'All', or left empty.
     * * FailoverModelStrategy: This rule ensures that the value for FailoverModelStrategy is either 'RequireSameModel', 'PreferDifferentModel', 'PreferSameModel', or left blank (not set). Any other value is not allowed.
     * * FailoverStrategy: This rule ensures that the FailoverStrategy field, if specified, must be either 'None', 'PowerRank', 'NextBestModel', 'SameModelDifferentVendor', or left blank (unset).
@@ -16727,6 +16773,7 @@ let AIPromptEntity = class AIPromptEntity extends core_1.BaseEntity {
         const result = super.Validate();
         this.ValidateCacheSimilarityThresholdIsBetweenZeroAndOne(result);
         this.ValidateCacheTTLSecondsGreaterThanZero(result);
+        this.ValidateEffortLevelIsWithinRange(result);
         this.ValidateFailoverErrorScopeAgainstAllowedValues(result);
         this.ValidateFailoverModelStrategyAgainstAllowedValues(result);
         this.ValidateFailoverStrategyAllowedValues(result);
@@ -16760,6 +16807,17 @@ let AIPromptEntity = class AIPromptEntity extends core_1.BaseEntity {
         }
     }
     /**
+    * This rule ensures that the EffortLevel must be a value between 1 and 100, inclusive.
+    * @param result - the ValidationResult object to add any errors or warnings to
+    * @public
+    * @method
+    */
+    ValidateEffortLevelIsWithinRange(result) {
+        if (this.EffortLevel < 1 || this.EffortLevel > 100) {
+            result.Errors.push(new core_1.ValidationErrorInfo("EffortLevel", "EffortLevel must be between 1 and 100.", this.EffortLevel, core_1.ValidationErrorType.Failure));
+        }
+    }
+    /**
     * This rule ensures that the FailoverErrorScope field can only be set to 'ServiceErrorOnly', 'RateLimitOnly', 'NetworkOnly', 'All', or left empty.
     * @param result - the ValidationResult object to add any errors or warnings to
     * @public
@@ -17539,6 +17597,18 @@ let AIPromptEntity = class AIPromptEntity extends core_1.BaseEntity {
         this.Set('FailoverErrorScope', value);
     }
     /**
+    * * Field Name: EffortLevel
+    * * Display Name: Effort Level
+    * * SQL Data Type: int
+    * * Description: Effort level for this specific prompt (1-100, where 1=minimal effort, 100=maximum effort). Higher values request more thorough reasoning and analysis. Can be overridden by agent DefaultPromptEffortLevel or runtime parameters.
+    */
+    get EffortLevel() {
+        return this.Get('EffortLevel');
+    }
+    set EffortLevel(value) {
+        this.Set('EffortLevel', value);
+    }
+    /**
     * * Field Name: Template
     * * Display Name: Template
     * * SQL Data Type: nvarchar(255)
@@ -31643,6 +31713,29 @@ let AIAgentRunEntity = class AIAgentRunEntity extends core_1.BaseEntity {
         return await super.InnerLoad(compositeKey, EntityRelationshipsToLoad);
     }
     /**
+    * Validate() method override for MJ: AI Agent Runs entity. This is an auto-generated method that invokes the generated validators for this entity for the following fields:
+    * * EffortLevel: This rule ensures that the EffortLevel must be a value between 1 and 100, inclusive.
+    * @public
+    * @method
+    * @override
+    */
+    Validate() {
+        const result = super.Validate();
+        this.ValidateEffortLevelWithinAllowedRange(result);
+        return result;
+    }
+    /**
+    * This rule ensures that the EffortLevel must be a value between 1 and 100, inclusive.
+    * @param result - the ValidationResult object to add any errors or warnings to
+    * @public
+    * @method
+    */
+    ValidateEffortLevelWithinAllowedRange(result) {
+        if (this.EffortLevel < 1 || this.EffortLevel > 100) {
+            result.Errors.push(new core_1.ValidationErrorInfo("EffortLevel", "EffortLevel must be between 1 and 100.", this.EffortLevel, core_1.ValidationErrorType.Failure));
+        }
+    }
+    /**
     * * Field Name: ID
     * * Display Name: ID
     * * SQL Data Type: uniqueidentifier
@@ -32107,6 +32200,18 @@ each time the agent processes a prompt step.
         this.Set('Verbose', value);
     }
     /**
+    * * Field Name: EffortLevel
+    * * Display Name: Effort Level
+    * * SQL Data Type: int
+    * * Description: Effort level that was actually used during this agent run execution (1-100, where 1=minimal effort, 100=maximum effort). This is the resolved effort level after applying the precedence hierarchy: runtime override > agent default > prompt defaults.
+    */
+    get EffortLevel() {
+        return this.Get('EffortLevel');
+    }
+    set EffortLevel(value) {
+        this.Set('EffortLevel', value);
+    }
+    /**
     * * Field Name: Agent
     * * Display Name: Agent
     * * SQL Data Type: nvarchar(255)
@@ -34384,6 +34489,7 @@ let AIPromptRunEntity = class AIPromptRunEntity extends core_1.BaseEntity {
     }
     /**
     * Validate() method override for MJ: AI Prompt Runs entity. This is an auto-generated method that invokes the generated validators for this entity for the following fields:
+    * * EffortLevel: This rule ensures that the effort level must be a number between 1 and 100, inclusive.
     * * Table-Level: This rule ensures that if the 'CompletedAt' field has a value, it must be on or after the 'RunAt' field. Otherwise, if 'CompletedAt' is empty, there is no restriction.
     * * Table-Level: This rule ensures that either both TokensPrompt and TokensCompletion are missing, or TokensUsed is missing, or, if all values are present, the value of TokensUsed equals the sum of TokensPrompt and TokensCompletion.
     * @public
@@ -34392,11 +34498,23 @@ let AIPromptRunEntity = class AIPromptRunEntity extends core_1.BaseEntity {
     */
     Validate() {
         const result = super.Validate();
+        this.ValidateEffortLevelWithinRange(result);
         this.ValidateCompletedAtIsNullOrAfterRunAt(result);
         this.ValidateTokensUsedSumMatchesPromptAndCompletion(result);
         return result;
     }
     /**
+    * This rule ensures that the effort level must be a number between 1 and 100, inclusive.
+    * @param result - the ValidationResult object to add any errors or warnings to
+    * @public
+    * @method
+    */
+    ValidateEffortLevelWithinRange(result) {
+        if (this.EffortLevel < 1 || this.EffortLevel > 100) {
+            result.Errors.push(new core_1.ValidationErrorInfo("EffortLevel", "EffortLevel must be between 1 and 100.", this.EffortLevel, core_1.ValidationErrorType.Failure));
+        }
+    }
+    /**
     * This rule ensures that if the 'CompletedAt' field has a value, it must be on or after the 'RunAt' field. Otherwise, if 'CompletedAt' is empty, there is no restriction.
     * @param result - the ValidationResult object to add any errors or warnings to
     * @public
@@ -35413,6 +35531,18 @@ let AIPromptRunEntity = class AIPromptRunEntity extends core_1.BaseEntity {
         this.Set('ModelSpecificResponseDetails', value);
     }
     /**
+    * * Field Name: EffortLevel
+    * * Display Name: Effort Level
+    * * SQL Data Type: int
+    * * Description: Effort level that was actually used during this prompt run execution (1-100, where 1=minimal effort, 100=maximum effort). This is the resolved effort level after applying the precedence hierarchy: runtime override > agent default > prompt default > provider default.
+    */
+    get EffortLevel() {
+        return this.Get('EffortLevel');
+    }
+    set EffortLevel(value) {
+        this.Set('EffortLevel', value);
+    }
+    /**
     * * Field Name: Prompt
     * * Display Name: Prompt
     * * SQL Data Type: nvarchar(255)