@memberjunction/ai-agents 2.75.0 → 2.76.0

package/README.md

@@ -35,6 +35,14 @@ Concrete implementation of BaseAgentType that:
 - Parses structured JSON responses from prompts
 - Supports actions, sub-agents, and conditional termination
 
+### FlowAgentType
+Deterministic workflow agent type that:
+- Executes predefined workflows using directed graphs
+- Evaluates boolean conditions to determine paths
+- Supports parallel starting steps (Sequence=0)
+- Provides action output mapping to payload
+- Enables hybrid AI/deterministic workflows
+
 ### AgentRunner
 Simple orchestrator that:
 - Loads agent metadata from database
@@ -109,6 +117,16 @@ Agents are configured through MemberJunction entities:
    - `ExecutionOrder`: Determines prompt execution sequence
    - Links agents to their specific prompts
 
+5. **AIAgentStep**: Defines workflow steps for Flow agents
+   - `StepType`: Action, Sub-Agent, or Prompt
+   - `StartingStep`: Boolean flag for initial steps
+   - `TimeoutSeconds`: Step execution timeout
+   - `ActionOutputMapping`: JSON mapping for action results
+
+6. **AIAgentStepPath**: Connects workflow steps
+   - `Condition`: Boolean expression for path evaluation
+   - `Priority`: Determines path selection order
+
 ## Creating Custom Agent Types
 
 ```typescript
@@ -631,6 +649,134 @@ export class DecisionTreeAgent extends BaseAgentType {
 }
 ```
 
+### Flow Agent Configuration
+
+Flow agents enable deterministic workflow execution through graph-based step definitions:
+
+```typescript
+// Database configuration for a Flow agent workflow
+// AIAgentStep records define the workflow nodes
+const approvalWorkflowSteps = [
+    {
+        Name: 'CheckAmount',
+        StepType: 'Action',
+        ActionID: checkAmountActionId,
+        StartingStep: true,
+        Sequence: 0
+    },
+    {
+        Name: 'AutoApprove',
+        StepType: 'Action',
+        ActionID: approveActionId,
+        ActionOutputMapping: JSON.stringify({
+            'approvalId': 'payload.approval.id',
+            'timestamp': 'payload.approval.approvedAt'
+        })
+    },
+    {
+        Name: 'ManagerReview',
+        StepType: 'Prompt',
+        PromptID: managerReviewPromptId,
+        Description: 'Get manager approval decision'
+    },
+    {
+        Name: 'NotifyRejection',
+        StepType: 'Action',
+        ActionID: sendNotificationActionId
+    }
+];
+
+// AIAgentStepPath records define the workflow edges
+const approvalWorkflowPaths = [
+    {
+        OriginStepID: checkAmountStep.ID,
+        DestinationStepID: autoApproveStep.ID,
+        Condition: 'payload.amount <= 1000',
+        Priority: 10
+    },
+    {
+        OriginStepID: checkAmountStep.ID,
+        DestinationStepID: managerReviewStep.ID,
+        Condition: 'payload.amount > 1000',
+        Priority: 10
+    },
+    {
+        OriginStepID: managerReviewStep.ID,
+        DestinationStepID: autoApproveStep.ID,
+        Condition: 'stepResult.approved === true',
+        Priority: 10
+    },
+    {
+        OriginStepID: managerReviewStep.ID,
+        DestinationStepID: notifyRejectionStep.ID,
+        Condition: 'stepResult.approved === false',
+        Priority: 10
+    }
+];
+```
+
+### Flow Agent Features
+
+#### Safe Expression Evaluation
+Flow agents use the SafeExpressionEvaluator to securely evaluate path conditions without arbitrary code execution:
+
+```typescript
+// Supported operations in conditions:
+// - Comparisons: ==, ===, !=, !==, <, >, <=, >=
+// - Logical: &&, ||, !
+// - Property access: payload.user.role, stepResult.score
+// - Safe methods: .includes(), .length, .some(), .every()
+// - Type checking: typeof
+
+// Example conditions:
+"payload.status == 'approved' && payload.priority > 5"
+"stepResult.items.some(item => item.price > 100)"
+"payload.user.roles.includes('admin') || payload.override === true"
+```
+
+#### Action Output Mapping
+Automatically map action results to the payload:
+
+```typescript
+// In AIAgentStep.ActionOutputMapping
+{
+    "userId": "payload.customer.id",           // Map specific output
+    "orderTotal": "payload.order.total",       // Nested path mapping
+    "*": "payload.actionResults.lastResult"    // Wildcard for entire result
+}
+```
+
+#### Flow Context Tracking
+The framework maintains flow execution state in `__flowContext`:
+
+```typescript
+// Automatically tracked in payload.__flowContext
+{
+    agentId: "flow-agent-id",
+    currentStepId: "current-step-id",
+    completedStepIds: ["step1", "step2"],
+    stepResults: {
+        "step1": { success: true, data: {...} },
+        "step2": { approved: false }
+    },
+    executionPath: ["step1", "step2", "step3"]
+}
+```
+
+#### Prompt Steps for AI Decisions
+Flow agents can incorporate AI decision points:
+
+```typescript
+// Prompt step expects response format:
+{
+    "nextStepName?": "StepToExecute",
+    "reasoning?": "Why this decision was made",
+    "confidence?": 0.95,
+    "terminate?": false,
+    "message?": "Decision explanation"
+}
+```
+
 ## Architecture Documentation
 
 For detailed architecture information, see [agent-architecture.md](./agent-architecture.md).

