@agent-e/core 1.3.2 → 1.4.4

package/dist/index.d.mts

@@ -372,6 +372,8 @@ declare class AgentE {
         max: number;
     }): void;
     addPrinciple(principle: Principle): void;
+    setMode(mode: AgentEMode): void;
+    getMode(): AgentEMode;
     removePrinciple(id: string): void;
     registerCustomMetric(name: string, fn: (state: EconomyState) => number): void;
     getDecisions(filter?: Parameters<DecisionLog['query']>[0]): DecisionEntry[];
@@ -474,6 +476,23 @@ declare class PersonaTracker {
     private classify;
 }
 
+interface ValidationError {
+    path: string;
+    expected: string;
+    received: string;
+    message: string;
+}
+interface ValidationWarning {
+    path: string;
+    message: string;
+}
+interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+}
+declare function validateEconomyState(state: unknown): ValidationResult;
+
 declare const DEFAULT_THRESHOLDS: Thresholds;
 declare const PERSONA_HEALTHY_RANGES: Record<string, {
     min: number;
@@ -573,4 +592,4 @@ declare const LIVEOPS_PRINCIPLES: Principle[];
 /** All 60 built-in principles in priority order (supply chain → liveops) */
 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, INCENTIVE_PRINCIPLES, LIVEOPS_PRINCIPLES, MARKET_DYNAMICS_PRINCIPLES, MEASUREMENT_PRINCIPLES, type MetricQuery, type MetricQueryResult, type MetricResolution, MetricStore, OPEN_ECONOMY_PRINCIPLES, Observer, P10_SpawnWeightingUsesInversePopulation, 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_PinchPoint, P2_ClosedLoopsNeedDirectHandoff, P30_MovingPinchPoint, 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_SharkTooth, P52_EndowmentEffect, P53_EventCompletionRate, P54_LiveOpsCadence, P55_ArbitrageThermometer, P56_ContentDropShock, P57_CombinatorialPriceSpace, P58_NoNaturalNumeraire, P59_GiftEconomyNoise, P5_ProfitabilityIsCompetitive, P60_SurplusDisposalAsymmetry, P6_CrowdingMultiplierOnAllRoles, P7_NonSpecialistsSubsidiseSpecialists, P8_RegulatorCannotFightDesign, P9_RoleSwitchingNeedsFriction, PERSONA_HEALTHY_RANGES, PLAYER_EXPERIENCE_PRINCIPLES, POPULATION_PRINCIPLES, type PersonaProfile, PersonaTracker, type PersonaType, type PinchPointStatus, Planner, type Principle, type PrincipleCategory, type PrincipleOk, type PrincipleResult, type PrincipleViolation, REGULATOR_PRINCIPLES, RESOURCE_MGMT_PRINCIPLES, type RollbackCondition, STATISTICAL_PRINCIPLES, SUPPLY_CHAIN_PRINCIPLES, SYSTEM_DYNAMICS_PRINCIPLES, type SimulationOutcome, type SimulationResult, Simulator, type SuggestedAction, type Thresholds, type TickConfig, emptyMetrics };
+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, INCENTIVE_PRINCIPLES, LIVEOPS_PRINCIPLES, MARKET_DYNAMICS_PRINCIPLES, MEASUREMENT_PRINCIPLES, type MetricQuery, type MetricQueryResult, type MetricResolution, MetricStore, OPEN_ECONOMY_PRINCIPLES, Observer, P10_SpawnWeightingUsesInversePopulation, 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_PinchPoint, P2_ClosedLoopsNeedDirectHandoff, P30_MovingPinchPoint, 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_SharkTooth, P52_EndowmentEffect, P53_EventCompletionRate, P54_LiveOpsCadence, P55_ArbitrageThermometer, P56_ContentDropShock, P57_CombinatorialPriceSpace, P58_NoNaturalNumeraire, P59_GiftEconomyNoise, P5_ProfitabilityIsCompetitive, P60_SurplusDisposalAsymmetry, P6_CrowdingMultiplierOnAllRoles, P7_NonSpecialistsSubsidiseSpecialists, P8_RegulatorCannotFightDesign, P9_RoleSwitchingNeedsFriction, PERSONA_HEALTHY_RANGES, PLAYER_EXPERIENCE_PRINCIPLES, POPULATION_PRINCIPLES, type PersonaProfile, PersonaTracker, type PersonaType, type PinchPointStatus, Planner, type Principle, type PrincipleCategory, type PrincipleOk, type PrincipleResult, type PrincipleViolation, REGULATOR_PRINCIPLES, RESOURCE_MGMT_PRINCIPLES, 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, validateEconomyState };

