@memberjunction/ai-agent-manager 2.108.0 → 2.109.0

package/dist/agents/architect-agent.js

@@ -0,0 +1,247 @@
+"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.AgentArchitectAgent = void 0;
+const ai_agents_1 = require("@memberjunction/ai-agents");
+const core_1 = require("@memberjunction/core");
+const global_1 = require("@memberjunction/global");
+/**
+ * Architect Agent - Transforms technical design into validated AgentSpec JSON
+ *
+ * This agent creates AgentSpec objects from technical designs and validates them
+ * before passing to the Builder Agent for persistence. It overrides validateSuccessNextStep
+ * to ensure the generated AgentSpec is valid before proceeding.
+ *
+ * Key responsibilities:
+ * - Transform design documents into AgentSpec format
+ * - Validate required fields are present
+ * - Verify action IDs exist in database
+ * - Verify prompt IDs exist (if specified)
+ * - Validate SubAgent structure
+ * - Auto-correct minor issues (casing, missing optional fields)
+ * - Force retry with detailed errors if validation fails
+ */
+let AgentArchitectAgent = class AgentArchitectAgent extends ai_agents_1.BaseAgent {
+    /**
+     * Applies payload changes if any are requested in the next step
+     */
+    applyPayloadChanges(payload, nextStep) {
+        if (nextStep.payloadChangeRequest) {
+            const pm = new ai_agents_1.PayloadManager();
+            const result = pm.applyAgentChangeRequest(payload, nextStep.payloadChangeRequest);
+            return result.result || payload;
+        }
+        return payload;
+    }
+    async validateSuccessNextStep(params, nextStep, currentPayload, agentRun, currentStep) {
+        // First call base validation
+        const baseValidation = await super.validateSuccessNextStep(params, nextStep, currentPayload, agentRun, currentStep);
+        if (baseValidation.step === 'Retry') {
+            return baseValidation;
+        }
+        // Apply payload changes to get the spec that would be sent forward
+        const payloadWithChanges = this.applyPayloadChanges(currentPayload, nextStep);
+        // Extract the agentSpec from the nested payload structure
+        // The payload has structure: { metadata, requirements, design, agentSpec }
+        const agentSpec = payloadWithChanges.agentSpec;
+        console.log('🏗️ Architect Agent: Validating AgentSpec:', agentSpec ? `Name="${agentSpec.Name}"` : 'agentSpec is null/undefined');
+        // Validate the AgentSpec
+        const validation = await this.validateAgentSpec(agentSpec, params);
+        if (validation.errors.length > 0) {
+            console.log('❌ Architect Agent: Validation failed with errors:', validation.errors);
+            // Return retry with detailed error messages
+            return {
+                ...nextStep,
+                step: 'Retry',
+                retryInstructions: this.formatValidationErrors(validation.errors),
+                newPayload: nextStep.newPayload
+            };
+        }
+        // If spec was auto-corrected, update the payload with corrected spec
+        if (validation.correctedSpec) {
+            console.log('✓ Architect Agent: Auto-corrected AgentSpec, updating payload');
+            const updatedPayload = {
+                ...payloadWithChanges,
+                agentSpec: validation.correctedSpec
+            };
+            return {
+                ...nextStep,
+                newPayload: updatedPayload
+            };
+        }
+        console.log('✅ Architect Agent: AgentSpec validation passed');
+        return nextStep;
+    }
+    /**
+     * Validates an AgentSpec object
+     * Returns errors array and potentially a corrected spec
+     */
+    async validateAgentSpec(spec, params) {
+        const errors = [];
+        let corrected = false;
+        // Check if spec exists
+        if (!spec) {
+            errors.push('❌ AgentSpec is null or undefined. Ensure you place the AgentSpec in payload.agentSpec (inside a payloadChangeRequest with newElements or replaceElements)');
+            return { errors };
+        }
+        const correctedSpec = { ...spec };
+        // 1. Validate required fields
+        if (!correctedSpec.Name || correctedSpec.Name.trim().length === 0) {
+            errors.push('❌ AgentSpec.Name is required and cannot be empty');
+        }
+        if (!correctedSpec.StartingPayloadValidationMode) {
+            // Auto-correct: add default
+            correctedSpec.StartingPayloadValidationMode = 'Fail';
+            corrected = true;
+            console.log('✓ Auto-corrected: Added default StartingPayloadValidationMode = "Fail"');
+        }
+        else if (correctedSpec.StartingPayloadValidationMode !== 'Fail' && correctedSpec.StartingPayloadValidationMode !== 'Warn') {
+            errors.push(`❌ StartingPayloadValidationMode must be either "Fail" or "Warn", got: "${correctedSpec.StartingPayloadValidationMode}"`);
+        }
+        // 2. Validate Actions if specified
+        if (correctedSpec.Actions && correctedSpec.Actions.length > 0) {
+            const actionValidation = await this.validateActions(correctedSpec.Actions, params);
+            if (actionValidation.errors.length > 0) {
+                errors.push(...actionValidation.errors);
+            }
+        }
+        // 3. Validate SubAgents if specified
+        if (correctedSpec.SubAgents && correctedSpec.SubAgents.length > 0) {
+            const subAgentValidation = this.validateSubAgents(correctedSpec.SubAgents);
+            if (subAgentValidation.errors.length > 0) {
+                errors.push(...subAgentValidation.errors);
+            }
+            if (subAgentValidation.corrected) {
+                corrected = true;
+            }
+        }
+        // 4. Validate optional but important fields
+        if (correctedSpec.FinalPayloadValidationMode &&
+            !['Fail', 'Retry', 'Warn'].includes(correctedSpec.FinalPayloadValidationMode)) {
+            errors.push(`❌ FinalPayloadValidationMode must be "Fail", "Retry", or "Warn", got: "${correctedSpec.FinalPayloadValidationMode}"`);
+        }
+        if (correctedSpec.InvocationMode &&
+            !['Any', 'Agent', 'User', 'Never'].includes(correctedSpec.InvocationMode)) {
+            errors.push(`❌ InvocationMode must be "Any", "Agent", "User", or "Never", got: "${correctedSpec.InvocationMode}"`);
+        }
+        return {
+            errors,
+            correctedSpec: corrected ? correctedSpec : undefined
+        };
+    }
+    /**
+     * Validates that action IDs exist in the database
+     */
+    async validateActions(actions, params) {
+        const errors = [];
+        if (!actions || actions.length === 0) {
+            return { errors };
+        }
+        try {
+            const rv = new core_1.RunView();
+            const actionIds = actions
+                .map(a => a.ActionID)
+                .filter(id => id && id.trim().length > 0);
+            if (actionIds.length === 0) {
+                errors.push('❌ All actions must have an ActionID');
+                return { errors };
+            }
+            // Query database for these action IDs
+            const filter = actionIds.map(id => `ID='${id}'`).join(' OR ');
+            const result = await rv.RunView({
+                EntityName: 'Actions',
+                ExtraFilter: filter,
+                ResultType: 'entity_object'
+            }, params.contextUser);
+            if (!result.Success) {
+                errors.push(`❌ Failed to validate actions: ${result.ErrorMessage}`);
+                return { errors };
+            }
+            const foundIds = new Set(result.Results.map(a => a.ID));
+            // Check which actions weren't found
+            for (const action of actions) {
+                if (!action.ActionID) {
+                    errors.push('❌ Action is missing ActionID field');
+                    continue;
+                }
+                if (!foundIds.has(action.ActionID)) {
+                    errors.push(`❌ Action with ID "${action.ActionID}" not found in database. Please use "Find Best Action" or "List Actions" to get valid action IDs.`);
+                }
+            }
+        }
+        catch (error) {
+            errors.push(`❌ Error validating actions: ${error?.message || String(error)}`);
+        }
+        return { errors };
+    }
+    /**
+     * Validates SubAgent structure
+     */
+    validateSubAgents(subAgents) {
+        const errors = [];
+        let corrected = false;
+        if (!subAgents || subAgents.length === 0) {
+            return { errors, corrected };
+        }
+        for (let i = 0; i < subAgents.length; i++) {
+            const subAgent = subAgents[i];
+            // Validate Type field
+            if (!subAgent.Type) {
+                errors.push(`❌ SubAgent at index ${i} is missing required "Type" field (must be "child" or "related")`);
+                continue;
+            }
+            if (subAgent.Type !== 'child' && subAgent.Type !== 'related') {
+                errors.push(`❌ SubAgent at index ${i} has invalid Type "${subAgent.Type}" (must be "child" or "related")`);
+                continue;
+            }
+            // Validate SubAgent.SubAgent field
+            if (!subAgent.SubAgent) {
+                errors.push(`❌ SubAgent at index ${i} is missing required "SubAgent" field`);
+                continue;
+            }
+            // SubAgent.ID can be empty string "" for NEW sub-agents (Builder creates them recursively)
+            // Only validate that ID is not null/undefined
+            if (subAgent.SubAgent.ID === null || subAgent.SubAgent.ID === undefined) {
+                errors.push(`❌ SubAgent at index ${i} has null/undefined SubAgent.ID (use empty string "" for new sub-agents, or provide existing agent GUID)`);
+            }
+            // Validate SubAgent.SubAgent.Name
+            if (!subAgent.SubAgent.Name || subAgent.SubAgent.Name.trim().length === 0) {
+                errors.push(`❌ SubAgent at index ${i} is missing SubAgent.Name`);
+            }
+            // Auto-correct: Add default StartingPayloadValidationMode if missing
+            if (!subAgent.SubAgent.StartingPayloadValidationMode) {
+                subAgent.SubAgent.StartingPayloadValidationMode = 'Fail';
+                corrected = true;
+                console.log(`✓ Auto-corrected: Added SubAgent[${i}].SubAgent.StartingPayloadValidationMode = "Fail"`);
+            }
+            // Validate related-specific fields
+            if (subAgent.Type === 'related' && !subAgent.AgentRelationshipID) {
+                // AgentRelationshipID can be empty for new relationships, it will be created on save
+                // This is not an error
+            }
+        }
+        return { errors, corrected };
+    }
+    /**
+     * Formats validation errors into a clear, actionable message
+     */
+    formatValidationErrors(errors) {
+        if (errors.length === 0) {
+            return '';
+        }
+        const header = '## AgentSpec Validation Errors\n\nThe generated AgentSpec has the following issues that must be fixed:\n\n';
+        const errorList = errors.map((err, idx) => `${idx + 1}. ${err}`).join('\n');
+        const footer = '\n\n**Please fix these issues and regenerate the AgentSpec.**';
+        return header + errorList + footer;
+    }
+};
+exports.AgentArchitectAgent = AgentArchitectAgent;
+exports.AgentArchitectAgent = AgentArchitectAgent = __decorate([
+    (0, global_1.RegisterClass)(ai_agents_1.BaseAgent, 'AgentArchitectAgent')
+], AgentArchitectAgent);
+//# sourceMappingURL=architect-agent.js.map

