@agent-e/core 1.5.1 → 1.5.3

package/README.md

@@ -1,6 +1,6 @@
 # @agent-e/core
 
-Autonomous economic balancer SDK. 60 built-in principles, 5-stage pipeline, zero dependencies.
+Autonomous economic balancer SDK. 60 built-in principles, 5-stage pipeline, zero dependencies. Works with any digital economy.
 
 ## Install
 
@@ -13,43 +13,43 @@ npm install @agent-e/core
 ```typescript
 import { AgentE } from '@agent-e/core';
 
-const adapter = {
-  getState: () => ({
-    tick: currentTick,
-    currencies: ['gold', 'gems'],
-    agentBalances: {
-      player1: { gold: 100, gems: 50 },
-      player2: { gold: 200, gems: 10 },
-    },
-    agentRoles: { /* id → role */ },
-    agentInventories: { /* id → { resource → qty } */ },
-    marketPrices: {
-      gold: { sword: 10, potion: 5 },
-      gems: { sword: 2, potion: 1 },
+const agent = new AgentE({
+  adapter: {
+    getState: () => ({
+      tick: currentTick,
+      currencies: ['currency_a', 'currency_b'],
+      systems: ['system_1', 'system_2'],
+      agentBalances: {
+        agent_001: { currency_a: 500, currency_b: 20 },
+        agent_002: { currency_a: 120, currency_b: 80 },
+      },
+      agentRoles: { agent_001: 'role_a', agent_002: 'role_b' },
+      marketPrices: {
+        currency_a: { resource_x: 10, resource_y: 25 },
+      },
+      agentSatisfaction: { agent_001: 72, agent_002: 85 },
+      poolSizes: { main_pool: { currency_a: 5000 } },
+      roles: ['role_a', 'role_b'],
+      resources: ['resource_x', 'resource_y'],
+      recentTransactions: [],
+    }),
+    setParam: async (param, value, scope) => {
+      applyToYourEconomy(param, value, scope);
     },
-    agentSatisfaction: { /* id → 0-100 */ },
-    poolSizes: { rewardPool: { gold: 500, gems: 100 } },
-    roles: ['warrior', 'mage'],
-    resources: ['sword', 'potion'],
-    recentTransactions: [],
-  }),
-  setParam: async (param, value, currency) => {
-    // currency tells you which economy to adjust
-    applyToYourEconomy(param, value, currency);
   },
-};
-
-const agent = new AgentE({
-  adapter,
-  mode: 'advisor', // or 'autonomous'
+  parameters: [
+    { key: 'your_fee_param',    type: 'fee',    flowImpact: 'friction', scope: { system: 'system_1' } },
+    { key: 'your_reward_param', type: 'reward', flowImpact: 'faucet',   scope: { system: 'system_2' } },
+  ],
+  mode: 'advisor',
 });
 
-agent.connect(adapter).start();
-
-// Call once per tick in your loop:
+agent.start();
 await agent.tick();
 ```
 
+**Replace the placeholder names with YOUR economy's actual names.** See the root README for real-world examples (game, DeFi, marketplace).
+
 ## The 5-Stage Pipeline
 
 1. **Observer** — Translates raw state into 40+ metrics at 3 resolutions (fine/medium/coarse)
@@ -58,54 +58,75 @@ await agent.tick();
 4. **Planner** — Lag-aware, cooldown-aware planning with rollback conditions
 5. **Executor** — Applies actions and monitors for rollback triggers
 
-## Multi-Currency Support
+## Parameter Registry
 
-AgentE tracks each currency independently. Every currency gets its own:
-- Supply, net flow, velocity, inflation rate
-- Gini coefficient, median/mean balance, wealth distribution
-- Faucet/sink volumes, pool sizes
-- Price index, arbitrage index
+Register your parameters with semantic types and flow impacts:
 
-When a principle detects an issue, the violation tells you which currency
-is unhealthy and the suggested action is scoped to that currency.
+```typescript
+parameters: [
+  // key: whatever YOU call it
+  // type: what kind of lever is it?
+  // flowImpact: what does it do to currency flow?
+  // scope: where in your economy does it live?
+
+  { key: 'my_fee',      type: 'fee',      flowImpact: 'friction',       scope: { system: 'trading' } },
+  { key: 'my_reward',   type: 'reward',   flowImpact: 'faucet',         scope: { system: 'engagement' } },
+  { key: 'my_rate',     type: 'rate',     flowImpact: 'sink',           scope: { system: 'burning' } },
+  { key: 'my_yield',    type: 'yield',    flowImpact: 'faucet',         scope: { system: 'staking', currency: 'currency_b' } },
+  { key: 'my_cut',      type: 'fee',      flowImpact: 'sink',           scope: { system: 'platform', tags: ['operator'] } },
+]
+```
 