package/dist/index.d.ts

@@ -372,6 +372,8 @@ declare class AgentE {
         max: number;
     }): void;
     addPrinciple(principle: Principle): void;
+    setMode(mode: AgentEMode): void;
+    getMode(): AgentEMode;
     removePrinciple(id: string): void;
     registerCustomMetric(name: string, fn: (state: EconomyState) => number): void;
     getDecisions(filter?: Parameters<DecisionLog['query']>[0]): DecisionEntry[];
@@ -474,6 +476,23 @@ declare class PersonaTracker {
     private classify;
 }
 
+interface ValidationError {
+    path: string;
+    expected: string;
+    received: string;
+    message: string;
+}
+interface ValidationWarning {
+    path: string;
+    message: string;
+}
+interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+}
+declare function validateEconomyState(state: unknown): ValidationResult;
+
 declare const DEFAULT_THRESHOLDS: Thresholds;
 declare const PERSONA_HEALTHY_RANGES: Record<string, {
     min: number;
@@ -573,4 +592,4 @@ declare const LIVEOPS_PRINCIPLES: Principle[];
 /** All 60 built-in principles in priority order (supply chain → liveops) */
 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, INCENTIVE_PRINCIPLES, LIVEOPS_PRINCIPLES, MARKET_DYNAMICS_PRINCIPLES, MEASUREMENT_PRINCIPLES, type MetricQuery, type MetricQueryResult, type MetricResolution, MetricStore, OPEN_ECONOMY_PRINCIPLES, Observer, P10_SpawnWeightingUsesInversePopulation, 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_PinchPoint, P2_ClosedLoopsNeedDirectHandoff, P30_MovingPinchPoint, 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_SharkTooth, P52_EndowmentEffect, P53_EventCompletionRate, P54_LiveOpsCadence, P55_ArbitrageThermometer, P56_ContentDropShock, P57_CombinatorialPriceSpace, P58_NoNaturalNumeraire, P59_GiftEconomyNoise, P5_ProfitabilityIsCompetitive, P60_SurplusDisposalAsymmetry, P6_CrowdingMultiplierOnAllRoles, P7_NonSpecialistsSubsidiseSpecialists, P8_RegulatorCannotFightDesign, P9_RoleSwitchingNeedsFriction, PERSONA_HEALTHY_RANGES, PLAYER_EXPERIENCE_PRINCIPLES, POPULATION_PRINCIPLES, type PersonaProfile, PersonaTracker, type PersonaType, type PinchPointStatus, Planner, type Principle, type PrincipleCategory, type PrincipleOk, type PrincipleResult, type PrincipleViolation, REGULATOR_PRINCIPLES, RESOURCE_MGMT_PRINCIPLES, type RollbackCondition, STATISTICAL_PRINCIPLES, SUPPLY_CHAIN_PRINCIPLES, SYSTEM_DYNAMICS_PRINCIPLES, type SimulationOutcome, type SimulationResult, Simulator, type SuggestedAction, type Thresholds, type TickConfig, emptyMetrics };
+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, INCENTIVE_PRINCIPLES, LIVEOPS_PRINCIPLES, MARKET_DYNAMICS_PRINCIPLES, MEASUREMENT_PRINCIPLES, type MetricQuery, type MetricQueryResult, type MetricResolution, MetricStore, OPEN_ECONOMY_PRINCIPLES, Observer, P10_SpawnWeightingUsesInversePopulation, 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_PinchPoint, P2_ClosedLoopsNeedDirectHandoff, P30_MovingPinchPoint, 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_SharkTooth, P52_EndowmentEffect, P53_EventCompletionRate, P54_LiveOpsCadence, P55_ArbitrageThermometer, P56_ContentDropShock, P57_CombinatorialPriceSpace, P58_NoNaturalNumeraire, P59_GiftEconomyNoise, P5_ProfitabilityIsCompetitive, P60_SurplusDisposalAsymmetry, P6_CrowdingMultiplierOnAllRoles, P7_NonSpecialistsSubsidiseSpecialists, P8_RegulatorCannotFightDesign, P9_RoleSwitchingNeedsFriction, PERSONA_HEALTHY_RANGES, PLAYER_EXPERIENCE_PRINCIPLES, POPULATION_PRINCIPLES, type PersonaProfile, PersonaTracker, type PersonaType, type PinchPointStatus, Planner, type Principle, type PrincipleCategory, type PrincipleOk, type PrincipleResult, type PrincipleViolation, REGULATOR_PRINCIPLES, RESOURCE_MGMT_PRINCIPLES, 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, validateEconomyState };

