@memberjunction/ai-agent-manager 2.112.0 → 2.113.0

package/dist/agents/planning-designer-agent.js

@@ -0,0 +1,160 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlanningDesignerAgent = void 0;
+const ai_agents_1 = require("@memberjunction/ai-agents");
+const global_1 = require("@memberjunction/global");
+/**
+ * Planning Designer Agent - Designs agent architectures by researching existing capabilities
+ *
+ * This agent creates TechnicalDesign or modificationPlan by researching available
+ * actions, agents, and database entities. It overrides validateSuccessNextStep to
+ * enforce that required research actions are called before finalizing designs.
+ *
+ * Key responsibilities:
+ * - Force discovery of existing agents before selecting actions
+ * - Force discovery of available actions before designing
+ * - Force database schema research for CRUD operations
+ * - Prevent hallucination of non-existent entities/actions
+ * - Ensure designs are research-backed, not assumption-based
+ */
+let PlanningDesignerAgent = class PlanningDesignerAgent extends ai_agents_1.BaseAgent {
+    async validateSuccessNextStep(params, nextStep, currentPayload, agentRun, currentStep) {
+        // 1. Call base validation first (checks MinExecutionsPerRun, FinalPayloadValidation)
+        const baseValidation = await super.validateSuccessNextStep(params, nextStep, currentPayload, agentRun, currentStep);
+        if (baseValidation.step === 'Retry') {
+            return baseValidation;
+        }
+        // 2. Check if required research actions were called
+        const researchViolations = await this.checkResearchRequirements(params.agent, agentRun, currentPayload);
+        if (researchViolations.length > 0) {
+            console.log('🚫 Planning Designer: Research requirements not met:', researchViolations);
+            return {
+                ...nextStep,
+                step: 'Retry',
+                retryInstructions: this.formatResearchViolations(researchViolations)
+            };
+        }
+        console.log('✅ Planning Designer: All research requirements met');
+        return nextStep;
+    }
+    /**
+     * Checks if Planning Designer called required research actions/agents
+     */
+    async checkResearchRequirements(agent, agentRun, currentPayload) {
+        const violations = [];
+        // Hardcoded IDs for required research capabilities (from metadata)
+        const FIND_CANDIDATE_AGENTS_ACTION_ID = 'EF610103-E48D-4D9C-8DA2-1CF5B05F8AB6';
+        const FIND_CANDIDATE_ACTIONS_ACTION_ID = 'FD932133-CB1D-4C96-8EFC-14F0C8CE045B';
+        const DATABASE_RESEARCH_AGENT_ID = '746CD1E8-CB8D-49A4-BE69-D0F208A0B462';
+        // Get execution counts using hardcoded IDs
+        const findAgentsCount = await this.getActionExecutionCount(agentRun.ID, FIND_CANDIDATE_AGENTS_ACTION_ID);
+        const findActionsCount = await this.getActionExecutionCount(agentRun.ID, FIND_CANDIDATE_ACTIONS_ACTION_ID);
+        const dbResearchCount = await this.getSubAgentExecutionCount(agentRun.ID, DATABASE_RESEARCH_AGENT_ID);
+        // Find Candidate Agents is MANDATORY (at least once)
+        if (findAgentsCount === 0) {
+            violations.push(`❌ MISSING: "Find Candidate Agents" action has NOT been called
+
+**Purpose**: Discovers existing agents that can handle your subtasks as related subagents
+**What it returns**: Agent IDs, names, descriptions, existing actions, and existing subAgents
+**Why critical**: Existing specialized agents eliminate the need for multiple actions - one capable agent can replace several actions. You must search BEFORE selecting actions to avoid duplication.
+**What to do**: Call "Find Candidate Agents" multiple times with different TaskDescriptions for each major subtask. Set ExcludeSubAgents=false to see ALL available agents. Review their actions and subAgents arrays to understand full capabilities.`);
+        }
+        // Find Candidate Actions is MANDATORY (at least once)
+        if (findActionsCount === 0) {
+            violations.push(`❌ MISSING: "Find Candidate Actions" action has NOT been called
+
+**Purpose**: Discovers existing actions that can handle specific tasks (only use for tasks NOT covered by existing agents)
+**What it returns**: Action IDs, names, parameters (inputs/outputs), and descriptions
+**Why critical**: You cannot guess or make up action IDs - they must come from actual search results. Actions have specific parameter structures you need to understand.
+**What to do**: Call "Find Candidate Actions" for each task that existing agents cannot handle. Use the exact action IDs and names from results in your design.`);
+        }
+        // Database Research Agent is REQUIRED if design mentions CRUD/database operations
+        const designText = this.getDesignText(currentPayload);
+        if (this.mentionsDatabaseOperations(designText)) {
+            if (dbResearchCount === 0) {
+                violations.push(`❌ MISSING: "Database Research Agent" sub-agent has NOT been called (but your design mentions database/CRUD operations)
+
+**Purpose**: Provides actual entity names, field names, primary keys, data types, and relationships from the database schema
+**What it returns**: Complete entity schema information written to payload.TechnicalDesign.databaseSchema
+**Why critical**: NEVER guess entity or field names - they must come from Database Research Agent. CRUD actions require exact entity names and field names to work correctly.
+**What to do**: Call Database Research Agent with specific questions like "Is there an entity called [NAME] or related to [CONCEPT]? Give me all fields." Review the results and use ONLY those exact entity/field names in your CRUD action designs.`);
+            }
+        }
+        return violations;
+    }
+    /**
+     * Extracts design text from payload (FunctionalRequirements, TechnicalDesign, or modificationPlan)
+     */
+    getDesignText(payload) {
+        if (!payload) {
+            return '';
+        }
+        // Check all possible fields that might mention database operations:
+        // - FunctionalRequirements (from Requirements Analyst - may mention data storage needs)
+        // - TechnicalDesign (creation mode - the design document)
+        // - modificationPlan (modification mode - the change plan)
+        const functionalRequirements = payload.FunctionalRequirements || '';
+        const technicalDesign = payload.TechnicalDesign || '';
+        const modificationPlan = payload.modificationPlan || '';
+        return (functionalRequirements + ' ' + technicalDesign + ' ' + modificationPlan).toLowerCase();
+    }
+    /**
+     * Checks if text mentions database operations that require entity knowledge
+     */
+    mentionsDatabaseOperations(text) {
+        const keywords = [
+            'create record',
+            'update record',
+            'delete record',
+            'crud',
+            'database',
+            'entity',
+            'save to',
+            'store in',
+            'persist',
+            'write to database',
+            'update priority',
+            'create new record',
+            'insert into',
+            'entityname'
+        ];
+        return keywords.some(keyword => text.includes(keyword));
+    }
+    /**
+     * Formats research violations into clear, actionable retry instructions
+     */
+    formatResearchViolations(violations) {
+        const header = '## Research Requirements Not Met\n\nYou must conduct thorough research before finalizing your design:\n\n';
+        const violationList = violations.map((v, idx) => `${idx + 1}. ${v}`).join('\n\n');
+        const footer = `\n\n---
+
+**Next Steps - Complete Research Process**:
+
+1. **Call each missing research action/agent listed above** (in order shown)
+
+2. **Review research results carefully**:
+   - "Find Candidate Agents": Check each agent's actions and subAgents arrays - if an agent can handle multiple subtasks, use it instead of individual actions
+   - "Find Candidate Actions": Note the exact action IDs and parameter structures - you'll need these exact IDs in your design
+   - "Database Research Agent": Copy the exact entity names and field names - use ONLY these in your CRUD action instructions
+
+3. **Update your design based on actual research findings**:
+   - Replace any guessed/assumed names with actual IDs and names from research
+   - Remove redundant actions if subagents already provide those capabilities
+   - Maximize reuse of existing agents to simplify your design
+   - For CRUD actions: Include exact entity names and field names in the agent prompt
+
+4. **Try again** - Your next response must include research-backed design (no assumptions!)`;
+        return header + violationList + footer;
+    }
+};
+exports.PlanningDesignerAgent = PlanningDesignerAgent;
+exports.PlanningDesignerAgent = PlanningDesignerAgent = __decorate([
+    (0, global_1.RegisterClass)(ai_agents_1.BaseAgent, 'AgentPlanningDesigner')
+], PlanningDesignerAgent);
+//# sourceMappingURL=planning-designer-agent.js.map

