@exagent/agent 0.1.38 → 0.1.39

package/dist/index.d.mts

@@ -680,14 +680,14 @@ declare class VaultManager {
  * Shared types for the command center relay protocol.
  * Used by both the SDK relay client and the API relay service.
  */
-type AgentMode = 'idle' | 'trading';
-type CommandType = 'start_trading' | 'stop_trading' | 'enable_hyperliquid' | 'disable_hyperliquid' | 'start_perp_trading' | 'stop_perp_trading' | 'update_risk_params' | 'update_perp_params' | 'update_trading_interval' | 'create_vault' | 'refresh_status' | 'shutdown';
+type AgentMode = 'idle' | 'trading' | 'paper';
+type CommandType = 'start_trading' | 'stop_trading' | 'start_paper_trading' | 'stop_paper_trading' | 'enable_hyperliquid' | 'disable_hyperliquid' | 'start_perp_trading' | 'stop_perp_trading' | 'update_risk_params' | 'update_perp_params' | 'update_trading_interval' | 'create_vault' | 'refresh_status' | 'shutdown';
 interface RelayCommand {
     id: string;
     type: CommandType;
     params?: Record<string, unknown>;
 }
-type MessageType = 'trade_executed' | 'trade_failed' | 'perp_fill' | 'perp_liquidation_warning' | 'perp_funding' | 'funds_low' | 'risk_limit_hit' | 'vault_created' | 'config_updated' | 'llm_error' | 'command_result' | 'system';
+type MessageType = 'trade_executed' | 'trade_failed' | 'paper_trade_executed' | 'paper_trade_failed' | 'perp_fill' | 'perp_liquidation_warning' | 'perp_funding' | 'funds_low' | 'risk_limit_hit' | 'vault_created' | 'config_updated' | 'llm_error' | 'command_result' | 'system';
 type MessageLevel = 'info' | 'warning' | 'error' | 'success';
 interface AgentStatusPayload {
     mode: AgentMode;
@@ -739,6 +739,22 @@ interface AgentStatusPayload {
         recentTrades: number;
         totalRealizedPnL: number;
     };
+    /** Paper trading state (only present when mode === 'paper') */
+    paper?: {
+        active: boolean;
+        startedAt: number;
+        simulatedValue: number;
+        simulatedPnLPct: number;
+        tradeCount: number;
+        totalFees: number;
+        wins: number;
+        losses: number;
+        /** Last 50 equity curve points for chart display */
+        equityCurve: Array<{
+            timestamp: number;
+            value: number;
+        }>;
+    };
     /** Current on-chain config hash (for epoch tracking) */
     configHash?: string;
     /** Config hash awaiting owner approval — null/undefined means no pending verification */
@@ -786,6 +802,10 @@ declare class AgentRuntime {
     private allowedTokens;
     private strategyContext;
     private positionTracker;
+    private paperExecutor;
+    private paperPortfolio;
+    /** Whether agent was started directly in paper mode via CLI */
+    private startInPaperMode;
     private perpClient;
     private perpSigner;
     private perpOrders;
@@ -801,7 +821,12 @@ declare class AgentRuntime {
     private cachedPerpMarginUsed;
     private cachedPerpLeverage;
     private cachedPerpOpenPositions;
-    constructor(config: RuntimeConfig);
+    constructor(config: RuntimeConfig, options?: {
+        paperMode?: boolean;
+        paperBalances?: Record<string, bigint>;
+    });
+    /** Initial balances override for paper mode (from CLI --initial-eth/--initial-usdc) */
+    private _paperInitialBalances?;
     /**
      * Initialize the agent runtime
      */
@@ -858,6 +883,16 @@ declare class AgentRuntime {
      * Handle a command from the command center
      */
     private handleCommand;
+    /**
+     * Initialize and enter paper trading mode.
+     * Snapshots current on-chain balances (or uses provided overrides) as starting state.
+     */
+    private startPaperTrading;
+    /**
+     * Exit paper trading mode and return to idle.
+     * Saves the paper portfolio state to disk.
+     */
+    private stopPaperTrading;
     /**
      * Periodically check if the owner has approved the pending config hash.
      * Called from sendRelayStatus at most every 2.5 minutes (timestamp-throttled).
@@ -2203,6 +2238,6 @@ declare function decryptEnvFile(encPath: string, passphrase: string): Record<str
 declare function loadSecureEnv(basePath: string, passphrase?: string): boolean;
 
 /** @exagent/agent package version — update alongside package.json */
-declare const AGENT_VERSION = "0.1.38";
+declare const AGENT_VERSION = "0.1.39";
 
 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

@@ -680,14 +680,14 @@ declare class VaultManager {
  * Shared types for the command center relay protocol.
  * Used by both the SDK relay client and the API relay service.
  */
-type AgentMode = 'idle' | 'trading';
-type CommandType = 'start_trading' | 'stop_trading' | 'enable_hyperliquid' | 'disable_hyperliquid' | 'start_perp_trading' | 'stop_perp_trading' | 'update_risk_params' | 'update_perp_params' | 'update_trading_interval' | 'create_vault' | 'refresh_status' | 'shutdown';
+type AgentMode = 'idle' | 'trading' | 'paper';
+type CommandType = 'start_trading' | 'stop_trading' | 'start_paper_trading' | 'stop_paper_trading' | 'enable_hyperliquid' | 'disable_hyperliquid' | 'start_perp_trading' | 'stop_perp_trading' | 'update_risk_params' | 'update_perp_params' | 'update_trading_interval' | 'create_vault' | 'refresh_status' | 'shutdown';
 interface RelayCommand {
     id: string;
     type: CommandType;
     params?: Record<string, unknown>;
 }
-type MessageType = 'trade_executed' | 'trade_failed' | 'perp_fill' | 'perp_liquidation_warning' | 'perp_funding' | 'funds_low' | 'risk_limit_hit' | 'vault_created' | 'config_updated' | 'llm_error' | 'command_result' | 'system';
+type MessageType = 'trade_executed' | 'trade_failed' | 'paper_trade_executed' | 'paper_trade_failed' | 'perp_fill' | 'perp_liquidation_warning' | 'perp_funding' | 'funds_low' | 'risk_limit_hit' | 'vault_created' | 'config_updated' | 'llm_error' | 'command_result' | 'system';
 type MessageLevel = 'info' | 'warning' | 'error' | 'success';
 interface AgentStatusPayload {
     mode: AgentMode;
@@ -739,6 +739,22 @@ interface AgentStatusPayload {
         recentTrades: number;
         totalRealizedPnL: number;
     };
+    /** Paper trading state (only present when mode === 'paper') */
+    paper?: {
+        active: boolean;
+        startedAt: number;
+        simulatedValue: number;
+        simulatedPnLPct: number;
+        tradeCount: number;
+        totalFees: number;
+        wins: number;
+        losses: number;
+        /** Last 50 equity curve points for chart display */
+        equityCurve: Array<{
+            timestamp: number;
+            value: number;
+        }>;
+    };
     /** Current on-chain config hash (for epoch tracking) */
     configHash?: string;
     /** Config hash awaiting owner approval — null/undefined means no pending verification */
@@ -786,6 +802,10 @@ declare class AgentRuntime {
     private allowedTokens;
     private strategyContext;
     private positionTracker;
+    private paperExecutor;
+    private paperPortfolio;
+    /** Whether agent was started directly in paper mode via CLI */
+    private startInPaperMode;
     private perpClient;
     private perpSigner;
     private perpOrders;
@@ -801,7 +821,12 @@ declare class AgentRuntime {
     private cachedPerpMarginUsed;
     private cachedPerpLeverage;
     private cachedPerpOpenPositions;
-    constructor(config: RuntimeConfig);
+    constructor(config: RuntimeConfig, options?: {
+        paperMode?: boolean;
+        paperBalances?: Record<string, bigint>;
+    });
+    /** Initial balances override for paper mode (from CLI --initial-eth/--initial-usdc) */
+    private _paperInitialBalances?;
     /**
      * Initialize the agent runtime
      */
@@ -858,6 +883,16 @@ declare class AgentRuntime {
      * Handle a command from the command center
      */
     private handleCommand;
+    /**
+     * Initialize and enter paper trading mode.
+     * Snapshots current on-chain balances (or uses provided overrides) as starting state.
+     */
+    private startPaperTrading;
+    /**
+     * Exit paper trading mode and return to idle.
+     * Saves the paper portfolio state to disk.
+     */
+    private stopPaperTrading;
     /**
      * Periodically check if the owner has approved the pending config hash.
      * Called from sendRelayStatus at most every 2.5 minutes (timestamp-throttled).
@@ -2203,6 +2238,6 @@ declare function decryptEnvFile(encPath: string, passphrase: string): Record<str
 declare function loadSecureEnv(basePath: string, passphrase?: string): boolean;
 
 /** @exagent/agent package version — update alongside package.json */
-declare const AGENT_VERSION = "0.1.38";
+declare const AGENT_VERSION = "0.1.39";
 
 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 };