@memberjunction/server 2.92.0 → 2.93.0

package/README.md

@@ -13,7 +13,7 @@ The `@memberjunction/server` library provides a comprehensive API server for Mem
 - **Real-time Support**: WebSocket subscriptions for GraphQL
 - **Compression**: Built-in response compression for better performance
 - **Extensible Architecture**: Support for custom resolvers and entity subclasses
-- **AI Integration**: Built-in support for AI operations and learning cycle scheduling
+- **AI Integration**: Built-in support for AI operations, prompts, agents, and embeddings
 - **Security Features**: Entity-level and schema-level access control for REST API
 - **SQL Logging**: Runtime SQL logging configuration and session management for debugging
 
@@ -336,7 +336,45 @@ scheduler.start(60); // Run every 60 minutes
 
 ### AI Resolvers
 
-- `RunAIPromptResolver`: Execute AI prompts
+The server includes comprehensive AI resolvers for various AI operations:
+
+#### RunAIPromptResolver
+Handles AI prompt execution with multiple methods:
+
+- `RunAIPrompt`: Execute stored AI prompts with full parameter support
+  - Supports temperature, topP, topK, and other model parameters
+  - Handles conversation messages and system prompt overrides
+  - Returns parsed results, token usage, and execution metadata
+
+- `ExecuteSimplePrompt`: Execute ad-hoc prompts without stored configuration
+  - Direct system prompt and message execution
+  - Smart model selection based on preferences or power level
+  - Automatic JSON extraction from responses
+  - Available for both regular users and system users
+
+- `EmbedText`: Generate text embeddings using local models
+  - Batch processing support for multiple texts
+  - Model size selection (small/medium)
+  - Returns vector dimensions and model information
+  - Available for both regular users and system users
+
+#### RunAIAgentResolver
+- `RunAIAgent`: Execute AI agents for conversational interactions
+  - Session management for conversation context
+  - Streaming support for real-time responses
+  - Progress tracking and partial results
+  - Available for both regular users and system users
+
+#### System User Variants
+All AI operations have system user variants (queries) that use the `@RequireSystemUser` decorator:
+- `RunAIPromptSystemUser`
+- `ExecuteSimplePromptSystemUser`
+- `EmbedTextSystemUser`
+- `RunAIAgentSystemUser`
+
+These allow server-to-server operations with elevated privileges.
+
+#### AskSkipResolver
 - `AskSkipResolver`: Handle Skip AI queries
 
 ### SQL Logging Resolver

package/dist/generated/generated.d.ts