package/dist/agents/planning-designer-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-designer-agent.js","sourceRoot":"","sources":["../../src/agents/planning-designer-agent.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -7,12 +7,14 @@ export * from './old/agent-definition.interface';
 export * from './agent-spec-sync';
 export * from './agents/architect-agent';
 export * from './agents/builder-agent';
+export * from './agents/planning-designer-agent';
 /**
  * Loads the Agent Manager Core module and ensures all agent classes are registered.
  * This function prevents tree shaking from removing the agent class registrations.
  *
  * The function itself doesn't need to do anything - importing the module is enough
- * to trigger the @RegisterClass decorators on AgentArchitectAgent and AgentBuilderAgent.
+ * to trigger the @RegisterClass decorators on AgentArchitectAgent, AgentBuilderAgent,
+ * and PlanningDesignerAgent.
  */
 export declare function LoadAgentManagerCore(): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,kCAAkC,CAAC;AAEjD,cAAc,mBAAmB,CAAC;AAGlC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAgB,oBAAoB,SAGnC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,kCAAkC,CAAC;AAEjD,cAAc,mBAAmB,CAAC;AAGlC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,SAGnC"}

package/dist/index.js

@@ -26,12 +26,14 @@ __exportStar(require("./agent-spec-sync"), exports);
 // Export agent implementations
 __exportStar(require("./agents/architect-agent"), exports);
 __exportStar(require("./agents/builder-agent"), exports);
