@memberjunction/ai-agent-manager 2.103.0 → 2.104.0

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @memberjunction/ai-agent-manager@2.103.0 build
+> @memberjunction/ai-agent-manager@2.104.0 build
 > tsc
 

package/CHANGELOG.md

@@ -1,5 +1,7 @@
 # @memberjunction/ai-agent-manager
 
+## 2.104.0
+
 ## 2.103.0
 
 ### Patch Changes

package/dist/interfaces/agent-definition.interface.d.ts

@@ -15,32 +15,31 @@ export interface AIAgentDefinition {
     description: string;
     readonly type: 'Loop';
     purpose: string;
-    requirements: {
-        businessGoal: string;
-        functionalRequirements: string;
-        technicalRequirements: string;
-        dataRequirements: string;
-        integrationRequirements: string;
-        assumptions: string;
-        risks: string;
-        outOfScope: string;
-    };
-    successCriteria: string;
-    design: {
-        actions: [
-            {
-                id: string;
-                name: string;
-                reason: string;
-            }
-        ];
-        subAgents?: AIAgentDefinition[];
-    };
+    actions: {
+        /** Action ID from the system action library */
+        id: string;
+        /** Human-readable name of the action */
+        name: string;
+        /** Justification for why this action is needed */
+        reason: string;
+    }[];
     prompt: {
-        systemPrompt: string;
-        templateVariables: string;
-        promptNotes: string;
+        /** System prompt for this agent */
+        systemPrompt?: string;
+        /** Template variables documentation */
+        templateVariables?: string;
+        /** Prompt analysis and notes */
+        promptNotes?: string;
     };
+    payloadDownstreamPaths?: string[];
+    payloadUpstreamPaths?: string[];
+    subAgents?: AIAgentDefinition[];
+    executionOrder?: number;
+    exposeAsAction?: boolean;
+    iconClass?: string;
+    finalPayloadValidation?: string;
+    finalPayloadValidationMode?: 'Retry' | 'Fail' | 'Warn';
+    finalPayloadValidationMaxRetries?: number;
 }
 /**
  * Root context for the Agent Manager that tracks the entire creation process
@@ -61,4 +60,99 @@ export interface AIAgentManagerContext {
         report: string;
     };
 }
+/**
+ * Agent Manager Payload Definition
+ * This type defines the structure for data passed between Agent Manager sub-agents
+ */
+export interface AgentManagerPayload {
+    /**
+     * Metadata about the agent creation process
+     */
+    metadata: {
+        /** Unique identifier for this agent creation session */
+        sessionId: string;
+        /** Current status of the agent creation process */
+        status: 'requirements' | 'design' | 'prompting' | 'implementation' | 'validation' | 'complete';
+        /** Original user request for agent creation */
+        originalRequest: string;
+        /** The agent who last modified the payload */
+        lastModifiedBy: string;
+    };
+    /**
+     * Requirements Analyst agent section
+     */
+    requirements?: {
+        /** High-level business objective this agent will serve */
+        businessGoal: string;
+        /** Specific functional capabilities the agent must have */
+        functionalRequirements: string;
+        /** Technical constraints and requirements */
+        technicalRequirements: string;
+        /** Data sources and data handling requirements */
+        dataRequirements: string;
+        /** System integration requirements */
+        integrationRequirements: string;
+        /** Key assumptions made during requirements gathering */
+        assumptions: string;
+        /** Identified risks and mitigation strategies */
+        risks: string;
+        /** Explicitly defined scope boundaries */
+        outOfScope: string;
+        /** Measurable criteria for success */
+        successCriteria: string;
+    };
+    /**
+     * Planning Designer agent section
+     */
+    design?: {
+        /** Complete agent hierarchy structure */
+        agentHierarchy: AIAgentDefinition;
+        /** Architecture documentation */
+        architecture: {
+            /** How agents will execute in sequence/parallel */
+            executionFlow: string;
+            /** How data flows between agents */
+            dataFlow: string;
+            /** Error handling and recovery strategies */
+            errorHandling: string;
+        };
+    };
+    /**
+     * Prompt Designer agent section
+     */
+    prompts?: {
+        /** Map of agent names to their prompt configurations */
+        [agentName: string]: {
+            /** Complete system prompt for the agent */
+            systemPrompt: string;
+            /** Documentation of template variables used */
+            templateVariables: string;
+            /** Analysis and optimization notes */
+            promptNotes: string;
+        };
+    };
+    /**
+     * Agent Manager implementation section
+     */
+    implementation?: {
+        /** Agents that have been created in the system */
+        createdAgents: {
+            /** Database ID of the created agent */
+            id: string;
+            /** Name of the agent */
+            name: string;
+            /** Current status of the agent */
+            status: 'created' | 'configured' | 'validated' | 'active';
+        }[];
+        /** Validation results for the created agent system */
+        validationResults: {
+            /** ID of the agent that was validated */
+            agentId: string;
+            /** Whether the agent passed validation */
+            isValid: boolean;
+            /** Any issues found during validation */
+            issues: string[];
+        }[];
+    };
+}
 //# sourceMappingURL=agent-definition.interface.d.ts.map

