@exagent/agent 0.1.19 → 0.1.21

package/dist/cli.mjs

@@ -6,7 +6,7 @@ import {
   loadConfig,
   loadSecureEnv,
   validateConfig
-} from "./chunk-ZLDWYPBF.mjs";
+} from "./chunk-U6YJHCO3.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;
@@ -404,7 +478,99 @@ interface LLMResponse {
         totalTokens: number;
     };
 }
-type StrategyFunction = (marketData: MarketData, llm: LLMAdapter, config: AgentConfig) => Promise<TradeSignal[]>;
+/**
+ * Persistent key-value store for strategies.
+ * Data survives restarts (backed by a JSON file in the agent's data directory).
+ * Use this to store entry prices, position metadata, PnL tracking, etc.
+ */
+interface StrategyStore {
+    get<T = unknown>(key: string): T | undefined;
+    set<T = unknown>(key: string, value: T): void;
+    delete(key: string): void;
+    /** Get all keys in the store */
+    keys(): string[];
+}
+/**
+ * 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) */
+    store: StrategyStore;
+    /** Agent ID on-chain */
+    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).
+ * The 4th parameter (context) is optional for backward compatibility.
+ */
+type StrategyFunction = (marketData: MarketData, llm: LLMAdapter, config: AgentConfig, context?: StrategyContext) => Promise<TradeSignal[]>;
 interface LLMAdapter {
     chat(messages: LLMMessage[]): Promise<LLMResponse>;
     getMetadata(): LLMMetadata;
@@ -529,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;
@@ -558,6 +726,19 @@ 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;
+    };
 }
 interface RelayConfig {
     enabled: boolean;
@@ -593,9 +774,12 @@ declare class AgentRuntime {
     private lastCycleAt;
     private lastPortfolioValue;
     private lastEthBalance;
+    private lastPrices;
     private processAlive;
     private riskUniverse;
     private allowedTokens;
+    private strategyContext;
+    private positionTracker;
     private perpClient;
     private perpSigner;
     private perpOrders;
@@ -746,6 +930,22 @@ declare function validateConfig(config: RuntimeConfig): void;
  */
 declare function createSampleConfig(agentId: number, name: string): AgentConfig;
 
+/**
+ * File-backed persistent key-value store for strategies.
+ * Data is saved as JSON in the agent's data directory and survives restarts.
+ */
+declare class FileStore implements StrategyStore {
+    private data;
+    private filePath;
+    private dirty;
+    constructor(dataDir?: string);
+    get<T = unknown>(key: string): T | undefined;
+    set<T = unknown>(key: string, value: T): void;
+    delete(key: string): void;
+    keys(): string[];
+    private flush;
+}
+
 /**
  * Base adapter class with common functionality
  */
@@ -1116,7 +1316,9 @@ declare class RiskManager {
      */
     filterSignals(signals: TradeSignal[], marketData: MarketData): TradeSignal[];
     /**
-     * Validate individual signal against risk limits
+     * Validate individual signal against risk limits.
+     * Sell signals are exempt from position size and minimum value checks —
+     * those guardrails prevent oversized/dust buys, but blocking exits traps capital.
      */
     private validateSignal;
     /**
@@ -1141,6 +1343,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)
@@ -1861,4 +2080,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, 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 StrategyFunction, 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.21";
+
+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;
@@ -404,7 +478,99 @@ interface LLMResponse {
         totalTokens: number;
     };
 }
-type StrategyFunction = (marketData: MarketData, llm: LLMAdapter, config: AgentConfig) => Promise<TradeSignal[]>;
+/**
+ * Persistent key-value store for strategies.
+ * Data survives restarts (backed by a JSON file in the agent's data directory).
+ * Use this to store entry prices, position metadata, PnL tracking, etc.
+ */
+interface StrategyStore {
+    get<T = unknown>(key: string): T | undefined;
+    set<T = unknown>(key: string, value: T): void;
+    delete(key: string): void;
+    /** Get all keys in the store */
+    keys(): string[];
+}
+/**
+ * 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) */
+    store: StrategyStore;
+    /** Agent ID on-chain */
+    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).
+ * The 4th parameter (context) is optional for backward compatibility.
+ */
+type StrategyFunction = (marketData: MarketData, llm: LLMAdapter, config: AgentConfig, context?: StrategyContext) => Promise<TradeSignal[]>;
 interface LLMAdapter {
     chat(messages: LLMMessage[]): Promise<LLMResponse>;
     getMetadata(): LLMMetadata;
@@ -529,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;
@@ -558,6 +726,19 @@ 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;
+    };
 }
 interface RelayConfig {
     enabled: boolean;
@@ -593,9 +774,12 @@ declare class AgentRuntime {
     private lastCycleAt;
     private lastPortfolioValue;
     private lastEthBalance;
+    private lastPrices;
     private processAlive;
     private riskUniverse;
     private allowedTokens;
+    private strategyContext;
+    private positionTracker;
     private perpClient;
     private perpSigner;
     private perpOrders;
@@ -746,6 +930,22 @@ declare function validateConfig(config: RuntimeConfig): void;
  */
 declare function createSampleConfig(agentId: number, name: string): AgentConfig;
 
+/**
+ * File-backed persistent key-value store for strategies.
+ * Data is saved as JSON in the agent's data directory and survives restarts.
+ */
+declare class FileStore implements StrategyStore {
+    private data;
+    private filePath;
+    private dirty;
+    constructor(dataDir?: string);
+    get<T = unknown>(key: string): T | undefined;
+    set<T = unknown>(key: string, value: T): void;
+    delete(key: string): void;
+    keys(): string[];
+    private flush;
+}
+
 /**
  * Base adapter class with common functionality
  */
@@ -1116,7 +1316,9 @@ declare class RiskManager {
      */
     filterSignals(signals: TradeSignal[], marketData: MarketData): TradeSignal[];
     /**
-     * Validate individual signal against risk limits
+     * Validate individual signal against risk limits.
+     * Sell signals are exempt from position size and minimum value checks —
+     * those guardrails prevent oversized/dust buys, but blocking exits traps capital.
      */
     private validateSignal;
     /**
@@ -1141,6 +1343,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)
@@ -1861,4 +2080,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, 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 StrategyFunction, 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.21";
+
+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 };