-## Modes
+Principles say "decrease `fee` in `trading`" — the registry resolves to `my_fee`. Your names stay yours.
 
-| Mode | Behavior |
-|------|----------|
-| `autonomous` | Full pipeline — executes parameter changes automatically |
-| `advisor` | Full pipeline but stops before execution — emits recommendations via `onDecision` |
+### Semantic Types
 
-## 60 Principles
+| Type | What it means |
+|------|--------------|
+| `cost` | Something participants pay to do an action |
+| `fee` | A percentage or flat charge on transactions |
+| `reward` | Something participants receive for an action |
+| `yield` | Passive income from holding or staking |
+| `rate` | A speed or frequency multiplier |
+| `multiplier` | A scaling factor |
+| `threshold` | A boundary value that triggers behavior |
+| `weight` | A relative importance factor |
+| `custom` | Anything else |
 
-Organized across 15 categories: supply chain, incentives, population, currency flow, bootstrap, feedback loops, regulator, market dynamics, measurement, statistical, system dynamics, resource management, player experience, open economy, and liveops.
+### Flow Impacts
 
-Each principle has a `check(metrics, thresholds)` function that returns either `{ violated: false }` or a violation with severity, evidence, suggested action, confidence, and estimated lag.
+| Impact | What it does to currency flow |
+|--------|------------------------------|
+| `sink` | Removes currency from circulation |
+| `faucet` | Adds currency to circulation |
+| `friction` | Slows velocity without removing currency |
+| `redistribution` | Moves currency between participants |
+| `neutral` | No direct effect on flow |
 
-## Tick Configuration
+## Multi-System, Multi-Currency
 
-```typescript
-const agent = new AgentE({
-  adapter: yourAdapter,
-  tickConfig: {
-    duration: 5,          // one tick = 5 seconds
-    unit: 'second',
-    mediumWindow: 12,     // medium metrics = every 12 ticks (60s)
-    coarseWindow: 120,    // coarse metrics = every 120 ticks (10min)
-  },
-});
-```
+AgentE tracks each system and currency independently:
+
+- Per-currency: supply, net flow, velocity, inflation, Gini, wealth distribution, faucet/sink volumes, price index
+- Per-system: flow, activity, participant count
+- Cross-system: arbitrage index, source/sink share analysis
+
+## Modes
+
+| Mode | Behavior |
+|------|----------|
+| `autonomous` | Full pipeline — executes parameter changes automatically |
+| `advisor` | Full pipeline but stops before execution — emits recommendations via `onDecision` |
 
 ## Developer API
 
 ```typescript
-// Lock a parameter from automated adjustment
-agent.lock('productionCost');          // lock for ALL currencies
-// Future: agent.lock('productionCost', 'gems');  // lock for specific currency
-agent.unlock('productionCost');
+// Lock — AgentE will never adjust this parameter
+agent.lock('your_param_name');
+agent.unlock('your_param_name');
 
-// Constrain a parameter to a range
-agent.constrain('transactionFee', { min: 0.01, max: 0.50 });
+// Constrain — AgentE can adjust, but only within this range
+agent.constrain('another_param', { min: 0.01, max: 0.50 });
 
 // Add a custom principle
 agent.addPrinciple(myPrinciple);
@@ -115,7 +136,7 @@ agent.registerCustomMetric('myMetric', (state) => compute(state));
 
 // Veto actions
 agent.on('beforeAction', (plan) => {
-  if (plan.targetValue > 2.0) return false;
+  if (plan.parameterType === 'reward') return false;
 });
 
 // Query decision history
@@ -135,21 +156,22 @@ import type { Principle } from '@agent-e/core';
 
 const myRule: Principle = {
   id: 'MY_01',
-  name: 'Support Role Population Floor',
+  name: 'Minimum Provider Population',
   category: 'population',
-  description: 'Support role share below 5% is a crisis',
+  description: 'Triggers when a critical role drops below 5% of population',
   check(metrics, thresholds) {
-    const share = metrics.roleShares['support'] ?? 0;
+    const share = metrics.roleShares['role_a'] ?? 0;
     if (share < 0.05) {
       return {
         violated: true,
         severity: 8,
         evidence: { share },
         suggestedAction: {
-          parameter: 'supportReward',
+          parameterType: 'reward',
+          scope: { tags: ['role_a'] },
           direction: 'increase',
           magnitude: 0.25,
-          reasoning: 'Support role population critically low.',
+          reasoning: 'Critical role population below 5%.',
         },
         confidence: 0.90,
         estimatedLag: 10,
@@ -162,14 +184,23 @@ const myRule: Principle = {
 agent.addPrinciple(myRule);
 ```
 