+__exportStar(require("./agents/planning-designer-agent"), exports);
 /**
  * Loads the Agent Manager Core module and ensures all agent classes are registered.
  * This function prevents tree shaking from removing the agent class registrations.
  *
  * The function itself doesn't need to do anything - importing the module is enough
- * to trigger the @RegisterClass decorators on AgentArchitectAgent and AgentBuilderAgent.
+ * to trigger the @RegisterClass decorators on AgentArchitectAgent, AgentBuilderAgent,
+ * and PlanningDesignerAgent.
  */
 function LoadAgentManagerCore() {
     // Forces module to load and decorators to execute

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;AAEH,wBAAwB;AACxB,mEAAiD;AAEjD,oDAAkC;AAElC,+BAA+B;AAC/B,2DAAyC;AACzC,yDAAuC;AAEvC;;;;;;GAMG;AACH,SAAgB,oBAAoB;IAChC,kDAAkD;IAClD,4DAA4D;AAChE,CAAC;AAHD,oDAGC;AAED,mDAAmD;AACnD,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;AAEH,wBAAwB;AACxB,mEAAiD;AAEjD,oDAAkC;AAElC,+BAA+B;AAC/B,2DAAyC;AACzC,yDAAuC;AACvC,mEAAiD;AAEjD;;;;;;;GAOG;AACH,SAAgB,oBAAoB;IAChC,kDAAkD;IAClD,4DAA4D;AAChE,CAAC;AAHD,oDAGC;AAED,mDAAmD;AACnD,oBAAoB,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/ai-agent-manager",
-  "version": "2.112.0",
+  "version": "2.113.0",
   "description": "Core interfaces and types for the MemberJunction Agent Manager system",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,10 +19,11 @@
   "author": "MemberJunction",
   "license": "ISC",
   "dependencies": {
-    "@memberjunction/core-entities": "2.112.0",
-    "@memberjunction/global": "2.112.0",
-    "@memberjunction/ai-core-plus": "2.112.0",
-    "@memberjunction/ai-agents": "2.112.0"
+    "@memberjunction/core": "2.113.0",
+    "@memberjunction/core-entities": "2.113.0",
+    "@memberjunction/global": "2.113.0",
+    "@memberjunction/ai-core-plus": "2.113.0",
+    "@memberjunction/ai-agents": "2.113.0"
   },
   "devDependencies": {
     "@types/node": "^18.11.0",