@agent-e/core 1.5.1 → 1.5.3

package/dist/index.mjs

@@ -32,7 +32,7 @@ var DEFAULT_THRESHOLDS = {
   cooldownTicks: 15,
   // Currency (P13)
   poolWinRate: 0.65,
-  poolHouseCut: 0.1,
+  poolOperatorShare: 0.1,
   // Population balance (P9)
   roleSwitchFrictionMax: 0.05,
   // >5% of population switching in one period = herd
@@ -93,6 +93,12 @@ var Observer = class {
     this.customMetricFns[name] = fn;
   }
   compute(state, recentEvents) {
+    if (!state.currencies || state.currencies.length === 0) {
+      console.warn("[AgentE] Warning: state.currencies is empty. Metrics will be zeroed.");
+    }
+    if (!state.agentBalances || Object.keys(state.agentBalances).length === 0) {
+      console.warn("[AgentE] Warning: state.agentBalances is empty.");
+    }
     const tick = state.tick;
     const roles = Object.values(state.agentRoles);
     const totalAgents = Object.keys(state.agentBalances).length;
@@ -187,7 +193,7 @@ var Observer = class {
       const faucet = faucetVolumeByCurrency[curr] ?? 0;
       const sink = sinkVolumeByCurrency[curr] ?? 0;
       netFlowByCurrency[curr] = faucet - sink;
-      tapSinkRatioByCurrency[curr] = sink > 0 ? faucet / sink : faucet > 0 ? Infinity : 1;
+      tapSinkRatioByCurrency[curr] = sink > 0 ? Math.min(faucet / sink, 100) : faucet > 0 ? 100 : 1;
       const prevSupply = this.previousMetrics?.totalSupplyByCurrency?.[curr] ?? totalSupplyByCurrency[curr] ?? 0;
       const currSupply = totalSupplyByCurrency[curr] ?? 0;
       inflationRateByCurrency[curr] = prevSupply > 0 ? (currSupply - prevSupply) / prevSupply : 0;
@@ -222,7 +228,7 @@ var Observer = class {
     const faucetVolume = Object.values(faucetVolumeByCurrency).reduce((s, v) => s + v, 0);
     const sinkVolume = Object.values(sinkVolumeByCurrency).reduce((s, v) => s + v, 0);
     const netFlow = faucetVolume - sinkVolume;
-    const tapSinkRatio = sinkVolume > 0 ? faucetVolume / sinkVolume : faucetVolume > 0 ? Infinity : 1;
+    const tapSinkRatio = sinkVolume > 0 ? Math.min(faucetVolume / sinkVolume, 100) : faucetVolume > 0 ? 100 : 1;
     const velocity = totalSupply > 0 ? tradeEvents.length / totalSupply : 0;
     const prevTotalSupply = this.previousMetrics?.totalSupply ?? totalSupply;
     const inflationRate = prevTotalSupply > 0 ? (totalSupply - prevTotalSupply) / prevTotalSupply : 0;
@@ -260,7 +266,9 @@ var Observer = class {
       const pVals = Object.values(resourcePrices);
       priceIndexByCurrency[curr] = pVals.length > 0 ? pVals.reduce((s, p) => s + p, 0) / pVals.length : 0;
     }
-    this.previousPricesByCurrency = JSON.parse(JSON.stringify(pricesByCurrency));
+    this.previousPricesByCurrency = Object.fromEntries(
+      Object.entries(pricesByCurrency).map(([c, p]) => [c, { ...p }])
+    );
     const prices = pricesByCurrency[defaultCurrency] ?? {};
     const priceVolatility = priceVolatilityByCurrency[defaultCurrency] ?? {};
     const priceIndex = priceIndexByCurrency[defaultCurrency] ?? 0;
@@ -280,9 +288,9 @@ var Observer = class {
     for (const resource of /* @__PURE__ */ new Set([...Object.keys(supplyByResource), ...Object.keys(demandSignals)])) {
       const s = supplyByResource[resource] ?? 0;
       const d = demandSignals[resource] ?? 0;
-      if (d > 2 && s / d < 0.5) {
+      if (d > 0 && d > 2 && s / d < 0.5) {
         pinchPoints[resource] = "scarce";
-      } else if (s > 3 && d > 0 && s / d > 3) {
+      } else if (d > 0 && s > 3 && s / d > 3) {
         pinchPoints[resource] = "oversupplied";
       } else {
         pinchPoints[resource] = "optimal";
@@ -328,21 +336,11 @@ var Observer = class {
     const arbitrageIndexByCurrency = {};
     for (const curr of currencies) {
       const cPrices = pricesByCurrency[curr] ?? {};
-      const priceKeys = Object.keys(cPrices).filter((k) => cPrices[k] > 0);
-      if (priceKeys.length >= 2) {
-        let pairCount = 0;
-        let totalDivergence = 0;
-        for (let i = 0; i < priceKeys.length; i++) {
-          for (let j = i + 1; j < priceKeys.length; j++) {
-            const pA = cPrices[priceKeys[i]];
-            const pB = cPrices[priceKeys[j]];
-            let ratio = pA / pB;
-            ratio = Math.max(1e-3, Math.min(1e3, ratio));
-            totalDivergence += Math.abs(Math.log(ratio));
-            pairCount++;
-          }
-        }
-        arbitrageIndexByCurrency[curr] = pairCount > 0 ? Math.min(1, totalDivergence / pairCount) : 0;
+      const logPrices = Object.values(cPrices).filter((p) => p > 0).map((p) => Math.log(p));
+      if (logPrices.length >= 2) {
+        const mean = logPrices.reduce((s, v) => s + v, 0) / logPrices.length;
+        const variance = logPrices.reduce((s, v) => s + (v - mean) ** 2, 0) / logPrices.length;
+        arbitrageIndexByCurrency[curr] = Math.min(1, Math.sqrt(variance));
       } else {
         arbitrageIndexByCurrency[curr] = 0;
       }
@@ -429,10 +427,10 @@ var Observer = class {
       prices,
       priceVolatility,
       poolSizes: poolSizesAggregate,
-      extractionRatio: NaN,
-      newUserDependency: NaN,
-      smokeTestRatio: NaN,
-      currencyInsulation: NaN,
+      extractionRatio: 0,
+      newUserDependency: 0,
+      smokeTestRatio: 0,
+      currencyInsulation: 0,
       arbitrageIndex,
       giftTradeRatio,
       disposalTradeRatio,
@@ -454,7 +452,7 @@ var Observer = class {
       timeToValue,
       sharkToothPeaks: this.previousMetrics?.sharkToothPeaks ?? [],
       sharkToothValleys: this.previousMetrics?.sharkToothValleys ?? [],
-      eventCompletionRate: NaN,
+      eventCompletionRate: 0,
       contentDropAge,
       systems: state.systems ?? [],
       sources: state.sources ?? [],
@@ -486,7 +484,7 @@ function computeGini(sorted) {
   for (let i = 0; i < n; i++) {
     numerator += (2 * (i + 1) - n - 1) * (sorted[i] ?? 0);
   }
-  return Math.abs(numerator) / (n * sum);
+  return Math.min(1, Math.abs(numerator) / (n * sum));
 }
 
 // src/Diagnoser.ts
@@ -582,10 +580,10 @@ function emptyMetrics(tick = 0) {
     prices: {},
     priceVolatility: {},
     poolSizes: {},
-    extractionRatio: NaN,
-    newUserDependency: NaN,
-    smokeTestRatio: NaN,
-    currencyInsulation: NaN,
+    extractionRatio: 0,
+    newUserDependency: 0,
+    smokeTestRatio: 0,
+    currencyInsulation: 0,
     arbitrageIndex: 0,
     giftTradeRatio: 0,
     disposalTradeRatio: 0,
@@ -606,7 +604,7 @@ function emptyMetrics(tick = 0) {
     timeToValue: 0,
     sharkToothPeaks: [],
     sharkToothValleys: [],
-    eventCompletionRate: NaN,
+    eventCompletionRate: 0,
     contentDropAge: 0,
     systems: [],
     sources: [],
@@ -811,9 +809,9 @@ var SUPPLY_CHAIN_PRINCIPLES = [
 ];
 
 // src/principles/incentives.ts
-var P5_ProfitabilityIsCompetitive = {
+var P5_ProfitabilityIsRelative = {
   id: "P5",
-  name: "Profitability Is Competitive, Not Absolute",
+  name: "Profitability Is Relative, Not Absolute",
   category: "incentive",
   description: "Any profitability formula that returns the same number regardless of how many agents are already in that role will cause stampedes. 97 intermediaries happened because profit = transactions \xD7 10 with no competition denominator.",
   check(metrics, thresholds) {
@@ -877,7 +875,7 @@ var P7_NonSpecialistsSubsidiseSpecialists = {
   id: "P7",
   name: "Non-Specialists Subsidise Specialists in Zero-Sum Games",
   category: "incentive",
-  description: "In zero-sum pools (competitive pool, staking), the math only works if non-specialists overpay relative to specialists. If the pool is >70% specialists, there is no one left to subsidise and the pot drains.",
+  description: "In zero-sum pools (staking, prize pools, etc.), the math only works if non-specialists overpay relative to specialists. If the pool is >70% specialists, there is no one left to subsidise and the pot drains.",
   check(metrics, _thresholds) {
     const { poolSizes } = metrics;
     for (const [poolName, poolSize] of Object.entries(poolSizes)) {
@@ -913,7 +911,7 @@ var P8_RegulatorCannotFightDesign = {
   id: "P8",
   name: "Regulator Cannot Fight the Design",
   category: "incentive",
-  description: "If the economy is designed to have a majority role (e.g. dominant role exceeds 55%), the regulator must know this and exempt that role from population suppression. AgentE at tick 1 seeing dominant role exceeds 55% and slashing competitive pool rewards is overreach.",
+  description: "If the economy is designed to have a majority role (e.g. dominant role exceeds 55%), the regulator must know this and exempt that role from population suppression. AgentE at tick 1 seeing dominant role exceeds 55% and slashing pool rewards is overreach.",
   check(metrics, _thresholds) {
     const { roleShares, avgSatisfaction } = metrics;
     if (avgSatisfaction < 45) {
@@ -938,7 +936,7 @@ var P8_RegulatorCannotFightDesign = {
   }
 };
 var INCENTIVE_PRINCIPLES = [
-  P5_ProfitabilityIsCompetitive,
+  P5_ProfitabilityIsRelative,
   P6_CrowdingMultiplierOnAllRoles,
   P7_NonSpecialistsSubsidiseSpecialists,
   P8_RegulatorCannotFightDesign
@@ -1134,7 +1132,7 @@ var P13_PotsAreZeroSumAndSelfRegulate = {
   id: "P13",
   name: "Pots Self-Regulate with Correct Multiplier",
   category: "currency",
-  description: "Competitive pot math: winRate \xD7 multiplier > (1 - houseCut) drains the pot. At 65% win rate, multiplier must be \u2264 1.38. We use 1.5 for slight surplus buffer.",
+  description: "Pool math: winRate \xD7 multiplier > (1 - operatorShare) drains the pot. At 65% win rate, multiplier must be \u2264 1.38. We use 1.5 for slight surplus buffer.",
   check(metrics, thresholds) {
     const { populationByRole } = metrics;
     const roleEntries = Object.entries(populationByRole).sort((a, b) => b[1] - a[1]);
@@ -1143,8 +1141,8 @@ var P13_PotsAreZeroSumAndSelfRegulate = {
       for (const curr of metrics.currencies) {
         const poolSize = currencyAmounts[curr] ?? 0;
         if (dominantCount > 5 && poolSize < 50) {
-          const { poolWinRate, poolHouseCut } = thresholds;
-          const maxSustainableMultiplier = (1 - poolHouseCut) / poolWinRate;
+          const { poolWinRate, poolOperatorShare } = thresholds;
+          const maxSustainableMultiplier = (1 - poolOperatorShare) / poolWinRate;
           return {
             violated: true,
             severity: 7,
@@ -1427,7 +1425,7 @@ var P19_StartingSupplyExceedsDemand = {
           parameterType: "reward",
           direction: "increase",
           magnitude: 0.2,
-          reasoning: `${mostPopulatedRole} (${population} agents) has insufficient resources (${resourcesPerAgent.toFixed(2)} per agent). Cold-start scarcity. Boost competitive pool reward to attract participation despite scarcity.`
+          reasoning: `${mostPopulatedRole} (${population} agents) has insufficient resources (${resourcesPerAgent.toFixed(2)} per agent). Cold-start scarcity. Boost pool reward to attract participation despite scarcity.`
         },
         confidence: 0.75,
         estimatedLag: 5
@@ -2172,7 +2170,7 @@ var P35_DestructionCreatesValue = {
             scope: { tags: ["entry"] },
             direction: "decrease",
             magnitude: 0.1,
-            reasoning: `${resource} supply at ${supply} units with low destruction (sink ${sinkVolume}/t). Resources not being consumed. Lower competitive pool entry to increase resource usage.`
+            reasoning: `${resource} supply at ${supply} units with low destruction (sink ${sinkVolume}/t). Resources not being consumed. Lower pool entry to increase resource usage.`
           },
           confidence: 0.7,
           estimatedLag: 5
@@ -2779,15 +2777,24 @@ var ALL_PRINCIPLES = [
 ];
 
 // src/Simulator.ts
+var DEFAULT_SIM_CONFIG = {
+  sinkMultiplier: 0.2,
+  faucetMultiplier: 0.15,
+  frictionMultiplier: 0.1,
+  frictionVelocityScale: 10,
+  redistributionMultiplier: 0.3,
+  neutralMultiplier: 0.05,
+  minIterations: 100,
+  maxProjectionTicks: 20
+};
 var Simulator = class {
-  constructor(registry) {
+  constructor(registry, simConfig) {
     this.diagnoser = new Diagnoser(ALL_PRINCIPLES);
-    // Cache beforeViolations for the *current* tick only (one entry max).
-    // Using a Map here is intentional but the cache must be bounded — we only
-    // care about the tick that is currently being evaluated, so we evict any
-    // entries whose key differs from the incoming tick.
-    this.beforeViolationsCache = /* @__PURE__ */ new Map();
+    // Cache beforeViolations for the *current* tick only.
+    this.cachedViolationsTick = -1;
+    this.cachedViolations = /* @__PURE__ */ new Set();
     this.registry = registry;
+    this.simConfig = { ...DEFAULT_SIM_CONFIG, ...simConfig };
   }
   /**
    * Simulate the effect of applying `action` to the current economy forward `forwardTicks`.
@@ -2811,16 +2818,13 @@ var Simulator = class {
     const mean = this.averageMetrics(outcomes);
     const netImprovement = this.checkImprovement(currentMetrics, p50, action);
     const tick = currentMetrics.tick;
-    if (this.beforeViolationsCache.size > 0 && !this.beforeViolationsCache.has(tick)) {
-      this.beforeViolationsCache.clear();
-    }
-    let beforeViolations = this.beforeViolationsCache.get(tick);
-    if (!beforeViolations) {
-      beforeViolations = new Set(
+    if (this.cachedViolationsTick !== tick) {
+      this.cachedViolations = new Set(
         this.diagnoser.diagnose(currentMetrics, thresholds).map((d) => d.principle.id)
       );
-      this.beforeViolationsCache.set(tick, beforeViolations);
+      this.cachedViolationsTick = tick;
     }
+    const beforeViolations = this.cachedViolations;
     const afterViolations = new Set(
       this.diagnoser.diagnose(p50, thresholds).map((d) => d.principle.id)
     );
@@ -2910,21 +2914,22 @@ var Simulator = class {
     if (!impact) {
       impact = this.inferFlowImpact(action.parameterType);
     }
+    const cfg = this.simConfig;
     switch (impact) {
       case "sink":
-        return sign * (metrics.netFlowByCurrency[currency] ?? 0) * 0.2;
+        return sign * (metrics.netFlowByCurrency[currency] ?? 0) * cfg.sinkMultiplier;
       case "faucet":
-        return -sign * dominantRoleCount * 0.3;
+        return -sign * dominantRoleCount * cfg.redistributionMultiplier;
       case "neutral":
-        return sign * dominantRoleCount * 0.5;
+        return sign * dominantRoleCount * cfg.neutralMultiplier;
       case "mixed":
-        return sign * (metrics.faucetVolumeByCurrency[currency] ?? 0) * 0.15;
+        return sign * (metrics.faucetVolumeByCurrency[currency] ?? 0) * cfg.faucetMultiplier;
       case "friction":
-        return sign * (metrics.netFlowByCurrency[currency] ?? 0) * 0.1;
+        return sign * (metrics.netFlowByCurrency[currency] ?? 0) * cfg.frictionMultiplier;
       case "redistribution":
-        return sign * dominantRoleCount * 0.05;
+        return sign * dominantRoleCount * cfg.neutralMultiplier;
       default:
-        return sign * (metrics.netFlowByCurrency[currency] ?? 0) * 0.1;
+        return sign * (metrics.netFlowByCurrency[currency] ?? 0) * cfg.frictionMultiplier;
     }
   }
   /** Infer flow impact from parameter type when registry is unavailable */
@@ -2945,7 +2950,7 @@ var Simulator = class {
         return "mixed";
     }
   }
-  checkImprovement(before, after, action) {
+  checkImprovement(before, after, _action) {
     const satisfactionImproved = after.avgSatisfaction >= before.avgSatisfaction - 2;
     const flowMoreBalanced = before.currencies.every((curr) => {
       const afterFlow = Math.abs(after.netFlowByCurrency[curr] ?? 0);
@@ -2957,7 +2962,6 @@ var Simulator = class {
       const beforeGini = before.giniCoefficientByCurrency[curr] ?? 0;
       return afterGini <= beforeGini + 0.05;
     });
-    void action;
     return satisfactionImproved && flowMoreBalanced && notWorseGini;
   }
   averageMetrics(outcomes) {
@@ -3109,6 +3113,14 @@ var Planner = class {
     this.cooldowns.clear();
     this.typeCooldowns.clear();
   }
+  /** V1.5.2: Reset active plan count (e.g., on system restart) */
+  resetActivePlans() {
+    this.activePlanCount = 0;
+  }
+  /** V1.5.2: Current active plan count (for diagnostics) */
+  getActivePlanCount() {
+    return this.activePlanCount;
+  }
   typeCooldownKey(type, scope) {
     const parts = [type];
     if (scope?.system) parts.push(`sys:${scope.system}`);
@@ -3125,8 +3137,9 @@ var Planner = class {
 
 // src/Executor.ts
 var Executor = class {
-  constructor() {
+  constructor(settlementWindowTicks = 200) {
     this.activePlans = [];
+    this.maxActiveTicks = settlementWindowTicks;
   }
   async apply(plan, adapter, currentParams) {
     const originalValue = currentParams[plan.parameter] ?? plan.currentValue;
@@ -3145,8 +3158,7 @@ var Executor = class {
     for (const active of this.activePlans) {
       const { plan, originalValue } = active;
       const rc = plan.rollbackCondition;
-      const maxActiveTicks = 200;
-      if (plan.appliedAt !== void 0 && metrics.tick - plan.appliedAt > maxActiveTicks) {
+      if (plan.appliedAt !== void 0 && metrics.tick - plan.appliedAt > this.maxActiveTicks) {
         settled.push(plan);
         continue;
       }
@@ -3213,9 +3225,9 @@ var DecisionLog = class {
       reasoning: this.buildReasoning(diagnosis, plan, result),
       metricsSnapshot: metrics
     };
-    this.entries.unshift(entry);
-    if (this.entries.length > this.maxEntries) {
-      this.entries.pop();
+    this.entries.push(entry);
+    if (this.entries.length > this.maxEntries * 1.5) {
+      this.entries = this.entries.slice(-this.maxEntries);
     }
     return entry;
   }
@@ -3230,8 +3242,10 @@ var DecisionLog = class {
       reasoning: reason,
       metricsSnapshot: metrics
     };
-    this.entries.unshift(entry);
-    if (this.entries.length > this.maxEntries) this.entries.pop();
+    this.entries.push(entry);
+    if (this.entries.length > this.maxEntries * 1.5) {
+      this.entries = this.entries.slice(-this.maxEntries);
+    }
   }
   query(filter) {
     return this.entries.filter((e) => {
@@ -3244,7 +3258,7 @@ var DecisionLog = class {
     });
   }
   latest(n = 30) {
-    return this.entries.slice(0, n);
+    return this.entries.slice(-n).reverse();
   }
   export(format = "json") {
     if (format === "text") {
@@ -3473,10 +3487,13 @@ var MetricStore = class {
 var PersonaTracker = class {
   constructor() {
     this.agentHistory = /* @__PURE__ */ new Map();
+    this.lastSeen = /* @__PURE__ */ new Map();
   }
   /** Ingest a state snapshot and update agent signal history */
   update(state) {
+    const tick = state.tick;
     for (const agentId of Object.keys(state.agentBalances)) {
+      this.lastSeen.set(agentId, tick);
       const history = this.agentHistory.get(agentId) ?? [];
       const inv = state.agentInventories[agentId] ?? {};
       const uniqueItems = Object.values(inv).filter((q) => q > 0).length;
@@ -3494,6 +3511,14 @@ var PersonaTracker = class {
       if (history.length > 50) history.shift();
       this.agentHistory.set(agentId, history);
     }
+    if (tick % 50 === 0) {
+      for (const [id, lastTick] of this.lastSeen) {
+        if (tick - lastTick > 100) {
+          this.agentHistory.delete(id);
+          this.lastSeen.delete(id);
+        }
+      }
+    }
   }
   /** Classify all agents and return persona distribution */
   getDistribution() {
@@ -3685,7 +3710,6 @@ var ParameterRegistry = class {
 var AgentE = class {
   constructor(config) {
     this.planner = new Planner();
-    this.executor = new Executor();
     this.registry = new ParameterRegistry();
     // ── State ──
     this.log = new DecisionLog();
@@ -3708,6 +3732,8 @@ var AgentE = class {
       dominantRoles: config.dominantRoles ?? [],
       idealDistribution: config.idealDistribution ?? {},
       validateRegistry: config.validateRegistry ?? true,
+      simulation: config.simulation ?? {},
+      settlementWindowTicks: config.settlementWindowTicks ?? 200,
       tickConfig: config.tickConfig ?? { duration: 1, unit: "tick" },
       gracePeriod: config.gracePeriod ?? 50,
       checkInterval: config.checkInterval ?? 5,
@@ -3733,7 +3759,8 @@ var AgentE = class {
       for (const w of validation.warnings) console.warn(`[AgentE] Registry warning: ${w}`);
       for (const e of validation.errors) console.error(`[AgentE] Registry error: ${e}`);
     }
-    this.simulator = new Simulator(this.registry);
+    this.executor = new Executor(config.settlementWindowTicks);
+    this.simulator = new Simulator(this.registry, config.simulation);
     if (config.onDecision) this.on("decision", config.onDecision);
     if (config.onAlert) this.on("alert", config.onAlert);
     if (config.onRollback) this.on("rollback", config.onRollback);
@@ -3769,7 +3796,7 @@ var AgentE = class {
     if (!this.isRunning || this.isPaused) return;
     const currentState = state ?? await Promise.resolve(this.adapter.getState());
     this.currentTick = currentState.tick;
-    const events = [...this.eventBuffer];
+    const events = this.eventBuffer;
     this.eventBuffer = [];
     let metrics;
     try {
@@ -3887,7 +3914,9 @@ var AgentE = class {
   // ── Events ──────────────────────────────────────────────────────────────────
   on(event, handler) {
     const list = this.handlers.get(event) ?? [];
-    list.push(handler);
+    if (!list.includes(handler)) {
+      list.push(handler);
+    }
     this.handlers.set(event, list);
     return this;
   }
@@ -3900,8 +3929,12 @@ var AgentE = class {
     const list = this.handlers.get(event) ?? [];
     let result;
     for (const handler of list) {
-      result = handler(...args);
-      if (result === false) return false;
+      try {
+        result = handler(...args);
+        if (result === false) return false;
+      } catch (err) {
+        console.error(`[AgentE] Handler error on '${event}':`, err);
+      }
     }
     return result;
   }
@@ -4358,7 +4391,7 @@ export {
   P57_CombinatorialPriceSpace,
   P58_NoNaturalNumeraire,
   P59_GiftEconomyNoise,
-  P5_ProfitabilityIsCompetitive,
+  P5_ProfitabilityIsRelative,
   P60_SurplusDisposalAsymmetry,
   P6_CrowdingMultiplierOnAllRoles,
   P7_NonSpecialistsSubsidiseSpecialists,