package/dist/agent-types/base-agent-type.d.ts

@@ -1,10 +1,26 @@
-import { AIPromptParams, AIPromptRunResult, BaseAgentNextStep } from '@memberjunction/ai-core-plus';
+import { AIPromptParams, AIPromptRunResult, BaseAgentNextStep, AgentPayloadChangeRequest, AgentAction, AgentSubAgentRequest, ExecuteAgentParams } from '@memberjunction/ai-core-plus';
 import { AIAgentTypeEntity } from '@memberjunction/core-entities';
+import { JSONValidator } from '@memberjunction/global';
+import { ActionResult } from '@memberjunction/actions-base';
 export declare abstract class BaseAgentType {
-    abstract DetermineNextStep<P = any>(promptResult: AIPromptRunResult, currentPayload: P): Promise<BaseAgentNextStep<P>>;
-    abstract InjectPayload<P = any>(payload: P, prompt: AIPromptParams): Promise<void>;
+    protected _jsonValidator: JSONValidator;
+    static readonly CURRENT_PAYLOAD_PLACEHOLDER = "_CURRENT_PAYLOAD";
+    abstract DetermineNextStep<P = any>(promptResult: AIPromptRunResult | null, params: ExecuteAgentParams<any, P>): Promise<BaseAgentNextStep<P>>;
+    abstract DetermineInitialStep<P = any>(params: ExecuteAgentParams<P>): Promise<BaseAgentNextStep<P> | null>;
+    abstract PreProcessRetryStep<P = any>(params: ExecuteAgentParams<P>, retryStep: BaseAgentNextStep<P>): Promise<BaseAgentNextStep<P> | null>;
+    abstract InjectPayload<P = any>(payload: P, prompt: AIPromptParams, agentInfo: {
+        agentId: string;
+        agentRunId?: string;
+    }): Promise<void>;
     static GetAgentTypeInstance(agentType: AIAgentTypeEntity): Promise<BaseAgentType>;
     protected static getAgentTypeInstance(agentType: AIAgentTypeEntity): Promise<BaseAgentType | null>;
     protected static getAgentInstanceWithDriverClass(driverClass: string): Promise<BaseAgentType | null>;
+    protected parseJSONResponse<T>(promptResult: AIPromptRunResult): T | null;
+    protected createNextStep<P>(step: BaseAgentNextStep['step'], options?: Partial<BaseAgentNextStep<P>>): BaseAgentNextStep<P>;
+    protected createRetryStep<P>(errorMessage: string, options?: Partial<BaseAgentNextStep<P>>): BaseAgentNextStep<P>;
+    protected createSuccessStep<P>(options?: Partial<BaseAgentNextStep<P>>): BaseAgentNextStep<P>;
+    PreProcessActionStep<P>(actions: AgentAction[], currentPayload: P, currentStep: BaseAgentNextStep<P>): Promise<void>;
+    PostProcessActionStep<P>(actionResults: ActionResult[], actions: AgentAction[], currentPayload: P, currentStep: BaseAgentNextStep<P>): Promise<AgentPayloadChangeRequest<P> | null>;
+    PostProcessSubAgentStep<P>(subAgentResult: any, subAgentRequest: AgentSubAgentRequest, currentPayload: P, currentStep: BaseAgentNextStep<P>): Promise<AgentPayloadChangeRequest<P> | null>;
 }
 //# sourceMappingURL=base-agent-type.d.ts.map

