@mnemopay/sdk 0.9.0 → 0.9.2

package/dist/adaptive.d.ts

@@ -0,0 +1,214 @@
+/**
+ * MnemoPay Adaptive Engine
+ *
+ * Business philosophy encoded in code: a system that doesn't learn from its
+ * own operations is dead. MnemoPay adapts to what moves the business forward
+ * — securely, with guardrails, with a full audit trail.
+ *
+ * The engine observes:
+ *   - Agent behavior patterns (settlement rates, dispute frequency, charge velocity)
+ *   - Revenue signals (which fee tiers produce the most volume, where agents churn)
+ *   - Risk trends (emerging fraud patterns, anomaly drift, geographic shifts)
+ *   - Memory health (recall quality, consolidation rates, storage efficiency)
+ *
+ * It adapts:
+ *   - Fee tiers (within secure bounds) to maximize retention + revenue
+ *   - Risk thresholds (tighten on emerging threats, loosen on proven agents)
+ *   - Rate limits (reward trusted agents with higher throughput)
+ *   - Memory decay (faster for low-value agents, slower for high-value)
+ *
+ * It NEVER:
+ *   - Adapts below minimum security thresholds (floor on risk, max on limits)
+ *   - Changes without an audit record
+ *   - Overrides manual admin settings
+ *   - Makes jumps > 20% in any single adaptation cycle
+ *
+ * This is the Agent FICO thesis: the longer an agent operates, the smarter
+ * the system becomes about that agent. Trust is earned, never assumed.
+ */
+export interface AdaptiveConfig {
+    /** Enable adaptive optimization (default: true) */
+    enabled: boolean;
+    /** Minimum observations before adapting (default: 10) */
+    minObservations: number;
+    /** Maximum parameter change per cycle (0.2 = 20%) */
+    maxDeltaPercent: number;
+    /** Minimum cycle interval in minutes (default: 60) */
+    cycleIntervalMinutes: number;
+    /** Lock specific parameters from adaptation */
+    lockedParams: string[];
+}
+export declare const DEFAULT_ADAPTIVE_CONFIG: AdaptiveConfig;
+export interface AgentInsight {
+    agentId: string;
+    /** Settlement success rate (0-1) */
+    settlementRate: number;
+    /** Average charge amount */
+    avgChargeAmount: number;
+    /** Disputes filed against this agent */
+    disputeCount: number;
+    /** Total revenue generated */
+    totalRevenue: number;
+    /** Memory utilization efficiency (active memories / total) */
+    memoryEfficiency: number;
+    /** Recommended risk tier: trusted | standard | elevated | restricted */
+    riskTier: "trusted" | "standard" | "elevated" | "restricted";
+    /** Recommended fee tier override (null = use default) */
+    recommendedFeeRate: number | null;
+    /** Recommended rate limit multiplier (1.0 = default, 2.0 = double) */
+    rateLimitMultiplier: number;
+    /** Agent health score (0-100) */
+    healthScore: number;
+    /** Observations count */
+    observations: number;
+    /** Last analyzed */
+    analyzedAt: Date;
+}
+export interface AdaptationRecord {
+    id: string;
+    /** What was adapted */
+    parameter: string;
+    /** Previous value */
+    previousValue: number;
+    /** New value */
+    newValue: number;
+    /** Why it was adapted */
+    reason: string;
+    /** Evidence that triggered the adaptation */
+    evidence: Record<string, number>;
+    /** When the adaptation was applied */
+    appliedAt: Date;
+    /** Whether it was actually applied (false if locked or vetoed) */
+    applied: boolean;
+    /** Veto reason if not applied */
+    vetoReason?: string;
+}
+export interface BusinessMetrics {
+    /** Total platform revenue (from fees) */
+    totalRevenue: number;
+    /** Revenue this cycle */
+    cycleRevenue: number;
+    /** Total agents observed */
+    totalAgents: number;
+    /** Agents with settlement rate > 80% */
+    trustedAgents: number;
+    /** Agents with disputes */
+    disputedAgents: number;
+    /** Platform-wide settlement rate */
+    platformSettlementRate: number;
+    /** Average memory utilization across agents */
+    avgMemoryUtilization: number;
+    /** Fraud detection rate (blocked/total) */
+    fraudDetectionRate: number;
+    /** System health (0-100) */
+    systemHealth: number;
+    /** Computed at */
+    computedAt: Date;
+}
+export type AdaptiveEventType = "charge" | "settle" | "refund" | "dispute" | "memory_store" | "memory_recall" | "fraud_block" | "fraud_flag";
+export interface AdaptiveEvent {
+    type: AdaptiveEventType;
+    agentId: string;
+    amount?: number;
+    timestamp: number;
+    metadata?: Record<string, unknown>;
+}
+declare const SECURE_BOUNDS: {
+    readonly feeRate: {
+        readonly min: 0.005;
+        readonly max: 0.05;
+    };
+    readonly blockThreshold: {
+        readonly min: 0.3;
+        readonly max: 0.95;
+    };
+    readonly flagThreshold: {
+        readonly min: 0.1;
+        readonly max: 0.7;
+    };
+    readonly rateLimitMultiplier: {
+        readonly min: 0.5;
+        readonly max: 3;
+    };
+    readonly decayRate: {
+        readonly min: 0.001;
+        readonly max: 0.5;
+    };
+    readonly settlementHoldMinutes: {
+        readonly min: 5;
+        readonly max: 1440;
+    };
+};
+export declare class AdaptiveEngine {
+    private config;
+    private events;
+    private insights;
+    private adaptations;
+    private lastCycleAt;
+    /** Manual overrides set by admin — these are never auto-changed */
+    private adminOverrides;
+    private eventCounter;
+    constructor(config?: Partial<AdaptiveConfig>);
+    /**
+     * Record an operational event. The engine learns from every operation.
+     */
+    observe(event: AdaptiveEvent): void;
+    /**
+     * Analyze an agent's behavioral pattern and produce an insight profile.
+     * This is the "Agent FICO score" — built from real operational data.
+     */
+    analyzeAgent(agentId: string): AgentInsight;
+    /**
+     * Compute platform-wide business intelligence.
+     */
+    computeMetrics(): BusinessMetrics;
+    /**
+     * Run an adaptation cycle. Analyzes all data, proposes parameter changes,
+     * validates against secure bounds, and returns what was (or would be) changed.
+     *
+     * Returns proposed adaptations. Call applyAdaptations() to commit them.
+     */
+    runCycle(): AdaptationRecord[];
+    /**
+     * Lock a parameter from adaptive changes. Admin decisions override AI.
+     */
+    lockParam(param: string): void;
+    /**
+     * Unlock a parameter for adaptive changes.
+     */
+    unlockParam(param: string): void;
+    /**
+     * Set an admin override. This value will be used instead of adaptive suggestions.
+     */
+    setOverride(param: string, value: number): void;
+    /**
+     * Remove an admin override, allowing adaptive control.
+     */
+    removeOverride(param: string): void;
+    /**
+     * Get the effective value for a parameter (admin override > adaptation > default).
+     */
+    getEffectiveValue(param: string, defaultValue: number): number;
+    getInsight(agentId: string): AgentInsight | undefined;
+    getAdaptations(limit?: number): AdaptationRecord[];
+    get totalEvents(): number;
+    get secureBounds(): typeof SECURE_BOUNDS;
+    serialize(): {
+        config: AdaptiveConfig;
+        insights: [string, AgentInsight][];
+        adaptations: AdaptationRecord[];
+        overrides: [string, number][];
+        eventCount: number;
+    };
+    static deserialize(data: ReturnType<AdaptiveEngine["serialize"]>): AdaptiveEngine;
+    private isLocked;
+    private clamp;
+    /**
+     * Limit how much a parameter can change in one cycle.
+     * Prevents wild swings — stability is a security property.
+     */
+    private limitDelta;
+    private createRecord;
+}
+export {};
+//# sourceMappingURL=adaptive.d.ts.map