package/dist/agents/architect-agent.js.map

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

package/dist/agents/builder-agent.d.ts

@@ -0,0 +1,29 @@
+import { BaseAgent } from '@memberjunction/ai-agents';
+import { ExecuteAgentParams, AgentConfiguration, BaseAgentNextStep } from '@memberjunction/ai-core-plus';
+/**
+ * Builder Agent - Persists validated AgentSpec to database via AgentSpecSync
+ *
+ * This is a code-based agent that overrides executeAgentInternal to bypass
+ * the normal chat loop and directly execute persistence logic. It receives
+ * a validated AgentSpec from the Architect Agent and saves it to the database
+ * using AgentSpecSync.
+ *
+ * Key responsibilities:
+ * - Receive validated AgentSpec from payload
+ * - Create AgentSpecSync instance
+ * - Persist to database
+ * - Return success with created agent ID, or failure with error details
+ *
+ * This agent does NOT iterate - it runs once and returns Success or Failed.
+ */
+export declare class AgentBuilderAgent extends BaseAgent {
+    /**
+     * Override executeAgentInternal to run code instead of chat loop
+     * This follows the Skip Code Generator pattern
+     */
+    protected executeAgentInternal<P = any>(params: ExecuteAgentParams<P>, _config: AgentConfiguration): Promise<{
+        finalStep: BaseAgentNextStep<P>;
+        stepCount: number;
+    }>;
+}
+//# sourceMappingURL=builder-agent.d.ts.map

