@memberjunction/server 2.92.0 → 2.94.0

package/src/generated/generated.ts

@@ -1710,6 +1710,13 @@ each time the agent processes a prompt step.`})
     @Field(() => Int, {nullable: true, description: `Effort level that was actually used during this agent run execution (1-100, where 1=minimal effort, 100=maximum effort). This is the resolved effort level after applying the precedence hierarchy: runtime override > agent default > prompt defaults.`}) 
     EffortLevel?: number;
         
+    @Field({nullable: true, description: `Optional name for the agent run to help identify and tag runs for easier reference`}) 
+    @MaxLength(510)
+    RunName?: string;
+        
+    @Field({nullable: true, description: `Human-readable notes and comments about this agent run`}) 
+    Comments?: string;
+        
     @Field({nullable: true}) 
     @MaxLength(510)
     Agent?: string;
@@ -1854,6 +1861,12 @@ export class CreateAIAgentRunInput {
 
     @Field(() => Int, { nullable: true })
     EffortLevel: number | null;
+
+    @Field({ nullable: true })
+    RunName: string | null;
+
+    @Field({ nullable: true })
+    Comments: string | null;
 }
     
 
@@ -1967,6 +1980,12 @@ export class UpdateAIAgentRunInput {
     @Field(() => Int, { nullable: true })
     EffortLevel?: number | null;
 
+    @Field({ nullable: true })
+    RunName?: string | null;
+
+    @Field({ nullable: true })
+    Comments?: string | null;
+
     @Field(() => [KeyValuePairInput], { nullable: true })
     OldValues___?: KeyValuePairInput[];
 }
@@ -39142,6 +39161,9 @@ export class ComponentLibrary_ {
     @Field({nullable: true, description: `JSON configuration for library-specific lint rules that are applied during component validation. This field contains structured rules that define how components using this library should be validated, including DOM element requirements, initialization patterns, lifecycle methods, and common error patterns. Example structure: {"initialization": {"constructorName": "Chart", "elementType": "canvas"}, "lifecycle": {"requiredMethods": ["render"], "cleanupMethods": ["destroy"]}}. The linter dynamically applies these rules based on the libraries referenced in a component spec, enabling extensible validation without hardcoding library-specific logic.`}) 
     LintRules?: string;
         
+    @Field({nullable: true, description: `JSON object defining dependencies for this component library. Format: { "libraryName": "versionSpec", ... }. Version specifications follow NPM-style syntax (e.g., "~1.0.0", "^1.2.3", "2.3.4"). Dependencies are loaded before this library to ensure proper execution context.`}) 
+    Dependencies?: string;
+        
     @Field(() => [ComponentLibraryLink_])
     MJ_ComponentLibraryLinks_LibraryIDArray: ComponentLibraryLink_[]; // Link to MJ_ComponentLibraryLinks
     
@@ -39184,6 +39206,9 @@ export class CreateComponentLibraryInput {
 
     @Field({ nullable: true })
     LintRules: string | null;
+
+    @Field({ nullable: true })
+    Dependencies: string | null;
 }
     
 
@@ -39225,6 +39250,9 @@ export class UpdateComponentLibraryInput {
     @Field({ nullable: true })
     LintRules?: string | null;
 
+    @Field({ nullable: true })
+    Dependencies?: string | null;
+
     @Field(() => [KeyValuePairInput], { nullable: true })
     OldValues___?: KeyValuePairInput[];
 }
@@ -42644,6 +42672,13 @@ export class AIPromptRun_ {
     @Field(() => Int, {nullable: true, description: `Effort level that was actually used during this prompt run execution (1-100, where 1=minimal effort, 100=maximum effort). This is the resolved effort level after applying the precedence hierarchy: runtime override > agent default > prompt default > provider default.`}) 
     EffortLevel?: number;
         
+    @Field({nullable: true, description: `Optional name for the prompt run to help identify and tag runs for easier reference`}) 
+    @MaxLength(510)
+    RunName?: string;
+        
+    @Field({nullable: true, description: `Human-readable notes and comments about this prompt run`}) 
+    Comments?: string;
+        
     @Field() 
     @MaxLength(510)
     Prompt: string;
@@ -42925,6 +42960,12 @@ export class CreateAIPromptRunInput {
 
     @Field(() => Int, { nullable: true })
     EffortLevel: number | null;
+
+    @Field({ nullable: true })
+    RunName: string | null;
+
+    @Field({ nullable: true })
+    Comments: string | null;
 }
     
 
@@ -43170,6 +43211,12 @@ export class UpdateAIPromptRunInput {
     @Field(() => Int, { nullable: true })
     EffortLevel?: number | null;
 
+    @Field({ nullable: true })
+    RunName?: string | null;
+
+    @Field({ nullable: true })
+    Comments?: string | null;
+
     @Field(() => [KeyValuePairInput], { nullable: true })
     OldValues___?: KeyValuePairInput[];
 }
@@ -43363,6 +43410,16 @@ permanently, Warn means validation failed but execution continues.`})
 detailed information about what validation rules failed.`}) 
     FinalPayloadValidationMessages?: string;
         
+    @Field({nullable: true, description: `Optional reference to parent step for tracking hierarchical relationships like code->test->fix->code cycles`}) 
+    @MaxLength(16)
+    ParentID?: string;
+        
+    @Field({nullable: true, description: `Human-readable notes and comments about this agent run step`}) 
+    Comments?: string;
+        
+    @Field(() => [AIAgentRunStep_])
+    MJ_AIAgentRunSteps_ParentIDArray: AIAgentRunStep_[]; // Link to MJ_AIAgentRunSteps
+    
 }
 
 //****************************************************************************
@@ -43423,6 +43480,12 @@ export class CreateAIAgentRunStepInput {
 
     @Field({ nullable: true })
     FinalPayloadValidationMessages: string | null;
+
+    @Field({ nullable: true })
+    ParentID: string | null;
+
+    @Field({ nullable: true })
+    Comments: string | null;
 }
     
 
@@ -43485,6 +43548,12 @@ export class UpdateAIAgentRunStepInput {
     @Field({ nullable: true })
     FinalPayloadValidationMessages?: string | null;
 
+    @Field({ nullable: true })
+    ParentID?: string | null;
+
+    @Field({ nullable: true })
+    Comments?: string | null;
+
     @Field(() => [KeyValuePairInput], { nullable: true })
     OldValues___?: KeyValuePairInput[];
 }
@@ -43547,6 +43616,17 @@ export class AIAgentRunStepResolver extends ResolverBase {
         return result;
     }
     
+    @FieldResolver(() => [AIAgentRunStep_])
+    async MJ_AIAgentRunSteps_ParentIDArray(@Root() aiagentrunstep_: AIAgentRunStep_, @Ctx() { dataSources, userPayload, providers }: AppContext, @PubSub() pubSub: PubSubEngine) {
+        this.CheckUserReadPermissions('MJ: AI Agent Run Steps', userPayload);
+        const provider = GetReadOnlyProvider(providers, { allowFallbackToReadWrite: true });
+        const connPool = GetReadOnlyDataSource(dataSources, { allowFallbackToReadWrite: true });
+        const sSQL = `SELECT * FROM [${Metadata.Provider.ConfigData.MJCoreSchemaName}].[vwAIAgentRunSteps] WHERE [ParentID]='${aiagentrunstep_.ID}' ` + this.getRowLevelSecurityWhereClause(provider, 'MJ: AI Agent Run Steps', userPayload, EntityPermissionType.Read, 'AND');
+        const rows = await SQLServerDataProvider.ExecuteSQLWithPool(connPool, sSQL, undefined, this.GetUserFromPayload(userPayload));
+        const result = this.ArrayMapFieldNamesToCodeNames('MJ: AI Agent Run Steps', rows);
+        return result;
+    }
+        
     @Mutation(() => AIAgentRunStep_)
     async CreateAIAgentRunStep(
         @Arg('input', () => CreateAIAgentRunStepInput) input: CreateAIAgentRunStepInput,

package/src/generic/RunViewResolver.ts

@@ -581,7 +581,16 @@ export class RunViewResolver extends ResolverBase {
     try {
       const provider = GetReadOnlyProvider(providers, { allowFallbackToReadWrite: true });
       const rawData = await super.RunViewByNameGeneric(input, provider, userPayload, pubSub);
-      if (rawData === null) return null;
+      if (rawData === null) {
+        return {
+          Results: [],
+          Success: false,
+          ErrorMessage: `Failed to execute view: ${input.ViewName}`,
+          RowCount: 0,
+          TotalRowCount: 0,
+          ExecutionTime: 0
+        };
+      }
 
       const entity = provider.Entities.find((e) => e.Name === input.ViewName);
       const entityId = entity ? entity.ID : null;
@@ -596,8 +605,16 @@ export class RunViewResolver extends ResolverBase {
         ErrorMessage: rawData?.ErrorMessage,
       };
     } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : 'Unknown error occurred';
       LogError(err);
-      return null;
+      return {
+        Results: [],
+        Success: false,
+        ErrorMessage: errorMessage,
+        RowCount: 0,
+        TotalRowCount: 0,
+        ExecutionTime: 0
+      };
     }
   }
 
@@ -611,7 +628,16 @@ export class RunViewResolver extends ResolverBase {
     try {
       const provider = GetReadOnlyProvider(providers, { allowFallbackToReadWrite: true });
       const rawData = await super.RunViewByIDGeneric(input, provider, userPayload, pubSub);
-      if (rawData === null) return null;
+      if (rawData === null) {
+        return {
+          Results: [],
+          Success: false,
+          ErrorMessage: `Failed to execute view with ID: ${input.ViewID}`,
+          RowCount: 0,
+          TotalRowCount: 0,
+          ExecutionTime: 0
+        };
+      }
 
       const viewInfo = super.safeFirstArrayElement<UserViewEntityExtended>(await super.findBy<UserViewEntityExtended>(provider, "User Views", { ID: input.ViewID }, userPayload.userRecord));
       const returnData = this.processRawData(rawData.Results, viewInfo.EntityID);
@@ -625,8 +651,16 @@ export class RunViewResolver extends ResolverBase {
         ErrorMessage: rawData?.ErrorMessage,
       };
     } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : 'Unknown error occurred';
       LogError(err);
-      return null;
+      return {
+        Results: [],
+        Success: false,
+        ErrorMessage: errorMessage,
+        RowCount: 0,
+        TotalRowCount: 0,
+        ExecutionTime: 0
+      };
     }
   }
 
@@ -640,12 +674,29 @@ export class RunViewResolver extends ResolverBase {
     try {
       const provider = GetReadOnlyProvider(providers, { allowFallbackToReadWrite: true });
       const rawData = await super.RunDynamicViewGeneric(input, provider, userPayload, pubSub);
-      if (rawData === null) return null;
+      if (rawData === null) {
+        return {
+          Results: [],
+          Success: false,
+          ErrorMessage: 'Failed to execute dynamic view',
+          RowCount: 0,
+          TotalRowCount: 0,
+          ExecutionTime: 0
+        };
+      }
 
       const entity = provider.Entities.find((e) => e.Name === input.EntityName);
       if (!entity) {
-        LogError(new Error(`Entity with name ${input.EntityName} not found`));
-        return null;
+        const errorMsg = `Entity ${input.EntityName} not found in metadata`;
+        LogError(new Error(errorMsg));
+        return {
+          Results: [],
+          Success: false,
+          ErrorMessage: errorMsg,
+          RowCount: 0,
+          TotalRowCount: 0,
+          ExecutionTime: 0
+        };
       }
       const returnData = this.processRawData(rawData.Results, entity.ID);
       return {
@@ -658,8 +709,16 @@ export class RunViewResolver extends ResolverBase {
         ErrorMessage: rawData?.ErrorMessage,
       };
     } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : 'Unknown error occurred';
       LogError(err);
-      return null;
+      return {
+        Results: [],
+        Success: false,
+        ErrorMessage: errorMessage,
+        RowCount: 0,
+        TotalRowCount: 0,
+        ExecutionTime: 0
+      };
     }
   }
 

package/src/resolvers/ReportResolver.ts

@@ -103,20 +103,19 @@ export class ReportResolverExtended {
       const title = skipData.title ? skipData.title : skipData.reportTitle ? skipData.reportTitle : 'Untitled Report';
       report.Name = title;
       report.Description = skipData.userExplanation ? skipData.userExplanation : '';
-      report.ConversationID = result[0].ConversationID;
+      report.ConversationID = result.recordset[0].ConversationID;
       report.ConversationDetailID = ConversationDetailID;
 
       const dc: DataContext = new DataContext();
-      await dc.LoadMetadata(result[0].DataContextID, u);
+      await dc.LoadMetadata(result.recordset[0].DataContextID, u);
       const newDataContext = await DataContext.Clone(dc, false, u);
       if (!newDataContext) throw new Error('Error cloning data context');
       report.DataContextID = newDataContext.ID;
 
       // next, strip out the messags from the SkipData object to put them into our Report Configuration as we dont need to store that information as we have a
-      // link back to the conversation and conversation detail
-      const newSkipData: SkipAPIAnalysisCompleteResponse = JSON.parse(JSON.stringify(skipData));
-      newSkipData.messages = [];
-      report.Configuration = JSON.stringify(newSkipData);
+      // link back to the conversation and conversation detail, skipData can be modified as it is a copy of the data doesn't affect the original source
+      skipData.messages = [];
+      report.Configuration = JSON.stringify(skipData);
 
       report.SharingScope = 'None';
       report.UserID = u.ID;

package/src/resolvers/RunAIAgentResolver.ts

@@ -1,4 +1,4 @@
-import { Resolver, Mutation, Arg, Ctx, ObjectType, Field, PubSub, PubSubEngine, Subscription, Root, ResolverFilterData, ID } from 'type-graphql';
+import { Resolver, Mutation, Query, Arg, Ctx, ObjectType, Field, PubSub, PubSubEngine, Subscription, Root, ResolverFilterData, ID } from 'type-graphql';
 import { UserPayload } from '../types.js';
 import { LogError, LogStatus } from '@memberjunction/core';
 import { AIAgentEntityExtended } from '@memberjunction/core-entities';
@@ -7,6 +7,7 @@ import { ExecuteAgentResult } from '@memberjunction/ai-core-plus';
 import { AIEngine } from '@memberjunction/aiengine';
 import { ResolverBase } from '../generic/ResolverBase.js';
 import { PUSH_STATUS_UPDATES_TOPIC } from '../generic/PushStatusResolver.js';
+import { RequireSystemUser } from '../directives/RequireSystemUser.js';
 
 @ObjectType()
 export class AIAgentRunResult {
@@ -297,18 +298,22 @@ export class RunAIAgentResolver extends ResolverBase {
         };
     }
 
-    @Mutation(() => AIAgentRunResult)
-    async RunAIAgent(
-        @Arg('agentId') agentId: string,
-        @Ctx() { userPayload }: { userPayload: UserPayload },
-        @Arg('messages') messagesJson: string,
-        @Arg('sessionId') sessionId: string,
-        @PubSub() pubSub: PubSubEngine,
-        @Arg('data', { nullable: true }) data?: string,
-        @Arg('templateData', { nullable: true }) templateData?: string,
-        @Arg('lastRunId', { nullable: true }) lastRunId?: string,
-        @Arg('autoPopulateLastRunPayload', { nullable: true }) autoPopulateLastRunPayload?: boolean,
-        @Arg('configurationId', { nullable: true }) configurationId?: string
+    /**
+     * Internal method that handles the core AI agent execution logic.
+     * This method is called by both the regular and system user resolvers.
+     * @private
+     */
+    private async executeAIAgent(
+        agentId: string,
+        userPayload: UserPayload,
+        messagesJson: string,
+        sessionId: string,
+        pubSub: PubSubEngine,
+        data?: string,
+        templateData?: string,
+        lastRunId?: string,
+        autoPopulateLastRunPayload?: boolean,
+        configurationId?: string
     ): Promise<AIAgentRunResult> {
         const startTime = Date.now();
         
@@ -441,5 +446,67 @@ export class RunAIAgentResolver extends ResolverBase {
         };
         this.PublishStreamingUpdate(pubSub, completeMsg, userPayload);
     }
+
+    /**
+     * Public mutation for regular users to run AI agents with authentication.
+     */
+    @Mutation(() => AIAgentRunResult)
+    async RunAIAgent(
+        @Arg('agentId') agentId: string,
+        @Ctx() { userPayload }: { userPayload: UserPayload },
+        @Arg('messages') messagesJson: string,
+        @Arg('sessionId') sessionId: string,
+        @PubSub() pubSub: PubSubEngine,
+        @Arg('data', { nullable: true }) data?: string,
+        @Arg('templateData', { nullable: true }) templateData?: string,
+        @Arg('lastRunId', { nullable: true }) lastRunId?: string,
+        @Arg('autoPopulateLastRunPayload', { nullable: true }) autoPopulateLastRunPayload?: boolean,
+        @Arg('configurationId', { nullable: true }) configurationId?: string
+    ): Promise<AIAgentRunResult> {
+        return this.executeAIAgent(
+            agentId,
+            userPayload,
+            messagesJson,
+            sessionId,
+            pubSub,
+            data,
+            templateData,
+            lastRunId,
+            autoPopulateLastRunPayload,
+            configurationId
+        );
+    }
+
+    /**
+     * System user query for running AI agents with elevated privileges.
+     * Requires the @RequireSystemUser decorator to ensure only system users can access.
+     */
+    @RequireSystemUser()
+    @Query(() => AIAgentRunResult)
+    async RunAIAgentSystemUser(
+        @Arg('agentId') agentId: string,
+        @Ctx() { userPayload }: { userPayload: UserPayload },
+        @Arg('messages') messagesJson: string,
+        @Arg('sessionId') sessionId: string,
+        @PubSub() pubSub: PubSubEngine,
+        @Arg('data', { nullable: true }) data?: string,
+        @Arg('templateData', { nullable: true }) templateData?: string,
+        @Arg('lastRunId', { nullable: true }) lastRunId?: string,
+        @Arg('autoPopulateLastRunPayload', { nullable: true }) autoPopulateLastRunPayload?: boolean,
+        @Arg('configurationId', { nullable: true }) configurationId?: string
+    ): Promise<AIAgentRunResult> {
+        return this.executeAIAgent(
+            agentId,
+            userPayload,
+            messagesJson,
+            sessionId,
+            pubSub,
+            data,
+            templateData,
+            lastRunId,
+            autoPopulateLastRunPayload,
+            configurationId
+        );
+    }
  
 }