@exagent/agent 0.1.40 → 0.1.42

package/dist/index.d.mts

@@ -9,6 +9,24 @@ interface RiskState {
     dailyFees: number;
     lastResetDate: string;
 }
+/** Stuck position detection result */
+interface StuckPosition {
+    token: string;
+    symbol: string;
+    consecutiveFailures: number;
+    lastFailureReason: string;
+    holdingDurationMs: number;
+    estimatedValueUSD: number;
+}
+/** Result of an inferred exit detected during balance sync */
+interface InferredExit {
+    token: string;
+    symbol: string;
+    amountExited: number;
+    exitValueUSD: number;
+    realizedPnL: number;
+    costBasis: number;
+}
 /**
  * PositionTracker — automatic position tracking with persistence.
  *
@@ -25,6 +43,7 @@ declare class PositionTracker {
     private store;
     private positions;
     private tradeHistory;
+    private sellFailures;
     private maxTradeHistory;
     constructor(store: StrategyStore, options?: {
         maxTradeHistory?: number;
@@ -55,9 +74,20 @@ declare class PositionTracker {
     private handleSell;
     /**
      * Sync tracked positions with on-chain balances.
-     * Updates currentAmount, detects new tokens (airdrops), removes zeroed positions.
+     * Updates currentAmount, detects new tokens (airdrops), and handles position exits.
+     *
+     * CRITICAL: When a tracked position's balance decreases without a corresponding
+     * sell trade, we infer a manual exit and record it with realized PnL calculated
+     * at current market price. This prevents PnL manipulation via off-router sells.
+     *
+     * Returns array of inferred exits for the runtime to report to Command Center.
+     */
+    syncBalances(balances: Record<string, bigint>, prices: Record<string, number>): InferredExit[];
+    /**
+     * Record an inferred exit in trade history.
+     * These are exits detected from balance changes, not from tracked sell executions.
      */
-    syncBalances(balances: Record<string, bigint>, prices: Record<string, number>): void;
+    private recordInferredExit;
     /** Get all tracked positions (backfills missing symbols from resolver) */
     getPositions(): TrackedPosition[];
     /** Get a single position by token address */