@@ -428,14 +428,16 @@ export declare class AIAgentRun_ {
     Data?: string;
     Verbose?: boolean;
     EffortLevel?: number;
+    RunName?: string;
+    Comments?: string;
     Agent?: string;
     Conversation?: string;
     User?: string;
     Configuration?: string;
     OverrideModel?: string;
     OverrideVendor?: string;
-    MJ_AIAgentRunSteps_AgentRunIDArray: AIAgentRunStep_[];
     MJ_AIAgentRuns_ParentRunIDArray: AIAgentRun_[];
+    MJ_AIAgentRunSteps_AgentRunIDArray: AIAgentRunStep_[];
     MJ_AIPromptRuns_AgentRunIDArray: AIPromptRun_[];
 }
 export declare class CreateAIAgentRunInput {
@@ -474,6 +476,8 @@ export declare class CreateAIAgentRunInput {
     Data: string | null;
     Verbose?: boolean | null;
     EffortLevel: number | null;
+    RunName: string | null;
+    Comments: string | null;
 }
 export declare class UpdateAIAgentRunInput {
     ID: string;
@@ -511,6 +515,8 @@ export declare class UpdateAIAgentRunInput {
     Data?: string | null;
     Verbose?: boolean | null;
     EffortLevel?: number | null;
+    RunName?: string | null;
+    Comments?: string | null;
     OldValues___?: KeyValuePairInput[];
 }
 export declare class RunAIAgentRunViewResult {
@@ -527,8 +533,8 @@ export declare class AIAgentRunResolver extends ResolverBase {
     RunAIAgentRunViewByName(input: RunViewByNameInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<import("@memberjunction/core").RunViewResult<any>>;
     RunAIAgentRunDynamicView(input: RunDynamicViewInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<import("@memberjunction/core").RunViewResult<any>>;
     AIAgentRun(ID: string, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<AIAgentRun_ | null>;
-    MJ_AIAgentRunSteps_AgentRunIDArray(aiagentrun_: AIAgentRun_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJ_AIAgentRuns_ParentRunIDArray(aiagentrun_: AIAgentRun_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
+    MJ_AIAgentRunSteps_AgentRunIDArray(aiagentrun_: AIAgentRun_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJ_AIPromptRuns_AgentRunIDArray(aiagentrun_: AIAgentRun_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     CreateAIAgentRun(input: CreateAIAgentRunInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
     UpdateAIAgentRun(input: UpdateAIAgentRunInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
@@ -598,9 +604,9 @@ export declare class AIConfiguration_ {
     DefaultPromptForContextSummarization?: string;
     MJ_AIConfigurationParams_ConfigurationIDArray: AIConfigurationParam_[];
     MJ_AIAgentPrompts_ConfigurationIDArray: AIAgentPrompt_[];
+    MJ_AIPromptRuns_ConfigurationIDArray: AIPromptRun_[];
     MJ_AIPromptModels_ConfigurationIDArray: AIPromptModel_[];
     AIResultCache_ConfigurationIDArray: AIResultCache_[];
-    MJ_AIPromptRuns_ConfigurationIDArray: AIPromptRun_[];
     MJ_AIAgentRuns_ConfigurationIDArray: AIAgentRun_[];
 }
 export declare class CreateAIConfigurationInput {
@@ -638,9 +644,9 @@ export declare class AIConfigurationResolver extends ResolverBase {
     AIConfiguration(ID: string, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<AIConfiguration_ | null>;
     MJ_AIConfigurationParams_ConfigurationIDArray(aiconfiguration_: AIConfiguration_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJ_AIAgentPrompts_ConfigurationIDArray(aiconfiguration_: AIConfiguration_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
+    MJ_AIPromptRuns_ConfigurationIDArray(aiconfiguration_: AIConfiguration_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJ_AIPromptModels_ConfigurationIDArray(aiconfiguration_: AIConfiguration_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     AIResultCache_ConfigurationIDArray(aiconfiguration_: AIConfiguration_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
-    MJ_AIPromptRuns_ConfigurationIDArray(aiconfiguration_: AIConfiguration_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJ_AIAgentRuns_ConfigurationIDArray(aiconfiguration_: AIConfiguration_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     CreateAIConfiguration(input: CreateAIConfigurationInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
     UpdateAIConfiguration(input: UpdateAIConfigurationInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
@@ -1290,8 +1296,8 @@ export declare class AIPrompt_ {
     MJ_AIAgentTypes_SystemPromptIDArray: AIAgentType_[];
     MJ_AIConfigurations_DefaultPromptForContextSummarizationIDArray: AIConfiguration_[];
     AIPrompts_ResultSelectorPromptIDArray: AIPrompt_[];
-    MJ_AIPromptModels_PromptIDArray: AIPromptModel_[];
     MJ_AIAgentPrompts_PromptIDArray: AIAgentPrompt_[];
+    MJ_AIPromptModels_PromptIDArray: AIPromptModel_[];
     MJ_AIAgentSteps_PromptIDArray: AIAgentStep_[];
     MJ_AIPromptRuns_PromptIDArray: AIPromptRun_[];
     AIAgents_ContextCompressionPromptIDArray: AIAgent_[];
@@ -1418,8 +1424,8 @@ export declare class AIPromptResolver extends ResolverBase {
     MJ_AIAgentTypes_SystemPromptIDArray(aiprompt_: AIPrompt_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJ_AIConfigurations_DefaultPromptForContextSummarizationIDArray(aiprompt_: AIPrompt_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     AIPrompts_ResultSelectorPromptIDArray(aiprompt_: AIPrompt_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
-    MJ_AIPromptModels_PromptIDArray(aiprompt_: AIPrompt_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJ_AIAgentPrompts_PromptIDArray(aiprompt_: AIPrompt_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
+    MJ_AIPromptModels_PromptIDArray(aiprompt_: AIPrompt_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJ_AIAgentSteps_PromptIDArray(aiprompt_: AIPrompt_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     MJ_AIPromptRuns_PromptIDArray(aiprompt_: AIPrompt_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     AIAgents_ContextCompressionPromptIDArray(aiprompt_: AIPrompt_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
@@ -10544,6 +10550,8 @@ export declare class AIPromptRun_ {
     CompletionTime?: number;
     ModelSpecificResponseDetails?: string;
     EffortLevel?: number;
+    RunName?: string;
+    Comments?: string;
     Prompt: string;
     Model: string;
     Vendor: string;
@@ -10635,6 +10643,8 @@ export declare class CreateAIPromptRunInput {
     CompletionTime: number | null;
     ModelSpecificResponseDetails: string | null;
     EffortLevel: number | null;
+    RunName: string | null;
+    Comments: string | null;
 }
 export declare class UpdateAIPromptRunInput {
     ID: string;
@@ -10716,6 +10726,8 @@ export declare class UpdateAIPromptRunInput {
     CompletionTime?: number | null;
     ModelSpecificResponseDetails?: string | null;
     EffortLevel?: number | null;
+    RunName?: string | null;
+    Comments?: string | null;
     OldValues___?: KeyValuePairInput[];
 }
 export declare class RunAIPromptRunViewResult {
@@ -10759,6 +10771,9 @@ export declare class AIAgentRunStep_ {
     PayloadAtEnd?: string;
     FinalPayloadValidationResult?: string;
     FinalPayloadValidationMessages?: string;
+    ParentID?: string;
+    Comments?: string;
+    MJ_AIAgentRunSteps_ParentIDArray: AIAgentRunStep_[];
 }
 export declare class CreateAIAgentRunStepInput {
     ID?: string;
@@ -10779,6 +10794,8 @@ export declare class CreateAIAgentRunStepInput {
     PayloadAtEnd: string | null;
     FinalPayloadValidationResult: string | null;
     FinalPayloadValidationMessages: string | null;
+    ParentID: string | null;
+    Comments: string | null;
 }
 export declare class UpdateAIAgentRunStepInput {
     ID: string;
@@ -10799,6 +10816,8 @@ export declare class UpdateAIAgentRunStepInput {
     PayloadAtEnd?: string | null;
     FinalPayloadValidationResult?: string | null;
     FinalPayloadValidationMessages?: string | null;
+    ParentID?: string | null;
+    Comments?: string | null;
     OldValues___?: KeyValuePairInput[];
 }
 export declare class RunAIAgentRunStepViewResult {
@@ -10815,6 +10834,7 @@ export declare class AIAgentRunStepResolver extends ResolverBase {
     RunAIAgentRunStepViewByName(input: RunViewByNameInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<import("@memberjunction/core").RunViewResult<any>>;
     RunAIAgentRunStepDynamicView(input: RunDynamicViewInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<import("@memberjunction/core").RunViewResult<any>>;
     AIAgentRunStep(ID: string, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<AIAgentRunStep_ | null>;
+    MJ_AIAgentRunSteps_ParentIDArray(aiagentrunstep_: AIAgentRunStep_, { dataSources, userPayload, providers }: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     CreateAIAgentRunStep(input: CreateAIAgentRunStepInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
     UpdateAIAgentRunStep(input: UpdateAIAgentRunStepInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;
     DeleteAIAgentRunStep(ID: string, options: DeleteOptionsInput, { providers, userPayload }: AppContext, pubSub: PubSubEngine): Promise<any>;