package/dist/agents/builder-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-agent.d.ts","sourceRoot":"","sources":["../../src/agents/builder-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAa,MAAM,8BAA8B,CAAC;AAIpH;;;;;;;;;;;;;;;GAeG;AACH,qBACa,iBAAkB,SAAQ,SAAS;IAE5C;;;OAGG;cACsB,oBAAoB,CAAC,CAAC,GAAG,GAAG,EACjD,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC7B,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC;QAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAyDrE"}

package/dist/agents/builder-agent.js

@@ -0,0 +1,84 @@
+"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.AgentBuilderAgent = void 0;
+const ai_agents_1 = require("@memberjunction/ai-agents");
+const global_1 = require("@memberjunction/global");
+const agent_spec_sync_1 = require("../agent-spec-sync");
+/**
+ * Builder Agent - Persists validated AgentSpec to database via AgentSpecSync
+ *
+ * This is a code-based agent that overrides executeAgentInternal to bypass
+ * the normal chat loop and directly execute persistence logic. It receives
+ * a validated AgentSpec from the Architect Agent and saves it to the database
+ * using AgentSpecSync.
+ *
+ * Key responsibilities:
+ * - Receive validated AgentSpec from payload
+ * - Create AgentSpecSync instance
+ * - Persist to database
+ * - Return success with created agent ID, or failure with error details
+ *
+ * This agent does NOT iterate - it runs once and returns Success or Failed.
+ */
+let AgentBuilderAgent = class AgentBuilderAgent extends ai_agents_1.BaseAgent {
+    /**
+     * Override executeAgentInternal to run code instead of chat loop
+     * This follows the Skip Code Generator pattern
+     */
+    async executeAgentInternal(params, _config) {
+        console.log('🔨 Builder Agent: Starting agent persistence...');
+        try {
+            // Extract AgentSpec from nested payload structure
+            // The payload has structure: { metadata, requirements, design, agentSpec }
+            const agentSpec = params.payload.agentSpec;
+            if (!agentSpec) {
+                throw new Error('No AgentSpec found in payload.agentSpec - ensure Architect Agent placed it there');
+            }
+            if (!agentSpec.Name) {
+                throw new Error('AgentSpec is missing required Name field');
+            }
+            console.log(`🔨 Builder Agent: Creating agent "${agentSpec.Name}"...`);
+            // Create AgentSpecSync instance
+            const specSync = new agent_spec_sync_1.AgentSpecSync(agentSpec, params.contextUser);
+            // Mark as dirty to ensure it saves
+            specSync.markDirty();
+            // Save to database
+            const agentId = await specSync.SaveToDatabase();
+            console.log(`✅ Builder Agent: Successfully created agent with ID: ${agentId}`);
+            // Return success with the created agent ID
+            const updatedSpec = { ...agentSpec, ID: agentId };
+            return {
+                finalStep: {
+                    terminate: true,
+                    step: 'Success',
+                    reasoning: `Successfully created agent "${agentSpec.Name}" with ID: ${agentId}`,
+                    newPayload: updatedSpec
+                },
+                stepCount: 1
+            };
+        }
+        catch (error) {
+            console.error('❌ Builder Agent: Failed to create agent:', error);
+            // Return failure with error details
+            return {
+                finalStep: {
+                    terminate: true,
+                    step: 'Failed',
+                    reasoning: `Failed to create agent: ${error?.message || String(error)}`
+                },
+                stepCount: 1
+            };
+        }
+    }
+};
+exports.AgentBuilderAgent = AgentBuilderAgent;
+exports.AgentBuilderAgent = AgentBuilderAgent = __decorate([
+    (0, global_1.RegisterClass)(ai_agents_1.BaseAgent, 'AgentBuilderAgent')
+], AgentBuilderAgent);
+//# sourceMappingURL=builder-agent.js.map