package/dist/interfaces/agent-definition.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-definition.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/agent-definition.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAEhC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAC;IAGhB,YAAY,EAAE;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,qBAAqB,EAAE,MAAM,CAAC;QAC9B,gBAAgB,EAAE,MAAM,CAAC;QACzB,uBAAuB,EAAE,MAAM,CAAC;QAChC,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,eAAe,EAAE,MAAM,CAAC;IAGxB,MAAM,EAAE;QACN,OAAO,EAAE;YACP;gBACE,EAAE,EAAE,MAAM,CAAC;gBACX,IAAI,EAAE,MAAM,CAAC;gBACb,MAAM,EAAE,MAAM,CAAA;aACf;SACF,CAAC;QAEF,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;KACjC,CAAC;IAGF,MAAM,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAEpC,KAAK,EAAE,iBAAiB,CAAC;IAGzB,YAAY,EAAE,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,gBAAgB,GAAG,YAAY,GAAG,UAAU,CAAC;IAGrG,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IAGF,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH"}
+{"version":3,"file":"agent-definition.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/agent-definition.interface.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/ai-agent-manager",
-  "version": "2.103.0",
+  "version": "2.104.0",
   "description": "Core interfaces and types for the MemberJunction Agent Manager system",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/interfaces/agent-definition.interface.ts

@@ -15,42 +15,45 @@ export interface AIAgentDefinition {
   // Basic Information
   name: string;
   description: string;
-  readonly type: 'Loop' // ONLY LOOP FOR NOW | 'Sequential' | 'Graph';
+  readonly type: 'Loop'; // ONLY LOOP FOR NOW | 'Sequential' | 'Graph';
   purpose: string;
   
-  // Requirements & Specifications
-  requirements: {
-    businessGoal: string;
-    functionalRequirements: string;
-    technicalRequirements: string;
-    dataRequirements: string;
-    integrationRequirements: string;
-    assumptions: string;
-    risks: string;
-    outOfScope: string;
-  };
-  
-  successCriteria: string;
-  
-  // Design & Architecture
-  design: {
-    actions: [
-      {
-        id: string, // id of the action from the available actions in our system
-        name: string, // name of the action
-        reason: string // Why this action is needed
-      }
-    ];
-    // Sub-Agents (recursive structure for n-level depth)
-    subAgents?: AIAgentDefinition[];
-  };
+  // Actions this agent can use
+  actions: {
+    /** Action ID from the system action library */
+    id: string;
+    /** Human-readable name of the action */
+    name: string;
+    /** Justification for why this action is needed */
+    reason: string;
+  }[];
   
   // Prompt Configuration
   prompt: {
-    systemPrompt: string;
-    templateVariables: string;
-    promptNotes: string;
+    /** System prompt for this agent */
+    systemPrompt?: string;
+    /** Template variables documentation */
+    templateVariables?: string;
+    /** Prompt analysis and notes */
+    promptNotes?: string;
   };
+  
+  // Payload access control
+  payloadDownstreamPaths?: string[];
+  payloadUpstreamPaths?: string[];
+  
+  // Recursive sub-agents
+  subAgents?: AIAgentDefinition[];
+  
+  // Execution configuration
+  executionOrder?: number;
+  exposeAsAction?: boolean;
+  iconClass?: string;
+  
+  // Final payload validation
+  finalPayloadValidation?: string; // JSON validation schema
+  finalPayloadValidationMode?: 'Retry' | 'Fail' | 'Warn';
+  finalPayloadValidationMaxRetries?: number;
 }
 
 /**
@@ -78,4 +81,104 @@ export interface AIAgentManagerContext {
     isValid: boolean;
     report: string;
   };
+}
+
+/**
+ * Agent Manager Payload Definition
+ * This type defines the structure for data passed between Agent Manager sub-agents
+ */
+export interface AgentManagerPayload {
+  /**
+   * Metadata about the agent creation process
+   */
+  metadata: {
+    /** Unique identifier for this agent creation session */
+    sessionId: string;
+    /** Current status of the agent creation process */
+    status: 'requirements' | 'design' | 'prompting' | 'implementation' | 'validation' | 'complete';
+    /** Original user request for agent creation */
+    originalRequest: string;
+    /** The agent who last modified the payload */
+    lastModifiedBy: string;
+  };
+
+  /**
+   * Requirements Analyst agent section
+   */
+  requirements?: {
+    /** High-level business objective this agent will serve */
+    businessGoal: string;
+    /** Specific functional capabilities the agent must have */
+    functionalRequirements: string;
+    /** Technical constraints and requirements */
+    technicalRequirements: string;
+    /** Data sources and data handling requirements */
+    dataRequirements: string;
+    /** System integration requirements */
+    integrationRequirements: string;
+    /** Key assumptions made during requirements gathering */
+    assumptions: string;
+    /** Identified risks and mitigation strategies */
+    risks: string;
+    /** Explicitly defined scope boundaries */
+    outOfScope: string;
+    /** Measurable criteria for success */
+    successCriteria: string;
+  };
+
+  /**
+   * Planning Designer agent section
+   */
+  design?: {
+    /** Complete agent hierarchy structure */
+    agentHierarchy: AIAgentDefinition;
+    /** Architecture documentation */
+    architecture: {
+      /** How agents will execute in sequence/parallel */
+      executionFlow: string;
+      /** How data flows between agents */
+      dataFlow: string;
+      /** Error handling and recovery strategies */
+      errorHandling: string;
+    };
+  };
+
+  /**
+   * Prompt Designer agent section
+   */
+  prompts?: {
+    /** Map of agent names to their prompt configurations */
+    [agentName: string]: {
+      /** Complete system prompt for the agent */
+      systemPrompt: string;
+      /** Documentation of template variables used */
+      templateVariables: string;
+      /** Analysis and optimization notes */
+      promptNotes: string;
+    };
+  };
+
+  /**
+   * Agent Manager implementation section
+   */
+  implementation?: {
+    /** Agents that have been created in the system */
+    createdAgents: {
+      /** Database ID of the created agent */
+      id: string;
+      /** Name of the agent */
+      name: string;
+      /** Current status of the agent */
+      status: 'created' | 'configured' | 'validated' | 'active';
+    }[];
+    /** Validation results for the created agent system */
+    validationResults: {
+      /** ID of the agent that was validated */
+      agentId: string;
+      /** Whether the agent passed validation */
+      isValid: boolean;
+      /** Any issues found during validation */
+      issues: string[];
+    }[];
+  };
 }