@agent-e/core 1.6.2 → 1.6.4

package/dist/index.d.ts

@@ -1,777 +0,0 @@
-/** High-level parameter categories (what it IS, not what it's called) */
-type ParameterType = 'cost' | 'fee' | 'reward' | 'yield' | 'rate' | 'cap' | 'penalty' | 'multiplier' | string;
-/** How a parameter change affects net currency flow */
-type FlowImpact = 'sink' | 'faucet' | 'neutral' | 'mixed' | 'friction' | 'redistribution';
-/** Scope narrows which concrete parameter a type resolves to */
-interface ParameterScope {
-    system?: string;
-    currency?: string;
-    tags?: string[];
-}
-/** A registered parameter in the economy */
-interface RegisteredParameter {
-    /** Concrete key used by the adapter (e.g. 'craftingCost', 'stakingYield') */
-    key: string;
-    /** What type of parameter this is */
-    type: ParameterType;
-    /** How changing this affects net flow */
-    flowImpact: FlowImpact;
-    /** Scope constraints — narrows resolution */
-    scope?: Partial<ParameterScope>;
-    /** Current value (updated after each apply) */
-    currentValue?: number;
-    /** Human-readable description */
-    description?: string;
-    /** Priority tiebreaker — higher wins when specificity scores are equal */
-    priority?: number;
-    /** Human-readable label for UIs and logs */
-    label?: string;
-}
-/** Result of registry.validate() */
-interface RegistryValidationResult {
-    valid: boolean;
-    warnings: string[];
-    errors: string[];
-}
-declare class ParameterRegistry {
-    private parameters;
-    /** Register a parameter. Overwrites if key already exists. */
-    register(param: RegisteredParameter): void;
-    /** Register multiple parameters at once. */
-    registerAll(params: RegisteredParameter[]): void;
-    /**
-     * Resolve a parameterType + scope to a concrete RegisteredParameter.
-     * Returns the best match, or undefined if no match.
-     *
-     * Matching rules:
-     * 1. Filter candidates by type
-     * 2. Score each by scope specificity (system +10, currency +5, tags +3 each)
-     * 3. Mismatched scope fields disqualify (score = -Infinity)
-     * 4. Ties broken by `priority` (higher wins), then registration order
-     * 5. All disqualified → undefined
-     */
-    resolve(type: ParameterType, scope?: Partial<ParameterScope>): RegisteredParameter | undefined;
-    /** Find all parameters of a given type. */
-    findByType(type: ParameterType): RegisteredParameter[];
-    /** Find all parameters belonging to a given system. */
-    findBySystem(system: string): RegisteredParameter[];
-    /** Get a parameter by its concrete key. */
-    get(key: string): RegisteredParameter | undefined;
-    /** Get the flow impact of a parameter by its concrete key. */
-    getFlowImpact(key: string): FlowImpact | undefined;
-    /** Update the current value of a registered parameter. */
-    updateValue(key: string, value: number): void;
-    /** Get all registered parameters. */
-    getAll(): RegisteredParameter[];
-    /** Number of registered parameters. */
-    get size(): number;
-    /**
-     * Validate the registry for common misconfigurations.
-     * Returns warnings (non-fatal) and errors (likely broken).
-     */
-    validate(): RegistryValidationResult;
-    private scopeSpecificity;
-}
-
-type EconomicEventType = 'trade' | 'mint' | 'burn' | 'transfer' | 'produce' | 'consume' | 'role_change' | 'enter' | 'churn';
-interface EconomicEvent {
-    type: EconomicEventType;
-    timestamp: number;
-    actor: string;
-    role?: string;
-    resource?: string;
-    currency?: string;
-    amount?: number;
-    price?: number;
-    from?: string;
-    to?: string;
-    system?: string;
-    sourceOrSink?: string;
-    metadata?: Record<string, unknown>;
-}
-type PinchPointStatus = 'optimal' | 'oversupplied' | 'scarce';
-interface EconomyMetrics {
-    tick: number;
-    timestamp: number;
-    currencies: string[];
-    totalSupplyByCurrency: Record<string, number>;
-    netFlowByCurrency: Record<string, number>;
-    velocityByCurrency: Record<string, number>;
-    inflationRateByCurrency: Record<string, number>;
-    faucetVolumeByCurrency: Record<string, number>;
-    sinkVolumeByCurrency: Record<string, number>;
-    tapSinkRatioByCurrency: Record<string, number>;
-    anchorRatioDriftByCurrency: Record<string, number>;
-    totalSupply: number;
-    netFlow: number;
-    velocity: number;
-    inflationRate: number;
-    faucetVolume: number;
-    sinkVolume: number;
-    tapSinkRatio: number;
-    anchorRatioDrift: number;
-    giniCoefficientByCurrency: Record<string, number>;
-    medianBalanceByCurrency: Record<string, number>;
-    meanBalanceByCurrency: Record<string, number>;
-    top10PctShareByCurrency: Record<string, number>;
-    meanMedianDivergenceByCurrency: Record<string, number>;
-    giniCoefficient: number;
-    medianBalance: number;
-    meanBalance: number;
-    top10PctShare: number;
-    meanMedianDivergence: number;
-    populationByRole: Record<string, number>;
-    roleShares: Record<string, number>;
-    totalAgents: number;
-    churnRate: number;
-    churnByRole: Record<string, number>;
-    personaDistribution: Record<string, number>;
-    priceIndexByCurrency: Record<string, number>;
-    pricesByCurrency: Record<string, Record<string, number>>;
-    priceVolatilityByCurrency: Record<string, Record<string, number>>;
-    priceIndex: number;
-    prices: Record<string, number>;
-    priceVolatility: Record<string, number>;
-    productionIndex: number;
-    capacityUsage: number;
-    supplyByResource: Record<string, number>;
-    demandSignals: Record<string, number>;
-    pinchPoints: Record<string, PinchPointStatus>;
-    avgSatisfaction: number;
-    blockedAgentCount: number;
-    timeToValue: number;
-    poolSizesByCurrency: Record<string, Record<string, number>>;
-    poolSizes: Record<string, number>;
-    extractionRatioByCurrency: Record<string, number>;
-    newUserDependencyByCurrency: Record<string, number>;
-    currencyInsulationByCurrency: Record<string, number>;
-    extractionRatio: number;
-    newUserDependency: number;
-    smokeTestRatio: number;
-    currencyInsulation: number;
-    cyclicalPeaks: number[];
-    cyclicalValleys: number[];
-    eventCompletionRate: number;
-    arbitrageIndexByCurrency: Record<string, number>;
-    arbitrageIndex: number;
-    contentDropAge: number;
-    giftTradeRatioByCurrency: Record<string, number>;
-    giftTradeRatio: number;
-    disposalTradeRatioByCurrency: Record<string, number>;
-    disposalTradeRatio: number;
-    systems: string[];
-    sources: string[];
-    sinks: string[];
-    flowBySystem: Record<string, number>;
-    activityBySystem: Record<string, number>;
-    participantsBySystem: Record<string, number>;
-    flowBySource: Record<string, number>;
-    flowBySink: Record<string, number>;
-    sourceShare: Record<string, number>;
-    sinkShare: Record<string, number>;
-    custom: Record<string, number>;
-}
-declare function emptyMetrics(tick?: number): EconomyMetrics;
-type PrincipleCategory = 'supply_chain' | 'incentive' | 'population' | 'currency' | 'bootstrap' | 'feedback' | 'regulator' | 'market_dynamics' | 'measurement' | 'wealth_distribution' | 'resource' | 'system_design' | 'participant_experience' | 'statistical' | 'system_dynamics' | 'open_economy' | 'operations';
-interface PrincipleViolation {
-    violated: true;
-    severity: number;
-    evidence: Record<string, unknown>;
-    suggestedAction: SuggestedAction;
-    confidence: number;
-    estimatedLag?: number;
-}
-interface PrincipleOk {
-    violated: false;
-}
-type PrincipleResult = PrincipleViolation | PrincipleOk;
-interface Principle {
-    id: string;
-    name: string;
-    category: PrincipleCategory;
-    description: string;
-    check: (metrics: EconomyMetrics, thresholds: Thresholds) => PrincipleResult;
-}
-interface SuggestedAction {
-    parameterType: ParameterType;
-    direction: 'increase' | 'decrease' | 'set';
-    magnitude?: number;
-    absoluteValue?: number;
-    scope?: Partial<ParameterScope>;
-    resolvedParameter?: string;
-    reasoning: string;
-}
-interface ActionPlan {
-    id: string;
-    diagnosis: Diagnosis;
-    parameter: string;
-    scope?: ParameterScope;
-    currentValue: number;
-    targetValue: number;
-    maxChangePercent: number;
-    cooldownTicks: number;
-    rollbackCondition: RollbackCondition;
-    simulationResult: SimulationResult;
-    estimatedLag: number;
-    appliedAt?: number;
-}
-interface RollbackCondition {
-    metric: keyof EconomyMetrics | string;
-    direction: 'above' | 'below';
-    threshold: number;
-    checkAfterTick: number;
-}
-interface Diagnosis {
-    principle: Principle;
-    violation: PrincipleViolation;
-    tick: number;
-}
-interface SimulationOutcome {
-    p10: EconomyMetrics;
-    p50: EconomyMetrics;
-    p90: EconomyMetrics;
-    mean: EconomyMetrics;
-}
-interface SimulationResult {
-    proposedAction: SuggestedAction;
-    iterations: number;
-    forwardTicks: number;
-    outcomes: SimulationOutcome;
-    netImprovement: boolean;
-    noNewProblems: boolean;
-    confidenceInterval: [number, number];
-    estimatedEffectTick: number;
-    overshootRisk: number;
-}
-type DecisionResult = 'applied' | 'skipped_cooldown' | 'skipped_simulation_failed' | 'skipped_locked' | 'skipped_override' | 'rolled_back' | 'rejected';
-interface DecisionEntry {
-    id: string;
-    tick: number;
-    timestamp: number;
-    diagnosis: Diagnosis;
-    plan: ActionPlan;
-    result: DecisionResult;
-    reasoning: string;
-    metricsSnapshot: EconomyMetrics;
-}
-interface EconomyState {
-    tick: number;
-    roles: string[];
-    resources: string[];
-    currencies: string[];
-    agentBalances: Record<string, Record<string, number>>;
-    agentRoles: Record<string, string>;
-    agentInventories: Record<string, Record<string, number>>;
-    agentSatisfaction?: Record<string, number>;
-    marketPrices: Record<string, Record<string, number>>;
-    recentTransactions: EconomicEvent[];
-    poolSizes?: Record<string, Record<string, number>>;
-    systems?: string[];
-    sources?: string[];
-    sinks?: string[];
-    customData?: Record<string, unknown>;
-}
-interface EconomyAdapter {
-    /** Return current full state snapshot */
-    getState(): EconomyState | Promise<EconomyState>;
-    /** Apply a parameter change to the host system */
-    setParam(key: string, value: number, scope?: ParameterScope): void | Promise<void>;
-    /** Optional: adapter pushes events as they happen */
-    onEvent?: (handler: (event: EconomicEvent) => void) => void;
-}
-interface Thresholds {
-    meanMedianDivergenceMax: number;
-    simulationMinIterations: number;
-    personaMonocultureMax: number;
-    personaMinClusters: number;
-    extractionRatioYellow: number;
-    extractionRatioRed: number;
-    smokeTestWarning: number;
-    smokeTestCritical: number;
-    currencyInsulationMax: number;
-    timeBudgetRatio: number;
-    payPowerRatioMax: number;
-    payPowerRatioTarget: number;
-    cyclicalPeakDecay: number;
-    cyclicalValleyDecay: number;
-    eventCompletionMin: number;
-    eventCompletionMax: number;
-    lagMultiplierMin: number;
-    lagMultiplierMax: number;
-    complexityBudgetMax: number;
-    replacementRateMultiplier: number;
-    maxAdjustmentPercent: number;
-    cooldownTicks: number;
-    poolWinRate: number;
-    poolOperatorShare: number;
-    roleSwitchFrictionMax: number;
-    poolCapPercent: number;
-    poolDecayRate: number;
-    stampedeProfitRatio: number;
-    blockedAgentMaxFraction: number;
-    giniWarnThreshold: number;
-    giniRedThreshold: number;
-    churnWarnRate: number;
-    netFlowWarnThreshold: number;
-    arbitrageIndexWarning: number;
-    arbitrageIndexCritical: number;
-    contentDropCooldownTicks: number;
-    postDropArbitrageMax: number;
-    relativePriceConvergenceTarget: number;
-    priceDiscoveryWindowTicks: number;
-    giftTradeFilterRatio: number;
-    disposalTradeWeightDiscount: number;
-}
-interface TickConfig {
-    /** How many real-world units one tick represents. Default: 1 */
-    duration: number;
-    /** The unit of time. Default: 'tick' (abstract). Examples: 'second', 'minute', 'block', 'frame' */
-    unit: string;
-    /** Medium-resolution metric window in ticks. Default: 10 */
-    mediumWindow?: number;
-    /** 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;
-    mode?: AgentEMode;
-    dominantRoles?: string[];
-    idealDistribution?: Record<string, number>;
-    parameters?: RegisteredParameter[];
-    /** Run registry.validate() on startup and log warnings/errors (default: true) */
-    validateRegistry?: boolean;
-    tickConfig?: Partial<TickConfig>;
-    gracePeriod?: number;
-    checkInterval?: number;
-    maxAdjustmentPercent?: number;
-    cooldownTicks?: number;
-    simulation?: SimulationConfig;
-    settlementWindowTicks?: number;
-    thresholds?: Partial<Thresholds>;
-    onDecision?: (entry: DecisionEntry) => void;
-    onAlert?: (diagnosis: Diagnosis) => void;
-    onRollback?: (plan: ActionPlan, reason: string) => void;
-}
-type PersonaType = 'Whale' | 'ActiveTrader' | 'Accumulator' | 'Spender' | 'NewEntrant' | 'AtRisk' | 'Dormant' | 'PowerUser' | 'Passive' | string;
-interface PersonaProfile {
-    type: PersonaType;
-    share: number;
-    healthyRangeMin: number;
-    healthyRangeMax: number;
-}
-type MetricResolution = 'fine' | 'medium' | 'coarse';
-interface MetricQuery {
-    metric: keyof EconomyMetrics | string;
-    from?: number;
-    to?: number;
-    resolution?: MetricResolution;
-}
-interface MetricQueryResult {
-    metric: string;
-    resolution: MetricResolution;
-    points: Array<{
-        tick: number;
-        value: number;
-    }>;
-}
-
-declare class Diagnoser {
-    private principles;
-    constructor(principles: Principle[]);
-    addPrinciple(principle: Principle): void;
-    removePrinciple(id: string): void;
-    /**
-     * Run all principles against current metrics.
-     * Returns violations sorted by severity (highest first).
-     * Only one action is taken per cycle — the highest severity violation.
-     */
-    diagnose(metrics: EconomyMetrics, thresholds: Thresholds): Diagnosis[];
-    getPrinciples(): Principle[];
-}
-
-declare class DecisionLog {
-    private entries;
-    private maxEntries;
-    constructor(maxEntries?: number);
-    record(diagnosis: Diagnosis, plan: ActionPlan, result: DecisionResult, metrics: EconomyMetrics): DecisionEntry;
-    recordSkip(diagnosis: Diagnosis, result: DecisionResult, metrics: EconomyMetrics, reason: string): void;
-    query(filter?: {
-        since?: number;
-        until?: number;
-        issue?: string;
-        parameter?: string;
-        result?: DecisionResult;
-    }): DecisionEntry[];
-    getById(id: string): DecisionEntry | undefined;
-    updateResult(id: string, newResult: DecisionResult, reasoning?: string): boolean;
-    latest(n?: number): DecisionEntry[];
-    export(format?: 'json' | 'text'): string;
-    private buildReasoning;
-    private stubPlan;
-}
-
-declare class MetricStore {
-    /** Fine: last 200 ticks, one entry per tick */
-    private fine;
-    /** Medium: last 200 windows */
-    private medium;
-    /** Coarse: last 200 epochs */
-    private coarse;
-    private mediumWindow;
-    private coarseWindow;
-    private ticksSinceLastMedium;
-    private ticksSinceLastCoarse;
-    private mediumAccumulator;
-    private coarseAccumulator;
-    constructor(tickConfig?: Partial<TickConfig>);
-    record(metrics: EconomyMetrics): void;
-    latest(resolution?: MetricResolution): EconomyMetrics;
-    query(q: MetricQuery): MetricQueryResult;
-    /** Summarized recent history for dashboard charts */
-    recentHistory(count?: number): Array<{
-        tick: number;
-        health: number;
-        giniCoefficient: number;
-        totalSupply: number;
-        netFlow: number;
-        velocity: number;
-        inflationRate: number;
-        avgSatisfaction: number;
-        churnRate: number;
-        totalAgents: number;
-        priceIndex: number;
-    }>;
-    /** Check if fine and coarse resolution metrics diverge significantly */
-    divergenceDetected(): boolean;
-    private bufferFor;
-    private aggregate;
-}
-
-type EventName = 'decision' | 'alert' | 'rollback' | 'beforeAction' | 'afterAction';
-declare class AgentE {
-    private readonly config;
-    private readonly thresholds;
-    private adapter;
-    private mode;
-    private observer;
-    private diagnoser;
-    private simulator;
-    private planner;
-    private executor;
-    private registry;
-    readonly log: DecisionLog;
-    readonly store: MetricStore;
-    private personaTracker;
-    private params;
-    private eventBuffer;
-    private isRunning;
-    private isPaused;
-    private currentTick;
-    private handlers;
-    constructor(config: AgentEConfig);
-    connect(adapter: EconomyAdapter): this;
-    start(): this;
-    pause(): void;
-    resume(): void;
-    stop(): void;
-    tick(state?: EconomyState): Promise<void>;
-    /** Apply a plan manually (for advisor mode) */
-    apply(plan: ActionPlan): Promise<void>;
-    lock(param: string): void;
-    unlock(param: string): void;
-    constrain(param: string, bounds: {
-        min: number;
-        max: number;
-    }): void;
-    addPrinciple(principle: Principle): void;
-    setMode(mode: AgentEMode): void;
-    getMode(): AgentEMode;
-    removePrinciple(id: string): void;
-    registerParameter(param: RegisteredParameter): void;
-    getRegistry(): ParameterRegistry;
-    registerCustomMetric(name: string, fn: (state: EconomyState) => number): void;
-    getDecisions(filter?: Parameters<DecisionLog['query']>[0]): DecisionEntry[];
-    getPrinciples(): Principle[];
-    getActivePlans(): ActionPlan[];
-    /** Access to the metric time-series store */
-    readonly metrics: {
-        query: (q: MetricQuery) => MetricQueryResult;
-        latest: (resolution?: "fine" | "medium" | "coarse") => EconomyMetrics;
-    };
-    on(event: EventName, handler: (...args: unknown[]) => unknown): this;
-    off(event: EventName, handler: (...args: unknown[]) => unknown): this;
-    private emit;
-    diagnoseNow(): ReturnType<Diagnoser['diagnose']>;
-    getHealth(): number;
-    ingest(event: EconomicEvent): void;
-}
-
-declare class Observer {
-    private previousMetrics;
-    private previousPricesByCurrency;
-    private customMetricFns;
-    private anchorBaselineByCurrency;
-    private tickConfig;
-    constructor(tickConfig?: Partial<TickConfig>);
-    registerCustomMetric(name: string, fn: (state: EconomyState) => number): void;
-    compute(state: EconomyState, recentEvents: EconomicEvent[]): EconomyMetrics;
-}
-
-declare class Simulator {
-    private diagnoser;
-    private registry;
-    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.
-     *
-     * The inner model is intentionally lightweight — it models how key metrics evolve
-     * under a parameter change using simplified dynamics. This is not a full agent simulation;
-     * it is a fast inner model that catches obvious over/under-corrections.
-     */
-    simulate(action: SuggestedAction, currentMetrics: EconomyMetrics, thresholds: Thresholds, iterations?: number, forwardTicks?: number): SimulationResult;
-    /**
-     * Lightweight forward model: apply action then project key metrics forward.
-     * Uses simplified dynamics — not a full agent replay.
-     */
-    private runForward;
-    private actionMultiplier;
-    private flowEffect;
-    /** Infer flow impact from parameter type when registry is unavailable */
-    private inferFlowImpact;
-    private checkImprovement;
-    private averageMetrics;
-}
-
-interface ParameterConstraint {
-    min: number;
-    max: number;
-}
-declare class Planner {
-    private lockedParams;
-    private constraints;
-    private cooldowns;
-    private typeCooldowns;
-    private activePlanCount;
-    lock(param: string): void;
-    unlock(param: string): void;
-    constrain(param: string, constraint: ParameterConstraint): void;
-    /**
-     * Convert a diagnosis into an ActionPlan.
-     * Returns null if:
-     * - parameter is locked
-     * - parameter is still in cooldown
-     * - simulation result failed
-     * - complexity budget exceeded
-     * - no matching parameter in registry
-     */
-    plan(diagnosis: Diagnosis, metrics: EconomyMetrics, simulationResult: SimulationResult, currentParams: Record<string, number>, thresholds: Thresholds, registry?: ParameterRegistry): ActionPlan | null;
-    recordApplied(plan: ActionPlan, tick: number): void;
-    recordRolledBack(_plan: ActionPlan): void;
-    recordSettled(_plan: ActionPlan): void;
-    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.
-     * Returns { rolledBack, settled } — plans that were undone and plans that passed their window.
-     */
-    checkRollbacks(metrics: EconomyMetrics, adapter: EconomyAdapter): Promise<{
-        rolledBack: ActionPlan[];
-        settled: ActionPlan[];
-    }>;
-    private getMetricValue;
-    getActivePlans(): ActionPlan[];
-}
-
-interface PersonaConfig {
-    /** Top X% by holdings = Whale. Default: 0.05 (5%) */
-    whalePercentile: number;
-    /** Top X% by tx frequency = Active Trader. Default: 0.20 (20%) */
-    activeTraderPercentile: number;
-    /** Ticks to consider an agent "new." Default: 10 */
-    newEntrantWindow: number;
-    /** Ticks with zero activity = Dormant. Default: 20 */
-    dormantWindow: number;
-    /** Activity drop threshold for At-Risk. Default: 0.5 (50% drop) */
-    atRiskDropThreshold: number;
-    /** Min distinct systems for Power User. Default: 3 */
-    powerUserMinSystems: number;
-    /** Rolling history window size (ticks). Default: 50 */
-    historyWindow: number;
-}
-declare class PersonaTracker {
-    private agents;
-    private config;
-    constructor(config?: Partial<PersonaConfig>);
-    /**
-     * Ingest a state snapshot + events and update per-agent signals.
-     * Call this once per tick BEFORE getDistribution().
-     */
-    update(state: EconomyState, events?: EconomicEvent[]): void;
-    /**
-     * Classify all tracked agents and return the population distribution.
-     * Returns { Whale: 0.05, ActiveTrader: 0.18, Passive: 0.42, ... }
-     */
-    getDistribution(): Record<string, number>;
-}
-
-/**
- * Find the system with the worst metric value.
- * Works with flat Record<string, number> maps like flowBySystem.
- *
- * @param metrics - Current economy metrics snapshot
- * @param check - Function that returns a numeric "badness" score per system (higher = worse)
- * @param tolerancePercent - Only flag if the worst system exceeds the average by this % (default 0)
- * @returns The system name and its score, or undefined if no systems or none exceeds tolerance
- */
-declare function findWorstSystem(metrics: EconomyMetrics, check: (systemName: string, metrics: EconomyMetrics) => number, tolerancePercent?: number): {
-    system: string;
-    score: number;
-} | undefined;
-
-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;
-    max: number;
-}>;
-
-declare const P1_ProductionMatchesConsumption: Principle;
-declare const P2_ClosedLoopsNeedDirectHandoff: Principle;
-declare const P3_BootstrapCapitalCoversFirstTransaction: Principle;
-declare const P4_MaterialsFlowFasterThanCooldown: Principle;
-declare const P60_SurplusDisposalAsymmetry: Principle;
-declare const SUPPLY_CHAIN_PRINCIPLES: Principle[];
-
-declare const P5_ProfitabilityIsRelative: Principle;
-declare const P6_CrowdingMultiplierOnAllRoles: Principle;
-declare const P7_NonSpecialistsSubsidiseSpecialists: Principle;
-declare const P8_RegulatorCannotFightDesign: Principle;
-declare const INCENTIVE_PRINCIPLES: Principle[];
-
-declare const P9_RoleSwitchingNeedsFriction: Principle;
-declare const P10_EntryWeightingUsesInversePopulation: Principle;
-declare const P11_TwoTierPressure: Principle;
-declare const P46_PersonaDiversity: Principle;
-declare const POPULATION_PRINCIPLES: Principle[];
-
-declare const P12_OnePrimaryFaucet: Principle;
-declare const P13_PotsAreZeroSumAndSelfRegulate: Principle;
-declare const P14_TrackActualInjection: Principle;
-declare const P15_PoolsNeedCapAndDecay: Principle;
-declare const P16_WithdrawalPenaltyScales: Principle;
-declare const P32_VelocityAboveSupply: Principle;
-declare const P58_NoNaturalNumeraire: Principle;
-declare const CURRENCY_FLOW_PRINCIPLES: Principle[];
-
-declare const P17_GracePeriodBeforeIntervention: Principle;
-declare const P18_FirstProducerNeedsStartingInventory: Principle;
-declare const P19_StartingSupplyExceedsDemand: Principle;
-declare const BOOTSTRAP_PRINCIPLES: Principle[];
-
-declare const P20_DecayPreventsAccumulation: Principle;
-declare const P21_PriceFromGlobalSupply: Principle;
-declare const P22_MarketAwarenessPreventsSurplus: Principle;
-declare const P23_ProfitabilityFactorsFeasibility: Principle;
-declare const P24_BlockedAgentsDecayFaster: Principle;
-declare const FEEDBACK_LOOP_PRINCIPLES: Principle[];
-
-declare const P25_CorrectLeversForCorrectProblems: Principle;
-declare const P26_ContinuousPressureBeatsThresholdCuts: Principle;
-declare const P27_AdjustmentsNeedCooldowns: Principle;
-declare const P28_StructuralDominanceIsNotPathological: Principle;
-declare const P38_CommunicationPreventsRevolt: Principle;
-declare const REGULATOR_PRINCIPLES: Principle[];
-
-declare const P29_BottleneckDetection: Principle;
-declare const P30_DynamicBottleneckRotation: Principle;
-declare const P57_CombinatorialPriceSpace: Principle;
-declare const MARKET_DYNAMICS_PRINCIPLES: Principle[];
-
-declare const P31_AnchorValueTracking: Principle;
-declare const P41_MultiResolutionMonitoring: Principle;
-declare const P55_ArbitrageThermometer: Principle;
-declare const P59_GiftEconomyNoise: Principle;
-declare const MEASUREMENT_PRINCIPLES: Principle[];
-
-declare const P42_TheMedianPrinciple: Principle;
-declare const P43_SimulationMinimum: Principle;
-declare const STATISTICAL_PRINCIPLES: Principle[];
-
-declare const P39_TheLagPrinciple: Principle;
-declare const P44_ComplexityBudget: Principle;
-declare const SYSTEM_DYNAMICS_PRINCIPLES: Principle[];
-
-declare const P35_DestructionCreatesValue: Principle;
-declare const P40_ReplacementRate: Principle;
-declare const P49_IdleAssetTax: Principle;
-declare const RESOURCE_MGMT_PRINCIPLES: Principle[];
-
-declare const P33_FairNotEqual: Principle;
-declare const P36_MechanicFrictionDetector: Principle;
-declare const P37_LatecommerProblem: Principle;
-declare const P45_TimeBudget: Principle;
-declare const P50_PayPowerRatio: Principle;
-declare const PARTICIPANT_EXPERIENCE_PRINCIPLES: Principle[];
-
-declare const P34_ExtractionRatio: Principle;
-declare const P47_SmokeTest: Principle;
-declare const P48_CurrencyInsulation: Principle;
-declare const OPEN_ECONOMY_PRINCIPLES: Principle[];
-
-declare const P51_CyclicalEngagement: Principle;
-declare const P52_EndowmentEffect: Principle;
-declare const P53_EventCompletionRate: Principle;
-declare const P54_OperationalCadence: Principle;
-declare const P56_SupplyShockAbsorption: Principle;
-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, 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 PersonaConfig, 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 };