@memberjunction/ai-agents 5.0.0 → 5.2.0

package/dist/base-agent.js

@@ -713,7 +713,7 @@ export class BaseAgent {
      * all required metadata is present and handles errors gracefully.
      *
      * @param {ExecuteAgentParams} params - Parameters for agent execution
-     * @param {AIAgentEntityExtended} params.agent - The agent entity to execute
+     * @param {MJAIAgentEntityExtended} params.agent - The agent entity to execute
      * @param {ChatMessage[]} params.conversationMessages - Conversation history
      * @param {UserInfo} [params.contextUser] - Optional user context
      * @param {any} [params.context] - Optional context object passed to sub-agents and actions
@@ -1169,7 +1169,7 @@ export class BaseAgent {
     /**
      * Validates that the agent is active and ready for execution.
      *
-     * @param {AIAgentEntityExtended} agent - The agent to validate
+     * @param {MJAIAgentEntityExtended} agent - The agent to validate
      * @returns {ExecuteAgentResult | null} Error result if validation fails, null if valid
      * @protected
      */
@@ -1290,7 +1290,7 @@ export class BaseAgent {
     /**
      * Loads all required configuration for agent execution.
      *
-     * @param {AIAgentEntityExtended} agent - The agent to load configuration for
+     * @param {MJAIAgentEntityExtended} agent - The agent to load configuration for
      * @returns {Promise<AgentConfiguration>} Configuration object with loaded entities
      * @protected
      */
@@ -1355,8 +1355,8 @@ export class BaseAgent {
      * Prepares prompt parameters for hierarchical execution.
      *
      * @param {MJAIAgentTypeEntity} agentType - The agent type
-     * @param {AIPromptEntityExtended} systemPrompt - The system prompt
-     * @param {AIPromptEntityExtended} childPrompt - The child prompt
+     * @param {MJAIPromptEntityExtended} systemPrompt - The system prompt
+     * @param {MJAIPromptEntityExtended} childPrompt - The child prompt
      * @param {ExecuteAgentParams} params - Original execution parameters
      * @returns {Promise<AIPromptParams>} Configured prompt parameters
      * @protected
@@ -2823,7 +2823,7 @@ The context is now within limits. Please retry your request with the recovered c
      * structured to provide the LLM with comprehensive context about the agent's
      * capabilities and hierarchical relationships.
      *
-     * @param {AIAgentEntityExtended} agent - The agent to gather context for
+     * @param {MJAIAgentEntityExtended} agent - The agent to gather context for
      * @param {UserInfo} [_contextUser] - Optional user context (reserved for future use)
      * @param {any} [extraData] - Optional extra data to include in the context, if provided and keys conflict within the agent context data, the extraData will override the agent context data.
      * @param {ActionChange[]} [actionChanges] - Optional runtime action modifications
@@ -3100,7 +3100,7 @@ The context is now within limits. Please retry your request with the recovered c
      *
      * @param {ExecuteAgentParams} params - Execution parameters with conversation history
      * @param {AgentSubAgentRequest} subAgentRequest - Sub-agent request details
-     * @param {AIAgentEntityExtended} subAgent - The sub-agent entity
+     * @param {MJAIAgentEntityExtended} subAgent - The sub-agent entity
      * @param {ChatMessage | undefined} contextMessage - Optional context from SubAgentContextPaths
      * @returns {ChatMessage[]} Prepared message array for sub-agent execution
      *
@@ -3273,7 +3273,7 @@ The context is now within limits. Please retry your request with the recovered c
     /**
      * Formats sub-agent details for inclusion in prompt context.
      *
-     * @param {AIAgentEntityExtended[]} subAgents - Array of sub-agent entities
+     * @param {MJAIAgentEntityExtended[]} subAgents - Array of sub-agent entities
      * @returns {string} JSON formatted string with sub-agent details
      * @private
      */
@@ -3325,7 +3325,7 @@ The context is now within limits. Please retry your request with the recovered c
     /**
      * Formats action details for inclusion in prompt context.
      *
-     * @param {ActionEntityExtended[]} actions - Array of action entities
+     * @param {MJActionEntityExtended[]} actions - Array of action entities
      * @returns {string} JSON formatted string with comprehensive action details
      * @private
      */
@@ -3542,7 +3542,7 @@ The context is now within limits. Please retry your request with the recovered c
         return 'General';
     }
     /**
-     * Initializes the agent run tracking by creating AIAgentRunEntityExtended and setting up context.
+     * Initializes the agent run tracking by creating MJAIAgentRunEntityExtended and setting up context.
      *
      * @private
      * @param {ExecuteAgentParams} params - The execution parameters
@@ -3703,7 +3703,7 @@ The context is now within limits. Please retry your request with the recovered c
      * Validates the agent with tracking.
      *
      * @private
-     * @param {AIAgentEntityExtended} agent - The agent to validate
+     * @param {MJAIAgentEntityExtended} agent - The agent to validate
      * @returns {Promise<ExecuteAgentResult | null>} - Failure result if validation fails, null if successful
      */
     async validateAgentWithTracking(agent, contextUser) {
@@ -3731,7 +3731,7 @@ The context is now within limits. Please retry your request with the recovered c
      *
      * @private
      * @param params - Step creation parameters
-     * @returns {Promise<AIAgentRunStepEntityExtended>} - The created step entity
+     * @returns {Promise<MJAIAgentRunStepEntityExtended>} - The created step entity
      */
     async createStepEntity(params) {
         const stepEntity = await this._metadata.GetEntityObject('MJ: AI Agent Run Steps', params.contextUser);
@@ -3779,7 +3779,7 @@ The context is now within limits. Please retry your request with the recovered c
      * Finalizes a step entity with completion status.
      *
      * @private
-     * @param {AIAgentRunStepEntityExtended} stepEntity - The step entity to finalize
+     * @param {MJAIAgentRunStepEntityExtended} stepEntity - The step entity to finalize
      * @param {boolean} success - Whether the step was successful
      * @param {string} [errorMessage] - Optional error message
      * @param {any} [outputData] - Optional output data to capture for this step
@@ -4284,7 +4284,7 @@ The context is now within limits. Please retry your request with the recovered c
             finalPayload = updatedNextStep.newPayload || finalPayload;
             // Prepare output data, these are simple elements of the state that are not typically
             // included in payload but are helpful. We do not include the prompt result here
-            // or the payload as those are stored already(prompt result via TargetLogID -> AIPromptRunEntityExtended)
+            // or the payload as those are stored already(prompt result via TargetLogID -> MJAIPromptRunEntityExtended)
             // and payload via the specialied PayloadAtStart/End fields on the step entity.
             const outputData = {
                 nextStep: {
@@ -4643,7 +4643,7 @@ The context is now within limits. Please retry your request with the recovered c
             // Prepare output data
             const outputData = {
                 subAgentResult: {
-                    // we have a link to the AIAgentRunEntityExtended via the TargetLogID above
+                    // we have a link to the MJAIAgentRunEntityExtended via the TargetLogID above
                     // but we throw in just a few things here for convenience/summary that are
                     // light - we don't want to store the payload again for example
                     // that is stored in PayloadAtEnd on the step and also in PayloadAtEnd in the sub-agent's run