+## 60 Principles
+
+Organized across 15 categories: supply chain, incentives, population, currency flow, bootstrap, feedback loops, regulator, market dynamics, measurement, statistical, system dynamics, resource management, participant experience, open economy, and operations.
+
 ## Performance
 
 - **O(N) event classification** — single-pass instead of 6 separate filters
+- **O(n) arbitrage index** — log-price standard deviation instead of pairwise
 - **Cached diagnosis** — no redundant principle checks within the same tick
-- **Numerical stability** — clamped inputs to prevent NaN edge cases
+- **Numerical stability** — clamped inputs to prevent NaN/Infinity edge cases
 
 Typical for 1,000 agents, 100 events/tick: ~60ms end-to-end.
 
 ## License
 
 MIT
+
+---
+
+**Built by Oka × Claude — AB Labs**

package/dist/index.d.mts

@@ -303,7 +303,7 @@ interface Thresholds {
     maxAdjustmentPercent: number;
     cooldownTicks: number;
     poolWinRate: number;
-    poolHouseCut: number;
+    poolOperatorShare: number;
     roleSwitchFrictionMax: number;
     poolCapPercent: number;
     poolDecayRate: number;
@@ -332,6 +332,16 @@ interface TickConfig {
     /** Coarse-resolution metric window in ticks. Default: 100 */
     coarseWindow?: number;
 }
+interface SimulationConfig {
+    sinkMultiplier?: number;
+    faucetMultiplier?: number;
+    frictionMultiplier?: number;
+    frictionVelocityScale?: number;
+    redistributionMultiplier?: number;
+    neutralMultiplier?: number;
+    minIterations?: number;
+    maxProjectionTicks?: number;
+}
 type AgentEMode = 'autonomous' | 'advisor';
 interface AgentEConfig {
     adapter: EconomyAdapter;
@@ -346,6 +356,8 @@ interface AgentEConfig {
     checkInterval?: number;
     maxAdjustmentPercent?: number;
     cooldownTicks?: number;
+    simulation?: SimulationConfig;
+    settlementWindowTicks?: number;
     thresholds?: Partial<Thresholds>;
     onDecision?: (entry: DecisionEntry) => void;
     onAlert?: (diagnosis: Diagnosis) => void;
@@ -503,8 +515,10 @@ declare class Observer {
 declare class Simulator {
     private diagnoser;
     private registry;
-    constructor(registry?: ParameterRegistry);
-    private beforeViolationsCache;
+    private simConfig;
+    constructor(registry?: ParameterRegistry, simConfig?: SimulationConfig);
+    private cachedViolationsTick;
+    private cachedViolations;
     /**
      * Simulate the effect of applying `action` to the current economy forward `forwardTicks`.
      * Runs `iterations` Monte Carlo trials and returns the outcome distribution.
@@ -556,12 +570,19 @@ declare class Planner {
     isOnCooldown(param: string, currentTick: number, cooldownTicks: number): boolean;
     /** Reset all cooldowns (useful for testing) */
     resetCooldowns(): void;
+    /** V1.5.2: Reset active plan count (e.g., on system restart) */
+    resetActivePlans(): void;
+    /** V1.5.2: Current active plan count (for diagnostics) */
+    getActivePlanCount(): number;
     private typeCooldownKey;
     private isTypeCooldown;
 }
 
+type ExecutionResult = 'applied' | 'rolled_back' | 'rollback_skipped';
 declare class Executor {
     private activePlans;
+    private maxActiveTicks;
+    constructor(settlementWindowTicks?: number);
     apply(plan: ActionPlan, adapter: EconomyAdapter, currentParams: Record<string, number>): Promise<void>;
     /**
      * Check all active plans for rollback conditions.
@@ -577,6 +598,7 @@ declare class Executor {
 
 declare class PersonaTracker {
     private agentHistory;
+    private lastSeen;
     /** Ingest a state snapshot and update agent signal history */
     update(state: EconomyState): void;
     /** Classify all agents and return persona distribution */
@@ -628,7 +650,7 @@ declare const P4_MaterialsFlowFasterThanCooldown: Principle;
 declare const P60_SurplusDisposalAsymmetry: Principle;
 declare const SUPPLY_CHAIN_PRINCIPLES: Principle[];
 
-declare const P5_ProfitabilityIsCompetitive: Principle;
+declare const P5_ProfitabilityIsRelative: Principle;
 declare const P6_CrowdingMultiplierOnAllRoles: Principle;
 declare const P7_NonSpecialistsSubsidiseSpecialists: Principle;
 declare const P8_RegulatorCannotFightDesign: Principle;
@@ -714,4 +736,4 @@ declare const OPERATIONS_PRINCIPLES: Principle[];
 /** All 60 built-in principles in priority order (supply chain → operations) */
 declare const ALL_PRINCIPLES: Principle[];
 
-export { ALL_PRINCIPLES, type ActionPlan, AgentE, type AgentEConfig, type AgentEMode, BOOTSTRAP_PRINCIPLES, CURRENCY_FLOW_PRINCIPLES, DEFAULT_THRESHOLDS, type DecisionEntry, DecisionLog, type DecisionResult, Diagnoser, type Diagnosis, type EconomicEvent, type EconomicEventType, type EconomyAdapter, type EconomyMetrics, type EconomyState, Executor, FEEDBACK_LOOP_PRINCIPLES, type FlowImpact, INCENTIVE_PRINCIPLES, MARKET_DYNAMICS_PRINCIPLES, MEASUREMENT_PRINCIPLES, type MetricQuery, type MetricQueryResult, type MetricResolution, MetricStore, OPEN_ECONOMY_PRINCIPLES, OPERATIONS_PRINCIPLES, Observer, P10_EntryWeightingUsesInversePopulation, P11_TwoTierPressure, P12_OnePrimaryFaucet, P13_PotsAreZeroSumAndSelfRegulate, P14_TrackActualInjection, P15_PoolsNeedCapAndDecay, P16_WithdrawalPenaltyScales, P17_GracePeriodBeforeIntervention, P18_FirstProducerNeedsStartingInventory, P19_StartingSupplyExceedsDemand, P1_ProductionMatchesConsumption, P20_DecayPreventsAccumulation, P21_PriceFromGlobalSupply, P22_MarketAwarenessPreventsSurplus, P23_ProfitabilityFactorsFeasibility, P24_BlockedAgentsDecayFaster, P25_CorrectLeversForCorrectProblems, P26_ContinuousPressureBeatsThresholdCuts, P27_AdjustmentsNeedCooldowns, P28_StructuralDominanceIsNotPathological, P29_BottleneckDetection, P2_ClosedLoopsNeedDirectHandoff, P30_DynamicBottleneckRotation, P31_AnchorValueTracking, P32_VelocityAboveSupply, P33_FairNotEqual, P34_ExtractionRatio, P35_DestructionCreatesValue, P36_MechanicFrictionDetector, P37_LatecommerProblem, P38_CommunicationPreventsRevolt, P39_TheLagPrinciple, P3_BootstrapCapitalCoversFirstTransaction, P40_ReplacementRate, P41_MultiResolutionMonitoring, P42_TheMedianPrinciple, P43_SimulationMinimum, P44_ComplexityBudget, P45_TimeBudget, P46_PersonaDiversity, P47_SmokeTest, P48_CurrencyInsulation, P49_IdleAssetTax, P4_MaterialsFlowFasterThanCooldown, P50_PayPowerRatio, P51_CyclicalEngagement, P52_EndowmentEffect, P53_EventCompletionRate, P54_OperationalCadence, P55_ArbitrageThermometer, P56_SupplyShockAbsorption, P57_CombinatorialPriceSpace, P58_NoNaturalNumeraire, P59_GiftEconomyNoise, P5_ProfitabilityIsCompetitive, P60_SurplusDisposalAsymmetry, P6_CrowdingMultiplierOnAllRoles, P7_NonSpecialistsSubsidiseSpecialists, P8_RegulatorCannotFightDesign, P9_RoleSwitchingNeedsFriction, PARTICIPANT_EXPERIENCE_PRINCIPLES, PERSONA_HEALTHY_RANGES, POPULATION_PRINCIPLES, ParameterRegistry, type ParameterScope, type ParameterType, type PersonaProfile, PersonaTracker, type PersonaType, type PinchPointStatus, Planner, type Principle, type PrincipleCategory, type PrincipleOk, type PrincipleResult, type PrincipleViolation, REGULATOR_PRINCIPLES, RESOURCE_MGMT_PRINCIPLES, type RegisteredParameter, type RegistryValidationResult, type RollbackCondition, STATISTICAL_PRINCIPLES, SUPPLY_CHAIN_PRINCIPLES, SYSTEM_DYNAMICS_PRINCIPLES, type SimulationOutcome, type SimulationResult, Simulator, type SuggestedAction, type Thresholds, type TickConfig, type ValidationError, type ValidationResult, type ValidationWarning, emptyMetrics, findWorstSystem, validateEconomyState };
+export { ALL_PRINCIPLES, type ActionPlan, AgentE, type AgentEConfig, type AgentEMode, BOOTSTRAP_PRINCIPLES, CURRENCY_FLOW_PRINCIPLES, DEFAULT_THRESHOLDS, type DecisionEntry, DecisionLog, type DecisionResult, Diagnoser, type Diagnosis, type EconomicEvent, type EconomicEventType, type EconomyAdapter, type EconomyMetrics, type EconomyState, type ExecutionResult, Executor, FEEDBACK_LOOP_PRINCIPLES, type FlowImpact, INCENTIVE_PRINCIPLES, MARKET_DYNAMICS_PRINCIPLES, MEASUREMENT_PRINCIPLES, type MetricQuery, type MetricQueryResult, type MetricResolution, MetricStore, OPEN_ECONOMY_PRINCIPLES, OPERATIONS_PRINCIPLES, Observer, P10_EntryWeightingUsesInversePopulation, P11_TwoTierPressure, P12_OnePrimaryFaucet, P13_PotsAreZeroSumAndSelfRegulate, P14_TrackActualInjection, P15_PoolsNeedCapAndDecay, P16_WithdrawalPenaltyScales, P17_GracePeriodBeforeIntervention, P18_FirstProducerNeedsStartingInventory, P19_StartingSupplyExceedsDemand, P1_ProductionMatchesConsumption, P20_DecayPreventsAccumulation, P21_PriceFromGlobalSupply, P22_MarketAwarenessPreventsSurplus, P23_ProfitabilityFactorsFeasibility, P24_BlockedAgentsDecayFaster, P25_CorrectLeversForCorrectProblems, P26_ContinuousPressureBeatsThresholdCuts, P27_AdjustmentsNeedCooldowns, P28_StructuralDominanceIsNotPathological, P29_BottleneckDetection, P2_ClosedLoopsNeedDirectHandoff, P30_DynamicBottleneckRotation, P31_AnchorValueTracking, P32_VelocityAboveSupply, P33_FairNotEqual, P34_ExtractionRatio, P35_DestructionCreatesValue, P36_MechanicFrictionDetector, P37_LatecommerProblem, P38_CommunicationPreventsRevolt, P39_TheLagPrinciple, P3_BootstrapCapitalCoversFirstTransaction, P40_ReplacementRate, P41_MultiResolutionMonitoring, P42_TheMedianPrinciple, P43_SimulationMinimum, P44_ComplexityBudget, P45_TimeBudget, P46_PersonaDiversity, P47_SmokeTest, P48_CurrencyInsulation, P49_IdleAssetTax, P4_MaterialsFlowFasterThanCooldown, P50_PayPowerRatio, P51_CyclicalEngagement, P52_EndowmentEffect, P53_EventCompletionRate, P54_OperationalCadence, P55_ArbitrageThermometer, P56_SupplyShockAbsorption, P57_CombinatorialPriceSpace, P58_NoNaturalNumeraire, P59_GiftEconomyNoise, P5_ProfitabilityIsRelative, P60_SurplusDisposalAsymmetry, P6_CrowdingMultiplierOnAllRoles, P7_NonSpecialistsSubsidiseSpecialists, P8_RegulatorCannotFightDesign, P9_RoleSwitchingNeedsFriction, PARTICIPANT_EXPERIENCE_PRINCIPLES, PERSONA_HEALTHY_RANGES, POPULATION_PRINCIPLES, ParameterRegistry, type ParameterScope, type ParameterType, type PersonaProfile, PersonaTracker, type PersonaType, type PinchPointStatus, Planner, type Principle, type PrincipleCategory, type PrincipleOk, type PrincipleResult, type PrincipleViolation, REGULATOR_PRINCIPLES, RESOURCE_MGMT_PRINCIPLES, type RegisteredParameter, type RegistryValidationResult, type RollbackCondition, STATISTICAL_PRINCIPLES, SUPPLY_CHAIN_PRINCIPLES, SYSTEM_DYNAMICS_PRINCIPLES, type SimulationConfig, type SimulationOutcome, type SimulationResult, Simulator, type SuggestedAction, type Thresholds, type TickConfig, type ValidationError, type ValidationResult, type ValidationWarning, emptyMetrics, findWorstSystem, validateEconomyState };

package/dist/index.d.ts

@@ -303,7 +303,7 @@ interface Thresholds {
     maxAdjustmentPercent: number;
     cooldownTicks: number;
     poolWinRate: number;
-    poolHouseCut: number;
+    poolOperatorShare: number;
     roleSwitchFrictionMax: number;
     poolCapPercent: number;
     poolDecayRate: number;
@@ -332,6 +332,16 @@ interface TickConfig {
     /** Coarse-resolution metric window in ticks. Default: 100 */
     coarseWindow?: number;
 }
+interface SimulationConfig {
+    sinkMultiplier?: number;
+    faucetMultiplier?: number;
+    frictionMultiplier?: number;
+    frictionVelocityScale?: number;
+    redistributionMultiplier?: number;
+    neutralMultiplier?: number;
+    minIterations?: number;
+    maxProjectionTicks?: number;
+}
 type AgentEMode = 'autonomous' | 'advisor';
 interface AgentEConfig {
     adapter: EconomyAdapter;
@@ -346,6 +356,8 @@ interface AgentEConfig {
     checkInterval?: number;
     maxAdjustmentPercent?: number;
     cooldownTicks?: number;
+    simulation?: SimulationConfig;
+    settlementWindowTicks?: number;
     thresholds?: Partial<Thresholds>;
     onDecision?: (entry: DecisionEntry) => void;
     onAlert?: (diagnosis: Diagnosis) => void;
@@ -503,8 +515,10 @@ declare class Observer {
 declare class Simulator {
     private diagnoser;
     private registry;
-    constructor(registry?: ParameterRegistry);
-    private beforeViolationsCache;
+    private simConfig;
+    constructor(registry?: ParameterRegistry, simConfig?: SimulationConfig);
+    private cachedViolationsTick;
+    private cachedViolations;
     /**
      * Simulate the effect of applying `action` to the current economy forward `forwardTicks`.
      * Runs `iterations` Monte Carlo trials and returns the outcome distribution.
@@ -556,12 +570,19 @@ declare class Planner {
     isOnCooldown(param: string, currentTick: number, cooldownTicks: number): boolean;
     /** Reset all cooldowns (useful for testing) */
     resetCooldowns(): void;
+    /** V1.5.2: Reset active plan count (e.g., on system restart) */
+    resetActivePlans(): void;
+    /** V1.5.2: Current active plan count (for diagnostics) */
+    getActivePlanCount(): number;
     private typeCooldownKey;
     private isTypeCooldown;
 }
 
+type ExecutionResult = 'applied' | 'rolled_back' | 'rollback_skipped';
 declare class Executor {
     private activePlans;
+    private maxActiveTicks;
+    constructor(settlementWindowTicks?: number);
     apply(plan: ActionPlan, adapter: EconomyAdapter, currentParams: Record<string, number>): Promise<void>;
     /**
      * Check all active plans for rollback conditions.
@@ -577,6 +598,7 @@ declare class Executor {
 
 declare class PersonaTracker {
     private agentHistory;
+    private lastSeen;
     /** Ingest a state snapshot and update agent signal history */
     update(state: EconomyState): void;
     /** Classify all agents and return persona distribution */
@@ -628,7 +650,7 @@ declare const P4_MaterialsFlowFasterThanCooldown: Principle;
 declare const P60_SurplusDisposalAsymmetry: Principle;
 declare const SUPPLY_CHAIN_PRINCIPLES: Principle[];
 
-declare const P5_ProfitabilityIsCompetitive: Principle;
+declare const P5_ProfitabilityIsRelative: Principle;
 declare const P6_CrowdingMultiplierOnAllRoles: Principle;
 declare const P7_NonSpecialistsSubsidiseSpecialists: Principle;
 declare const P8_RegulatorCannotFightDesign: Principle;
@@ -714,4 +736,4 @@ declare const OPERATIONS_PRINCIPLES: Principle[];
 /** All 60 built-in principles in priority order (supply chain → operations) */
 declare const ALL_PRINCIPLES: Principle[];
 
-export { ALL_PRINCIPLES, type ActionPlan, AgentE, type AgentEConfig, type AgentEMode, BOOTSTRAP_PRINCIPLES, CURRENCY_FLOW_PRINCIPLES, DEFAULT_THRESHOLDS, type DecisionEntry, DecisionLog, type DecisionResult, Diagnoser, type Diagnosis, type EconomicEvent, type EconomicEventType, type EconomyAdapter, type EconomyMetrics, type EconomyState, Executor, FEEDBACK_LOOP_PRINCIPLES, type FlowImpact, INCENTIVE_PRINCIPLES, MARKET_DYNAMICS_PRINCIPLES, MEASUREMENT_PRINCIPLES, type MetricQuery, type MetricQueryResult, type MetricResolution, MetricStore, OPEN_ECONOMY_PRINCIPLES, OPERATIONS_PRINCIPLES, Observer, P10_EntryWeightingUsesInversePopulation, P11_TwoTierPressure, P12_OnePrimaryFaucet, P13_PotsAreZeroSumAndSelfRegulate, P14_TrackActualInjection, P15_PoolsNeedCapAndDecay, P16_WithdrawalPenaltyScales, P17_GracePeriodBeforeIntervention, P18_FirstProducerNeedsStartingInventory, P19_StartingSupplyExceedsDemand, P1_ProductionMatchesConsumption, P20_DecayPreventsAccumulation, P21_PriceFromGlobalSupply, P22_MarketAwarenessPreventsSurplus, P23_ProfitabilityFactorsFeasibility, P24_BlockedAgentsDecayFaster, P25_CorrectLeversForCorrectProblems, P26_ContinuousPressureBeatsThresholdCuts, P27_AdjustmentsNeedCooldowns, P28_StructuralDominanceIsNotPathological, P29_BottleneckDetection, P2_ClosedLoopsNeedDirectHandoff, P30_DynamicBottleneckRotation, P31_AnchorValueTracking, P32_VelocityAboveSupply, P33_FairNotEqual, P34_ExtractionRatio, P35_DestructionCreatesValue, P36_MechanicFrictionDetector, P37_LatecommerProblem, P38_CommunicationPreventsRevolt, P39_TheLagPrinciple, P3_BootstrapCapitalCoversFirstTransaction, P40_ReplacementRate, P41_MultiResolutionMonitoring, P42_TheMedianPrinciple, P43_SimulationMinimum, P44_ComplexityBudget, P45_TimeBudget, P46_PersonaDiversity, P47_SmokeTest, P48_CurrencyInsulation, P49_IdleAssetTax, P4_MaterialsFlowFasterThanCooldown, P50_PayPowerRatio, P51_CyclicalEngagement, P52_EndowmentEffect, P53_EventCompletionRate, P54_OperationalCadence, P55_ArbitrageThermometer, P56_SupplyShockAbsorption, P57_CombinatorialPriceSpace, P58_NoNaturalNumeraire, P59_GiftEconomyNoise, P5_ProfitabilityIsCompetitive, P60_SurplusDisposalAsymmetry, P6_CrowdingMultiplierOnAllRoles, P7_NonSpecialistsSubsidiseSpecialists, P8_RegulatorCannotFightDesign, P9_RoleSwitchingNeedsFriction, PARTICIPANT_EXPERIENCE_PRINCIPLES, PERSONA_HEALTHY_RANGES, POPULATION_PRINCIPLES, ParameterRegistry, type ParameterScope, type ParameterType, type PersonaProfile, PersonaTracker, type PersonaType, type PinchPointStatus, Planner, type Principle, type PrincipleCategory, type PrincipleOk, type PrincipleResult, type PrincipleViolation, REGULATOR_PRINCIPLES, RESOURCE_MGMT_PRINCIPLES, type RegisteredParameter, type RegistryValidationResult, type RollbackCondition, STATISTICAL_PRINCIPLES, SUPPLY_CHAIN_PRINCIPLES, SYSTEM_DYNAMICS_PRINCIPLES, type SimulationOutcome, type SimulationResult, Simulator, type SuggestedAction, type Thresholds, type TickConfig, type ValidationError, type ValidationResult, type ValidationWarning, emptyMetrics, findWorstSystem, validateEconomyState };
+export { ALL_PRINCIPLES, type ActionPlan, AgentE, type AgentEConfig, type AgentEMode, BOOTSTRAP_PRINCIPLES, CURRENCY_FLOW_PRINCIPLES, DEFAULT_THRESHOLDS, type DecisionEntry, DecisionLog, type DecisionResult, Diagnoser, type Diagnosis, type EconomicEvent, type EconomicEventType, type EconomyAdapter, type EconomyMetrics, type EconomyState, type ExecutionResult, Executor, FEEDBACK_LOOP_PRINCIPLES, type FlowImpact, INCENTIVE_PRINCIPLES, MARKET_DYNAMICS_PRINCIPLES, MEASUREMENT_PRINCIPLES, type MetricQuery, type MetricQueryResult, type MetricResolution, MetricStore, OPEN_ECONOMY_PRINCIPLES, OPERATIONS_PRINCIPLES, Observer, P10_EntryWeightingUsesInversePopulation, P11_TwoTierPressure, P12_OnePrimaryFaucet, P13_PotsAreZeroSumAndSelfRegulate, P14_TrackActualInjection, P15_PoolsNeedCapAndDecay, P16_WithdrawalPenaltyScales, P17_GracePeriodBeforeIntervention, P18_FirstProducerNeedsStartingInventory, P19_StartingSupplyExceedsDemand, P1_ProductionMatchesConsumption, P20_DecayPreventsAccumulation, P21_PriceFromGlobalSupply, P22_MarketAwarenessPreventsSurplus, P23_ProfitabilityFactorsFeasibility, P24_BlockedAgentsDecayFaster, P25_CorrectLeversForCorrectProblems, P26_ContinuousPressureBeatsThresholdCuts, P27_AdjustmentsNeedCooldowns, P28_StructuralDominanceIsNotPathological, P29_BottleneckDetection, P2_ClosedLoopsNeedDirectHandoff, P30_DynamicBottleneckRotation, P31_AnchorValueTracking, P32_VelocityAboveSupply, P33_FairNotEqual, P34_ExtractionRatio, P35_DestructionCreatesValue, P36_MechanicFrictionDetector, P37_LatecommerProblem, P38_CommunicationPreventsRevolt, P39_TheLagPrinciple, P3_BootstrapCapitalCoversFirstTransaction, P40_ReplacementRate, P41_MultiResolutionMonitoring, P42_TheMedianPrinciple, P43_SimulationMinimum, P44_ComplexityBudget, P45_TimeBudget, P46_PersonaDiversity, P47_SmokeTest, P48_CurrencyInsulation, P49_IdleAssetTax, P4_MaterialsFlowFasterThanCooldown, P50_PayPowerRatio, P51_CyclicalEngagement, P52_EndowmentEffect, P53_EventCompletionRate, P54_OperationalCadence, P55_ArbitrageThermometer, P56_SupplyShockAbsorption, P57_CombinatorialPriceSpace, P58_NoNaturalNumeraire, P59_GiftEconomyNoise, P5_ProfitabilityIsRelative, P60_SurplusDisposalAsymmetry, P6_CrowdingMultiplierOnAllRoles, P7_NonSpecialistsSubsidiseSpecialists, P8_RegulatorCannotFightDesign, P9_RoleSwitchingNeedsFriction, PARTICIPANT_EXPERIENCE_PRINCIPLES, PERSONA_HEALTHY_RANGES, POPULATION_PRINCIPLES, ParameterRegistry, type ParameterScope, type ParameterType, type PersonaProfile, PersonaTracker, type PersonaType, type PinchPointStatus, Planner, type Principle, type PrincipleCategory, type PrincipleOk, type PrincipleResult, type PrincipleViolation, REGULATOR_PRINCIPLES, RESOURCE_MGMT_PRINCIPLES, type RegisteredParameter, type RegistryValidationResult, type RollbackCondition, STATISTICAL_PRINCIPLES, SUPPLY_CHAIN_PRINCIPLES, SYSTEM_DYNAMICS_PRINCIPLES, type SimulationConfig, type SimulationOutcome, type SimulationResult, Simulator, type SuggestedAction, type Thresholds, type TickConfig, type ValidationError, type ValidationResult, type ValidationWarning, emptyMetrics, findWorstSystem, validateEconomyState };