@memberjunction/ai-agents 2.60.0 → 2.62.0

package/dist/PayloadDiff.js

@@ -0,0 +1,232 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PayloadDiffer = exports.DiffChangeType = void 0;
+const _ = __importStar(require("lodash"));
+var DiffChangeType;
+(function (DiffChangeType) {
+    DiffChangeType["Added"] = "added";
+    DiffChangeType["Removed"] = "removed";
+    DiffChangeType["Modified"] = "modified";
+    DiffChangeType["Unchanged"] = "unchanged";
+})(DiffChangeType || (exports.DiffChangeType = DiffChangeType = {}));
+class PayloadDiffer {
+    constructor(config) {
+        this.config = {
+            includeUnchanged: false,
+            maxDepth: 10,
+            maxStringLength: 100,
+            includeArrayIndices: true,
+            ...config
+        };
+    }
+    diff(oldPayload, newPayload) {
+        const changes = [];
+        this.generateDiff(oldPayload, newPayload, [], changes, 0);
+        changes.sort((a, b) => a.path.localeCompare(b.path));
+        const summary = {
+            added: changes.filter(c => c.type === DiffChangeType.Added).length,
+            removed: changes.filter(c => c.type === DiffChangeType.Removed).length,
+            modified: changes.filter(c => c.type === DiffChangeType.Modified).length,
+            unchanged: changes.filter(c => c.type === DiffChangeType.Unchanged).length,
+            totalPaths: changes.length
+        };
+        const formatted = this.formatDiff(changes, summary);
+        return {
+            changes,
+            summary,
+            formatted
+        };
+    }
+    generateDiff(oldValue, newValue, path, changes, depth) {
+        if (depth > this.config.maxDepth) {
+            return;
+        }
+        const pathStr = path.join('.');
+        if (oldValue === newValue) {
+            if (this.config.includeUnchanged) {
+                changes.push({
+                    path: pathStr || 'root',
+                    type: DiffChangeType.Unchanged,
+                    oldValue,
+                    newValue,
+                    description: 'No change'
+                });
+            }
+        }
+        else if (oldValue === undefined && newValue !== undefined) {
+            changes.push({
+                path: pathStr || 'root',
+                type: DiffChangeType.Added,
+                newValue,
+                description: this.describeValue(newValue, 'Added')
+            });
+        }
+        else if (oldValue !== undefined && newValue === undefined) {
+            changes.push({
+                path: pathStr || 'root',
+                type: DiffChangeType.Removed,
+                oldValue,
+                description: this.describeValue(oldValue, 'Removed')
+            });
+        }
+        else if (Array.isArray(oldValue) && Array.isArray(newValue)) {
+            this.diffArrays(oldValue, newValue, path, changes, depth);
+        }
+        else if (_.isObject(oldValue) && _.isObject(newValue)) {
+            this.diffObjects(oldValue, newValue, path, changes, depth);
+        }
+        else {
+            changes.push({
+                path: pathStr || 'root',
+                type: DiffChangeType.Modified,
+                oldValue,
+                newValue,
+                description: `Changed from ${this.describeValue(oldValue)} to ${this.describeValue(newValue)}`
+            });
+        }
+    }
+    diffArrays(oldArray, newArray, path, changes, depth) {
+        const pathStr = path.join('.');
+        if (oldArray.length !== newArray.length) {
+            changes.push({
+                path: pathStr || 'root',
+                type: DiffChangeType.Modified,
+                oldValue: `Array[${oldArray.length}]`,
+                newValue: `Array[${newArray.length}]`,
+                description: `Array length changed from ${oldArray.length} to ${newArray.length}`
+            });
+        }
+        const maxLength = Math.max(oldArray.length, newArray.length);
+        for (let i = 0; i < maxLength; i++) {
+            const elementPath = this.config.includeArrayIndices
+                ? [...path, `[${i}]`]
+                : path;
+            if (i < oldArray.length && i < newArray.length) {
+                this.generateDiff(oldArray[i], newArray[i], elementPath, changes, depth + 1);
+            }
+            else if (i < oldArray.length) {
+                changes.push({
+                    path: elementPath.join('.'),
+                    type: DiffChangeType.Removed,
+                    oldValue: oldArray[i],
+                    description: `Removed array element at index ${i}`
+                });
+            }
+            else {
+                changes.push({
+                    path: elementPath.join('.'),
+                    type: DiffChangeType.Added,
+                    newValue: newArray[i],
+                    description: `Added array element at index ${i}`
+                });
+            }
+        }
+    }
+    diffObjects(oldObj, newObj, path, changes, depth) {
+        const allKeys = new Set([...Object.keys(oldObj), ...Object.keys(newObj)]);
+        for (const key of allKeys) {
+            const keyPath = [...path, key];
+            if (!(key in oldObj)) {
+                changes.push({
+                    path: keyPath.join('.'),
+                    type: DiffChangeType.Added,
+                    newValue: newObj[key],
+                    description: `Added property '${key}'`
+                });
+            }
+            else if (!(key in newObj)) {
+                changes.push({
+                    path: keyPath.join('.'),
+                    type: DiffChangeType.Removed,
+                    oldValue: oldObj[key],
+                    description: `Removed property '${key}'`
+                });
+            }
+            else {
+                this.generateDiff(oldObj[key], newObj[key], keyPath, changes, depth + 1);
+            }
+        }
+    }
+    describeValue(value, prefix) {
+        const type = Array.isArray(value) ? 'array' : typeof value;
+        switch (type) {
+            case 'string':
+                const str = value.length > this.config.maxStringLength
+                    ? value.substring(0, this.config.maxStringLength) + '...'
+                    : value;
+                return prefix ? `${prefix} string: "${str}"` : `"${str}"`;
+            case 'number':
+            case 'boolean':
+                return prefix ? `${prefix} ${type}: ${value}` : String(value);
+            case 'array':
+                return prefix ? `${prefix} array[${value.length}]` : `array[${value.length}]`;
+            case 'object':
+                if (value === null) {
+                    return prefix ? `${prefix} null` : 'null';
+                }
+                const keys = Object.keys(value).length;
+                return prefix ? `${prefix} object{${keys} keys}` : `object{${keys} keys}`;
+            default:
+                return prefix ? `${prefix} ${type}` : type;
+        }
+    }
+    formatDiff(changes, summary) {
+        const lines = [
+            '=== Payload Diff ===',
+            `Summary: +${summary.added} -${summary.removed} ~${summary.modified}`,
+            ''
+        ];
+        const grouped = _.groupBy(changes, 'type');
+        if (grouped[DiffChangeType.Added]?.length > 0) {
+            lines.push('Added:');
+            for (const change of grouped[DiffChangeType.Added]) {
+                lines.push(`  + ${change.path}: ${change.description}`);
+            }
+            lines.push('');
+        }
+        if (grouped[DiffChangeType.Removed]?.length > 0) {
+            lines.push('Removed:');
+            for (const change of grouped[DiffChangeType.Removed]) {
+                lines.push(`  - ${change.path}: ${change.description}`);
+            }
+            lines.push('');
+        }
+        if (grouped[DiffChangeType.Modified]?.length > 0) {
+            lines.push('Modified:');
+            for (const change of grouped[DiffChangeType.Modified]) {
+                lines.push(`  ~ ${change.path}: ${change.description}`);
+            }
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    generateCompactSummary(diff) {
+        const { summary } = diff;
+        return `+${summary.added} -${summary.removed} ~${summary.modified} (${summary.totalPaths} total paths)`;
+    }
+}
+exports.PayloadDiffer = PayloadDiffer;
+//# sourceMappingURL=PayloadDiff.js.map

package/dist/PayloadDiff.js.map

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

package/dist/PayloadFeedbackManager.d.ts

@@ -0,0 +1,39 @@
+import { PayloadWarning } from './PayloadChangeAnalyzer';
+export interface PayloadFeedbackQuestion {
+    id: string;
+    question: string;
+    warning: PayloadWarning;
+    context?: {
+        path: string;
+        changeType: string;
+        details: any;
+    };
+}
+export interface PayloadFeedbackResponse {
+    questionId: string;
+    intended: boolean;
+    explanation?: string;
+}
+export interface PayloadFeedbackResult {
+    questions: PayloadFeedbackQuestion[];
+    responses: PayloadFeedbackResponse[];
+    acceptedChanges: string[];
+    rejectedChanges: string[];
+    requiresRevision: boolean;
+}
+export interface PayloadFeedbackConfig {
+    feedbackPromptId?: string;
+    maxQuestionsPerBatch?: number;
+    temperature?: number;
+}
+export declare class PayloadFeedbackManager {
+    private config;
+    constructor(config?: PayloadFeedbackConfig);
+    generateQuestions(warnings: PayloadWarning[]): PayloadFeedbackQuestion[];
+    private createQuestionFromWarning;
+    queryAgent(questions: PayloadFeedbackQuestion[], conversationContext: any): Promise<PayloadFeedbackResponse[]>;
+    private buildFeedbackTemplateParams;
+    processFeedback(questions: PayloadFeedbackQuestion[], responses: PayloadFeedbackResponse[]): PayloadFeedbackResult;
+    logFeedbackResults(result: PayloadFeedbackResult): void;
+}
+//# sourceMappingURL=PayloadFeedbackManager.d.ts.map

package/dist/PayloadFeedbackManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PayloadFeedbackManager.d.ts","sourceRoot":"","sources":["../src/PayloadFeedbackManager.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAKzD,MAAM,WAAW,uBAAuB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,GAAG,CAAC;KAChB,CAAC;CACL;AAKD,MAAM,WAAW,uBAAuB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAKD,MAAM,WAAW,qBAAqB;IAClC,SAAS,EAAE,uBAAuB,EAAE,CAAC;IACrC,SAAS,EAAE,uBAAuB,EAAE,CAAC;IACrC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;CAC7B;AAKD,MAAM,WAAW,qBAAqB;IAElC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAKD,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,CAAC,EAAE,qBAAqB;IAWnC,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,uBAAuB,EAAE;IAgB/E,OAAO,CAAC,yBAAyB;IA6CpB,UAAU,CACnB,SAAS,EAAE,uBAAuB,EAAE,EACpC,mBAAmB,EAAE,GAAG,GACzB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAqBrC,OAAO,CAAC,2BAA2B;IAiB5B,eAAe,CAClB,SAAS,EAAE,uBAAuB,EAAE,EACpC,SAAS,EAAE,uBAAuB,EAAE,GACrC,qBAAqB;IA2BjB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI;CAoBjE"}

package/dist/PayloadFeedbackManager.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PayloadFeedbackManager = void 0;
+const core_1 = require("@memberjunction/core");
+class PayloadFeedbackManager {
+    constructor(config) {
+        this.config = {
+            maxQuestionsPerBatch: 10,
+            temperature: 0.1,
+            ...config
+        };
+    }
+    generateQuestions(warnings) {
+        const questions = [];
+        const feedbackWarnings = warnings.filter(w => w.requiresFeedback);
+        for (let i = 0; i < feedbackWarnings.length; i++) {
+            const warning = feedbackWarnings[i];
+            const question = this.createQuestionFromWarning(warning, i);
+            questions.push(question);
+        }
+        return questions;
+    }
+    createQuestionFromWarning(warning, index) {
+        let question = '';
+        switch (warning.type) {
+            case 'content_truncation':
+                question = `Did you intend to reduce the content at "${warning.path}" from ${warning.details.originalLength} to ${warning.details.newLength} characters (${warning.details.reductionPercentage.toFixed(1)}% reduction)?`;
+                break;
+            case 'key_removal':
+                question = `Did you intend to remove the non-empty key(s) at "${warning.path}": ${warning.details.removedKeys.join(', ')}?`;
+                break;
+            case 'type_change':
+                question = `Did you intend to change the type at "${warning.path}" from ${warning.details.originalType} to ${warning.details.newType}?`;
+                break;
+            case 'pattern_anomaly':
+                question = `Did you intend the following change at "${warning.path}": ${warning.message}?`;
+                break;
+            default:
+                question = `Did you intend the change at "${warning.path}": ${warning.message}?`;
+        }
+        return {
+            id: `feedback_${index}_${Date.now()}`,
+            question,
+            warning,
+            context: {
+                path: warning.path,
+                changeType: warning.type,
+                details: warning.details
+            }
+        };
+    }
+    async queryAgent(questions, conversationContext) {
+        if (questions.length === 0) {
+            return [];
+        }
+        (0, core_1.LogStatus)('PayloadFeedbackManager.queryAgent not yet implemented - accepting all changes by default');
+        return questions.map(q => ({
+            questionId: q.id,
+            intended: true,
+            explanation: 'Accepted by default (feedback system not yet implemented)'
+        }));
+    }
+    buildFeedbackTemplateParams(questions) {
+        return {
+            questions: questions.map((q, i) => ({
+                number: i + 1,
+                text: q.question,
+                context: q.context,
+                warningType: q.warning.type,
+                severity: q.warning.severity
+            })),
+            totalQuestions: questions.length,
+            timestamp: new Date().toISOString()
+        };
+    }
+    processFeedback(questions, responses) {
+        const acceptedChanges = [];
+        const rejectedChanges = [];
+        for (const response of responses) {
+            const question = questions.find(q => q.id === response.questionId);
+            if (question) {
+                if (response.intended) {
+                    acceptedChanges.push(question.warning.path);
+                }
+                else {
+                    rejectedChanges.push(question.warning.path);
+                }
+            }
+        }
+        return {
+            questions,
+            responses,
+            acceptedChanges,
+            rejectedChanges,
+            requiresRevision: rejectedChanges.length > 0
+        };
+    }
+    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}`);
+        if (result.rejectedChanges.length > 0) {
+            (0, core_1.LogStatus)(`\n   Rejected change paths:`);
+            for (const path of result.rejectedChanges) {
+                (0, core_1.LogStatus)(`      - ${path}`);
+            }
+        }
+        if (result.requiresRevision) {
+            (0, core_1.LogStatus)(`\n   ⚠️  Agent needs to revise the payload`);
+        }
+    }
+}
+exports.PayloadFeedbackManager = PayloadFeedbackManager;
+//# sourceMappingURL=PayloadFeedbackManager.js.map

package/dist/PayloadFeedbackManager.js.map

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

package/dist/PayloadManager.d.ts

@@ -1,3 +1,19 @@
+import { AgentPayloadChangeRequest } from '@memberjunction/ai-core-plus';
+import { PayloadAnalysisResult } from './PayloadChangeAnalyzer';
+import { PayloadDiff } from './PayloadDiff';
+export interface PayloadManagerResult<P = any> {
+    result: P;
+    applied: {
+        additions: number;
+        updates: number;
+        deletions: number;
+    };
+    warnings: string[];
+    analysis?: PayloadAnalysisResult;
+    diff?: PayloadDiff;
+    requiresFeedback?: boolean;
+    timestamp: Date;
+}
 export declare class PayloadManager {
     extractDownstreamPayload(subAgentName: string, fullPayload: any, downstreamPaths: string[]): any;
     mergeUpstreamPayload(subAgentName: string, parentPayload: any, subAgentPayload: any, upstreamPaths: string[]): any;
@@ -12,5 +28,23 @@ export declare class PayloadManager {
     private isPathAllowed;
     private parsePathParts;
     private deepMerge;
+    applyAgentChangeRequest<P = any>(originalPayload: P, changeRequest: AgentPayloadChangeRequest<P>, options?: {
+        validateChanges?: boolean;
+        logChanges?: boolean;
+        agentName?: string;
+        analyzeChanges?: boolean;
+        generateDiff?: boolean;
+    }): PayloadManagerResult<P>;
+    private processChangeRequest;
+    private processArrayChanges;
+    private processObjectChanges;
+    private processKeyChange;
+    private getChangeKeys;
+    private isSignificantValue;
+    private logChangesSummary;
+    applySubAgentChangeRequest<P = any>(parentPayload: P, changeRequest: AgentPayloadChangeRequest<P>, upstreamPaths: string[], subAgentName: string): PayloadManagerResult<P> & {
+        blocked: number;
+    };
+    private countBlockedChanges;
 }
 //# 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":"AA8BA,qBAAa,cAAc;IAgBhB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,GAAG;IAuChG,oBAAoB,CACvB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,GAAG,EAClB,eAAe,EAAE,GAAG,EACpB,aAAa,EAAE,MAAM,EAAE,GACxB,GAAG;IA2BN,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,WAAW;IAqDnB,OAAO,CAAC,gBAAgB;IAoDxB,OAAO,CAAC,mBAAmB;IAiC3B,OAAO,CAAC,iBAAiB;IA4DzB,OAAO,CAAC,wBAAwB;IAsBhC,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,WAAW;IA8BnB,OAAO,CAAC,aAAa;IA+CrB,OAAO,CAAC,cAAc;IAmCtB,OAAO,CAAC,SAAS;CAoBpB"}
+{"version":3,"file":"PayloadManager.d.ts","sourceRoot":"","sources":["../src/PayloadManager.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,OAAO,EAAyB,qBAAqB,EAAkB,MAAM,yBAAyB,CAAC;AACvG,OAAO,EAAiB,WAAW,EAAE,MAAM,eAAe,CAAC;AAK3D,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,GAAG;IAEzC,MAAM,EAAE,CAAC,CAAC;IAEV,OAAO,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAEjC,IAAI,CAAC,EAAE,WAAW,CAAC;IAEnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,SAAS,EAAE,IAAI,CAAC;CACnB;AAgBD,qBAAa,cAAc;IAgBhB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,GAAG;IAuChG,oBAAoB,CACvB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,GAAG,EAClB,eAAe,EAAE,GAAG,EACpB,aAAa,EAAE,MAAM,EAAE,GACxB,GAAG;IA2BN,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,WAAW;IAqDnB,OAAO,CAAC,gBAAgB;IAoDxB,OAAO,CAAC,mBAAmB;IAiC3B,OAAO,CAAC,iBAAiB;IA4DzB,OAAO,CAAC,wBAAwB;IAsBhC,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,WAAW;IA8BnB,OAAO,CAAC,aAAa;IA+CrB,OAAO,CAAC,cAAc;IAmCtB,OAAO,CAAC,SAAS;IA6BV,uBAAuB,CAAC,CAAC,GAAG,GAAG,EAClC,eAAe,EAAE,CAAC,EAClB,aAAa,EAAE,yBAAyB,CAAC,CAAC,CAAC,EAC3C,OAAO,CAAC,EAAE;QACN,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,YAAY,CAAC,EAAE,OAAO,CAAC;KAC1B,GACF,oBAAoB,CAAC,CAAC,CAAC;IAqD1B,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,mBAAmB;IAkE3B,OAAO,CAAC,oBAAoB;IA0C5B,OAAO,CAAC,gBAAgB;IAsExB,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,iBAAiB;IAmBlB,0BAA0B,CAAC,CAAC,GAAG,GAAG,EACrC,aAAa,EAAE,CAAC,EAChB,aAAa,EAAE,yBAAyB,CAAC,CAAC,CAAC,EAC3C,aAAa,EAAE,MAAM,EAAE,EACvB,YAAY,EAAE,MAAM,GACrB,oBAAoB,CAAC,CAAC,CAAC,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;IA6BhD,OAAO,CAAC,mBAAmB;CAO9B"}

package/dist/PayloadManager.js

@@ -26,6 +26,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PayloadManager = void 0;
 const core_1 = require("@memberjunction/core");
 const _ = __importStar(require("lodash"));
+const PayloadChangeAnalyzer_1 = require("./PayloadChangeAnalyzer");
+const PayloadDiff_1 = require("./PayloadDiff");
 class PayloadManager {
     extractDownstreamPayload(subAgentName, fullPayload, downstreamPaths) {
         if (!fullPayload)
@@ -335,6 +337,172 @@ class PayloadManager {
         }
         return result;
     }
+    applyAgentChangeRequest(originalPayload, changeRequest, options) {
+        const warnings = [];
+        const result = _.cloneDeep(originalPayload) || {};
+        const counts = { additions: 0, updates: 0, deletions: 0 };
+        this.processChangeRequest(result, originalPayload, changeRequest, [], counts, warnings);
+        if (options?.logChanges) {
+            this.logChangesSummary(counts, changeRequest.reasoning, options.agentName);
+        }
+        let analysis;
+        if (options?.analyzeChanges !== false) {
+            const analyzer = new PayloadChangeAnalyzer_1.PayloadChangeAnalyzer();
+            analysis = analyzer.analyzeChangeRequest(originalPayload, changeRequest, result);
+            if (analysis.warnings.length > 0) {
+                warnings.push(...analysis.warnings.map(w => `[${w.severity}] ${w.message}`));
+            }
+        }
+        let diff;
+        if (options?.generateDiff !== false) {
+            const differ = new PayloadDiff_1.PayloadDiffer();
+            diff = differ.diff(originalPayload, result);
+        }
+        return {
+            result,
+            applied: counts,
+            warnings,
+            analysis,
+            diff,
+            requiresFeedback: analysis?.requiresFeedback || false,
+            timestamp: new Date()
+        };
+    }
+    processChangeRequest(target, original, changeRequest, path, counts, warnings) {
+        if (Array.isArray(target)) {
+            this.processArrayChanges(target, original, changeRequest, path, counts, warnings);
+        }
+        else if (typeof target === 'object' && target !== null) {
+            this.processObjectChanges(target, original, changeRequest, path, counts, warnings);
+        }
+    }
+    processArrayChanges(target, original, changeRequest, path, counts, warnings) {
+        const pathStr = path.join('.');
+        const removeArray = pathStr ? _.get(changeRequest.removeElements, pathStr) : changeRequest.removeElements;
+        const updateArray = pathStr ? _.get(changeRequest.updateElements, pathStr) : changeRequest.updateElements;
+        const newArray = pathStr ? _.get(changeRequest.newElements, pathStr) : changeRequest.newElements;
+        const newTargetArray = [];
+        for (let i = 0; i < target.length; i++) {
+            if (removeArray && removeArray[i] === '_DELETE_') {
+                counts.deletions++;
+                continue;
+            }
+            let elementToAdd = target[i];
+            if (updateArray && this.isSignificantValue(updateArray[i])) {
+                elementToAdd = updateArray[i];
+                counts.updates++;
+            }
+            else if (typeof elementToAdd === 'object' && elementToAdd !== null) {
+                elementToAdd = _.cloneDeep(elementToAdd);
+                this.processChangeRequest(elementToAdd, original ? original[i] : undefined, changeRequest, [...path, i.toString()], counts, warnings);
+            }
+            newTargetArray.push(elementToAdd);
+        }
+        if (newArray && Array.isArray(newArray)) {
+            for (const item of newArray) {
+                if (this.isSignificantValue(item)) {
+                    newTargetArray.push(item);
+                    counts.additions++;
+                }
+            }
+        }
+        target.length = 0;
+        target.push(...newTargetArray);
+    }
+    processObjectChanges(target, original, changeRequest, path, counts, warnings) {
+        const changeKeys = this.getChangeKeys(changeRequest, path);
+        for (const key of changeKeys) {
+            this.processKeyChange(target, original, changeRequest, [...path, key], key, counts, warnings);
+        }
+        for (const key of Object.keys(target)) {
+            if (!changeKeys.has(key) && typeof target[key] === 'object' && target[key] !== null) {
+                this.processChangeRequest(target[key], original ? original[key] : undefined, changeRequest, [...path, key], counts, warnings);
+            }
+        }
+    }
+    processKeyChange(target, original, changeRequest, keyPath, key, counts, warnings) {
+        const pathStr = keyPath.join('.');
+        const removeValue = _.get(changeRequest.removeElements, pathStr);
+        if (removeValue === '_DELETE_') {
+            delete target[key];
+            counts.deletions++;
+            return;
+        }
+        const newValue = _.get(changeRequest.newElements, pathStr);
+        if (newValue !== undefined && !(key in target)) {
+            target[key] = newValue;
+            counts.additions++;
+            return;
+        }
+        const updateValue = _.get(changeRequest.updateElements, pathStr);
+        const effectiveUpdateValue = (updateValue !== undefined) ? updateValue :
+            (newValue !== undefined && key in target) ? newValue :
+                undefined;
+        if (effectiveUpdateValue !== undefined && key in target) {
+            if (typeof effectiveUpdateValue === 'object' && effectiveUpdateValue !== null &&
+                typeof target[key] === 'object' && target[key] !== null &&
+                !Array.isArray(effectiveUpdateValue) && !Array.isArray(target[key])) {
+                this.processChangeRequest(target[key], original ? original[key] : undefined, changeRequest, keyPath, counts, warnings);
+            }
+            else {
+                target[key] = effectiveUpdateValue;
+                counts.updates++;
+            }
+            if (updateValue === undefined && newValue !== undefined) {
+                warnings.push(`Auto-corrected: '${key}' was in newElements but already exists (treated as update)`);
+            }
+        }
+        else if (updateValue !== undefined && !(key in target)) {
+            target[key] = updateValue;
+            counts.additions++;
+            warnings.push(`Auto-corrected: '${key}' was in updateElements but doesn't exist (treated as addition)`);
+        }
+    }
+    getChangeKeys(changeRequest, path) {
+        const keys = new Set();
+        const pathStr = path.join('.');
+        const addKeysFromObject = (obj) => {
+            if (obj && typeof obj === 'object' && !Array.isArray(obj)) {
+                Object.keys(obj).forEach(k => keys.add(k));
+            }
+        };
+        const removeObj = pathStr ? _.get(changeRequest.removeElements, pathStr) : changeRequest.removeElements;
+        const updateObj = pathStr ? _.get(changeRequest.updateElements, pathStr) : changeRequest.updateElements;
+        const newObj = pathStr ? _.get(changeRequest.newElements, pathStr) : changeRequest.newElements;
+        addKeysFromObject(removeObj);
+        addKeysFromObject(updateObj);
+        addKeysFromObject(newObj);
+        return keys;
+    }
+    isSignificantValue(value) {
+        if (value === undefined)
+            return false;
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            return Object.keys(value).length > 0;
+        }
+        return true;
+    }
+    logChangesSummary(counts, reasoning, agentName) {
+        const agent = agentName ? ` by ${agentName}` : '';
+        const reason = reasoning ? ` | Reason: ${reasoning}` : '';
+        (0, core_1.LogStatus)(`Payload changes applied${agent}: ` +
+            `+${counts.additions} additions, ~${counts.updates} updates, -${counts.deletions} deletions${reason}`);
+    }
+    applySubAgentChangeRequest(parentPayload, changeRequest, upstreamPaths, subAgentName) {
+        const changeResult = this.applyAgentChangeRequest(parentPayload, changeRequest, { validateChanges: true });
+        const guardedPayload = this.mergeUpstreamPayload(subAgentName, parentPayload, changeResult.result, upstreamPaths);
+        const blocked = this.countBlockedChanges(parentPayload, changeResult.result, guardedPayload);
+        return {
+            ...changeResult,
+            result: guardedPayload,
+            blocked
+        };
+    }
+    countBlockedChanges(_original, intended, actual) {
+        const intendedStr = JSON.stringify(intended);
+        const actualStr = JSON.stringify(actual);
+        return intendedStr === actualStr ? 0 : 1;
+    }
 }
 exports.PayloadManager = PayloadManager;
 //# sourceMappingURL=PayloadManager.js.map