@agent-e/core 1.2.0 → 1.2.1

package/README.md

@@ -13,25 +13,30 @@ npm install @agent-e/core
 ```typescript
 import { AgentE } from '@agent-e/core';
 
-const agent = new AgentE({
-  adapter: {
-    getState: () => ({
-      tick: currentTick,
-      agentBalances: { /* id → balance */ },
-      agentRoles: { /* id → role */ },
-      agentInventories: { /* id → { resource → qty } */ },
-      marketPrices: { /* resource → price */ },
-      agentSatisfaction: { /* id → 0-100 */ },
-      poolSizes: { /* pool → amount */ },
-    }),
-    setParam: async (param, value) => {
-      // Apply parameter change to your economy
-    },
+const adapter = {
+  getState: () => ({
+    tick: currentTick,
+    agentBalances: { /* id → balance */ },
+    agentRoles: { /* id → role */ },
+    agentInventories: { /* id → { resource → qty } */ },
+    marketPrices: { /* resource → price */ },
+    agentSatisfaction: { /* id → 0-100 */ },
+    poolSizes: { /* pool → amount */ },
+    roles: ['consumer', 'producer'],       // all possible roles
+    resources: ['goodA', 'goodB'],         // all possible resources
+    currency: 'credits',                   // currency name
+  }),
+  setParam: async (param, value) => {
+    // Apply parameter change to your economy
   },
+};
+
+const agent = new AgentE({
+  adapter,
   mode: 'advisor', // or 'autonomous'
 });
 
-agent.connect(agent.adapter).start();
+agent.connect(adapter).start();
 
 // Call once per tick in your loop:
 await agent.tick();

package/dist/index.js

@@ -215,6 +215,7 @@ var Observer = class {
     const tradeEvents = [];
     const roleChangeEvents = [];
     let churnCount = 0;
+    let productionAmount = 0;
     for (const e of recentEvents) {
       switch (e.type) {
         case "mint":
@@ -225,6 +226,9 @@ var Observer = class {
         case "consume":
           sinkVolume += e.amount ?? 0;
           break;
+        case "produce":
+          productionAmount += e.amount ?? 1;
+          break;
         case "trade":
           tradeEvents.push(e);
           break;
@@ -298,7 +302,7 @@ var Observer = class {
         pinchPoints[resource] = "optimal";
       }
     }
-    const productionIndex = recentEvents.filter((e) => e.type === "produce").reduce((s, e) => s + (e.amount ?? 1), 0);
+    const productionIndex = productionAmount;
     const maxPossibleProduction = productionIndex + sinkVolume;
     const capacityUsage = maxPossibleProduction > 0 ? productionIndex / maxPossibleProduction : 0;
     const satisfactions = Object.values(state.agentSatisfaction ?? {});
@@ -996,7 +1000,7 @@ var P12_OnePrimaryFaucet = {
   id: "P12",
   name: "One Primary Faucet",
   category: "currency",
-  description: "Multiple independent currency sources (gathering + crafting + quests) each creating gold causes uncontrolled inflation. One clear primary faucet makes the economy predictable and auditable.",
+  description: "Multiple independent currency sources (gathering + production + quests) each creating currency causes uncontrolled inflation. One clear primary faucet makes the economy predictable and auditable.",
   check(metrics, thresholds) {
     const { netFlow, faucetVolume, sinkVolume } = metrics;
     if (netFlow > thresholds.netFlowWarnThreshold) {
@@ -1008,7 +1012,7 @@ var P12_OnePrimaryFaucet = {
           parameter: "productionCost",
           direction: "increase",
           magnitude: 0.15,
-          reasoning: `Net flow +${netFlow.toFixed(1)} g/t. Inflationary. Increase crafting cost (primary sink) to balance faucet output.`
+          reasoning: `Net flow +${netFlow.toFixed(1)}/tick. Inflationary. Increase production cost (primary sink) to balance faucet output.`
         },
         confidence: 0.8,
         estimatedLag: 8
@@ -1023,7 +1027,7 @@ var P12_OnePrimaryFaucet = {
           parameter: "productionCost",
           direction: "decrease",
           magnitude: 0.15,
-          reasoning: `Net flow ${netFlow.toFixed(1)} g/t. Deflationary. Decrease crafting cost to ease sink pressure.`
+          reasoning: `Net flow ${netFlow.toFixed(1)}/tick. Deflationary. Decrease production cost to ease sink pressure.`
         },
         confidence: 0.8,
         estimatedLag: 8
@@ -1082,7 +1086,7 @@ var P14_TrackActualInjection = {
           parameter: "yieldRate",
           direction: "decrease",
           magnitude: 0.1,
-          reasoning: `Supply growing at ${(supplyGrowthRate * 100).toFixed(1)}%/tick. Verify gold injection tracking. Resources should not create gold directly.`
+          reasoning: `Supply growing at ${(supplyGrowthRate * 100).toFixed(1)}%/tick. Verify currency injection tracking. Resources should not create currency directly.`
         },
         confidence: 0.55,
         estimatedLag: 5
@@ -1095,7 +1099,7 @@ var P15_PoolsNeedCapAndDecay = {
   id: "P15",
   name: "Pools Need Cap + Decay",
   category: "currency",
-  description: "Any pool (bank, reward pool) without a cap accumulates infinitely. Bank pool at 42% of gold supply means 42% of the economy is frozen. Cap at 5%, decay at 2%/tick.",
+  description: "Any pool (bank, reward pool) without a cap accumulates infinitely. A pool at 42% of total supply means 42% of the economy is frozen. Cap at 5%, decay at 2%/tick.",
   check(metrics, thresholds) {
     const { poolSizes, totalSupply } = metrics;
     const { poolCapPercent } = thresholds;
@@ -1110,7 +1114,7 @@ var P15_PoolsNeedCapAndDecay = {
             parameter: "transactionFee",
             direction: "decrease",
             magnitude: 0.1,
-            reasoning: `${pool} pool at ${(shareOfSupply * 100).toFixed(1)}% of supply (cap: ${(poolCapPercent * 100).toFixed(0)}%). Gold frozen. Lower fees to encourage circulation over accumulation.`
+            reasoning: `${pool} pool at ${(shareOfSupply * 100).toFixed(1)}% of supply (cap: ${(poolCapPercent * 100).toFixed(0)}%). Currency frozen. Lower fees to encourage circulation over accumulation.`
           },
           confidence: 0.85,
           estimatedLag: 5
@@ -1252,25 +1256,22 @@ var P18_FirstProducerNeedsStartingInventory = {
   description: "A producer with 0 resources and 0 currency must sell nothing to get currency before they can buy raw materials. This creates a chicken-and-egg freeze. Starting inventory (2 goods + 4 raw materials + 40 currency) breaks the deadlock.",
   check(metrics, _thresholds) {
     if (metrics.tick > 20) return { violated: false };
+    const hasAgents = metrics.totalAgents > 0;
     for (const [resource, supply] of Object.entries(metrics.supplyByResource)) {
-      if (supply === 0) {
-        for (const [role, population] of Object.entries(metrics.populationByRole)) {
-          if (population > 0) {
-            return {
-              violated: true,
-              severity: 8,
-              evidence: { tick: metrics.tick, resource, supply, role, population },
-              suggestedAction: {
-                parameter: "productionCost",
-                direction: "decrease",
-                magnitude: 0.5,
-                reasoning: `Bootstrap failure: ${role} exists but ${resource} supply is 0 on tick 1-20. Drastically reduce production cost to allow immediate output.`
-              },
-              confidence: 0.9,
-              estimatedLag: 2
-            };
-          }
-        }
+      if (supply === 0 && hasAgents) {
+        return {
+          violated: true,
+          severity: 8,
+          evidence: { tick: metrics.tick, resource, supply, totalAgents: metrics.totalAgents },
+          suggestedAction: {
+            parameter: "productionCost",
+            direction: "decrease",
+            magnitude: 0.5,
+            reasoning: `Bootstrap failure: ${resource} supply is 0 at tick ${metrics.tick} with ${metrics.totalAgents} agents. Drastically reduce production cost to allow immediate output.`
+          },
+          confidence: 0.9,
+          estimatedLag: 2
+        };
       }
     }
     return { violated: false };
@@ -1911,7 +1912,7 @@ var P42_TheMedianPrinciple = {
           parameter: "transactionFee",
           direction: "increase",
           magnitude: 0.15,
-          reasoning: `Mean/median divergence ${(meanMedianDivergence * 100).toFixed(0)}% (threshold: ${(thresholds.meanMedianDivergenceMax * 100).toFixed(0)}%). Economy has outliers skewing metrics. Use median for decisions. Raise auction fees to redistribute wealth.`
+          reasoning: `Mean/median divergence ${(meanMedianDivergence * 100).toFixed(0)}% (threshold: ${(thresholds.meanMedianDivergenceMax * 100).toFixed(0)}%). Economy has outliers skewing metrics. Use median for decisions. Raise transaction fees to redistribute wealth.`
         },
         confidence: 0.85,
         estimatedLag: 15