package/dist/index.js

@@ -107,7 +107,8 @@ __export(index_exports, {
   SUPPLY_CHAIN_PRINCIPLES: () => SUPPLY_CHAIN_PRINCIPLES,
   SYSTEM_DYNAMICS_PRINCIPLES: () => SYSTEM_DYNAMICS_PRINCIPLES,
   Simulator: () => Simulator,
-  emptyMetrics: () => emptyMetrics
+  emptyMetrics: () => emptyMetrics,
+  validateEconomyState: () => validateEconomyState
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -3641,6 +3642,12 @@ var AgentE = class {
   addPrinciple(principle) {
     this.diagnoser.addPrinciple(principle);
   }
+  setMode(mode) {
+    this.mode = mode;
+  }
+  getMode() {
+    return this.mode;
+  }
   removePrinciple(id) {
     this.diagnoser.removePrinciple(id);
   }
@@ -3700,6 +3707,340 @@ var AgentE = class {
     this.eventBuffer.push(event);
   }
 };
+
+// src/StateValidator.ts
+function validateEconomyState(state) {
+  const errors = [];
+  const warnings = [];
+  if (state === null || state === void 0 || typeof state !== "object") {
+    errors.push({
+      path: "",
+      expected: "object",
+      received: state === null ? "null" : typeof state,
+      message: "State must be a non-null object"
+    });
+    return { valid: false, errors, warnings };
+  }
+  const s = state;
+  if (!isNonNegativeInteger(s["tick"])) {
+    errors.push({
+      path: "tick",
+      expected: "non-negative integer",
+      received: describeValue(s["tick"]),
+      message: "tick must be a non-negative integer"
+    });
+  }
+  if (!isNonEmptyStringArray(s["roles"])) {
+    errors.push({
+      path: "roles",
+      expected: "non-empty string[]",
+      received: describeValue(s["roles"]),
+      message: "roles must be a non-empty array of strings"
+    });
+  }
+  const roles = new Set(Array.isArray(s["roles"]) ? s["roles"].filter((r) => typeof r === "string") : []);
+  if (!isStringArray(s["resources"])) {
+    errors.push({
+      path: "resources",
+      expected: "string[]",
+      received: describeValue(s["resources"]),
+      message: "resources must be an array of strings (can be empty)"
+    });
+  }
+  const resources = new Set(Array.isArray(s["resources"]) ? s["resources"].filter((r) => typeof r === "string") : []);
+  if (!isNonEmptyStringArray(s["currencies"])) {
+    errors.push({
+      path: "currencies",
+      expected: "non-empty string[]",
+      received: describeValue(s["currencies"]),
+      message: "currencies must be a non-empty array of strings"
+    });
+  }
+  const currencies = new Set(
+    Array.isArray(s["currencies"]) ? s["currencies"].filter((r) => typeof r === "string") : []
+  );
+  if (isRecord(s["agentBalances"])) {
+    const balances = s["agentBalances"];
+    for (const [agentId, currencyMap] of Object.entries(balances)) {
+      if (!isRecord(currencyMap)) {
+        errors.push({
+          path: `agentBalances.${agentId}`,
+          expected: "Record<string, number>",
+          received: describeValue(currencyMap),
+          message: `agentBalances.${agentId} must be a Record<string, number>`
+        });
+        continue;
+      }
+      for (const [currency, value] of Object.entries(currencyMap)) {
+        if (typeof value !== "number" || value < 0) {
+          errors.push({
+            path: `agentBalances.${agentId}.${currency}`,
+            expected: "number >= 0",
+            received: describeValue(value),
+            message: `agentBalances.${agentId}.${currency} must be a non-negative number`
+          });
+        }
+        if (currencies.size > 0 && !currencies.has(currency)) {
+          errors.push({
+            path: `agentBalances.${agentId}.${currency}`,
+            expected: `one of [${[...currencies].join(", ")}]`,
+            received: currency,
+            message: `agentBalances currency key "${currency}" is not in currencies`
+          });
+        }
+      }
+    }
+  } else {
+    errors.push({
+      path: "agentBalances",
+      expected: "Record<string, Record<string, number>>",
+      received: describeValue(s["agentBalances"]),
+      message: "agentBalances must be a nested Record<string, Record<string, number>>"
+    });
+  }
+  if (isRecord(s["agentRoles"])) {
+    const agentRoles = s["agentRoles"];
+    for (const [agentId, role] of Object.entries(agentRoles)) {
+      if (typeof role !== "string") {
+        errors.push({
+          path: `agentRoles.${agentId}`,
+          expected: "string",
+          received: describeValue(role),
+          message: `agentRoles.${agentId} must be a string`
+        });
+      } else if (roles.size > 0 && !roles.has(role)) {
+        errors.push({
+          path: `agentRoles.${agentId}`,
+          expected: `one of [${[...roles].join(", ")}]`,
+          received: role,
+          message: `agentRoles value "${role}" is not in roles`
+        });
+      }
+    }
+  } else {
+    errors.push({
+      path: "agentRoles",
+      expected: "Record<string, string>",
+      received: describeValue(s["agentRoles"]),
+      message: "agentRoles must be a Record<string, string>"
+    });
+  }
+  if (isRecord(s["agentInventories"])) {
+    const inventories = s["agentInventories"];
+    for (const [agentId, inv] of Object.entries(inventories)) {
+      if (!isRecord(inv)) {
+        errors.push({
+          path: `agentInventories.${agentId}`,
+          expected: "Record<string, number>",
+          received: describeValue(inv),
+          message: `agentInventories.${agentId} must be a Record<string, number>`
+        });
+        continue;
+      }
+      for (const [resource, qty] of Object.entries(inv)) {
+        if (typeof qty !== "number" || qty < 0) {
+          errors.push({
+            path: `agentInventories.${agentId}.${resource}`,
+            expected: "number >= 0",
+            received: describeValue(qty),
+            message: `agentInventories.${agentId}.${resource} must be a non-negative number`
+          });
+        }
+      }
+    }
+  } else {
+    errors.push({
+      path: "agentInventories",
+      expected: "Record<string, Record<string, number>>",
+      received: describeValue(s["agentInventories"]),
+      message: "agentInventories must be a Record<string, Record<string, number>>"
+    });
+  }
+  if (isRecord(s["marketPrices"])) {
+    const marketPrices = s["marketPrices"];
+    for (const [currency, resourcePrices] of Object.entries(marketPrices)) {
+      if (currencies.size > 0 && !currencies.has(currency)) {
+        errors.push({
+          path: `marketPrices.${currency}`,
+          expected: `one of [${[...currencies].join(", ")}]`,
+          received: currency,
+          message: `marketPrices outer key "${currency}" is not in currencies`
+        });
+      }
+      if (!isRecord(resourcePrices)) {
+        errors.push({
+          path: `marketPrices.${currency}`,
+          expected: "Record<string, number>",
+          received: describeValue(resourcePrices),
+          message: `marketPrices.${currency} must be a Record<string, number>`
+        });
+        continue;
+      }
+      for (const [resource, price] of Object.entries(resourcePrices)) {
+        if (typeof price !== "number" || price < 0) {
+          errors.push({
+            path: `marketPrices.${currency}.${resource}`,
+            expected: "number >= 0",
+            received: describeValue(price),
+            message: `marketPrices.${currency}.${resource} must be a non-negative number`
+          });
+        }
+      }
+    }
+  } else {
+    errors.push({
+      path: "marketPrices",
+      expected: "Record<string, Record<string, number>>",
+      received: describeValue(s["marketPrices"]),
+      message: "marketPrices must be a nested Record<string, Record<string, number>>"
+    });
+  }
+  if (!Array.isArray(s["recentTransactions"])) {
+    errors.push({
+      path: "recentTransactions",
+      expected: "array",
+      received: describeValue(s["recentTransactions"]),
+      message: "recentTransactions must be an array"
+    });
+  }
+  if (s["agentSatisfaction"] !== void 0) {
+    if (isRecord(s["agentSatisfaction"])) {
+      const satisfaction = s["agentSatisfaction"];
+      for (const [agentId, value] of Object.entries(satisfaction)) {
+        if (typeof value !== "number" || value < 0 || value > 100) {
+          errors.push({
+            path: `agentSatisfaction.${agentId}`,
+            expected: "number 0-100",
+            received: describeValue(value),
+            message: `agentSatisfaction.${agentId} must be a number between 0 and 100`
+          });
+        }
+      }
+    } else {
+      errors.push({
+        path: "agentSatisfaction",
+        expected: "Record<string, number> | undefined",
+        received: describeValue(s["agentSatisfaction"]),
+        message: "agentSatisfaction must be a Record<string, number> if provided"
+      });
+    }
+  }
+  if (s["poolSizes"] !== void 0) {
+    if (isRecord(s["poolSizes"])) {
+      const pools = s["poolSizes"];
+      for (const [currency, poolMap] of Object.entries(pools)) {
+        if (!isRecord(poolMap)) {
+          errors.push({
+            path: `poolSizes.${currency}`,
+            expected: "Record<string, number>",
+            received: describeValue(poolMap),
+            message: `poolSizes.${currency} must be a Record<string, number>`
+          });
+          continue;
+        }
+        for (const [poolName, size] of Object.entries(poolMap)) {
+          if (typeof size !== "number" || size < 0) {
+            errors.push({
+              path: `poolSizes.${currency}.${poolName}`,
+              expected: "number >= 0",
+              received: describeValue(size),
+              message: `poolSizes.${currency}.${poolName} must be a non-negative number`
+            });
+          }
+        }
+      }
+    } else {
+      errors.push({
+        path: "poolSizes",
+        expected: "Record<string, Record<string, number>> | undefined",
+        received: describeValue(s["poolSizes"]),
+        message: "poolSizes must be a nested Record if provided"
+      });
+    }
+  }
+  if (currencies.size > 0 && isRecord(s["agentBalances"])) {
+    const heldCurrencies = /* @__PURE__ */ new Set();
+    const balances = s["agentBalances"];
+    for (const currencyMap of Object.values(balances)) {
+      if (isRecord(currencyMap)) {
+        for (const key of Object.keys(currencyMap)) {
+          heldCurrencies.add(key);
+        }
+      }
+    }
+    for (const currency of currencies) {
+      if (!heldCurrencies.has(currency)) {
+        warnings.push({
+          path: `currencies`,
+          message: `Currency "${currency}" is declared but no agent holds it`
+        });
+      }
+    }
+  }
+  if (isRecord(s["agentBalances"]) && isRecord(s["agentRoles"])) {
+    const agentRoles = s["agentRoles"];
+    const agentBalances = s["agentBalances"];
+    for (const agentId of Object.keys(agentBalances)) {
+      if (!(agentId in agentRoles)) {
+        warnings.push({
+          path: `agentBalances.${agentId}`,
+          message: `Agent "${agentId}" has balances but no role assigned`
+        });
+      }
+    }
+  }
+  if (resources.size === 0 && isRecord(s["agentInventories"])) {
+    const inventories = s["agentInventories"];
+    let hasItems = false;
+    for (const inv of Object.values(inventories)) {
+      if (isRecord(inv) && Object.keys(inv).length > 0) {
+        hasItems = true;
+        break;
+      }
+    }
+    if (hasItems) {
+      warnings.push({
+        path: "resources",
+        message: "resources is empty but agents have non-empty inventories"
+      });
+    }
+  }
+  if (Array.isArray(s["recentTransactions"]) && currencies.size > 0) {
+    for (const event of s["recentTransactions"]) {
+      if (isRecord(event)) {
+        const e = event;
+        if (typeof e["metadata"] === "object" && e["metadata"] !== null) {
+          const meta = e["metadata"];
+          if (typeof meta["currency"] === "string" && !currencies.has(meta["currency"])) {
+            warnings.push({
+              path: "recentTransactions",
+              message: `Event references unknown currency "${meta["currency"]}"`
+            });
+          }
+        }
+      }
+    }
+  }
+  return { valid: errors.length === 0, errors, warnings };
+}
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isStringArray(value) {
+  return Array.isArray(value) && value.every((v) => typeof v === "string");
+}
+function isNonEmptyStringArray(value) {
+  return isStringArray(value) && value.length > 0;
+}
+function isNonNegativeInteger(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function describeValue(value) {
+  if (value === null) return "null";
+  if (value === void 0) return "undefined";
+  if (Array.isArray(value)) return `array(${value.length})`;
+  return typeof value;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ALL_PRINCIPLES,
@@ -3789,6 +4130,7 @@ var AgentE = class {
   SUPPLY_CHAIN_PRINCIPLES,
   SYSTEM_DYNAMICS_PRINCIPLES,
   Simulator,
-  emptyMetrics
+  emptyMetrics,
+  validateEconomyState
 });
 //# sourceMappingURL=index.js.map