@memberjunction/server 2.67.0 → 2.69.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/server",
-  "version": "2.67.0",
+  "version": "2.69.0",
   "description": "MemberJunction: This project provides API access via GraphQL to the common data store.",
   "main": "./dist/index.js",
   "types": "./src/index.ts",
@@ -22,39 +22,39 @@
   "dependencies": {
     "@apollo/server": "^4.9.1",
     "@graphql-tools/utils": "^10.0.1",
-    "@memberjunction/actions": "2.67.0",
-    "@memberjunction/ai": "2.67.0",
-    "@memberjunction/ai-core-plus": "2.67.0",
-    "@memberjunction/ai-agents": "2.67.0",
-    "@memberjunction/aiengine": "2.67.0",
-    "@memberjunction/ai-prompts": "2.67.0",
-    "@memberjunction/ai-agent-manager-actions": "2.67.0",
-    "@memberjunction/ai-mistral": "2.67.0",
-    "@memberjunction/ai-openai": "2.67.0",
-    "@memberjunction/ai-anthropic": "2.67.0",
-    "@memberjunction/ai-groq": "2.67.0",
-    "@memberjunction/ai-cerebras": "2.67.0",
-    "@memberjunction/ai-vectors-pinecone": "2.67.0",
-    "@memberjunction/core": "2.67.0",
-    "@memberjunction/core-actions": "2.67.0",
-    "@memberjunction/actions-bizapps-accounting": "2.67.0",
-    "@memberjunction/actions-bizapps-crm": "2.67.0",
-    "@memberjunction/actions-bizapps-lms": "2.67.0",
-    "@memberjunction/actions-bizapps-social": "2.67.0",
-    "@memberjunction/core-entities": "2.67.0",
-    "@memberjunction/core-entities-server": "2.67.0",
-    "@memberjunction/data-context": "2.67.0",
-    "@memberjunction/data-context-server": "2.67.0",
-    "@memberjunction/doc-utils": "2.67.0",
-    "@memberjunction/entity-communications-server": "2.67.0",
-    "@memberjunction/external-change-detection": "2.67.0",
-    "@memberjunction/global": "2.67.0",
-    "@memberjunction/graphql-dataprovider": "2.67.0",
-    "@memberjunction/queue": "2.67.0",
-    "@memberjunction/skip-types": "2.67.0",
-    "@memberjunction/sqlserver-dataprovider": "2.67.0",
-    "@memberjunction/storage": "2.67.0",
-    "@memberjunction/templates": "2.67.0",
+    "@memberjunction/actions": "2.69.0",
+    "@memberjunction/ai": "2.69.0",
+    "@memberjunction/ai-core-plus": "2.69.0",
+    "@memberjunction/ai-agents": "2.69.0",
+    "@memberjunction/aiengine": "2.69.0",
+    "@memberjunction/ai-prompts": "2.69.0",
+    "@memberjunction/ai-agent-manager-actions": "2.69.0",
+    "@memberjunction/ai-mistral": "2.69.0",
+    "@memberjunction/ai-openai": "2.69.0",
+    "@memberjunction/ai-anthropic": "2.69.0",
+    "@memberjunction/ai-groq": "2.69.0",
+    "@memberjunction/ai-cerebras": "2.69.0",
+    "@memberjunction/ai-vectors-pinecone": "2.69.0",
+    "@memberjunction/core": "2.69.0",
+    "@memberjunction/core-actions": "2.69.0",
+    "@memberjunction/actions-bizapps-accounting": "2.69.0",
+    "@memberjunction/actions-bizapps-crm": "2.69.0",
+    "@memberjunction/actions-bizapps-lms": "2.69.0",
+    "@memberjunction/actions-bizapps-social": "2.69.0",
+    "@memberjunction/core-entities": "2.69.0",
+    "@memberjunction/core-entities-server": "2.69.0",
+    "@memberjunction/data-context": "2.69.0",
+    "@memberjunction/data-context-server": "2.69.0",
+    "@memberjunction/doc-utils": "2.69.0",
+    "@memberjunction/entity-communications-server": "2.69.0",
+    "@memberjunction/external-change-detection": "2.69.0",
+    "@memberjunction/global": "2.69.0",
+    "@memberjunction/graphql-dataprovider": "2.69.0",
+    "@memberjunction/queue": "2.69.0",
+    "@memberjunction/skip-types": "2.69.0",
+    "@memberjunction/sqlserver-dataprovider": "2.69.0",
+    "@memberjunction/storage": "2.69.0",
+    "@memberjunction/templates": "2.69.0",
     "@types/compression": "^1.7.5",
     "@types/cors": "^2.8.13",
     "@types/jsonwebtoken": "9.0.6",

package/src/generated/generated.ts

@@ -1318,6 +1318,10 @@ export class AIAgentRun_ {
     @Field({nullable: true, description: `The initial payload provided at the start of this run. Can be populated from the FinalPayload of the LastRun.`}) 
     StartingPayload?: string;
         
+    @Field(() => Int, {description: `Total number of prompt iterations executed during this agent run. Incremented
+  each time the agent processes a prompt step.`}) 
+    TotalPromptIterations: number;
+        
     @Field({nullable: true}) 
     @MaxLength(510)
     Agent?: string;
@@ -1429,6 +1433,9 @@ export class CreateAIAgentRunInput {
 
     @Field({ nullable: true })
     StartingPayload: string | null;
+
+    @Field(() => Int, { nullable: true })
+    TotalPromptIterations?: number;
 }
     
 
@@ -1521,6 +1528,9 @@ export class UpdateAIAgentRunInput {
     @Field({ nullable: true })
     StartingPayload?: string | null;
 
+    @Field(() => Int, { nullable: true })
+    TotalPromptIterations?: number;
+
     @Field(() => [KeyValuePairInput], { nullable: true })
     OldValues___?: KeyValuePairInput[];
 }
@@ -2204,14 +2214,50 @@ export class AIAgent_ {
     @Field({description: `JSON array of paths that define which parts of the payload sub-agents are allowed to write back upstream. Use ["*"] to allow all writes, or specify paths like ["analysis.results", "recommendations.*"]`}) 
     PayloadUpstreamPaths: string;
         
-    @Field({nullable: true, description: `JSON array of paths that specify what parts of the payload the agent's own prompt can read. Controls downstream data 
+    @Field({nullable: true, description: `JSON array of paths that specify what parts of the payload the agent's own prompt can read. Controls downstream data 
 flow when the agent executes its own prompt step.`}) 
     PayloadSelfReadPaths?: string;
         
-    @Field({nullable: true, description: `JSON array of paths that specify what parts of the payload the agent's own prompt can write back. Controls upstream 
+    @Field({nullable: true, description: `JSON array of paths that specify what parts of the payload the agent's own prompt can write back. Controls upstream 
 data flow when the agent executes its own prompt step.`}) 
     PayloadSelfWritePaths?: string;
         
+    @Field({nullable: true, description: `Defines the scope/path within the parent payload that this sub-agent operates on. When set, the sub-agent receives only this portion of the payload and all change requests are relative to this scope. Format: /path/to/scope (e.g. /PropA/SubProp1)`}) 
+    PayloadScope?: string;
+        
+    @Field({nullable: true, description: `Optional JSON schema or requirements that define the expected structure and content of the agent's final payload. Used to validate the output when the agent declares success. Similar to OutputExample in AI Prompts.`}) 
+    FinalPayloadValidation?: string;
+        
+    @Field({description: `Determines how to handle validation failures when FinalPayloadValidation is specified. Options: Retry (default) - retry the agent with validation feedback, Fail - fail the agent run immediately, Warn - log a warning but allow success.`}) 
+    @MaxLength(50)
+    FinalPayloadValidationMode: string;
+        
+    @Field(() => Int, {description: `Maximum number of retry attempts allowed when FinalPayloadValidation fails with
+Retry mode. After reaching this limit, the validation will fail permanently.`}) 
+    FinalPayloadValidationMaxRetries: number;
+        
+    @Field(() => Float, {nullable: true, description: `Maximum cost in dollars allowed for a single agent run. Run will be terminated
+  if this limit is exceeded.`}) 
+    MaxCostPerRun?: number;
+        
+    @Field(() => Int, {nullable: true, description: `Maximum total tokens (input + output) allowed for a single agent run. Run will
+  be terminated if this limit is exceeded.`}) 
+    MaxTokensPerRun?: number;
+        
+    @Field(() => Int, {nullable: true, description: `Maximum number of prompt iterations allowed for a single agent run. Run will be
+   terminated if this limit is exceeded.`}) 
+    MaxIterationsPerRun?: number;
+        
+    @Field(() => Int, {nullable: true, description: `Maximum time in seconds allowed for a single agent run. Run will be terminated
+  if this limit is exceeded.`}) 
+    MaxTimePerRun?: number;
+        
+    @Field(() => Int, {nullable: true, description: `When acting as a sub-agent, minimum number of times this agent must be executed per parent agent run`}) 
+    MinExecutionsPerRun?: number;
+        
+    @Field(() => Int, {nullable: true, description: `When acting as a sub-agent, maximum number of times this agent can be executed per parent agent run`}) 
+    MaxExecutionsPerRun?: number;
+        
     @Field({nullable: true}) 
     @MaxLength(510)
     Parent?: string;
@@ -2323,6 +2369,36 @@ export class CreateAIAgentInput {
 
     @Field({ nullable: true })
     PayloadSelfWritePaths: string | null;
+
+    @Field({ nullable: true })
+    PayloadScope: string | null;
+
+    @Field({ nullable: true })
+    FinalPayloadValidation: string | null;
+
+    @Field({ nullable: true })
+    FinalPayloadValidationMode?: string;
+
+    @Field(() => Int, { nullable: true })
+    FinalPayloadValidationMaxRetries?: number;
+
+    @Field(() => Float, { nullable: true })
+    MaxCostPerRun: number | null;
+
+    @Field(() => Int, { nullable: true })
+    MaxTokensPerRun: number | null;
+
+    @Field(() => Int, { nullable: true })
+    MaxIterationsPerRun: number | null;
+
+    @Field(() => Int, { nullable: true })
+    MaxTimePerRun: number | null;
+
+    @Field(() => Int, { nullable: true })
+    MinExecutionsPerRun: number | null;
+
+    @Field(() => Int, { nullable: true })
+    MaxExecutionsPerRun: number | null;
 }
     
 
@@ -2394,6 +2470,36 @@ export class UpdateAIAgentInput {
     @Field({ nullable: true })
     PayloadSelfWritePaths?: string | null;
 
+    @Field({ nullable: true })
+    PayloadScope?: string | null;
+
+    @Field({ nullable: true })
+    FinalPayloadValidation?: string | null;
+
+    @Field({ nullable: true })
+    FinalPayloadValidationMode?: string;
+
+    @Field(() => Int, { nullable: true })
+    FinalPayloadValidationMaxRetries?: number;
+
+    @Field(() => Float, { nullable: true })
+    MaxCostPerRun?: number | null;
+
+    @Field(() => Int, { nullable: true })
+    MaxTokensPerRun?: number | null;
+
+    @Field(() => Int, { nullable: true })
+    MaxIterationsPerRun?: number | null;
+
+    @Field(() => Int, { nullable: true })
+    MaxTimePerRun?: number | null;
+
+    @Field(() => Int, { nullable: true })
+    MinExecutionsPerRun?: number | null;
+
+    @Field(() => Int, { nullable: true })
+    MaxExecutionsPerRun?: number | null;
+
     @Field(() => [KeyValuePairInput], { nullable: true })
     OldValues___?: KeyValuePairInput[];
 }
@@ -3512,6 +3618,12 @@ export class AIAgentAction_ {
     @MaxLength(10)
     _mj__UpdatedAt: Date;
         
+    @Field(() => Int, {nullable: true, description: `Minimum number of times this action must be executed per agent run`}) 
+    MinExecutionsPerRun?: number;
+        
+    @Field(() => Int, {nullable: true, description: `Maximum number of times this action can be executed per agent run`}) 
+    MaxExecutionsPerRun?: number;
+        
     @Field({nullable: true}) 
     @MaxLength(510)
     Agent?: string;
@@ -3538,6 +3650,12 @@ export class CreateAIAgentActionInput {
 
     @Field({ nullable: true })
     Status?: string;
+
+    @Field(() => Int, { nullable: true })
+    MinExecutionsPerRun: number | null;
+
+    @Field(() => Int, { nullable: true })
+    MaxExecutionsPerRun: number | null;
 }
     
 
@@ -3558,6 +3676,12 @@ export class UpdateAIAgentActionInput {
     @Field({ nullable: true })
     Status?: string;
 
+    @Field(() => Int, { nullable: true })
+    MinExecutionsPerRun?: number | null;
+
+    @Field(() => Int, { nullable: true })
+    MaxExecutionsPerRun?: number | null;
+
     @Field(() => [KeyValuePairInput], { nullable: true })
     OldValues___?: KeyValuePairInput[];
 }
@@ -3969,16 +4093,16 @@ export class AIPrompt_ {
     @Field(() => Int, {nullable: true, description: `Default number of top log probabilities to include when IncludeLogProbs is true. Can be overridden at runtime.`}) 
     TopLogProbs?: number;
         
+    @Field({description: `Failover strategy to use when the primary model fails. Options: SameModelDifferentVendor, NextBestModel, PowerRank, None`}) 
+    @MaxLength(100)
+    FailoverStrategy: string;
+        
     @Field(() => Int, {nullable: true, description: `Maximum number of failover attempts before giving up`}) 
     FailoverMaxAttempts?: number;
         
     @Field(() => Int, {nullable: true, description: `Initial delay in seconds between failover attempts`}) 
     FailoverDelaySeconds?: number;
         
-    @Field({description: `Failover strategy to use when the primary model fails. Options: SameModelDifferentVendor, NextBestModel, PowerRank, None`}) 
-    @MaxLength(100)
-    FailoverStrategy: string;
-        
     @Field({description: `Strategy for selecting failover models. Options: PreferSameModel, PreferDifferentModel, RequireSameModel`}) 
     @MaxLength(100)
     FailoverModelStrategy: string;
@@ -4170,15 +4294,15 @@ export class CreateAIPromptInput {
     @Field(() => Int, { nullable: true })
     TopLogProbs: number | null;
 
+    @Field({ nullable: true })
+    FailoverStrategy?: string;
+
     @Field(() => Int, { nullable: true })
     FailoverMaxAttempts?: number | null;
 
     @Field(() => Int, { nullable: true })
     FailoverDelaySeconds?: number | null;
 
-    @Field({ nullable: true })
-    FailoverStrategy?: string;
-
     @Field({ nullable: true })
     FailoverModelStrategy?: string;
 
@@ -4321,15 +4445,15 @@ export class UpdateAIPromptInput {
     @Field(() => Int, { nullable: true })
     TopLogProbs?: number | null;
 
+    @Field({ nullable: true })
+    FailoverStrategy?: string;
+
     @Field(() => Int, { nullable: true })
     FailoverMaxAttempts?: number | null;
 
     @Field(() => Int, { nullable: true })
     FailoverDelaySeconds?: number | null;
 
-    @Field({ nullable: true })
-    FailoverStrategy?: string;
-
     @Field({ nullable: true })
     FailoverModelStrategy?: string;
 
@@ -39577,6 +39701,10 @@ export class AIPromptRun_ {
     @Field({nullable: true, description: `JSON array of duration in milliseconds for each failover attempt`}) 
     FailoverDurations?: string;
         
+    @Field({nullable: true, description: `The AI Model ID that was originally attempted before any failovers`}) 
+    @MaxLength(16)
+    OriginalModelID?: string;
+        
     @Field({nullable: true, description: `Timestamp when the original request started, before any failovers`}) 
     @MaxLength(8)
     OriginalRequestStartTime?: Date;
@@ -39584,10 +39712,6 @@ export class AIPromptRun_ {
     @Field(() => Int, {nullable: true, description: `Total time spent in failover attempts in milliseconds`}) 
     TotalFailoverDuration?: number;
         
-    @Field({nullable: true, description: `The AI Model ID that was originally attempted before any failovers`}) 
-    @MaxLength(16)
-    OriginalModelID?: string;
-        
     @Field() 
     @MaxLength(510)
     Prompt: string;
@@ -39790,14 +39914,14 @@ export class CreateAIPromptRunInput {
     @Field({ nullable: true })
     FailoverDurations: string | null;
 
+    @Field({ nullable: true })
+    OriginalModelID: string | null;
+
     @Field({ nullable: true })
     OriginalRequestStartTime: Date | null;
 
     @Field(() => Int, { nullable: true })
     TotalFailoverDuration: number | null;
-
-    @Field({ nullable: true })
-    OriginalModelID: string | null;
 }
     
 
@@ -39971,15 +40095,15 @@ export class UpdateAIPromptRunInput {
     @Field({ nullable: true })
     FailoverDurations?: string | null;
 
+    @Field({ nullable: true })
+    OriginalModelID?: string | null;
+
     @Field({ nullable: true })
     OriginalRequestStartTime?: Date | null;
 
     @Field(() => Int, { nullable: true })
     TotalFailoverDuration?: number | null;
 
-    @Field({ nullable: true })
-    OriginalModelID?: string | null;
-
     @Field(() => [KeyValuePairInput], { nullable: true })
     OldValues___?: KeyValuePairInput[];
 }
@@ -40160,6 +40284,16 @@ export class AIAgentRunStep_ {
     @Field({nullable: true, description: `JSON serialization of the Payload state at the end of this step`}) 
     PayloadAtEnd?: string;
         
+    @Field({nullable: true, description: `Result of the final payload validation for this step. Pass indicates successful
+validation, Retry means validation failed but will retry, Fail means validation failed
+permanently, Warn means validation failed but execution continues.`}) 
+    @MaxLength(50)
+    FinalPayloadValidationResult?: string;
+        
+    @Field({nullable: true, description: `Validation error messages or warnings from final payload validation. Contains
+detailed information about what validation rules failed.`}) 
+    FinalPayloadValidationMessages?: string;
+        
 }
 
 //****************************************************************************
@@ -40214,6 +40348,12 @@ export class CreateAIAgentRunStepInput {
 
     @Field({ nullable: true })
     PayloadAtEnd: string | null;
+
+    @Field({ nullable: true })
+    FinalPayloadValidationResult: string | null;
+
+    @Field({ nullable: true })
+    FinalPayloadValidationMessages: string | null;
 }
     
 
@@ -40270,6 +40410,12 @@ export class UpdateAIAgentRunStepInput {
     @Field({ nullable: true })
     PayloadAtEnd?: string | null;
 
+    @Field({ nullable: true })
+    FinalPayloadValidationResult?: string | null;
+
+    @Field({ nullable: true })
+    FinalPayloadValidationMessages?: string | null;
+
     @Field(() => [KeyValuePairInput], { nullable: true })
     OldValues___?: KeyValuePairInput[];
 }

package/src/index.ts

@@ -45,7 +45,7 @@ import { LoadAnthropicLLM } from '@memberjunction/ai-anthropic';
 import { LoadGroqLLM } from '@memberjunction/ai-groq';
 import { LoadCerebrasLLM } from '@memberjunction/ai-cerebras';
 import { LoadMistralLLM } from '@memberjunction/ai-mistral';
-// Load AI LLMs
+// Load AI LLMs and Base AI Engine
 // These imports are necessary to ensure the LLMs are registered in the MemberJunction AI
 // system. They are not tree-shaken because they are dynamically loaded at runtime.
 LoadOpenAILLM();