@@ -68,6 +98,31 @@ declare class PositionTracker {
     getUnrealizedPnL(prices: Record<string, number>): Record<string, number>;
     /** Get total unrealized PnL across all positions */
     getTotalUnrealizedPnL(prices: Record<string, number>): number;
+    /**
+     * Record a sell failure for a token. Called when a sell attempt fails
+     * due to liquidity issues, route simulation failure, or excessive price impact.
+     */
+    recordSellFailure(token: string, reason: string): void;
+    /**
+     * Clear sell failure tracking for a token (called after successful sell).
+     */
+    clearSellFailure(token: string): void;
+    /**
+     * Detect positions that are "stuck" — we've tried and failed to sell them
+     * multiple times, likely due to insufficient liquidity.
+     *
+     * Returns positions that have failed to sell >= STUCK_FAILURE_THRESHOLD times.
+     */
+    getStuckPositions(prices: Record<string, number>): StuckPosition[];
+    /**
+     * Check if a specific position is stuck.
+     */
+    isPositionStuck(token: string): boolean;
+    /**
+     * Check if we should alert about a stuck position (rate-limited to once per 24h).
+     * Returns true if we should alert, and marks the alert as sent.
+     */
+    shouldAlertStuckPosition(token: string): boolean;
     /** Load persisted risk state */
     getRiskState(): RiskState;
     /** Save risk state to persistent store */
@@ -271,29 +326,21 @@ declare const PredictionConfigSchema: z.ZodOptional<z.ZodObject<{
     maxTotalExposureUSD: number;
     polygonAllocationUSD: number;
     feeBridgeThresholdUSD: number;
-    vault?: {
-        enabled: boolean;
-        factoryAddress: string;
-        isVerified: boolean;
-        feeRecipient?: string | undefined;
-        feeCollectorAddress?: string | undefined;
-        vaultAddress?: string | undefined;
-    } | undefined;
     polygonRpcUrl?: string | undefined;
     clobApiKey?: string | undefined;
     clobApiSecret?: string | undefined;
     clobApiPassphrase?: string | undefined;
     predictionRelayerKey?: string | undefined;
     allowedCategories?: string[] | undefined;
-}, {
     vault?: {
+        enabled: boolean;
         factoryAddress: string;
+        isVerified: boolean;
         feeRecipient?: string | undefined;
-        enabled?: boolean | undefined;
         feeCollectorAddress?: string | undefined;
         vaultAddress?: string | undefined;
-        isVerified?: boolean | undefined;
     } | undefined;
+}, {
     enabled?: boolean | undefined;
     maxNotionalUSD?: number | undefined;
     clobApiUrl?: string | undefined;
@@ -307,6 +354,14 @@ declare const PredictionConfigSchema: z.ZodOptional<z.ZodObject<{
     polygonAllocationUSD?: number | undefined;
     allowedCategories?: string[] | undefined;
     feeBridgeThresholdUSD?: number | undefined;
+    vault?: {
+        factoryAddress: string;
+        feeRecipient?: string | undefined;
+        enabled?: boolean | undefined;
+        feeCollectorAddress?: string | undefined;
+        vaultAddress?: string | undefined;
+        isVerified?: boolean | undefined;
+    } | undefined;
 }>>;
 type PredictionConfig$1 = z.infer<typeof PredictionConfigSchema>;
 declare const AgentConfigSchema: z.ZodObject<{
@@ -504,29 +559,21 @@ declare const AgentConfigSchema: z.ZodObject<{
         maxTotalExposureUSD: number;
         polygonAllocationUSD: number;
         feeBridgeThresholdUSD: number;
-        vault?: {
-            enabled: boolean;
-            factoryAddress: string;
-            isVerified: boolean;
-            feeRecipient?: string | undefined;
-            feeCollectorAddress?: string | undefined;
-            vaultAddress?: string | undefined;
-        } | undefined;
         polygonRpcUrl?: string | undefined;
         clobApiKey?: string | undefined;
         clobApiSecret?: string | undefined;
         clobApiPassphrase?: string | undefined;
         predictionRelayerKey?: string | undefined;
         allowedCategories?: string[] | undefined;
-    }, {
         vault?: {
+            enabled: boolean;
             factoryAddress: string;
+            isVerified: boolean;
             feeRecipient?: string | undefined;
-            enabled?: boolean | undefined;
             feeCollectorAddress?: string | undefined;
             vaultAddress?: string | undefined;
-            isVerified?: boolean | undefined;
         } | undefined;
+    }, {
         enabled?: boolean | undefined;
         maxNotionalUSD?: number | undefined;
         clobApiUrl?: string | undefined;
@@ -540,12 +587,27 @@ declare const AgentConfigSchema: z.ZodObject<{
         polygonAllocationUSD?: number | undefined;
         allowedCategories?: string[] | undefined;
         feeBridgeThresholdUSD?: number | undefined;
+        vault?: {
+            factoryAddress: string;
+            feeRecipient?: string | undefined;
+            enabled?: boolean | undefined;
+            feeCollectorAddress?: string | undefined;
+            vaultAddress?: string | undefined;
+            isVerified?: boolean | undefined;
+        } | undefined;
     }>>;
     allowedTokens: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    agentId: string | number;
     name: string;
     network: "mainnet";
+    vault: {
+        policy: "disabled" | "manual";
+        preferVaultTrading: boolean;
+        defaultName?: string | undefined;
+        defaultSymbol?: string | undefined;
+        feeRecipient?: string | undefined;
+    };
+    agentId: string | number;
     llm: {
         provider: "custom" | "openai" | "anthropic" | "google" | "deepseek" | "mistral" | "groq" | "together" | "ollama";
         temperature: number;
@@ -564,13 +626,6 @@ declare const AgentConfigSchema: z.ZodObject<{
         maxSlippageBps: number;
         minTradeValueUSD: number;
     };
-    vault: {
-        policy: "disabled" | "manual";
-        preferVaultTrading: boolean;
-        defaultName?: string | undefined;
-        defaultSymbol?: string | undefined;
-        feeRecipient?: string | undefined;
-    };
     wallet?: {
         setup: "generate" | "provide";
     } | undefined;
@@ -598,6 +653,12 @@ declare const AgentConfigSchema: z.ZodObject<{
         maxTotalExposureUSD: number;
         polygonAllocationUSD: number;
         feeBridgeThresholdUSD: number;
+        polygonRpcUrl?: string | undefined;
+        clobApiKey?: string | undefined;
+        clobApiSecret?: string | undefined;
+        clobApiPassphrase?: string | undefined;
+        predictionRelayerKey?: string | undefined;
+        allowedCategories?: string[] | undefined;
         vault?: {
             enabled: boolean;
             factoryAddress: string;
@@ -606,17 +667,11 @@ declare const AgentConfigSchema: z.ZodObject<{
             feeCollectorAddress?: string | undefined;
             vaultAddress?: string | undefined;
         } | undefined;
-        polygonRpcUrl?: string | undefined;
-        clobApiKey?: string | undefined;
-        clobApiSecret?: string | undefined;
-        clobApiPassphrase?: string | undefined;
-        predictionRelayerKey?: string | undefined;
-        allowedCategories?: string[] | undefined;
     } | 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;
@@ -626,6 +681,13 @@ declare const AgentConfigSchema: z.ZodObject<{
         maxTokens?: number | undefined;
     };
     network?: "mainnet" | undefined;
+    vault?: {
+        policy?: "disabled" | "manual" | undefined;
+        defaultName?: string | undefined;
+        defaultSymbol?: string | undefined;
+        feeRecipient?: string | undefined;
+        preferVaultTrading?: boolean | undefined;
+    } | undefined;
     wallet?: {
         setup?: "generate" | "provide" | undefined;
     } | undefined;
@@ -639,13 +701,6 @@ declare const AgentConfigSchema: z.ZodObject<{
         maxSlippageBps?: number | undefined;
         minTradeValueUSD?: number | undefined;
     } | undefined;
-    vault?: {
-        policy?: "disabled" | "manual" | undefined;
-        defaultName?: string | undefined;
-        defaultSymbol?: string | undefined;
-        feeRecipient?: string | undefined;
-        preferVaultTrading?: boolean | undefined;
-    } | undefined;
     relay?: {
         apiUrl: string;
         enabled?: boolean | undefined;
@@ -663,14 +718,6 @@ declare const AgentConfigSchema: z.ZodObject<{
         allowedInstruments?: string[] | undefined;
     } | undefined;
     prediction?: {
-        vault?: {
-            factoryAddress: string;
-            feeRecipient?: string | undefined;
-            enabled?: boolean | undefined;
-            feeCollectorAddress?: string | undefined;
-            vaultAddress?: string | undefined;
-            isVerified?: boolean | undefined;
-        } | undefined;
         enabled?: boolean | undefined;
         maxNotionalUSD?: number | undefined;
         clobApiUrl?: string | undefined;
@@ -684,6 +731,14 @@ declare const AgentConfigSchema: z.ZodObject<{
         polygonAllocationUSD?: number | undefined;
         allowedCategories?: string[] | undefined;
         feeBridgeThresholdUSD?: number | undefined;
+        vault?: {
+            factoryAddress: string;
+            feeRecipient?: string | undefined;
+            enabled?: boolean | undefined;
+            feeCollectorAddress?: string | undefined;
+            vaultAddress?: string | undefined;
+            isVerified?: boolean | undefined;
+        } | undefined;
     } | undefined;
     allowedTokens?: string[] | undefined;
 }>;
@@ -783,6 +838,13 @@ interface TradeRecord {
     /** Realized PnL in USD (only for sells) */
     realizedPnL?: number;
     success: boolean;
+    /**
+     * True if this trade was inferred from balance changes, not from a tracked execution.
+     * Inferred exits occur when a position's balance decreases without a corresponding
+     * sell trade — typically from manual swaps outside the ExagentRouter.
+     * PnL is calculated at current market price and counts toward total realized PnL.
+     */
+    inferred?: boolean;
 }
 /**
  * Compact position summary for relay heartbeats.
@@ -936,7 +998,7 @@ interface RelayCommand {
     type: CommandType;
     params?: Record<string, unknown>;
 }
-type MessageType = 'trade_executed' | 'trade_failed' | 'paper_trade_executed' | 'paper_trade_failed' | 'perp_fill' | 'perp_liquidation_warning' | 'perp_funding' | 'prediction_fill' | 'prediction_market_resolved' | 'prediction_vault_created' | 'prediction_vault_deposit' | 'prediction_vault_withdraw' | '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' | 'prediction_fill' | 'prediction_market_resolved' | 'prediction_vault_created' | 'prediction_vault_deposit' | 'prediction_vault_withdraw' | 'funds_low' | 'risk_limit_hit' | 'position_stuck' | 'position_inferred_exit' | 'vault_created' | 'config_updated' | 'llm_error' | 'command_result' | 'system';
 type MessageLevel = 'info' | 'warning' | 'error' | 'success';
 interface AgentStatusPayload {
     mode: AgentMode;
@@ -3283,6 +3345,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.40";
+declare const AGENT_VERSION = "0.1.42";
 
-export { AGENT_VERSION, type AccountSummary, type AgentConfig, AgentConfigSchema, type AgentMode, AgentRuntime, type AgentStatusPayload, AnthropicAdapter, BaseLLMAdapter, type BridgeResult, type BridgeStep, 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 LocalPosition, MARKET_CATEGORIES, MarketBrowser, type MarketCategory, 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, PolymarketClient, PositionManager, type PositionSummary, PositionTracker, type PredictionAccountSummary, type PredictionAction, type PredictionConfig$1 as PredictionConfig, PredictionConfigSchema, type PredictionFill, PredictionFunding, type PredictionFundingConfig, type PredictionMarket, PredictionOrderManager, type PredictionPosition, PredictionPositionManager, type PredictionStrategyFunction, PredictionTradeRecorder, type PredictionTradeSignal, type PredictionConfig as PredictionTradingConfig, type RecordPerpTradeParams, type RecordPredictionTradeParams, 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, calculatePredictionFee, createLLMAdapter, createSampleConfig, decodePredictionInstrument, decryptEnvFile, encodePredictionInstrument, encryptEnvFile, fillHashToBytes32, fillOidToBytes32, getAllStrategyTemplates, getNextNonce, getStrategyTemplate, loadConfig, loadSecureEnv, loadStrategy, orderIdToBytes32, tradeIdToBytes32, validateConfig, validateStrategy };
+export { AGENT_VERSION, type AccountSummary, type AgentConfig, AgentConfigSchema, type AgentMode, AgentRuntime, type AgentStatusPayload, AnthropicAdapter, BaseLLMAdapter, type BridgeResult, type BridgeStep, type CommandType, DeepSeekAdapter, FileStore, type FillCallback, type FundingCallback, type FundingPayment, GoogleAdapter, GroqAdapter, HYPERLIQUID_DOMAIN, HyperliquidClient, HyperliquidSigner, HyperliquidWebSocket, type InferredExit, type LLMAdapter, type LLMConfig, LLMConfigSchema, type LLMMessage, type LLMMetadata, type LLMProvider, LLMProviderSchema, type LLMResponse, type LiquidationCallback, type LocalPosition, MARKET_CATEGORIES, MarketBrowser, type MarketCategory, 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, PolymarketClient, PositionManager, type PositionSummary, PositionTracker, type PredictionAccountSummary, type PredictionAction, type PredictionConfig$1 as PredictionConfig, PredictionConfigSchema, type PredictionFill, PredictionFunding, type PredictionFundingConfig, type PredictionMarket, PredictionOrderManager, type PredictionPosition, PredictionPositionManager, type PredictionStrategyFunction, PredictionTradeRecorder, type PredictionTradeSignal, type PredictionConfig as PredictionTradingConfig, type RecordPerpTradeParams, type RecordPredictionTradeParams, 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, type StuckPosition, TogetherAdapter, type TrackedPosition, TradeExecutor, type TradeRecord, type TradeSignal, type TradingConfig, TradingConfigSchema, type VaultConfig, VaultConfigSchema, VaultManager, type VaultManagerConfig, type VaultPolicy, VaultPolicySchema, type VaultStatus, calculatePredictionFee, createLLMAdapter, createSampleConfig, decodePredictionInstrument, decryptEnvFile, encodePredictionInstrument, encryptEnvFile, fillHashToBytes32, fillOidToBytes32, getAllStrategyTemplates, getNextNonce, getStrategyTemplate, loadConfig, loadSecureEnv, loadStrategy, orderIdToBytes32, tradeIdToBytes32, validateConfig, validateStrategy };

package/dist/index.d.ts

@@ -9,6 +9,24 @@ interface RiskState {
     dailyFees: number;
     lastResetDate: string;
 }
+/** Stuck position detection result */
+interface StuckPosition {
+    token: string;
+    symbol: string;
+    consecutiveFailures: number;
+    lastFailureReason: string;
+    holdingDurationMs: number;
+    estimatedValueUSD: number;
+}
+/** Result of an inferred exit detected during balance sync */
+interface InferredExit {
+    token: string;
+    symbol: string;
+    amountExited: number;
+    exitValueUSD: number;
+    realizedPnL: number;
+    costBasis: number;
+}
 /**
  * PositionTracker — automatic position tracking with persistence.
  *
@@ -25,6 +43,7 @@ declare class PositionTracker {
     private store;
     private positions;
     private tradeHistory;
+    private sellFailures;
     private maxTradeHistory;
     constructor(store: StrategyStore, options?: {
         maxTradeHistory?: number;
@@ -55,9 +74,20 @@ declare class PositionTracker {
     private handleSell;
     /**
      * Sync tracked positions with on-chain balances.
-     * Updates currentAmount, detects new tokens (airdrops), removes zeroed positions.
+     * Updates currentAmount, detects new tokens (airdrops), and handles position exits.
+     *
+     * CRITICAL: When a tracked position's balance decreases without a corresponding
+     * sell trade, we infer a manual exit and record it with realized PnL calculated
+     * at current market price. This prevents PnL manipulation via off-router sells.
+     *
+     * Returns array of inferred exits for the runtime to report to Command Center.
+     */
+    syncBalances(balances: Record<string, bigint>, prices: Record<string, number>): InferredExit[];
+    /**
+     * Record an inferred exit in trade history.
+     * These are exits detected from balance changes, not from tracked sell executions.
      */
-    syncBalances(balances: Record<string, bigint>, prices: Record<string, number>): void;
+    private recordInferredExit;
     /** Get all tracked positions (backfills missing symbols from resolver) */
     getPositions(): TrackedPosition[];
     /** Get a single position by token address */
@@ -68,6 +98,31 @@ declare class PositionTracker {
     getUnrealizedPnL(prices: Record<string, number>): Record<string, number>;
     /** Get total unrealized PnL across all positions */
     getTotalUnrealizedPnL(prices: Record<string, number>): number;
+    /**
+     * Record a sell failure for a token. Called when a sell attempt fails
+     * due to liquidity issues, route simulation failure, or excessive price impact.
+     */
+    recordSellFailure(token: string, reason: string): void;
+    /**
+     * Clear sell failure tracking for a token (called after successful sell).
+     */
+    clearSellFailure(token: string): void;
+    /**
+     * Detect positions that are "stuck" — we've tried and failed to sell them
+     * multiple times, likely due to insufficient liquidity.
+     *
+     * Returns positions that have failed to sell >= STUCK_FAILURE_THRESHOLD times.
+     */
+    getStuckPositions(prices: Record<string, number>): StuckPosition[];
+    /**
+     * Check if a specific position is stuck.
+     */
+    isPositionStuck(token: string): boolean;
+    /**
+     * Check if we should alert about a stuck position (rate-limited to once per 24h).
+     * Returns true if we should alert, and marks the alert as sent.
+     */
+    shouldAlertStuckPosition(token: string): boolean;
     /** Load persisted risk state */
     getRiskState(): RiskState;
     /** Save risk state to persistent store */
@@ -271,29 +326,21 @@ declare const PredictionConfigSchema: z.ZodOptional<z.ZodObject<{
     maxTotalExposureUSD: number;
     polygonAllocationUSD: number;
     feeBridgeThresholdUSD: number;
-    vault?: {
-        enabled: boolean;
-        factoryAddress: string;
-        isVerified: boolean;
-        feeRecipient?: string | undefined;
-        feeCollectorAddress?: string | undefined;
-        vaultAddress?: string | undefined;
-    } | undefined;
     polygonRpcUrl?: string | undefined;
     clobApiKey?: string | undefined;
     clobApiSecret?: string | undefined;
     clobApiPassphrase?: string | undefined;
     predictionRelayerKey?: string | undefined;
     allowedCategories?: string[] | undefined;
-}, {
     vault?: {
+        enabled: boolean;
         factoryAddress: string;
+        isVerified: boolean;
         feeRecipient?: string | undefined;
-        enabled?: boolean | undefined;
         feeCollectorAddress?: string | undefined;
         vaultAddress?: string | undefined;
-        isVerified?: boolean | undefined;
     } | undefined;
+}, {
     enabled?: boolean | undefined;
     maxNotionalUSD?: number | undefined;
     clobApiUrl?: string | undefined;
@@ -307,6 +354,14 @@ declare const PredictionConfigSchema: z.ZodOptional<z.ZodObject<{
     polygonAllocationUSD?: number | undefined;
     allowedCategories?: string[] | undefined;
     feeBridgeThresholdUSD?: number | undefined;
+    vault?: {
+        factoryAddress: string;
+        feeRecipient?: string | undefined;
+        enabled?: boolean | undefined;
+        feeCollectorAddress?: string | undefined;
+        vaultAddress?: string | undefined;
+        isVerified?: boolean | undefined;
+    } | undefined;
 }>>;
 type PredictionConfig$1 = z.infer<typeof PredictionConfigSchema>;
 declare const AgentConfigSchema: z.ZodObject<{
@@ -504,29 +559,21 @@ declare const AgentConfigSchema: z.ZodObject<{
         maxTotalExposureUSD: number;
         polygonAllocationUSD: number;
         feeBridgeThresholdUSD: number;
-        vault?: {
-            enabled: boolean;
-            factoryAddress: string;
-            isVerified: boolean;
-            feeRecipient?: string | undefined;
-            feeCollectorAddress?: string | undefined;
-            vaultAddress?: string | undefined;
-        } | undefined;
         polygonRpcUrl?: string | undefined;
         clobApiKey?: string | undefined;
         clobApiSecret?: string | undefined;
         clobApiPassphrase?: string | undefined;
         predictionRelayerKey?: string | undefined;
         allowedCategories?: string[] | undefined;
-    }, {
         vault?: {
+            enabled: boolean;
             factoryAddress: string;
+            isVerified: boolean;
             feeRecipient?: string | undefined;
-            enabled?: boolean | undefined;
             feeCollectorAddress?: string | undefined;
             vaultAddress?: string | undefined;
-            isVerified?: boolean | undefined;
         } | undefined;
+    }, {
         enabled?: boolean | undefined;
         maxNotionalUSD?: number | undefined;
         clobApiUrl?: string | undefined;
@@ -540,12 +587,27 @@ declare const AgentConfigSchema: z.ZodObject<{
         polygonAllocationUSD?: number | undefined;
         allowedCategories?: string[] | undefined;
         feeBridgeThresholdUSD?: number | undefined;
+        vault?: {
+            factoryAddress: string;
+            feeRecipient?: string | undefined;
+            enabled?: boolean | undefined;
+            feeCollectorAddress?: string | undefined;
+            vaultAddress?: string | undefined;
+            isVerified?: boolean | undefined;
+        } | undefined;
     }>>;
     allowedTokens: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    agentId: string | number;
     name: string;
     network: "mainnet";
+    vault: {
+        policy: "disabled" | "manual";
+        preferVaultTrading: boolean;
+        defaultName?: string | undefined;
+        defaultSymbol?: string | undefined;
+        feeRecipient?: string | undefined;
+    };
+    agentId: string | number;
     llm: {
         provider: "custom" | "openai" | "anthropic" | "google" | "deepseek" | "mistral" | "groq" | "together" | "ollama";
         temperature: number;
@@ -564,13 +626,6 @@ declare const AgentConfigSchema: z.ZodObject<{
         maxSlippageBps: number;
         minTradeValueUSD: number;
     };
-    vault: {
-        policy: "disabled" | "manual";
-        preferVaultTrading: boolean;
-        defaultName?: string | undefined;
-        defaultSymbol?: string | undefined;
-        feeRecipient?: string | undefined;
-    };
     wallet?: {
         setup: "generate" | "provide";
     } | undefined;
@@ -598,6 +653,12 @@ declare const AgentConfigSchema: z.ZodObject<{
         maxTotalExposureUSD: number;
         polygonAllocationUSD: number;
         feeBridgeThresholdUSD: number;
+        polygonRpcUrl?: string | undefined;
+        clobApiKey?: string | undefined;
+        clobApiSecret?: string | undefined;
+        clobApiPassphrase?: string | undefined;
+        predictionRelayerKey?: string | undefined;
+        allowedCategories?: string[] | undefined;
         vault?: {
             enabled: boolean;
             factoryAddress: string;
@@ -606,17 +667,11 @@ declare const AgentConfigSchema: z.ZodObject<{
             feeCollectorAddress?: string | undefined;
             vaultAddress?: string | undefined;
         } | undefined;
-        polygonRpcUrl?: string | undefined;
-        clobApiKey?: string | undefined;
-        clobApiSecret?: string | undefined;
-        clobApiPassphrase?: string | undefined;
-        predictionRelayerKey?: string | undefined;
-        allowedCategories?: string[] | undefined;
     } | 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;
@@ -626,6 +681,13 @@ declare const AgentConfigSchema: z.ZodObject<{
         maxTokens?: number | undefined;
     };
     network?: "mainnet" | undefined;
+    vault?: {
+        policy?: "disabled" | "manual" | undefined;
+        defaultName?: string | undefined;
+        defaultSymbol?: string | undefined;
+        feeRecipient?: string | undefined;
+        preferVaultTrading?: boolean | undefined;
+    } | undefined;
     wallet?: {
         setup?: "generate" | "provide" | undefined;
     } | undefined;
@@ -639,13 +701,6 @@ declare const AgentConfigSchema: z.ZodObject<{
         maxSlippageBps?: number | undefined;
         minTradeValueUSD?: number | undefined;
     } | undefined;
-    vault?: {
-        policy?: "disabled" | "manual" | undefined;
-        defaultName?: string | undefined;
-        defaultSymbol?: string | undefined;
-        feeRecipient?: string | undefined;
-        preferVaultTrading?: boolean | undefined;
-    } | undefined;
     relay?: {
         apiUrl: string;
         enabled?: boolean | undefined;
@@ -663,14 +718,6 @@ declare const AgentConfigSchema: z.ZodObject<{
         allowedInstruments?: string[] | undefined;
     } | undefined;
     prediction?: {
-        vault?: {
-            factoryAddress: string;
-            feeRecipient?: string | undefined;
-            enabled?: boolean | undefined;
-            feeCollectorAddress?: string | undefined;
-            vaultAddress?: string | undefined;
-            isVerified?: boolean | undefined;
-        } | undefined;
         enabled?: boolean | undefined;
         maxNotionalUSD?: number | undefined;
         clobApiUrl?: string | undefined;
@@ -684,6 +731,14 @@ declare const AgentConfigSchema: z.ZodObject<{
         polygonAllocationUSD?: number | undefined;
         allowedCategories?: string[] | undefined;
         feeBridgeThresholdUSD?: number | undefined;
+        vault?: {
+            factoryAddress: string;
+            feeRecipient?: string | undefined;
+            enabled?: boolean | undefined;
+            feeCollectorAddress?: string | undefined;
+            vaultAddress?: string | undefined;
+            isVerified?: boolean | undefined;
+        } | undefined;
     } | undefined;
     allowedTokens?: string[] | undefined;
 }>;
@@ -783,6 +838,13 @@ interface TradeRecord {
     /** Realized PnL in USD (only for sells) */
     realizedPnL?: number;
     success: boolean;
+    /**
+     * True if this trade was inferred from balance changes, not from a tracked execution.
+     * Inferred exits occur when a position's balance decreases without a corresponding
+     * sell trade — typically from manual swaps outside the ExagentRouter.
+     * PnL is calculated at current market price and counts toward total realized PnL.
+     */
+    inferred?: boolean;
 }
 /**
  * Compact position summary for relay heartbeats.
@@ -936,7 +998,7 @@ interface RelayCommand {
     type: CommandType;
     params?: Record<string, unknown>;
 }
-type MessageType = 'trade_executed' | 'trade_failed' | 'paper_trade_executed' | 'paper_trade_failed' | 'perp_fill' | 'perp_liquidation_warning' | 'perp_funding' | 'prediction_fill' | 'prediction_market_resolved' | 'prediction_vault_created' | 'prediction_vault_deposit' | 'prediction_vault_withdraw' | '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' | 'prediction_fill' | 'prediction_market_resolved' | 'prediction_vault_created' | 'prediction_vault_deposit' | 'prediction_vault_withdraw' | 'funds_low' | 'risk_limit_hit' | 'position_stuck' | 'position_inferred_exit' | 'vault_created' | 'config_updated' | 'llm_error' | 'command_result' | 'system';
 type MessageLevel = 'info' | 'warning' | 'error' | 'success';
 interface AgentStatusPayload {
     mode: AgentMode;
@@ -3283,6 +3345,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.40";
+declare const AGENT_VERSION = "0.1.42";
 
-export { AGENT_VERSION, type AccountSummary, type AgentConfig, AgentConfigSchema, type AgentMode, AgentRuntime, type AgentStatusPayload, AnthropicAdapter, BaseLLMAdapter, type BridgeResult, type BridgeStep, 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 LocalPosition, MARKET_CATEGORIES, MarketBrowser, type MarketCategory, 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, PolymarketClient, PositionManager, type PositionSummary, PositionTracker, type PredictionAccountSummary, type PredictionAction, type PredictionConfig$1 as PredictionConfig, PredictionConfigSchema, type PredictionFill, PredictionFunding, type PredictionFundingConfig, type PredictionMarket, PredictionOrderManager, type PredictionPosition, PredictionPositionManager, type PredictionStrategyFunction, PredictionTradeRecorder, type PredictionTradeSignal, type PredictionConfig as PredictionTradingConfig, type RecordPerpTradeParams, type RecordPredictionTradeParams, 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, calculatePredictionFee, createLLMAdapter, createSampleConfig, decodePredictionInstrument, decryptEnvFile, encodePredictionInstrument, encryptEnvFile, fillHashToBytes32, fillOidToBytes32, getAllStrategyTemplates, getNextNonce, getStrategyTemplate, loadConfig, loadSecureEnv, loadStrategy, orderIdToBytes32, tradeIdToBytes32, validateConfig, validateStrategy };
+export { AGENT_VERSION, type AccountSummary, type AgentConfig, AgentConfigSchema, type AgentMode, AgentRuntime, type AgentStatusPayload, AnthropicAdapter, BaseLLMAdapter, type BridgeResult, type BridgeStep, type CommandType, DeepSeekAdapter, FileStore, type FillCallback, type FundingCallback, type FundingPayment, GoogleAdapter, GroqAdapter, HYPERLIQUID_DOMAIN, HyperliquidClient, HyperliquidSigner, HyperliquidWebSocket, type InferredExit, type LLMAdapter, type LLMConfig, LLMConfigSchema, type LLMMessage, type LLMMetadata, type LLMProvider, LLMProviderSchema, type LLMResponse, type LiquidationCallback, type LocalPosition, MARKET_CATEGORIES, MarketBrowser, type MarketCategory, 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, PolymarketClient, PositionManager, type PositionSummary, PositionTracker, type PredictionAccountSummary, type PredictionAction, type PredictionConfig$1 as PredictionConfig, PredictionConfigSchema, type PredictionFill, PredictionFunding, type PredictionFundingConfig, type PredictionMarket, PredictionOrderManager, type PredictionPosition, PredictionPositionManager, type PredictionStrategyFunction, PredictionTradeRecorder, type PredictionTradeSignal, type PredictionConfig as PredictionTradingConfig, type RecordPerpTradeParams, type RecordPredictionTradeParams, 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, type StuckPosition, TogetherAdapter, type TrackedPosition, TradeExecutor, type TradeRecord, type TradeSignal, type TradingConfig, TradingConfigSchema, type VaultConfig, VaultConfigSchema, VaultManager, type VaultManagerConfig, type VaultPolicy, VaultPolicySchema, type VaultStatus, calculatePredictionFee, createLLMAdapter, createSampleConfig, decodePredictionInstrument, decryptEnvFile, encodePredictionInstrument, encryptEnvFile, fillHashToBytes32, fillOidToBytes32, getAllStrategyTemplates, getNextNonce, getStrategyTemplate, loadConfig, loadSecureEnv, loadStrategy, orderIdToBytes32, tradeIdToBytes32, validateConfig, validateStrategy };