package/dist/adaptive.d.ts.map

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

package/dist/adaptive.js

@@ -0,0 +1,389 @@
+"use strict";
+/**
+ * MnemoPay Adaptive Engine
+ *
+ * Business philosophy encoded in code: a system that doesn't learn from its
+ * own operations is dead. MnemoPay adapts to what moves the business forward
+ * — securely, with guardrails, with a full audit trail.
+ *
+ * The engine observes:
+ *   - Agent behavior patterns (settlement rates, dispute frequency, charge velocity)
+ *   - Revenue signals (which fee tiers produce the most volume, where agents churn)
+ *   - Risk trends (emerging fraud patterns, anomaly drift, geographic shifts)
+ *   - Memory health (recall quality, consolidation rates, storage efficiency)
+ *
+ * It adapts:
+ *   - Fee tiers (within secure bounds) to maximize retention + revenue
+ *   - Risk thresholds (tighten on emerging threats, loosen on proven agents)
+ *   - Rate limits (reward trusted agents with higher throughput)
+ *   - Memory decay (faster for low-value agents, slower for high-value)
+ *
+ * It NEVER:
+ *   - Adapts below minimum security thresholds (floor on risk, max on limits)
+ *   - Changes without an audit record
+ *   - Overrides manual admin settings
+ *   - Makes jumps > 20% in any single adaptation cycle
+ *
+ * This is the Agent FICO thesis: the longer an agent operates, the smarter
+ * the system becomes about that agent. Trust is earned, never assumed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdaptiveEngine = exports.DEFAULT_ADAPTIVE_CONFIG = void 0;
+exports.DEFAULT_ADAPTIVE_CONFIG = {
+    enabled: true,
+    minObservations: 10,
+    maxDeltaPercent: 0.2,
+    cycleIntervalMinutes: 60,
+    lockedParams: [],
+};
+// ─── Secure Bounds ──────────────────────────────────────────────────────────
+// These are HARD floors and ceilings. The adaptive engine cannot breach them.
+// This is the "never adapt yourself into an insecure state" principle.
+const SECURE_BOUNDS = {
+    // Fee rates: never go below 0.5% (business viability) or above 5% (market competitiveness)
+    feeRate: { min: 0.005, max: 0.05 },
+    // Risk block threshold: never go above 0.95 (must always be able to block)
+    blockThreshold: { min: 0.3, max: 0.95 },
+    // Flag threshold: never go above block threshold
+    flagThreshold: { min: 0.1, max: 0.7 },
+    // Rate limit multiplier: trusted agents get up to 3x, never below 0.5x
+    rateLimitMultiplier: { min: 0.5, max: 3.0 },
+    // Memory decay: never so fast memories die in < 1hr, never so slow they never decay
+    decayRate: { min: 0.001, max: 0.5 },
+    // Settlement hold: never below 5 minutes (gives rail time to capture)
+    settlementHoldMinutes: { min: 5, max: 1440 },
+};
+// ─── Adaptive Engine ────────────────────────────────────────────────────────
+class AdaptiveEngine {
+    config;
+    events = [];
+    insights = new Map();
+    adaptations = [];
+    lastCycleAt = 0;
+    /** Manual overrides set by admin — these are never auto-changed */
+    adminOverrides = new Map();
+    eventCounter = 0;
+    constructor(config) {
+        this.config = { ...exports.DEFAULT_ADAPTIVE_CONFIG, ...config };
+    }
+    // ── Event Ingestion ────────────────────────────────────────────────────
+    /**
+     * Record an operational event. The engine learns from every operation.
+     */
+    observe(event) {
+        this.events.push(event);
+        this.eventCounter++;
+        // Rolling window: keep last 50K events to bound memory usage
+        if (this.events.length > 50_000) {
+            this.events = this.events.slice(-25_000);
+        }
+    }
+    // ── Agent Analysis ─────────────────────────────────────────────────────
+    /**
+     * Analyze an agent's behavioral pattern and produce an insight profile.
+     * This is the "Agent FICO score" — built from real operational data.
+     */
+    analyzeAgent(agentId) {
+        const agentEvents = this.events.filter(e => e.agentId === agentId);
+        const charges = agentEvents.filter(e => e.type === "charge");
+        const settles = agentEvents.filter(e => e.type === "settle");
+        const refunds = agentEvents.filter(e => e.type === "refund");
+        const disputes = agentEvents.filter(e => e.type === "dispute");
+        const memStores = agentEvents.filter(e => e.type === "memory_store");
+        const memRecalls = agentEvents.filter(e => e.type === "memory_recall");
+        const fraudBlocks = agentEvents.filter(e => e.type === "fraud_block");
+        const totalCompleted = settles.length + refunds.length;
+        const settlementRate = totalCompleted > 0 ? settles.length / totalCompleted : 0;
+        const avgCharge = charges.length > 0
+            ? charges.reduce((sum, e) => sum + (e.amount ?? 0), 0) / charges.length
+            : 0;
+        const totalRevenue = settles.reduce((sum, e) => sum + (e.amount ?? 0) * 0.019, 0);
+        // Memory efficiency: recalls / stores (how often are stored memories actually used?)
+        const memoryEfficiency = memStores.length > 0
+            ? Math.min(memRecalls.length / memStores.length, 1.0)
+            : 0;
+        // Risk tier determination
+        let riskTier = "standard";
+        if (disputes.length > 0 || fraudBlocks.length > 2) {
+            riskTier = disputes.length >= 3 ? "restricted" : "elevated";
+        }
+        else if (settlementRate > 0.9 && settles.length >= 10) {
+            riskTier = "trusted";
+        }
+        // Recommended fee rate: reward high-volume, high-settlement agents
+        let recommendedFeeRate = null;
+        const totalVolume = settles.reduce((sum, e) => sum + (e.amount ?? 0), 0);
+        if (totalVolume >= 100_000)
+            recommendedFeeRate = 0.010;
+        else if (totalVolume >= 10_000)
+            recommendedFeeRate = 0.015;
+        // Rate limit multiplier: trusted agents earn higher throughput
+        let rateLimitMultiplier = 1.0;
+        if (riskTier === "trusted")
+            rateLimitMultiplier = 2.0;
+        else if (riskTier === "elevated")
+            rateLimitMultiplier = 0.7;
+        else if (riskTier === "restricted")
+            rateLimitMultiplier = 0.5;
+        // Health score (0-100)
+        let healthScore = 50;
+        healthScore += settlementRate * 20; // Up to +20 for settlements
+        healthScore += Math.min(settles.length, 50) * 0.2; // Up to +10 for volume
+        healthScore += memoryEfficiency * 10; // Up to +10 for memory usage
+        healthScore -= disputes.length * 5; // -5 per dispute
+        healthScore -= fraudBlocks.length * 10; // -10 per fraud block
+        healthScore = Math.max(0, Math.min(100, healthScore));
+        const insight = {
+            agentId,
+            settlementRate,
+            avgChargeAmount: Math.round(avgCharge * 100) / 100,
+            disputeCount: disputes.length,
+            totalRevenue: Math.round(totalRevenue * 100) / 100,
+            memoryEfficiency: Math.round(memoryEfficiency * 100) / 100,
+            riskTier,
+            recommendedFeeRate,
+            rateLimitMultiplier,
+            healthScore: Math.round(healthScore),
+            observations: agentEvents.length,
+            analyzedAt: new Date(),
+        };
+        this.insights.set(agentId, insight);
+        return insight;
+    }
+    // ── Business Metrics ───────────────────────────────────────────────────
+    /**
+     * Compute platform-wide business intelligence.
+     */
+    computeMetrics() {
+        const agentIds = new Set(this.events.map(e => e.agentId));
+        const settles = this.events.filter(e => e.type === "settle");
+        const refunds = this.events.filter(e => e.type === "refund");
+        const charges = this.events.filter(e => e.type === "charge");
+        const disputes = this.events.filter(e => e.type === "dispute");
+        const fraudBlocks = this.events.filter(e => e.type === "fraud_block");
+        const memStores = this.events.filter(e => e.type === "memory_store");
+        const memRecalls = this.events.filter(e => e.type === "memory_recall");
+        const totalRevenue = settles.reduce((sum, e) => sum + (e.amount ?? 0) * 0.019, 0);
+        const totalCompleted = settles.length + refunds.length;
+        const platformSettlementRate = totalCompleted > 0 ? settles.length / totalCompleted : 0;
+        // Cycle revenue (last cycle interval)
+        const cycleStart = Date.now() - this.config.cycleIntervalMinutes * 60_000;
+        const cycleSettles = settles.filter(e => e.timestamp > cycleStart);
+        const cycleRevenue = cycleSettles.reduce((sum, e) => sum + (e.amount ?? 0) * 0.019, 0);
+        // Analyze all agents for tier counts
+        let trustedCount = 0;
+        let disputedAgentIds = new Set();
+        for (const agentId of agentIds) {
+            const insight = this.analyzeAgent(agentId);
+            if (insight.riskTier === "trusted")
+                trustedCount++;
+            if (insight.disputeCount > 0)
+                disputedAgentIds.add(agentId);
+        }
+        const avgMemUtil = memStores.length > 0
+            ? Math.min(memRecalls.length / memStores.length, 1.0)
+            : 0;
+        const fraudDetectionRate = charges.length > 0
+            ? fraudBlocks.length / charges.length
+            : 0;
+        // System health: composite score
+        let systemHealth = 70; // baseline
+        systemHealth += platformSettlementRate * 15;
+        systemHealth -= (disputes.length / Math.max(settles.length, 1)) * 20;
+        systemHealth += avgMemUtil * 5;
+        systemHealth = Math.max(0, Math.min(100, Math.round(systemHealth)));
+        return {
+            totalRevenue: Math.round(totalRevenue * 100) / 100,
+            cycleRevenue: Math.round(cycleRevenue * 100) / 100,
+            totalAgents: agentIds.size,
+            trustedAgents: trustedCount,
+            disputedAgents: disputedAgentIds.size,
+            platformSettlementRate: Math.round(platformSettlementRate * 100) / 100,
+            avgMemoryUtilization: Math.round(avgMemUtil * 100) / 100,
+            fraudDetectionRate: Math.round(fraudDetectionRate * 1000) / 1000,
+            systemHealth,
+            computedAt: new Date(),
+        };
+    }
+    // ── Adaptive Optimization ──────────────────────────────────────────────
+    /**
+     * Run an adaptation cycle. Analyzes all data, proposes parameter changes,
+     * validates against secure bounds, and returns what was (or would be) changed.
+     *
+     * Returns proposed adaptations. Call applyAdaptations() to commit them.
+     */
+    runCycle() {
+        if (!this.config.enabled)
+            return [];
+        // Enforce minimum cycle interval
+        const now = Date.now();
+        if (now - this.lastCycleAt < this.config.cycleIntervalMinutes * 60_000) {
+            return [];
+        }
+        this.lastCycleAt = now;
+        if (this.events.length < this.config.minObservations) {
+            return [];
+        }
+        const metrics = this.computeMetrics();
+        const proposals = [];
+        // ── Adapt fee rate based on platform settlement rate ──────────────
+        if (!this.isLocked("feeRate")) {
+            const currentRate = 0.019; // default
+            let targetRate = currentRate;
+            // If settlement rate is high (> 90%), reward with lower fees
+            if (metrics.platformSettlementRate > 0.9 && metrics.totalAgents >= 5) {
+                targetRate = currentRate * 0.95; // 5% reduction
+            }
+            // If dispute rate is high, increase fees to cover risk
+            if (metrics.disputedAgents / Math.max(metrics.totalAgents, 1) > 0.1) {
+                targetRate = currentRate * 1.05; // 5% increase
+            }
+            targetRate = this.clamp(targetRate, SECURE_BOUNDS.feeRate.min, SECURE_BOUNDS.feeRate.max);
+            targetRate = this.limitDelta(currentRate, targetRate);
+            if (Math.abs(targetRate - currentRate) > 0.0001) {
+                proposals.push(this.createRecord("feeRate", currentRate, targetRate, metrics.platformSettlementRate > 0.9
+                    ? "High platform settlement rate — rewarding ecosystem"
+                    : "Elevated dispute rate — increasing to cover risk", { settlementRate: metrics.platformSettlementRate, disputeRatio: metrics.disputedAgents / Math.max(metrics.totalAgents, 1) }));
+            }
+        }
+        // ── Adapt risk thresholds based on fraud patterns ─────────────────
+        if (!this.isLocked("blockThreshold")) {
+            const currentBlock = 0.75;
+            let targetBlock = currentBlock;
+            // If fraud detection is catching too many (> 10% of charges), system may be too aggressive
+            if (metrics.fraudDetectionRate > 0.10) {
+                targetBlock = currentBlock * 1.03; // loosen slightly
+            }
+            // If zero fraud but many agents, may be too loose
+            if (metrics.fraudDetectionRate < 0.001 && metrics.totalAgents > 20) {
+                targetBlock = currentBlock * 0.98; // tighten slightly
+            }
+            targetBlock = this.clamp(targetBlock, SECURE_BOUNDS.blockThreshold.min, SECURE_BOUNDS.blockThreshold.max);
+            targetBlock = this.limitDelta(currentBlock, targetBlock);
+            if (Math.abs(targetBlock - currentBlock) > 0.001) {
+                proposals.push(this.createRecord("blockThreshold", currentBlock, targetBlock, metrics.fraudDetectionRate > 0.10
+                    ? "Fraud detection too aggressive — loosening to reduce false positives"
+                    : "Low fraud detection with many agents — tightening for safety", { fraudRate: metrics.fraudDetectionRate, totalAgents: metrics.totalAgents }));
+            }
+        }
+        this.adaptations.push(...proposals);
+        // Cap adaptation history at 1000 records
+        if (this.adaptations.length > 1000) {
+            this.adaptations = this.adaptations.slice(-500);
+        }
+        return proposals;
+    }
+    // ── Admin Controls ─────────────────────────────────────────────────────
+    /**
+     * Lock a parameter from adaptive changes. Admin decisions override AI.
+     */
+    lockParam(param) {
+        if (!this.config.lockedParams.includes(param)) {
+            this.config.lockedParams.push(param);
+        }
+    }
+    /**
+     * Unlock a parameter for adaptive changes.
+     */
+    unlockParam(param) {
+        this.config.lockedParams = this.config.lockedParams.filter(p => p !== param);
+    }
+    /**
+     * Set an admin override. This value will be used instead of adaptive suggestions.
+     */
+    setOverride(param, value) {
+        this.adminOverrides.set(param, value);
+    }
+    /**
+     * Remove an admin override, allowing adaptive control.
+     */
+    removeOverride(param) {
+        this.adminOverrides.delete(param);
+    }
+    /**
+     * Get the effective value for a parameter (admin override > adaptation > default).
+     */
+    getEffectiveValue(param, defaultValue) {
+        if (this.adminOverrides.has(param))
+            return this.adminOverrides.get(param);
+        // Check last applied adaptation
+        const lastAdaptation = [...this.adaptations]
+            .reverse()
+            .find(a => a.parameter === param && a.applied);
+        return lastAdaptation ? lastAdaptation.newValue : defaultValue;
+    }
+    // ── Getters ────────────────────────────────────────────────────────────
+    getInsight(agentId) {
+        return this.insights.get(agentId);
+    }
+    getAdaptations(limit = 50) {
+        return this.adaptations.slice(-limit);
+    }
+    get totalEvents() {
+        return this.eventCounter;
+    }
+    get secureBounds() {
+        return SECURE_BOUNDS;
+    }
+    // ── Serialization ──────────────────────────────────────────────────────
+    serialize() {
+        return {
+            config: this.config,
+            insights: Array.from(this.insights.entries()),
+            adaptations: this.adaptations.slice(-200), // Keep recent history
+            overrides: Array.from(this.adminOverrides.entries()),
+            eventCount: this.eventCounter,
+        };
+    }
+    static deserialize(data) {
+        const engine = new AdaptiveEngine(data.config);
+        for (const [id, insight] of data.insights) {
+            insight.analyzedAt = new Date(insight.analyzedAt);
+            engine.insights.set(id, insight);
+        }
+        engine.adaptations = data.adaptations.map(a => ({
+            ...a,
+            appliedAt: new Date(a.appliedAt),
+        }));
+        for (const [key, val] of data.overrides) {
+            engine.adminOverrides.set(key, val);
+        }
+        engine.eventCounter = data.eventCount ?? 0;
+        return engine;
+    }
+    // ── Internal Utilities ─────────────────────────────────────────────────
+    isLocked(param) {
+        return this.config.lockedParams.includes(param) || this.adminOverrides.has(param);
+    }
+    clamp(value, min, max) {
+        return Math.max(min, Math.min(max, value));
+    }
+    /**
+     * Limit how much a parameter can change in one cycle.
+     * Prevents wild swings — stability is a security property.
+     */
+    limitDelta(current, target) {
+        const maxDelta = current * this.config.maxDeltaPercent;
+        const delta = target - current;
+        if (Math.abs(delta) > maxDelta) {
+            return current + Math.sign(delta) * maxDelta;
+        }
+        return target;
+    }
+    createRecord(parameter, previousValue, newValue, reason, evidence) {
+        const isLocked = this.isLocked(parameter);
+        return {
+            id: `adapt_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+            parameter,
+            previousValue: Math.round(previousValue * 10000) / 10000,
+            newValue: Math.round(newValue * 10000) / 10000,
+            reason,
+            evidence,
+            appliedAt: new Date(),
+            applied: !isLocked,
+            vetoReason: isLocked ? `Parameter '${parameter}' is locked or has admin override` : undefined,
+        };
+    }
+}
+exports.AdaptiveEngine = AdaptiveEngine;
+//# sourceMappingURL=adaptive.js.map

package/dist/adaptive.js.map

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

package/dist/commerce.d.ts

@@ -173,6 +173,8 @@ export declare class CommerceEngine {
     private totalSpent;
     private approvalCallback;
     private externalOrderMap;
+    private searchLimiter;
+    private purchaseLimiter;
     constructor(agent: any, provider?: CommerceProvider);
     /**
      * Set a shopping mandate that defines what this agent can buy.