@exagent/agent 0.1.20 → 0.1.22

package/dist/cli.mjs

@@ -6,7 +6,7 @@ import {
   loadConfig,
   loadSecureEnv,
   validateConfig
-} from "./chunk-Z4N6G5XT.mjs";
+} from "./chunk-EJHDRG5Y.mjs";
 
 // src/cli.ts
 import { Command } from "commander";

package/dist/index.d.mts

@@ -2,6 +2,80 @@ import { z } from 'zod';
 import { Address, Hash, WalletClient } from 'viem';
 import { ExagentClient } from '@exagent/sdk';
 
+/** Risk state persisted across restarts */
+interface RiskState {
+    dailyPnL: number;
+    dailyFees: number;
+    lastResetDate: string;
+}
+/**
+ * PositionTracker — automatic position tracking with persistence.
+ *
+ * Wraps StrategyStore with domain-specific logic for tracking spot positions,
+ * trade history, and risk state. Used by the runtime to give strategies
+ * intelligent memory across restarts.
+ *
+ * - Entry prices tracked via cost-basis weighted average
+ * - Realized PnL calculated on sells
+ * - Balances synced from on-chain each cycle
+ * - Risk state (daily PnL/fees) persisted for circuit breaker continuity
+ */
+declare class PositionTracker {
+    private store;
+    private positions;
+    private tradeHistory;
+    private maxTradeHistory;
+    constructor(store: StrategyStore, options?: {
+        maxTradeHistory?: number;
+    });
+    /**
+     * Record a trade result. On buy: creates/updates position with cost-basis
+     * weighted average. On sell: calculates realized PnL and removes if fully sold.
+     */
+    recordTrade(params: {
+        action: 'buy' | 'sell';
+        tokenIn: string;
+        tokenOut: string;
+        amountIn: bigint;
+        priceIn: number;
+        priceOut: number;
+        txHash?: string;
+        reasoning?: string;
+        success: boolean;
+    }): void;
+    /**
+     * Handle a buy: create or update position with cost-basis weighted average.
+     */
+    private handleBuy;
+    /**
+     * Handle a sell: calculate realized PnL and remove position if fully sold.
+     * Returns the realized PnL in USD.
+     */
+    private handleSell;
+    /**
+     * Sync tracked positions with on-chain balances.
+     * Updates currentAmount, detects new tokens (airdrops), removes zeroed positions.
+     */
+    syncBalances(balances: Record<string, bigint>, prices: Record<string, number>): void;
+    /** Get all tracked positions */
+    getPositions(): TrackedPosition[];
+    /** Get a single position by token address */
+    getPosition(token: string): TrackedPosition | undefined;
+    /** Get trade history (newest first) */
+    getTradeHistory(limit?: number): TradeRecord[];
+    /** Get unrealized PnL per position given current prices */
+    getUnrealizedPnL(prices: Record<string, number>): Record<string, number>;
+    /** Get total unrealized PnL across all positions */
+    getTotalUnrealizedPnL(prices: Record<string, number>): number;
+    /** Load persisted risk state */
+    getRiskState(): RiskState;
+    /** Save risk state to persistent store */
+    saveRiskState(state: RiskState): void;
+    /** Get a compact summary for relay heartbeats */
+    getPositionSummary(prices: Record<string, number>): PositionSummary;
+    private persist;
+}
+
 declare const LLMProviderSchema: z.ZodEnum<["openai", "anthropic", "google", "deepseek", "mistral", "groq", "together", "ollama", "custom"]>;
 type LLMProvider = z.infer<typeof LLMProviderSchema>;
 declare const LLMConfigSchema: z.ZodObject<{
@@ -265,9 +339,9 @@ declare const AgentConfigSchema: z.ZodObject<{
     }>>;
     allowedTokens: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    agentId: string | number;
     name: string;
     network: "mainnet";
+    agentId: string | number;
     llm: {
         provider: "custom" | "openai" | "anthropic" | "google" | "deepseek" | "mistral" | "groq" | "together" | "ollama";
         temperature: number;
@@ -314,8 +388,8 @@ declare const AgentConfigSchema: z.ZodObject<{
     } | undefined;
     allowedTokens?: string[] | undefined;
 }, {
-    agentId: string | number;
     name: string;
+    agentId: string | number;
     llm: {
         provider: "custom" | "openai" | "anthropic" | "google" | "deepseek" | "mistral" | "groq" | "together" | "ollama";
         model?: string | undefined;
@@ -417,7 +491,66 @@ interface StrategyStore {
     keys(): string[];
 }
 /**
- * Context passed to strategies with persistent storage and trade history.
+ * A tracked spot position with entry price and cost basis.
+ * Automatically managed by the runtime's PositionTracker.
+ */
+interface TrackedPosition {
+    /** Lowercase token address */
+    token: string;
+    /** Human-readable symbol (e.g., "AERO") — best-effort, may be missing */
+    symbol?: string;
+    /** USD price at time of first buy */
+    entryPrice: number;
+    /** Cost-basis weighted average entry price */
+    averageEntryPrice: number;
+    /** Total USD spent buying this token */
+    totalCostBasis: number;
+    /** Total token amount ever acquired (in token units, not wei) */
+    totalAmountAcquired: number;
+    /** Latest known token amount held (in token units, from on-chain balance) */
+    currentAmount: number;
+    /** Timestamp of first buy (ms) */
+    entryTimestamp: number;
+    /** Timestamp of last update (ms) */
+    lastUpdateTimestamp: number;
+    /** Transaction hashes from buy trades (last 10) */
+    txHashes: string[];
+}
+/**
+ * A recorded trade with metadata and optional realized PnL.
+ */
+interface TradeRecord {
+    timestamp: number;
+    action: 'buy' | 'sell';
+    tokenIn: string;
+    tokenOut: string;
+    /** Serialized bigint (JSON can't encode bigint) */
+    amountIn: string;
+    /** Estimated USD value of the trade */
+    priceUSD: number;
+    txHash?: string;
+    reasoning?: string;
+    /** Realized PnL in USD (only for sells) */
+    realizedPnL?: number;
+    success: boolean;
+}
+/**
+ * Compact position summary for relay heartbeats.
+ */
+interface PositionSummary {
+    openPositions: number;
+    totalUnrealizedPnL: number;
+    topPositions: Array<{
+        token: string;
+        symbol?: string;
+        unrealizedPnL: number;
+        holdingDuration: number;
+    }>;
+    recentTrades: number;
+    totalRealizedPnL: number;
+}
+/**
+ * Context passed to strategies with persistent storage, positions, and trade history.
  */
 interface StrategyContext {
     /** Persistent key-value store (survives restarts) */
@@ -426,6 +559,12 @@ interface StrategyContext {
     agentId: number;
     /** Agent wallet address */
     walletAddress: string;
+    /** Current open positions with entry prices (auto-populated by runtime) */
+    positions?: TrackedPosition[];
+    /** Recent trade history, newest first (auto-populated by runtime) */
+    tradeHistory?: TradeRecord[];
+    /** Position tracker instance for advanced queries (e.g., getUnrealizedPnL) */
+    positionTracker?: PositionTracker;
 }
 /**
  * Strategy function signature (user implements this).
@@ -556,6 +695,8 @@ interface AgentStatusPayload {
     mode: AgentMode;
     agentId: string;
     wallet?: string;
+    /** @exagent/agent package version (e.g., "0.1.20") */
+    sdkVersion?: string;
     cycleCount?: number;
     lastCycleAt?: number;
     tradingIntervalMs?: number;
@@ -585,6 +726,23 @@ interface AgentStatusPayload {
         effectiveLeverage: number;
         pendingRecords: number;
     };
+    /** Spot position tracking summary (auto-populated by PositionTracker) */
+    positions?: {
+        openPositions: number;
+        totalUnrealizedPnL: number;
+        topPositions: Array<{
+            token: string;
+            symbol?: string;
+            unrealizedPnL: number;
+            holdingDuration: number;
+        }>;
+        recentTrades: number;
+        totalRealizedPnL: number;
+    };
+    /** Current on-chain config hash (for epoch tracking) */
+    configHash?: string;
+    /** Config hash awaiting owner approval — null/undefined means no pending verification */
+    pendingConfigHash?: string | null;
 }
 interface RelayConfig {
     enabled: boolean;
@@ -616,14 +774,18 @@ declare class AgentRuntime {
     private isRunning;
     private mode;
     private configHash;
+    private pendingConfigHash;
+    private lastConfigCheckAt;
     private cycleCount;
     private lastCycleAt;
     private lastPortfolioValue;
     private lastEthBalance;
+    private lastPrices;
     private processAlive;
     private riskUniverse;
     private allowedTokens;
     private strategyContext;
+    private positionTracker;
     private perpClient;
     private perpSigner;
     private perpOrders;
@@ -634,6 +796,11 @@ declare class AgentRuntime {
     private perpStrategy;
     private perpConnected;
     private perpTradingActive;
+    private cachedPerpEquity;
+    private cachedPerpUnrealizedPnl;
+    private cachedPerpMarginUsed;
+    private cachedPerpLeverage;
+    private cachedPerpOpenPositions;
     constructor(config: RuntimeConfig);
     /**
      * Initialize the agent runtime
@@ -665,8 +832,14 @@ declare class AgentRuntime {
     private loadTradingRestrictions;
     /**
      * Sync the LLM config hash to chain for epoch tracking.
-     * If the wallet has insufficient gas, enters a recovery loop
-     * that waits for the user to fund the wallet.
+     *
+     * If the trading wallet is NOT the agent owner, the on-chain setConfig
+     * call would revert with AgentNotOwner. Instead, we set a pending state
+     * and send a message to the command center so the owner can approve it
+     * from the website with one click.
+     *
+     * Until the config is verified on-chain, the agent won't appear on the
+     * leaderboard (trades still execute normally).
      */
     private syncConfigHash;
     /**
@@ -685,6 +858,11 @@ declare class AgentRuntime {
      * Handle a command from the command center
      */
     private handleCommand;
+    /**
+     * Periodically check if the owner has approved the pending config hash.
+     * Called from sendRelayStatus at most every 2.5 minutes (timestamp-throttled).
+     */
+    private checkPendingConfigApproval;
     /**
      * Send current status to the relay
      */
@@ -1187,6 +1365,23 @@ declare class RiskManager {
      * This prevents protocol fees from triggering circuit breakers.
      */
     updateFees(fees: number): void;
+    /**
+     * Export current risk state for persistence across restarts.
+     */
+    exportState(): {
+        dailyPnL: number;
+        dailyFees: number;
+        lastResetDate: string;
+    };
+    /**
+     * Restore risk state from persistence (called on startup).
+     * Only restores if the saved state is from today — expired state is ignored.
+     */
+    restoreState(state: {
+        dailyPnL: number;
+        dailyFees: number;
+        lastResetDate: string;
+    }): void;
     /**
      * Get current risk status
      * @param portfolioValue - Current portfolio value in USD (needed for accurate loss limit)
@@ -1907,4 +2102,7 @@ declare function decryptEnvFile(encPath: string, passphrase: string): Record<str
  */
 declare function loadSecureEnv(basePath: string, passphrase?: string): boolean;
 
-export { type AccountSummary, type AgentConfig, AgentConfigSchema, type AgentMode, AgentRuntime, type AgentStatusPayload, AnthropicAdapter, BaseLLMAdapter, type CommandType, DeepSeekAdapter, FileStore, type FillCallback, type FundingCallback, type FundingPayment, GoogleAdapter, GroqAdapter, HYPERLIQUID_DOMAIN, HyperliquidClient, HyperliquidSigner, HyperliquidWebSocket, type LLMAdapter, type LLMConfig, LLMConfigSchema, type LLMMessage, type LLMMetadata, type LLMProvider, LLMProviderSchema, type LLMResponse, type LiquidationCallback, type MarketData, MarketDataService, type MessageLevel, type MessageType, MistralAdapter, OllamaAdapter, type OnboardingStatus, OpenAIAdapter, OrderManager, type OrderResult, type PerpAction, type PerpConfig$1 as PerpConfig, PerpConfigSchema, type PerpFill, type PerpMarketData, PerpOnboarding, type PerpPosition, type PerpStrategyFunction, PerpTradeRecorder, type PerpTradeSignal, type PerpConfig as PerpTradingConfig, PositionManager, type RecordPerpTradeParams, RelayClient, type RelayCommand, type RelayConfig$1 as RelayConfig, RelayConfigSchema, RiskManager, type RiskUniverse, RiskUniverseSchema, type RuntimeConfig, STRATEGY_TEMPLATES, type StrategyContext, type StrategyFunction, type StrategyStore, type StrategyTemplate, TogetherAdapter, TradeExecutor, type TradeSignal, type TradingConfig, TradingConfigSchema, type VaultConfig, VaultConfigSchema, VaultManager, type VaultManagerConfig, type VaultPolicy, VaultPolicySchema, type VaultStatus, createLLMAdapter, createSampleConfig, decryptEnvFile, encryptEnvFile, fillHashToBytes32, fillOidToBytes32, getAllStrategyTemplates, getNextNonce, getStrategyTemplate, loadConfig, loadSecureEnv, loadStrategy, validateConfig, validateStrategy };
+/** @exagent/agent package version — update alongside package.json */
+declare const AGENT_VERSION = "0.1.22";
+
+export { AGENT_VERSION, type AccountSummary, type AgentConfig, AgentConfigSchema, type AgentMode, AgentRuntime, type AgentStatusPayload, AnthropicAdapter, BaseLLMAdapter, type CommandType, DeepSeekAdapter, FileStore, type FillCallback, type FundingCallback, type FundingPayment, GoogleAdapter, GroqAdapter, HYPERLIQUID_DOMAIN, HyperliquidClient, HyperliquidSigner, HyperliquidWebSocket, type LLMAdapter, type LLMConfig, LLMConfigSchema, type LLMMessage, type LLMMetadata, type LLMProvider, LLMProviderSchema, type LLMResponse, type LiquidationCallback, type MarketData, MarketDataService, type MessageLevel, type MessageType, MistralAdapter, OllamaAdapter, type OnboardingStatus, OpenAIAdapter, OrderManager, type OrderResult, type PerpAction, type PerpConfig$1 as PerpConfig, PerpConfigSchema, type PerpFill, type PerpMarketData, PerpOnboarding, type PerpPosition, type PerpStrategyFunction, PerpTradeRecorder, type PerpTradeSignal, type PerpConfig as PerpTradingConfig, PositionManager, type PositionSummary, PositionTracker, type RecordPerpTradeParams, RelayClient, type RelayCommand, type RelayConfig$1 as RelayConfig, RelayConfigSchema, RiskManager, type RiskState, type RiskUniverse, RiskUniverseSchema, type RuntimeConfig, STRATEGY_TEMPLATES, type StrategyContext, type StrategyFunction, type StrategyStore, type StrategyTemplate, TogetherAdapter, type TrackedPosition, TradeExecutor, type TradeRecord, type TradeSignal, type TradingConfig, TradingConfigSchema, type VaultConfig, VaultConfigSchema, VaultManager, type VaultManagerConfig, type VaultPolicy, VaultPolicySchema, type VaultStatus, createLLMAdapter, createSampleConfig, decryptEnvFile, encryptEnvFile, fillHashToBytes32, fillOidToBytes32, getAllStrategyTemplates, getNextNonce, getStrategyTemplate, loadConfig, loadSecureEnv, loadStrategy, validateConfig, validateStrategy };

package/dist/index.d.ts

@@ -2,6 +2,80 @@ import { z } from 'zod';
 import { Address, Hash, WalletClient } from 'viem';
 import { ExagentClient } from '@exagent/sdk';
 
+/** Risk state persisted across restarts */
+interface RiskState {
+    dailyPnL: number;
+    dailyFees: number;
+    lastResetDate: string;
+}
+/**
+ * PositionTracker — automatic position tracking with persistence.
+ *
+ * Wraps StrategyStore with domain-specific logic for tracking spot positions,
+ * trade history, and risk state. Used by the runtime to give strategies
+ * intelligent memory across restarts.
+ *
+ * - Entry prices tracked via cost-basis weighted average
+ * - Realized PnL calculated on sells
+ * - Balances synced from on-chain each cycle
+ * - Risk state (daily PnL/fees) persisted for circuit breaker continuity
+ */
+declare class PositionTracker {
+    private store;
+    private positions;
+    private tradeHistory;
+    private maxTradeHistory;
+    constructor(store: StrategyStore, options?: {
+        maxTradeHistory?: number;
+    });
+    /**
+     * Record a trade result. On buy: creates/updates position with cost-basis
+     * weighted average. On sell: calculates realized PnL and removes if fully sold.
+     */
+    recordTrade(params: {
+        action: 'buy' | 'sell';
+        tokenIn: string;
+        tokenOut: string;
+        amountIn: bigint;
+        priceIn: number;
+        priceOut: number;
+        txHash?: string;
+        reasoning?: string;
+        success: boolean;
+    }): void;
+    /**
+     * Handle a buy: create or update position with cost-basis weighted average.
+     */
+    private handleBuy;
+    /**
+     * Handle a sell: calculate realized PnL and remove position if fully sold.
+     * Returns the realized PnL in USD.
+     */
+    private handleSell;
+    /**
+     * Sync tracked positions with on-chain balances.
+     * Updates currentAmount, detects new tokens (airdrops), removes zeroed positions.
+     */
+    syncBalances(balances: Record<string, bigint>, prices: Record<string, number>): void;
+    /** Get all tracked positions */
+    getPositions(): TrackedPosition[];
+    /** Get a single position by token address */
+    getPosition(token: string): TrackedPosition | undefined;
+    /** Get trade history (newest first) */
+    getTradeHistory(limit?: number): TradeRecord[];
+    /** Get unrealized PnL per position given current prices */
+    getUnrealizedPnL(prices: Record<string, number>): Record<string, number>;
+    /** Get total unrealized PnL across all positions */
+    getTotalUnrealizedPnL(prices: Record<string, number>): number;
+    /** Load persisted risk state */
+    getRiskState(): RiskState;
+    /** Save risk state to persistent store */
+    saveRiskState(state: RiskState): void;
+    /** Get a compact summary for relay heartbeats */
+    getPositionSummary(prices: Record<string, number>): PositionSummary;
+    private persist;
+}
+
 declare const LLMProviderSchema: z.ZodEnum<["openai", "anthropic", "google", "deepseek", "mistral", "groq", "together", "ollama", "custom"]>;
 type LLMProvider = z.infer<typeof LLMProviderSchema>;
 declare const LLMConfigSchema: z.ZodObject<{
@@ -265,9 +339,9 @@ declare const AgentConfigSchema: z.ZodObject<{
     }>>;
     allowedTokens: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    agentId: string | number;
     name: string;
     network: "mainnet";
+    agentId: string | number;
     llm: {
         provider: "custom" | "openai" | "anthropic" | "google" | "deepseek" | "mistral" | "groq" | "together" | "ollama";
         temperature: number;
@@ -314,8 +388,8 @@ declare const AgentConfigSchema: z.ZodObject<{
     } | undefined;
     allowedTokens?: string[] | undefined;
 }, {
-    agentId: string | number;
     name: string;
+    agentId: string | number;
     llm: {
         provider: "custom" | "openai" | "anthropic" | "google" | "deepseek" | "mistral" | "groq" | "together" | "ollama";
         model?: string | undefined;
@@ -417,7 +491,66 @@ interface StrategyStore {
     keys(): string[];
 }
 /**
- * Context passed to strategies with persistent storage and trade history.
+ * A tracked spot position with entry price and cost basis.
+ * Automatically managed by the runtime's PositionTracker.
+ */
+interface TrackedPosition {
+    /** Lowercase token address */
+    token: string;
+    /** Human-readable symbol (e.g., "AERO") — best-effort, may be missing */
+    symbol?: string;
+    /** USD price at time of first buy */
+    entryPrice: number;
+    /** Cost-basis weighted average entry price */
+    averageEntryPrice: number;
+    /** Total USD spent buying this token */
+    totalCostBasis: number;
+    /** Total token amount ever acquired (in token units, not wei) */
+    totalAmountAcquired: number;
+    /** Latest known token amount held (in token units, from on-chain balance) */
+    currentAmount: number;
+    /** Timestamp of first buy (ms) */
+    entryTimestamp: number;
+    /** Timestamp of last update (ms) */
+    lastUpdateTimestamp: number;
+    /** Transaction hashes from buy trades (last 10) */
+    txHashes: string[];
+}
+/**
+ * A recorded trade with metadata and optional realized PnL.
+ */
+interface TradeRecord {
+    timestamp: number;
+    action: 'buy' | 'sell';
+    tokenIn: string;
+    tokenOut: string;
+    /** Serialized bigint (JSON can't encode bigint) */
+    amountIn: string;
+    /** Estimated USD value of the trade */
+    priceUSD: number;
+    txHash?: string;
+    reasoning?: string;
+    /** Realized PnL in USD (only for sells) */
+    realizedPnL?: number;
+    success: boolean;
+}
+/**
+ * Compact position summary for relay heartbeats.
+ */
+interface PositionSummary {
+    openPositions: number;
+    totalUnrealizedPnL: number;
+    topPositions: Array<{
+        token: string;
+        symbol?: string;
+        unrealizedPnL: number;
+        holdingDuration: number;
+    }>;
+    recentTrades: number;
+    totalRealizedPnL: number;
+}
+/**
+ * Context passed to strategies with persistent storage, positions, and trade history.
  */
 interface StrategyContext {
     /** Persistent key-value store (survives restarts) */
@@ -426,6 +559,12 @@ interface StrategyContext {
     agentId: number;
     /** Agent wallet address */
     walletAddress: string;
+    /** Current open positions with entry prices (auto-populated by runtime) */
+    positions?: TrackedPosition[];
+    /** Recent trade history, newest first (auto-populated by runtime) */
+    tradeHistory?: TradeRecord[];
+    /** Position tracker instance for advanced queries (e.g., getUnrealizedPnL) */
+    positionTracker?: PositionTracker;
 }
 /**
  * Strategy function signature (user implements this).
@@ -556,6 +695,8 @@ interface AgentStatusPayload {
     mode: AgentMode;
     agentId: string;
     wallet?: string;
+    /** @exagent/agent package version (e.g., "0.1.20") */
+    sdkVersion?: string;
     cycleCount?: number;
     lastCycleAt?: number;
     tradingIntervalMs?: number;
@@ -585,6 +726,23 @@ interface AgentStatusPayload {
         effectiveLeverage: number;
         pendingRecords: number;
     };
+    /** Spot position tracking summary (auto-populated by PositionTracker) */
+    positions?: {
+        openPositions: number;
+        totalUnrealizedPnL: number;
+        topPositions: Array<{
+            token: string;
+            symbol?: string;
+            unrealizedPnL: number;
+            holdingDuration: number;
+        }>;
+        recentTrades: number;
+        totalRealizedPnL: number;
+    };
+    /** Current on-chain config hash (for epoch tracking) */
+    configHash?: string;
+    /** Config hash awaiting owner approval — null/undefined means no pending verification */
+    pendingConfigHash?: string | null;
 }
 interface RelayConfig {
     enabled: boolean;
@@ -616,14 +774,18 @@ declare class AgentRuntime {
     private isRunning;
     private mode;
     private configHash;
+    private pendingConfigHash;
+    private lastConfigCheckAt;
     private cycleCount;
     private lastCycleAt;
     private lastPortfolioValue;
     private lastEthBalance;
+    private lastPrices;
     private processAlive;
     private riskUniverse;
     private allowedTokens;
     private strategyContext;
+    private positionTracker;
     private perpClient;
     private perpSigner;
     private perpOrders;
@@ -634,6 +796,11 @@ declare class AgentRuntime {
     private perpStrategy;
     private perpConnected;
     private perpTradingActive;
+    private cachedPerpEquity;
+    private cachedPerpUnrealizedPnl;
+    private cachedPerpMarginUsed;
+    private cachedPerpLeverage;
+    private cachedPerpOpenPositions;
     constructor(config: RuntimeConfig);
     /**
      * Initialize the agent runtime
@@ -665,8 +832,14 @@ declare class AgentRuntime {
     private loadTradingRestrictions;
     /**
      * Sync the LLM config hash to chain for epoch tracking.
-     * If the wallet has insufficient gas, enters a recovery loop
-     * that waits for the user to fund the wallet.
+     *
+     * If the trading wallet is NOT the agent owner, the on-chain setConfig
+     * call would revert with AgentNotOwner. Instead, we set a pending state
+     * and send a message to the command center so the owner can approve it
+     * from the website with one click.
+     *
+     * Until the config is verified on-chain, the agent won't appear on the
+     * leaderboard (trades still execute normally).
      */
     private syncConfigHash;
     /**
@@ -685,6 +858,11 @@ declare class AgentRuntime {
      * Handle a command from the command center
      */
     private handleCommand;
+    /**
+     * Periodically check if the owner has approved the pending config hash.
+     * Called from sendRelayStatus at most every 2.5 minutes (timestamp-throttled).
+     */
+    private checkPendingConfigApproval;
     /**
      * Send current status to the relay
      */
@@ -1187,6 +1365,23 @@ declare class RiskManager {
      * This prevents protocol fees from triggering circuit breakers.
      */
     updateFees(fees: number): void;
+    /**
+     * Export current risk state for persistence across restarts.
+     */
+    exportState(): {
+        dailyPnL: number;
+        dailyFees: number;
+        lastResetDate: string;
+    };
+    /**
+     * Restore risk state from persistence (called on startup).
+     * Only restores if the saved state is from today — expired state is ignored.
+     */
+    restoreState(state: {
+        dailyPnL: number;
+        dailyFees: number;
+        lastResetDate: string;
+    }): void;
     /**
      * Get current risk status
      * @param portfolioValue - Current portfolio value in USD (needed for accurate loss limit)
@@ -1907,4 +2102,7 @@ declare function decryptEnvFile(encPath: string, passphrase: string): Record<str
  */
 declare function loadSecureEnv(basePath: string, passphrase?: string): boolean;
 
-export { type AccountSummary, type AgentConfig, AgentConfigSchema, type AgentMode, AgentRuntime, type AgentStatusPayload, AnthropicAdapter, BaseLLMAdapter, type CommandType, DeepSeekAdapter, FileStore, type FillCallback, type FundingCallback, type FundingPayment, GoogleAdapter, GroqAdapter, HYPERLIQUID_DOMAIN, HyperliquidClient, HyperliquidSigner, HyperliquidWebSocket, type LLMAdapter, type LLMConfig, LLMConfigSchema, type LLMMessage, type LLMMetadata, type LLMProvider, LLMProviderSchema, type LLMResponse, type LiquidationCallback, type MarketData, MarketDataService, type MessageLevel, type MessageType, MistralAdapter, OllamaAdapter, type OnboardingStatus, OpenAIAdapter, OrderManager, type OrderResult, type PerpAction, type PerpConfig$1 as PerpConfig, PerpConfigSchema, type PerpFill, type PerpMarketData, PerpOnboarding, type PerpPosition, type PerpStrategyFunction, PerpTradeRecorder, type PerpTradeSignal, type PerpConfig as PerpTradingConfig, PositionManager, type RecordPerpTradeParams, RelayClient, type RelayCommand, type RelayConfig$1 as RelayConfig, RelayConfigSchema, RiskManager, type RiskUniverse, RiskUniverseSchema, type RuntimeConfig, STRATEGY_TEMPLATES, type StrategyContext, type StrategyFunction, type StrategyStore, type StrategyTemplate, TogetherAdapter, TradeExecutor, type TradeSignal, type TradingConfig, TradingConfigSchema, type VaultConfig, VaultConfigSchema, VaultManager, type VaultManagerConfig, type VaultPolicy, VaultPolicySchema, type VaultStatus, createLLMAdapter, createSampleConfig, decryptEnvFile, encryptEnvFile, fillHashToBytes32, fillOidToBytes32, getAllStrategyTemplates, getNextNonce, getStrategyTemplate, loadConfig, loadSecureEnv, loadStrategy, validateConfig, validateStrategy };
+/** @exagent/agent package version — update alongside package.json */
+declare const AGENT_VERSION = "0.1.22";
+
+export { AGENT_VERSION, type AccountSummary, type AgentConfig, AgentConfigSchema, type AgentMode, AgentRuntime, type AgentStatusPayload, AnthropicAdapter, BaseLLMAdapter, type CommandType, DeepSeekAdapter, FileStore, type FillCallback, type FundingCallback, type FundingPayment, GoogleAdapter, GroqAdapter, HYPERLIQUID_DOMAIN, HyperliquidClient, HyperliquidSigner, HyperliquidWebSocket, type LLMAdapter, type LLMConfig, LLMConfigSchema, type LLMMessage, type LLMMetadata, type LLMProvider, LLMProviderSchema, type LLMResponse, type LiquidationCallback, type MarketData, MarketDataService, type MessageLevel, type MessageType, MistralAdapter, OllamaAdapter, type OnboardingStatus, OpenAIAdapter, OrderManager, type OrderResult, type PerpAction, type PerpConfig$1 as PerpConfig, PerpConfigSchema, type PerpFill, type PerpMarketData, PerpOnboarding, type PerpPosition, type PerpStrategyFunction, PerpTradeRecorder, type PerpTradeSignal, type PerpConfig as PerpTradingConfig, PositionManager, type PositionSummary, PositionTracker, type RecordPerpTradeParams, RelayClient, type RelayCommand, type RelayConfig$1 as RelayConfig, RelayConfigSchema, RiskManager, type RiskState, type RiskUniverse, RiskUniverseSchema, type RuntimeConfig, STRATEGY_TEMPLATES, type StrategyContext, type StrategyFunction, type StrategyStore, type StrategyTemplate, TogetherAdapter, type TrackedPosition, TradeExecutor, type TradeRecord, type TradeSignal, type TradingConfig, TradingConfigSchema, type VaultConfig, VaultConfigSchema, VaultManager, type VaultManagerConfig, type VaultPolicy, VaultPolicySchema, type VaultStatus, createLLMAdapter, createSampleConfig, decryptEnvFile, encryptEnvFile, fillHashToBytes32, fillOidToBytes32, getAllStrategyTemplates, getNextNonce, getStrategyTemplate, loadConfig, loadSecureEnv, loadStrategy, validateConfig, validateStrategy };