package/dist/agents/builder-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-agent.js","sourceRoot":"","sources":["../../src/agents/builder-agent.ts"],"names":[],"mappings":";;;;;;;;;AAAA,yDAAsD;AAEtD,mDAAuD;AACvD,wDAAmD;AAEnD;;;;;;;;;;;;;;;GAeG;AAEI,IAAM,iBAAiB,GAAvB,MAAM,iBAAkB,SAAQ,qBAAS;IAE5C;;;OAGG;IACgB,KAAK,CAAC,oBAAoB,CACzC,MAA6B,EAC7B,OAA2B;QAG3B,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAE/D,IAAI,CAAC;YACD,kDAAkD;YAClD,2EAA2E;YAC3E,MAAM,SAAS,GAAI,MAAM,CAAC,OAAe,CAAC,SAAsB,CAAC;YAEjE,IAAI,CAAC,SAAS,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;YACxG,CAAC;YAED,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAChE,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,qCAAqC,SAAS,CAAC,IAAI,MAAM,CAAC,CAAC;YAEvE,gCAAgC;YAChC,MAAM,QAAQ,GAAG,IAAI,+BAAa,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;YAElE,mCAAmC;YACnC,QAAQ,CAAC,SAAS,EAAE,CAAC;YAErB,mBAAmB;YACnB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,CAAC;YAEhD,OAAO,CAAC,GAAG,CAAC,wDAAwD,OAAO,EAAE,CAAC,CAAC;YAE/E,2CAA2C;YAC3C,MAAM,WAAW,GAAG,EAAE,GAAG,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;YAElD,OAAO;gBACH,SAAS,EAAE;oBACP,SAAS,EAAE,IAAI;oBACf,IAAI,EAAE,SAAS;oBACf,SAAS,EAAE,+BAA+B,SAAS,CAAC,IAAI,cAAc,OAAO,EAAE;oBAC/E,UAAU,EAAE,WAAgB;iBAC/B;gBACD,SAAS,EAAE,CAAC;aACf,CAAC;QAEN,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;YAEjE,oCAAoC;YACpC,OAAO;gBACH,SAAS,EAAE;oBACP,SAAS,EAAE,IAAI;oBACf,IAAI,EAAE,QAAQ;oBACd,SAAS,EAAE,2BAA2B,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE;iBAC1E;gBACD,SAAS,EAAE,CAAC;aACf,CAAC;QACN,CAAC;IACL,CAAC;CACJ,CAAA;AAlEY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,sBAAa,EAAC,qBAAS,EAAE,mBAAmB,CAAC;GACjC,iBAAiB,CAkE7B"}

package/dist/index.d.ts

@@ -5,4 +5,14 @@
  */
 export * from './old/agent-definition.interface';
 export * from './agent-spec-sync';
+export * from './agents/architect-agent';
+export * from './agents/builder-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.
+ */
+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"}
+{"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"}

package/dist/index.js

@@ -19,7 +19,25 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoadAgentManagerCore = void 0;
 // Export all interfaces
 __exportStar(require("./old/agent-definition.interface"), exports);
 __exportStar(require("./agent-spec-sync"), exports);
+// Export agent implementations
+__exportStar(require("./agents/architect-agent"), exports);
+__exportStar(require("./agents/builder-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.
+ */
+function LoadAgentManagerCore() {
+    // Forces module to load and decorators to execute
+    // Classes are already exported and decorators run on import
+}
+exports.LoadAgentManagerCore = LoadAgentManagerCore;
+// Auto-load on import to ensure decorators execute
+LoadAgentManagerCore();
 //# sourceMappingURL=index.js.map

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"}
+{"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"}

package/package.json

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