package/dist/agent-types/base-agent-type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-agent-type.d.ts","sourceRoot":"","sources":["../../src/agent-types/base-agent-type.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAC,MAAM,8BAA8B,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAsClE,8BAAsB,aAAa;aA4Bf,iBAAiB,CAAC,CAAC,GAAG,GAAG,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;aAc7G,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;WAoBrE,oBAAoB,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;qBA4BvE,oBAAoB,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;qBAsBjF,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CAc7G"}
+{"version":3,"file":"base-agent-type.d.ts","sourceRoot":"","sources":["../../src/agent-types/base-agent-type.ts"],"names":[],"mappings":"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"}

package/dist/agent-types/base-agent-type.js

@@ -4,6 +4,9 @@ exports.BaseAgentType = void 0;
 const global_1 = require("@memberjunction/global");
 const core_1 = require("@memberjunction/core");
 class BaseAgentType {
+    constructor() {
+        this._jsonValidator = new global_1.JSONValidator();
+    }
     static async GetAgentTypeInstance(agentType) {
         try {
             const agentTypeInstance = await this.getAgentTypeInstance(agentType);
@@ -30,6 +33,58 @@ class BaseAgentType {
         }
         return instance;
     }
+    parseJSONResponse(promptResult) {
+        if (!promptResult.success || !promptResult.result) {
+            return null;
+        }
+        try {
+            let response;
+            if (typeof promptResult.result === 'string') {
+                response = JSON.parse(promptResult.result);
+            }
+            else {
+                response = promptResult.result;
+            }
+            response = this._jsonValidator.cleanValidationSyntax(response);
+            if ((0, core_1.IsVerboseLoggingEnabled)()) {
+                console.log(`${this.constructor.name}: Cleaned response from validation syntax`, response);
+            }
+            return response;
+        }
+        catch (error) {
+            (0, core_1.LogError)(`Failed to parse JSON response in ${this.constructor.name}: ${error.message}`);
+            return null;
+        }
+    }
+    createNextStep(step, options = {}) {
+        return {
+            step,
+            terminate: false,
+            ...options
+        };
+    }
+    createRetryStep(errorMessage, options = {}) {
+        return this.createNextStep('Retry', {
+            errorMessage,
+            terminate: false,
+            ...options
+        });
+    }
+    createSuccessStep(options = {}) {
+        return this.createNextStep('Success', {
+            terminate: true,
+            ...options
+        });
+    }
+    async PreProcessActionStep(actions, currentPayload, currentStep) {
+    }
+    async PostProcessActionStep(actionResults, actions, currentPayload, currentStep) {
+        return null;
+    }
+    async PostProcessSubAgentStep(subAgentResult, subAgentRequest, currentPayload, currentStep) {
+        return null;
+    }
 }
 exports.BaseAgentType = BaseAgentType;
+BaseAgentType.CURRENT_PAYLOAD_PLACEHOLDER = '_CURRENT_PAYLOAD';
 //# sourceMappingURL=base-agent-type.js.map

package/dist/agent-types/base-agent-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-agent-type.js","sourceRoot":"","sources":["../../src/agent-types/base-agent-type.ts"],"names":[],"mappings":";;;AAeA,mDAAkD;AAClD,+CAAgD;AAoChD,MAAsB,aAAa;IA8DxB,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,SAA4B;QACjE,IAAI,CAAC;YACD,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;YACrE,OAAO,iBAAiB,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAA,eAAQ,EAAC,KAAK,CAAC,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,yCAAyC,SAAS,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACjG,CAAC;IACL,CAAC;IAoBS,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,SAA4B;QAEpE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,eAAe,SAAS,CAAC,IAAI,+FAA+F,CAAC,CAAC;QAClJ,CAAC;QAGD,OAAO,IAAI,CAAC,+BAA+B,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACvE,CAAC;IAcS,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,WAAmB;QACtE,MAAM,QAAQ,GAAG,iBAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,cAAc,CAAgB,aAAa,EAAE,WAAW,CAAC,CAAC;QAE1G,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,uDAAuD,WAAW,iEAAiE,CAAC,CAAC;QACzJ,CAAC;QAGD,IAAI,QAAQ,CAAC,WAAW,KAAK,aAAa,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,oBAAoB,WAAW,2EAA2E,CAAC,CAAC;QAChI,CAAC;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC;CACJ;AA9HD,sCA8HC"}
+{"version":3,"file":"base-agent-type.js","sourceRoot":"","sources":["../../src/agent-types/base-agent-type.ts"],"names":[],"mappings":"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"}

package/dist/agent-types/flow-agent-type.d.ts

@@ -0,0 +1,38 @@
+import { BaseAgentType } from './base-agent-type';
+import { AIPromptRunResult, BaseAgentNextStep, AIPromptParams, AgentPayloadChangeRequest, AgentAction, ExecuteAgentParams } from '@memberjunction/ai-core-plus';
+import { ActionResult } from '@memberjunction/actions-base';
+export declare class FlowExecutionState {
+    agentId: string;
+    currentStepId?: string;
+    completedStepIds: Set<string>;
+    stepResults: Map<string, unknown>;
+    executionPath: string[];
+    constructor(agentId: string);
+}
+export declare class FlowAgentType extends BaseAgentType {
+    private _evaluator;
+    private static _flowStates;
+    private getOrCreateFlowState;
+    DetermineNextStep<P>(promptResult: AIPromptRunResult | null, params: ExecuteAgentParams<any, P>): Promise<BaseAgentNextStep<P>>;
+    InjectPayload<P = any>(payload: P, prompt: AIPromptParams, agentInfo: {
+        agentId: string;
+        agentRunId?: string;
+    }): Promise<void>;
+    private getStartingSteps;
+    private getStepById;
+    private getStepByName;
+    private getValidPaths;
+    private getLastStepResult;
+    private applyActionOutputMapping;
+    private createStepForFlowNode;
+    private getActionName;
+    private getAgentName;
+    processActionResult<P>(actionResult: Record<string, unknown>, _stepId: string, outputMapping?: string, currentPayload?: P): AgentPayloadChangeRequest<P> | null;
+    PreProcessActionStep<P>(actions: AgentAction[], currentPayload: P, currentStep: BaseAgentNextStep<P>): Promise<void>;
+    private getValueFromPath;
+    PostProcessActionStep<P>(actionResults: ActionResult[], _actions: AgentAction[], currentPayload: P, currentStep: BaseAgentNextStep<P>): Promise<AgentPayloadChangeRequest<P> | null>;
+    DetermineInitialStep<P = any>(params: ExecuteAgentParams<P>): Promise<BaseAgentNextStep<P> | null>;
+    PreProcessRetryStep<P = any>(params: ExecuteAgentParams<P>, retryStep: BaseAgentNextStep<P>): Promise<BaseAgentNextStep<P> | null>;
+}
+export declare function LoadFlowAgentType(): void;
+//# sourceMappingURL=flow-agent-type.d.ts.map

package/dist/agent-types/flow-agent-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-agent-type.d.ts","sourceRoot":"","sources":["../../src/agent-types/flow-agent-type.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,yBAAyB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGhK,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAQ5D,qBAAa,kBAAkB;IAE3B,OAAO,EAAE,MAAM,CAAC;IAGhB,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAa;IAG1C,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAa;IAG9C,aAAa,EAAE,MAAM,EAAE,CAAM;gBAEjB,OAAO,EAAE,MAAM;CAG9B;AAgED,qBACa,aAAc,SAAQ,aAAa;IAC5C,OAAO,CAAC,UAAU,CAAiC;IAMnD,OAAO,CAAC,MAAM,CAAC,WAAW,CAAyC;IAKnE,OAAO,CAAC,oBAAoB;IAwBf,iBAAiB,CAAC,CAAC,EAC5B,YAAY,EAAE,iBAAiB,GAAG,IAAI,EACtC,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,GACnC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IA2GnB,aAAa,CAAC,CAAC,GAAG,GAAG,EAC9B,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACpD,OAAO,CAAC,IAAI,CAAC;YA+BF,gBAAgB;YAUhB,WAAW;YASX,aAAa;YAUb,aAAa;IAuD3B,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,wBAAwB;YAyDlB,qBAAqB;YA+GrB,aAAa;YAUb,YAAY;IAWnB,mBAAmB,CAAC,CAAC,EACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,CAAC,GACnB,yBAAyB,CAAC,CAAC,CAAC,GAAG,IAAI;IAuBzB,oBAAoB,CAAC,CAAC,EAC/B,OAAO,EAAE,WAAW,EAAE,EACtB,cAAc,EAAE,CAAC,EACjB,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC;IA+EhB,OAAO,CAAC,gBAAgB;IA6BX,qBAAqB,CAAC,CAAC,EAChC,aAAa,EAAE,YAAY,EAAE,EAC7B,QAAQ,EAAE,WAAW,EAAE,EACvB,cAAc,EAAE,CAAC,EACjB,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAoDlC,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAgClG,mBAAmB,CAAC,CAAC,GAAG,GAAG,EACpC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC7B,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CA+D1C;AAKD,wBAAgB,iBAAiB,SAEhC"}