@memberjunction/ai-agents 3.4.0 → 4.1.0

package/dist/PayloadFeedbackManager.js

@@ -1,11 +1,21 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PayloadFeedbackManager = void 0;
-const core_1 = require("@memberjunction/core");
-const aiengine_1 = require("@memberjunction/aiengine");
-const ai_prompts_1 = require("@memberjunction/ai-prompts");
-const ai_core_plus_1 = require("@memberjunction/ai-core-plus");
-class PayloadFeedbackManager {
+/**
+ * @fileoverview Feedback mechanism for validating suspicious payload changes with LLMs
+ *
+ * This module provides a standardized way to query AI agents about potentially
+ * unintended changes and receive structured yes/no confirmations.
+ *
+ * @module @memberjunction/ai-agents
+ * @author MemberJunction.com
+ * @since 3.1.0
+ */
+import { LogStatus, LogError } from '@memberjunction/core';
+import { AIEngine } from '@memberjunction/aiengine';
+import { AIPromptRunner } from '@memberjunction/ai-prompts';
+import { AIPromptParams } from '@memberjunction/ai-core-plus';
+/**
+ * Manages feedback collection for suspicious payload changes
+ */
+export class PayloadFeedbackManager {
     constructor(config) {
         this.config = {
             maxQuestionsPerBatch: 10,
@@ -13,6 +23,9 @@ class PayloadFeedbackManager {
             ...config
         };
     }
+    /**
+     * Generate feedback questions from warnings
+     */
     generateQuestions(warnings) {
         const questions = [];
         const feedbackWarnings = warnings.filter(w => w.requiresFeedback);
@@ -23,6 +36,9 @@ class PayloadFeedbackManager {
         }
         return questions;
     }
+    /**
+     * Create a structured question from a warning
+     */
     createQuestionFromWarning(warning, index) {
         let question = '';
         switch (warning.type) {
@@ -55,15 +71,25 @@ class PayloadFeedbackManager {
             }
         };
     }
+    /**
+     * Query the AI agent about suspicious changes using MemberJunction AI Prompts system.
+     *
+     * @param questions - Array of feedback questions to ask about payload changes
+     * @param conversationContext - Context from the conversation (for reference)
+     * @param contextUser - User context for the prompt execution
+     * @returns Array of responses indicating whether each change was intended
+     */
     async queryAgent(questions, conversationContext, contextUser) {
         if (questions.length === 0) {
             return [];
         }
+        // Find the payload feedback prompt
         const promptName = 'Payload Change Feedback Query';
-        const prompt = aiengine_1.AIEngine.Instance.Prompts.find(p => p.Name.trim().toLowerCase() === promptName.toLowerCase() &&
+        const prompt = AIEngine.Instance.Prompts.find(p => p.Name.trim().toLowerCase() === promptName.toLowerCase() &&
             p.Category?.trim().toLowerCase() === 'mj: system');
         if (!prompt) {
-            (0, core_1.LogStatus)(`PayloadFeedbackManager: Prompt "${promptName}" not found in MJ: System category. Accepting all changes by default.`);
+            // Fallback: accept all changes if prompt not configured
+            LogStatus(`PayloadFeedbackManager: Prompt "${promptName}" not found in MJ: System category. Accepting all changes by default.`);
             return questions.map(q => ({
                 questionId: q.id,
                 intended: true,
@@ -71,9 +97,11 @@ class PayloadFeedbackManager {
             }));
         }
         try {
+            // Build template parameters
             const templateData = this.buildFeedbackTemplateParams(questions);
-            const runner = new ai_prompts_1.AIPromptRunner();
-            const promptParams = new ai_core_plus_1.AIPromptParams();
+            // Execute the prompt
+            const runner = new AIPromptRunner();
+            const promptParams = new AIPromptParams();
             promptParams.prompt = prompt;
             promptParams.data = templateData;
             if (contextUser) {
@@ -81,17 +109,20 @@ class PayloadFeedbackManager {
             }
             const result = await runner.ExecutePrompt(promptParams);
             if (!result.success || !result.result?.responses) {
-                (0, core_1.LogError)('PayloadFeedbackManager: Failed to get valid response from feedback prompt', undefined, result.errorMessage);
+                LogError('PayloadFeedbackManager: Failed to get valid response from feedback prompt', undefined, result.errorMessage);
+                // Fallback to accepting all changes
                 return questions.map(q => ({
                     questionId: q.id,
                     intended: true,
                     explanation: 'Accepted by default (prompt execution failed)'
                 }));
             }
+            // Map LLM responses back to our format
             return this.mapLLMResponsesToFeedback(questions, result.result.responses);
         }
         catch (error) {
-            (0, core_1.LogError)('PayloadFeedbackManager: Error querying agent for feedback', undefined, error);
+            LogError('PayloadFeedbackManager: Error querying agent for feedback', undefined, error);
+            // Fallback to accepting all changes
             return questions.map(q => ({
                 questionId: q.id,
                 intended: true,
@@ -99,6 +130,9 @@ class PayloadFeedbackManager {
             }));
         }
     }
+    /**
+     * Map LLM responses back to PayloadFeedbackResponse format
+     */
     mapLLMResponsesToFeedback(questions, llmResponses) {
         return questions.map((q, index) => {
             const questionNumber = index + 1;
@@ -110,6 +144,7 @@ class PayloadFeedbackManager {
                     explanation: llmResponse.explanation
                 };
             }
+            // Default to intended if no matching response found
             return {
                 questionId: q.id,
                 intended: true,
@@ -117,6 +152,11 @@ class PayloadFeedbackManager {
             };
         });
     }
+    /**
+     * Build template parameters for the feedback prompt
+     *
+     * @todo This should prepare the data structure to pass to the stored prompt template
+     */
     buildFeedbackTemplateParams(questions) {
         return {
             questions: questions.map((q, i) => ({
@@ -130,6 +170,9 @@ class PayloadFeedbackManager {
             timestamp: new Date().toISOString()
         };
     }
+    /**
+     * Process feedback responses and determine final result
+     */
     processFeedback(questions, responses) {
         const acceptedChanges = [];
         const rejectedChanges = [];
@@ -152,23 +195,25 @@ class PayloadFeedbackManager {
             requiresRevision: rejectedChanges.length > 0
         };
     }
+    /**
+     * Log feedback results
+     */
     logFeedbackResults(result) {
         if (result.responses.length === 0) {
             return;
         }
-        (0, core_1.LogStatus)(`\n📋 Payload Change Feedback Results:`);
-        (0, core_1.LogStatus)(`   ✅ Accepted changes: ${result.acceptedChanges.length}`);
-        (0, core_1.LogStatus)(`   ❌ Rejected changes: ${result.rejectedChanges.length}`);
+        LogStatus(`\n📋 Payload Change Feedback Results:`);
+        LogStatus(`   ✅ Accepted changes: ${result.acceptedChanges.length}`);
+        LogStatus(`   ❌ Rejected changes: ${result.rejectedChanges.length}`);
         if (result.rejectedChanges.length > 0) {
-            (0, core_1.LogStatus)(`\n   Rejected change paths:`);
+            LogStatus(`\n   Rejected change paths:`);
             for (const path of result.rejectedChanges) {
-                (0, core_1.LogStatus)(`      - ${path}`);
+                LogStatus(`      - ${path}`);
             }
         }
         if (result.requiresRevision) {
-            (0, core_1.LogStatus)(`\n   ⚠️  Agent needs to revise the payload`);
+            LogStatus(`\n   ⚠️  Agent needs to revise the payload`);
         }
     }
 }
-exports.PayloadFeedbackManager = PayloadFeedbackManager;
 //# sourceMappingURL=PayloadFeedbackManager.js.map

package/dist/PayloadFeedbackManager.js.map

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

package/dist/PayloadManager.d.ts

@@ -1,15 +1,59 @@
+/**
+ * @fileoverview Payload management for hierarchical agent execution.
+ *
+ * This module provides functionality to control which parts of a payload
+ * are accessible to sub-agents (downstream) and which parts they can
+ * modify (upstream). It supports JSON path-based access control with
+ * wildcards and nested path support.
+ *
+ * ## Key Features:
+ * - Path-based access control for sub-agent data isolation
+ * - Operation-level permissions (add, update, delete) per path
+ * - Automatic detection of suspicious payload changes
+ * - Human-readable diff generation for audit trails
+ * - Configurable warning thresholds for content changes
+ *
+ * ## Path Syntax:
+ * - Exact paths: "customer.name"
+ * - Wildcards: "customer.*" (all properties under customer)
+ * - Array indices: "items[0].price" or "items[*].price"
+ * - Deep wildcards: "**.id" (all id fields at any depth)
+ * - Root wildcard: "*" (entire payload)
+ * - Operation control: "path:add,update" (specific operations only)
+ *
+ * ## Change Detection Rules:
+ * - Content truncation: Warns when text reduced by >70%
+ * - Key removal: Flags when non-empty keys are removed
+ * - Type changes: Detects object→primitive conversions
+ * - Pattern anomalies: Identifies placeholder replacements
+ *
+ * @module @memberjunction/ai-agents
+ * @author MemberJunction.com
+ * @since 3.0.0
+ */
 import { AgentPayloadChangeRequest } from '@memberjunction/ai-core-plus';
 import { DeepDiffResult } from '@memberjunction/global';
-import { PayloadAnalysisResult } from './PayloadChangeAnalyzer';
+import { PayloadAnalysisResult } from './PayloadChangeAnalyzer.js';
+/**
+ * Result of applying a payload change request with enhanced tracking
+ */
+/**
+ * Summary of payload change operations for audit trail storage
+ */
 export interface PayloadChangeResultSummary {
+    /** Operation counts */
     applied: {
         additions: number;
         updates: number;
         deletions: number;
     };
+    /** Warning messages */
     warnings: string[];
+    /** Whether feedback is required */
     requiresFeedback: boolean;
+    /** Timestamp of the operation */
     timestamp: Date | string;
+    /** Payload validation tracking */
     payloadValidation?: {
         selfWriteViolations?: {
             deniedOperations: Array<{
@@ -36,6 +80,7 @@ export interface PayloadChangeResultSummary {
             timestamp: string;
         };
     };
+    /** Analysis summary */
     analysis?: {
         totalWarnings: number;
         warningsByType: Record<string, number>;
@@ -47,6 +92,7 @@ export interface PayloadChangeResultSummary {
             message: string;
         }>;
     };
+    /** Diff summary */
     diffSummary?: {
         added: number;
         removed: number;
@@ -55,17 +101,25 @@ export interface PayloadChangeResultSummary {
     };
 }
 export interface PayloadManagerResult<P = any> {
+    /** The resulting payload after changes */
     result: P;
+    /** Counts of applied operations */
     applied: {
         additions: number;
         updates: number;
         deletions: number;
     };
+    /** Basic warnings from the change process */
     warnings: string[];
+    /** Detailed analysis of suspicious changes */
     analysis?: PayloadAnalysisResult;
+    /** Diff between original and result payload */
     diff?: DeepDiffResult;
+    /** Whether feedback is required from the agent */
     requiresFeedback?: boolean;
+    /** Timestamp of the operation */
     timestamp: Date;
+    /** Blocked operations with detailed tracking */
     blockedOperations?: Array<{
         path: string;
         operation: 'add' | 'update' | 'delete';
@@ -75,23 +129,167 @@ export interface PayloadManagerResult<P = any> {
         timestamp: string;
     }>;
 }
+/**
+ * Manages payload access control for agent hierarchies.
+ *
+ * This class handles extracting specific paths from payloads when sending
+ * data downstream to sub-agents, and merging results back upstream while
+ * respecting write permissions.
+ *
+ * Path syntax supports:
+ * - Exact paths: "customer.name"
+ * - Wildcards: "customer.*" (all properties under customer)
+ * - Array indices: "items[0].price" or "items[*].price"
+ * - Deep wildcards: "**.id" (all id fields at any depth)
+ * - Root wildcard: "*" (entire payload)
+ */
 export declare class PayloadManager {
+    /**
+     * Extracts only the allowed paths from a payload for downstream transmission.
+     *
+     * @param fullPayload The complete payload object
+     * @param downstreamPaths Array of path patterns defining what to extract
+     * @returns A new object containing only the allowed paths
+     *
+     * @example
+     * ```typescript
+     * const payload = { customer: { id: 1, name: 'John', secret: 'xxx' }, order: { id: 2 } };
+     * const paths = ['customer.id', 'customer.name', 'order.*'];
+     * const result = extractDownstreamPayload(payload, paths);
+     * // Returns: { customer: { id: 1, name: 'John' }, order: { id: 2 } }
+     * ```
+     */
     extractDownstreamPayload<P = any>(subAgentName: string, fullPayload: P | null | undefined, downstreamPaths: string[]): Partial<P> | null;
+    /**
+     * Merges sub-agent results back into the parent payload, respecting write permissions.
+     *
+     * @param parentPayload The original parent payload
+     * @param subAgentPayload The payload returned by the sub-agent
+     * @param upstreamPaths Array of path patterns the sub-agent is allowed to write
+     * @returns A new merged payload object
+     *
+     * @example
+     * ```typescript
+     * const parent = { customer: { id: 1 }, analysis: { sentiment: null } };
+     * const subResult = { customer: { id: 2 }, analysis: { sentiment: 'positive', score: 0.9 } };
+     * const writePaths = ['analysis.*'];
+     * const merged = mergeUpstreamPayload(parent, subResult, writePaths);
+     * // Returns: { customer: { id: 1 }, analysis: { sentiment: 'positive', score: 0.9 } }
+     * ```
+     */
     mergeUpstreamPayload<P = any>(subAgentName: string, parentPayload: P | null | undefined, subAgentPayload: Partial<P> | null | undefined, upstreamPaths: string[], verbose?: boolean): PayloadManagerResult<P>;
+    /**
+     * Extracts a path pattern from source object into destination.
+     *
+     * @private
+     */
     private extractPathPattern;
+    /**
+     * Recursively extracts paths based on parsed path parts.
+     *
+     * @private
+     */
     private extractPath;
+    /**
+     * Handles array path extraction (e.g., items[0] or items[*]).
+     *
+     * @private
+     */
     private extractArrayPath;
+    /**
+     * Handles deep wildcard extraction (e.g., **.id).
+     *
+     * @private
+     */
     private extractDeepWildcard;
+    /**
+     * Merges allowed paths from sub-agent payload into result.
+     *
+     * @private
+     */
     private mergeAllowedPaths;
+    /**
+     * Count changes between two payloads for tracking operations
+     *
+     * @private
+     */
     private countChanges;
+    /**
+     * Groups unauthorized changes by their root path for cleaner display.
+     *
+     * @private
+     */
     private groupUnauthorizedChanges;
+    /**
+     * Formats a value for display in warning messages.
+     *
+     * @private
+     */
     private formatValue;
+    /**
+     * Gets all leaf paths from an object.
+     *
+     * @private
+     */
     private getAllPaths;
+    /**
+     * Recursively cleans up empty objects from arrays after merge operations.
+     * This is necessary because property-level deletions can leave empty object shells in arrays.
+     *
+     * @private
+     */
     private cleanupEmptyArrayElements;
+    /**
+     * Checks if a path matches any of the allowed patterns.
+     *
+     * @private
+     */
     private isPathAllowed;
+    /**
+     * Checks if a specific operation is allowed for a path.
+     *
+     * @param actualPath The actual path to check
+     * @param operation The operation to check
+     * @param allowedPatterns Array of allowed patterns with optional operations
+     * @returns True if the operation is allowed on this path
+     */
     private isOperationAllowedForPath;
+    /**
+     * Parses a path string into parts, handling array notation.
+     *
+     * @private
+     */
     private parsePathParts;
+    /**
+     * Deep merges two objects, with source overriding destination.
+     *
+     * This method preserves existing nested properties in the destination while
+     * adding or updating properties from the source. It handles nested objects
+     * recursively, ensuring that partial updates don't wipe out existing data.
+     *
+     * @example
+     * ```typescript
+     * const dest = { decision: { Y: 4, Z: 2 } };
+     * const src = { decision: { x: "string" } };
+     * const result = deepMerge(dest, src);
+     * // Returns: { decision: { x: "string", Y: 4, Z: 2 } }
+     * ```
+     *
+     * @param destination The target object to merge into
+     * @param source The source object to merge from
+     * @returns A new merged object with all properties from both objects
+     *
+     * @public
+     */
     deepMerge<T = any>(destination: T | null | undefined, source: Partial<T> | null | undefined): T;
+    /**
+     * Applies an AgentPayloadChangeRequest to a payload
+     *
+     * @param originalPayload The original payload to apply changes to
+     * @param changeRequest The change request from the AI agent
+     * @param options Configuration options for the operation
+     * @returns Result object with the modified payload, operation counts, and any warnings
+     */
     applyAgentChangeRequest<P = any>(originalPayload: P, changeRequest: AgentPayloadChangeRequest<any>, options?: {
         validateChanges?: boolean;
         logChanges?: boolean;
@@ -101,20 +299,107 @@ export declare class PayloadManager {
         allowedPaths?: string[];
         verbose?: boolean;
     }): PayloadManagerResult<P>;
+    /**
+     * Process a change request recursively through the payload structure
+     */
     private processChangeRequest;
+    /**
+     * Process changes for array elements with support for deep merging object elements.
+     *
+     * For arrays containing objects, updates are merged deeply rather than replacing
+     * the entire element. This preserves existing properties while updating only the
+     * specified fields.
+     *
+     * Example:
+     * Original: [{id: 1, name: "Test", value: 100}]
+     * Update: [{value: 200}]
+     * Result: [{id: 1, name: "Test", value: 200}]
+     *
+     * Arrays of primitives still use replacement behavior for backwards compatibility.
+     */
     private processArrayChanges;
+    /**
+     * Process changes for object properties
+     */
     private processObjectChanges;
+    /**
+     * Process a single key change (add, update, or delete)
+     */
     private processKeyChange;
+    /**
+     * Get all unique keys from change request for a given path
+     */
     private getChangeKeys;
+    /**
+     * Check if a value is significant (not empty object or undefined)
+     */
     private isSignificantValue;
+    /**
+     * Log a summary of changes applied
+     */
     private logChangesSummary;
+    /**
+     * Apply a change request to a sub-agent payload with upstream guardrails
+     *
+     * This method first applies the change request, then enforces upstream path restrictions
+     * to ensure the sub-agent only modifies allowed paths.
+     */
     applySubAgentChangeRequest<P = any>(parentPayload: P, changeRequest: AgentPayloadChangeRequest<P>, upstreamPaths: string[], subAgentName: string): PayloadManagerResult<P> & {
         blocked: number;
     };
+    /**
+     * Count how many changes were blocked by guardrails
+     */
     private countBlockedChanges;
+    /**
+     * Applies a payload scope transformation to extract only the scoped portion.
+     *
+     * @param payload The full payload to scope
+     * @param scopePath The scope path (e.g., "/functionalRequirements" or "/PropA/SubProp1")
+     * @returns The scoped portion of the payload
+     *
+     * @example
+     * ```typescript
+     * const payload = { functionalRequirements: { feature1: "..." }, technicalDesign: { ... } };
+     * const scoped = applyPayloadScope(payload, "/functionalRequirements");
+     * // Returns: { feature1: "..." }
+     * ```
+     */
     applyPayloadScope<P = any>(payload: P, scopePath: string): any | null;
+    /**
+     * Reverses a payload scope transformation by wrapping the scoped content back into the full structure.
+     *
+     * @param scopedPayload The scoped payload to wrap
+     * @param scopePath The scope path used for extraction
+     * @returns A full payload structure with the scoped content at the correct path
+     *
+     * @example
+     * ```typescript
+     * const scoped = { feature1: "updated" };
+     * const full = reversePayloadScope(scoped, "/functionalRequirements");
+     * // Returns: { functionalRequirements: { feature1: "updated" } }
+     * ```
+     */
     reversePayloadScope<P = any>(scopedPayload: unknown, scopePath: string): P;
+    /**
+     * Transforms paths in a change request to account for payload scoping.
+     * Prepends the scope path to all paths in the change request.
+     *
+     * @param changeRequest The change request with paths relative to the scoped view
+     * @param scopePath The scope path to prepend
+     * @returns A new change request with transformed paths
+     *
+     * @example
+     * ```typescript
+     * const request = { updateElements: { "field1": "value" } };
+     * const transformed = transformChangeRequestPaths(request, "/functionalRequirements");
+     * // Returns: { updateElements: { "functionalRequirements.field1": "value" } }
+     * ```
+     */
     transformChangeRequestPaths<P = any>(changeRequest: AgentPayloadChangeRequest<P>, scopePath: string): AgentPayloadChangeRequest<P>;
+    /**
+     * Helper to determine if a value is a leaf value (not a path structure)
+     */
     private isLeafValue;
 }
 //# sourceMappingURL=PayloadManager.d.ts.map

package/dist/PayloadManager.d.ts.map

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