@memberjunction/ai-agents 2.61.0 → 2.63.0

package/README.md

@@ -41,6 +41,14 @@ Simple orchestrator that:
 - Instantiates correct agent class using ClassFactory
 - Executes agents with provided context
 
+### PayloadManager
+Advanced payload access control for hierarchical agent execution:
+- Controls which payload paths sub-agents can read (downstream)
+- Controls which payload paths sub-agents can write (upstream)
+- Supports JSON path patterns with wildcards
+- Detects suspicious changes with configurable rules
+- Generates human-readable diffs for audit trails
+
 ## Installation
 
 ```bash
@@ -68,6 +76,15 @@ const result = await agent.Execute({
     conversationMessages: messages,
     contextUser: user
 });
+
+// Using run chaining to maintain context across multiple runs
+const followUpResult = await runner.RunAgent({
+    agent: agentEntity,
+    conversationMessages: newMessages,
+    contextUser: user,
+    lastRunId: result.agentRun.ID,
+    autoPopulateLastRunPayload: true // Automatically use previous run's final payload
+});
 ```
 
 ## Agent Configuration
@@ -144,6 +161,65 @@ export class MyCustomAgentType extends BaseAgentType {
 
 ## Advanced Features
 
+### Run Chaining
+
+The framework supports linking multiple agent runs together to maintain context across interactions:
+
+```typescript
+// Execute an agent with run chaining
+const result = await agent.Execute({
+    agent: agentEntity,
+    conversationMessages: messages,
+    contextUser: user,
+    lastRunId: previousRunId,        // Links to previous run
+    autoPopulateLastRunPayload: true  // Auto-loads previous payload
+});
+
+// The framework will:
+// 1. Load the FinalPayload from the previous run
+// 2. Set it as StartingPayload for the new run
+// 3. Use it as the initial payload if none provided
+// 4. Validate against circular references in the chain
+```
+
+Key features:
+- **LastRunID**: Links runs in a chain (different from ParentRunID for sub-agents)
+- **StartingPayload**: Captures the initial state of each run
+- **Auto-population**: Reduces bandwidth by avoiding payload round-trips
+- **Circular reference detection**: Prevents infinite loops in run chains
+
+### Payload Management and Change Detection
+
+The framework includes sophisticated payload management with automatic change detection:
+
+```typescript
+// Payload changes are automatically analyzed
+const changeResult = payloadManager.applyAgentChangeRequest(
+    originalPayload,
+    changeRequest,
+    {
+        analyzeChanges: true,    // Detect suspicious changes
+        generateDiff: true,      // Create audit trail
+        agentName: 'MyAgent'
+    }
+);
+
+// Suspicious changes are flagged:
+// - Content truncation (>70% reduction)
+// - Non-empty key removal
+// - Type changes (object→primitive)
+// - Pattern anomalies (placeholder replacement)
+```
+
+**Sub-agent Payload Access Control**:
+```typescript
+// In AIAgent entity configuration:
+{
+    PayloadDownstreamPaths: ["customer.id", "order.*"],  // What sub-agent can read
+    PayloadUpstreamPaths: ["analysis.*", "recommendations"]  // What sub-agent can write
+}
+```
+
 ### Hierarchical Prompt Execution
 ```typescript
 // System prompt provides base behavior
@@ -194,10 +270,17 @@ Key entities used by the agent framework:
 
 - **AIAgentType**: Agent behavior patterns and system prompts
 - **AIAgent**: Configured agent instances
+  - `PayloadDownstreamPaths`: JSON array of paths sub-agents can read
+  - `PayloadUpstreamPaths`: JSON array of paths sub-agents can write
 - **AIPrompt**: Reusable prompt templates with placeholders
 - **AIAgentPrompt**: Links agents to prompts with execution order
 - **AIAgentRun**: Tracks complete agent executions
+  - `LastRunID`: Links to previous run in a chain (for run chaining)
+  - `StartingPayload`: Initial payload for the run
 - **AIAgentRunStep**: Records individual steps within runs
+  - `PayloadAtStart`: JSON snapshot of payload before step
+  - `PayloadAtEnd`: JSON snapshot of payload after step
+  - `OutputData`: Includes `payloadChangeResult` with analysis
 - **AIAgentRunStepAction**: Details of actions executed
 - **AIAgentRunStepPrompt**: Prompt execution details
 
@@ -210,6 +293,8 @@ Key entities used by the agent framework:
 5. **Comprehensive Tracking**: Leverage built-in tracking for debugging and analysis
 6. **Context Efficiency**: Let the framework handle context compression automatically
 7. **Error Handling**: Implement robust error handling in custom agent types
+8. **Payload Security**: Use path-based access control for sub-agents
+9. **Change Monitoring**: Review payload change warnings in OutputData
 
 ## Examples
 
@@ -252,10 +337,6 @@ export class DecisionTreeAgent extends BaseAgentType {
 
 For detailed architecture information, see [agent-architecture.md](./agent-architecture.md).
 
-## Payload and State Management
-
-For comprehensive information about managing payload flow between agents and sub-agents, including access control and best practices, see [PAYLOAD_STATE_MANAGEMENT.md](./PAYLOAD_STATE_MANAGEMENT.md).
-
 ## Contributing
 
 Contributions are welcome! Please see the main MemberJunction [contributing guide](../../../CONTRIBUTING.md).

package/dist/PayloadChangeAnalyzer.d.ts

@@ -0,0 +1,71 @@
+import { AgentPayloadChangeRequest } from '@memberjunction/ai-core-plus';
+export declare enum PayloadWarningType {
+    ContentTruncation = "content_truncation",
+    KeyRemoval = "key_removal",
+    TypeChange = "type_change",
+    PatternAnomaly = "pattern_anomaly",
+    UnintendedOverwrite = "unintended_overwrite"
+}
+export interface PayloadWarning {
+    type: PayloadWarningType;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    path: string;
+    message: string;
+    requiresFeedback?: boolean;
+    details: any;
+}
+export interface ContentTruncationWarning extends PayloadWarning {
+    type: PayloadWarningType.ContentTruncation;
+    details: {
+        originalLength: number;
+        newLength: number;
+        reductionPercentage: number;
+        contentPreview: {
+            before: string;
+            after: string;
+        };
+    };
+}
+export interface KeyRemovalWarning extends PayloadWarning {
+    type: PayloadWarningType.KeyRemoval;
+    details: {
+        removedKeys: string[];
+        hadContent: boolean;
+        contentSize: number;
+        childKeysRemoved?: string[];
+    };
+}
+export interface PayloadAnalyzerConfig {
+    contentReductionThreshold: number;
+    minContentLengthForAnalysis: number;
+    arrayReductionThreshold: number;
+    objectKeyReductionThreshold: number;
+    analyzeNestedChanges: boolean;
+    maxAnalysisDepth: number;
+    truncationPatterns: RegExp[];
+}
+export interface PayloadAnalysisResult {
+    warnings: PayloadWarning[];
+    criticalWarnings: PayloadWarning[];
+    requiresFeedback: boolean;
+    summary: {
+        totalWarnings: number;
+        warningsByType: Record<PayloadWarningType, number>;
+        suspiciousChanges: number;
+    };
+}
+export declare class PayloadChangeAnalyzer {
+    private config;
+    constructor(config?: Partial<PayloadAnalyzerConfig>);
+    analyzeChangeRequest<P = any>(originalPayload: P, changeRequest: AgentPayloadChangeRequest<P>, resultPayload: P): PayloadAnalysisResult;
+    private analyzeChanges;
+    private analyzeStringChange;
+    private analyzeArrayChange;
+    private analyzeObjectChange;
+    private analyzeRemoval;
+    private analyzeTypeChange;
+    private detectPatternAnomalies;
+    private walkPayload;
+    generateFeedbackQuestions(warnings: PayloadWarning[]): string[];
+}
+//# sourceMappingURL=PayloadChangeAnalyzer.d.ts.map

package/dist/PayloadChangeAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PayloadChangeAnalyzer.d.ts","sourceRoot":"","sources":["../src/PayloadChangeAnalyzer.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAKzE,oBAAY,kBAAkB;IAC1B,iBAAiB,uBAAuB;IACxC,UAAU,gBAAgB;IAC1B,UAAU,gBAAgB;IAC1B,cAAc,oBAAoB;IAClC,mBAAmB,yBAAyB;CAC/C;AAKD,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,EAAE,GAAG,CAAC;CAChB;AAKD,MAAM,WAAW,wBAAyB,SAAQ,cAAc;IAC5D,IAAI,EAAE,kBAAkB,CAAC,iBAAiB,CAAC;IAC3C,OAAO,EAAE;QACL,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,cAAc,EAAE;YACZ,MAAM,EAAE,MAAM,CAAC;YACf,KAAK,EAAE,MAAM,CAAC;SACjB,CAAC;KACL,CAAC;CACL;AAKD,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACrD,IAAI,EAAE,kBAAkB,CAAC,UAAU,CAAC;IACpC,OAAO,EAAE;QACL,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,UAAU,EAAE,OAAO,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC/B,CAAC;CACL;AAKD,MAAM,WAAW,qBAAqB;IAElC,yBAAyB,EAAE,MAAM,CAAC;IAElC,2BAA2B,EAAE,MAAM,CAAC;IAEpC,uBAAuB,EAAE,MAAM,CAAC;IAEhC,2BAA2B,EAAE,MAAM,CAAC;IAEpC,oBAAoB,EAAE,OAAO,CAAC;IAE9B,gBAAgB,EAAE,MAAM,CAAC;IAEzB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAChC;AAKD,MAAM,WAAW,qBAAqB;IAClC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,gBAAgB,EAAE,cAAc,EAAE,CAAC;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;QACnD,iBAAiB,EAAE,MAAM,CAAC;KAC7B,CAAC;CACL;AAKD,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAsB5C,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAC/B,eAAe,EAAE,CAAC,EAClB,aAAa,EAAE,yBAAyB,CAAC,CAAC,CAAC,EAC3C,aAAa,EAAE,CAAC,GACjB,qBAAqB;IA4CxB,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,mBAAmB;IA4D3B,OAAO,CAAC,kBAAkB;IA+C1B,OAAO,CAAC,mBAAmB;IA6D3B,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,iBAAiB;IAiCzB,OAAO,CAAC,sBAAsB;IA4D9B,OAAO,CAAC,WAAW;IA0BZ,yBAAyB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE;CAuCzE"}

package/dist/PayloadChangeAnalyzer.js

@@ -0,0 +1,339 @@
+"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.PayloadChangeAnalyzer = exports.PayloadWarningType = void 0;
+const _ = __importStar(require("lodash"));
+var PayloadWarningType;
+(function (PayloadWarningType) {
+    PayloadWarningType["ContentTruncation"] = "content_truncation";
+    PayloadWarningType["KeyRemoval"] = "key_removal";
+    PayloadWarningType["TypeChange"] = "type_change";
+    PayloadWarningType["PatternAnomaly"] = "pattern_anomaly";
+    PayloadWarningType["UnintendedOverwrite"] = "unintended_overwrite";
+})(PayloadWarningType || (exports.PayloadWarningType = PayloadWarningType = {}));
+class PayloadChangeAnalyzer {
+    constructor(config) {
+        this.config = {
+            contentReductionThreshold: 70,
+            minContentLengthForAnalysis: 100,
+            arrayReductionThreshold: 50,
+            objectKeyReductionThreshold: 50,
+            analyzeNestedChanges: true,
+            maxAnalysisDepth: 10,
+            truncationPatterns: [
+                /\.\.\.$/,
+                /\[truncated\]/i,
+                /\[shortened\]/i,
+                /etc\.?$/i,
+                /and more/i
+            ],
+            ...config
+        };
+    }
+    analyzeChangeRequest(originalPayload, changeRequest, resultPayload) {
+        const warnings = [];
+        this.analyzeChanges(originalPayload, resultPayload, changeRequest, [], warnings);
+        this.detectPatternAnomalies(originalPayload, resultPayload, warnings);
+        const criticalWarnings = warnings.filter(w => w.severity === 'critical' || w.severity === 'high');
+        const requiresFeedback = warnings.some(w => w.requiresFeedback);
+        const warningsByType = warnings.reduce((acc, warning) => {
+            acc[warning.type] = (acc[warning.type] || 0) + 1;
+            return acc;
+        }, {});
+        return {
+            warnings,
+            criticalWarnings,
+            requiresFeedback,
+            summary: {
+                totalWarnings: warnings.length,
+                warningsByType,
+                suspiciousChanges: criticalWarnings.length
+            }
+        };
+    }
+    analyzeChanges(original, result, changeRequest, path, warnings) {
+        if (path.length > this.config.maxAnalysisDepth)
+            return;
+        if (typeof original === 'string' && typeof result === 'string') {
+            this.analyzeStringChange(original, result, path, warnings);
+        }
+        else if (Array.isArray(original) && Array.isArray(result)) {
+            this.analyzeArrayChange(original, result, path, warnings);
+        }
+        else if (_.isObject(original) && _.isObject(result)) {
+            this.analyzeObjectChange(original, result, changeRequest, path, warnings);
+        }
+        else if (original !== undefined && result === undefined) {
+            this.analyzeRemoval(original, path, warnings);
+        }
+        else if (typeof original !== typeof result && original !== undefined && result !== undefined) {
+            this.analyzeTypeChange(original, result, path, warnings);
+        }
+    }
+    analyzeStringChange(original, result, path, warnings) {
+        if (!original || !result)
+            return;
+        const originalLength = original.length;
+        const resultLength = result.length;
+        if (originalLength < this.config.minContentLengthForAnalysis)
+            return;
+        const reductionPercentage = ((originalLength - resultLength) / originalLength) * 100;
+        if (reductionPercentage > this.config.contentReductionThreshold) {
+            const warning = {
+                type: PayloadWarningType.ContentTruncation,
+                severity: reductionPercentage > 90 ? 'critical' : 'high',
+                path: path.join('.'),
+                message: `Content reduced by ${reductionPercentage.toFixed(1)}% (from ${originalLength} to ${resultLength} characters)`,
+                requiresFeedback: true,
+                details: {
+                    originalLength,
+                    newLength: resultLength,
+                    reductionPercentage,
+                    contentPreview: {
+                        before: original.substring(0, 100) + (originalLength > 100 ? '...' : ''),
+                        after: result.substring(0, 100) + (resultLength > 100 ? '...' : '')
+                    }
+                }
+            };
+            warnings.push(warning);
+        }
+        const hasTruncationPattern = this.config.truncationPatterns.some(pattern => pattern.test(result) && !pattern.test(original));
+        if (hasTruncationPattern) {
+            warnings.push({
+                type: PayloadWarningType.PatternAnomaly,
+                severity: 'medium',
+                path: path.join('.'),
+                message: 'Content appears to be truncated (detected truncation pattern)',
+                requiresFeedback: true,
+                details: {
+                    pattern: 'truncation_indicator',
+                    resultEnding: result.slice(-50)
+                }
+            });
+        }
+    }
+    analyzeArrayChange(original, result, path, warnings) {
+        const originalLength = original.length;
+        const resultLength = result.length;
+        if (originalLength === 0)
+            return;
+        const reductionPercentage = ((originalLength - resultLength) / originalLength) * 100;
+        if (reductionPercentage > this.config.arrayReductionThreshold) {
+            warnings.push({
+                type: PayloadWarningType.PatternAnomaly,
+                severity: reductionPercentage > 80 ? 'high' : 'medium',
+                path: path.join('.'),
+                message: `Array reduced by ${reductionPercentage.toFixed(1)}% (from ${originalLength} to ${resultLength} items)`,
+                requiresFeedback: true,
+                details: {
+                    pattern: 'array_reduction',
+                    originalLength,
+                    resultLength,
+                    reductionPercentage
+                }
+            });
+        }
+        if (this.config.analyzeNestedChanges) {
+            const minLength = Math.min(originalLength, resultLength);
+            for (let i = 0; i < minLength; i++) {
+                this.analyzeChanges(original[i], result[i], {}, [...path, `[${i}]`], warnings);
+            }
+        }
+    }
+    analyzeObjectChange(original, result, changeRequest, path, warnings) {
+        const originalKeys = Object.keys(original);
+        const resultKeys = Object.keys(result);
+        const removedKeys = originalKeys.filter(k => !resultKeys.includes(k));
+        if (removedKeys.length > 0) {
+            const keyReductionPercentage = (removedKeys.length / originalKeys.length) * 100;
+            if (keyReductionPercentage > this.config.objectKeyReductionThreshold) {
+                const removedWithContent = removedKeys.filter(k => {
+                    const value = original[k];
+                    return value !== null && value !== undefined && value !== '';
+                });
+                if (removedWithContent.length > 0) {
+                    const warning = {
+                        type: PayloadWarningType.KeyRemoval,
+                        severity: keyReductionPercentage > 80 ? 'critical' : 'high',
+                        path: path.join('.'),
+                        message: `${removedWithContent.length} non-empty keys removed (${keyReductionPercentage.toFixed(1)}% reduction)`,
+                        requiresFeedback: true,
+                        details: {
+                            removedKeys: removedWithContent,
+                            hadContent: true,
+                            contentSize: removedWithContent.reduce((size, key) => {
+                                const value = original[key];
+                                return size + (typeof value === 'string' ? value.length : JSON.stringify(value).length);
+                            }, 0)
+                        }
+                    };
+                    warnings.push(warning);
+                }
+            }
+        }
+        if (this.config.analyzeNestedChanges) {
+            for (const key of resultKeys) {
+                if (key in original) {
+                    this.analyzeChanges(original[key], result[key], changeRequest, [...path, key], warnings);
+                }
+            }
+        }
+    }
+    analyzeRemoval(original, path, warnings) {
+        if (original === null || original === undefined || original === '')
+            return;
+        const contentSize = typeof original === 'string'
+            ? original.length
+            : JSON.stringify(original).length;
+        if (contentSize > 50) {
+            warnings.push({
+                type: PayloadWarningType.KeyRemoval,
+                severity: contentSize > 500 ? 'high' : 'medium',
+                path: path.join('.'),
+                message: `Non-empty content removed (${contentSize} characters)`,
+                requiresFeedback: true,
+                details: {
+                    removedKeys: [path[path.length - 1]],
+                    hadContent: true,
+                    contentSize
+                }
+            });
+        }
+    }
+    analyzeTypeChange(original, result, path, warnings) {
+        const originalType = Array.isArray(original) ? 'array' : typeof original;
+        const resultType = Array.isArray(result) ? 'array' : typeof result;
+        const isDataLoss = (originalType === 'object' || originalType === 'array') &&
+            (resultType === 'string' || resultType === 'number' || resultType === 'boolean');
+        if (isDataLoss) {
+            warnings.push({
+                type: PayloadWarningType.TypeChange,
+                severity: 'high',
+                path: path.join('.'),
+                message: `Type changed from ${originalType} to ${resultType} (potential data loss)`,
+                requiresFeedback: true,
+                details: {
+                    originalType,
+                    newType: resultType,
+                    dataLoss: true
+                }
+            });
+        }
+    }
+    detectPatternAnomalies(original, result, warnings) {
+        if (_.isObject(original) && _.isObject(result)) {
+            const originalKeys = Object.keys(original);
+            const resultKeys = Object.keys(result);
+            const missingRatio = (originalKeys.length - resultKeys.length) / originalKeys.length;
+            if (missingRatio > 0.3 && originalKeys.length > 5) {
+                warnings.push({
+                    type: PayloadWarningType.PatternAnomaly,
+                    severity: 'high',
+                    path: '',
+                    message: `Significant portion of payload structure missing (${(missingRatio * 100).toFixed(1)}%)`,
+                    requiresFeedback: true,
+                    details: {
+                        pattern: 'partial_state_return',
+                        originalKeyCount: originalKeys.length,
+                        resultKeyCount: resultKeys.length,
+                        missingKeys: originalKeys.filter(k => !resultKeys.includes(k)).slice(0, 10)
+                    }
+                });
+            }
+        }
+        const placeholderPatterns = [
+            /^TODO:/i,
+            /^TBD$/i,
+            /^\[.*\]$/,
+            /^<.*>$/
+        ];
+        this.walkPayload(result, [], (value, path) => {
+            if (typeof value === 'string' && placeholderPatterns.some(p => p.test(value))) {
+                const originalValue = _.get(original, path);
+                if (originalValue && typeof originalValue === 'string' && originalValue.length > 50) {
+                    warnings.push({
+                        type: PayloadWarningType.PatternAnomaly,
+                        severity: 'medium',
+                        path: path.join('.'),
+                        message: 'Complex content replaced with placeholder',
+                        requiresFeedback: true,
+                        details: {
+                            pattern: 'placeholder_replacement',
+                            placeholder: value,
+                            originalLength: originalValue.length
+                        }
+                    });
+                }
+            }
+        });
+    }
+    walkPayload(obj, path, callback) {
+        if (!obj || typeof obj !== 'object') {
+            callback(obj, path);
+            return;
+        }
+        if (Array.isArray(obj)) {
+            obj.forEach((item, index) => {
+                this.walkPayload(item, [...path, `[${index}]`], callback);
+            });
+        }
+        else {
+            for (const key in obj) {
+                if (obj.hasOwnProperty(key)) {
+                    this.walkPayload(obj[key], [...path, key], callback);
+                }
+            }
+        }
+    }
+    generateFeedbackQuestions(warnings) {
+        const questions = [];
+        const feedbackWarnings = warnings.filter(w => w.requiresFeedback);
+        const grouped = _.groupBy(feedbackWarnings, 'type');
+        for (const [type, typeWarnings] of Object.entries(grouped)) {
+            switch (type) {
+                case PayloadWarningType.ContentTruncation:
+                    const truncations = typeWarnings;
+                    for (const warning of truncations) {
+                        questions.push(`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 PayloadWarningType.KeyRemoval:
+                    const removals = typeWarnings;
+                    for (const warning of removals) {
+                        questions.push(`Did you intend to remove the following non-empty keys at "${warning.path}": ${warning.details.removedKeys.join(', ')}?`);
+                    }
+                    break;
+                case PayloadWarningType.TypeChange:
+                    for (const warning of typeWarnings) {
+                        questions.push(`Did you intend to change the type at "${warning.path}" from ${warning.details.originalType} to ${warning.details.newType}?`);
+                    }
+                    break;
+            }
+        }
+        return questions;
+    }
+}
+exports.PayloadChangeAnalyzer = PayloadChangeAnalyzer;
+//# sourceMappingURL=PayloadChangeAnalyzer.js.map

package/dist/PayloadChangeAnalyzer.js.map

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