@memberjunction/server 2.92.0 → 2.94.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,6 +428,8 @@ export declare class AIAgentRun_ {
     Data?: string;
     Verbose?: boolean;
     EffortLevel?: number;
+    RunName?: string;
+    Comments?: string;
     Agent?: string;
     Conversation?: string;
     User?: string;
@@ -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 {
@@ -9658,6 +9664,7 @@ export declare class ComponentLibrary_ {
     _mj__UpdatedAt: Date;
     Status: string;
     LintRules?: string;
+    Dependencies?: string;
     MJ_ComponentLibraryLinks_LibraryIDArray: ComponentLibraryLink_[];
 }
 export declare class CreateComponentLibraryInput {
@@ -9672,6 +9679,7 @@ export declare class CreateComponentLibraryInput {
     Description: string | null;
     Status?: string;
     LintRules: string | null;
+    Dependencies: string | null;
 }
 export declare class UpdateComponentLibraryInput {
     ID: string;
@@ -9685,6 +9693,7 @@ export declare class UpdateComponentLibraryInput {
     Description?: string | null;
     Status?: string;
     LintRules?: string | null;
+    Dependencies?: string | null;
     OldValues___?: KeyValuePairInput[];
 }
 export declare class RunComponentLibraryViewResult {
@@ -10544,6 +10553,8 @@ export declare class AIPromptRun_ {
     CompletionTime?: number;
     ModelSpecificResponseDetails?: string;
     EffortLevel?: number;
+    RunName?: string;
+    Comments?: string;
     Prompt: string;
     Model: string;
     Vendor: string;
@@ -10635,6 +10646,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 +10729,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 +10774,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 +10797,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 +10819,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 +10837,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>;