@exagent/agent 0.1.46 → 0.1.48

package/dist/cli.mjs

@@ -13,6 +13,7 @@ import {
   encryptEnvFile,
   formatSessionReport,
   getAllStrategyTemplates,
+  getStrategyTemplate,
   getTokenDecimals,
   init_adapter,
   init_executor,
@@ -29,7 +30,7 @@ import {
   results_exports,
   saveSessionResult,
   validateConfig
-} from "./chunk-7QMPWDX3.mjs";
+} from "./chunk-V5XCNJWM.mjs";
 
 // src/backtest/data-loader.ts
 import * as fs from "fs";
@@ -1107,6 +1108,95 @@ ${llmEnvVar}EXAGENT_LLM_MODEL=${config.llm?.model || ""}
     loadEnvFile({ path: envPath, override: true });
   }
 }
+program.command("init").description("Scaffold a new agent project with strategy template and config").option("-t, --template <template>", "Strategy template (momentum, value, arbitrage, custom)", "momentum").option("--force", "Overwrite existing files without prompting").action(async (options) => {
+  try {
+    const templateId = options.template;
+    const template = getStrategyTemplate(templateId);
+    if (!template) {
+      const templates = getAllStrategyTemplates();
+      console.error(`Unknown template: ${templateId}`);
+      console.error(`Available templates: ${templates.map((t) => t.id).join(", ")}`);
+      process.exit(1);
+    }
+    console.log("");
+    console.log("=".repeat(50));
+    console.log("  EXAGENT INIT");
+    console.log("=".repeat(50));
+    console.log("");
+    console.log(`  Template: ${template.name}`);
+    console.log(`  Risk:     ${template.riskLevel}`);
+    console.log("");
+    const cwd = process.cwd();
+    const strategyPath = path4.join(cwd, "strategy.ts");
+    const configPath = path4.join(cwd, "agent-config.json");
+    const existingFiles = [];
+    if (fs3.existsSync(strategyPath)) existingFiles.push("strategy.ts");
+    if (fs3.existsSync(configPath)) existingFiles.push("agent-config.json");
+    if (existingFiles.length > 0 && !options.force) {
+      console.log(`  Files already exist: ${existingFiles.join(", ")}`);
+      const answer = await prompt("  Overwrite? (y/n): ");
+      if (answer.toLowerCase() !== "y") {
+        console.log("  Aborted.");
+        process.exit(0);
+      }
+      console.log("");
+    }
+    fs3.writeFileSync(strategyPath, template.exampleCode.trim() + "\n");
+    console.log("  Created: strategy.ts");
+    const defaultConfig = {
+      agentId: 0,
+      name: "my-agent",
+      network: "mainnet",
+      llm: {
+        provider: "openai",
+        model: "gpt-4o",
+        temperature: 0.7,
+        maxTokens: 4096
+      },
+      riskUniverse: "established",
+      trading: {
+        timeHorizon: "swing",
+        maxPositionSizeBps: 1e3,
+        maxDailyLossBps: 500,
+        maxConcurrentPositions: 5,
+        tradingIntervalMs: 6e4,
+        maxSlippageBps: 100,
+        minTradeValueUSD: 1
+      },
+      wallet: {
+        setup: "generate"
+      },
+      relay: {
+        enabled: true,
+        apiUrl: "https://exagent-api.onrender.com"
+      }
+    };
+    if (!fs3.existsSync(configPath) || options.force || existingFiles.includes("agent-config.json")) {
+      fs3.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2) + "\n");
+      console.log("  Created: agent-config.json");
+    }
+    console.log("");
+    console.log("=".repeat(50));
+    console.log("  NEXT STEPS");
+    console.log("=".repeat(50));
+    console.log("");
+    console.log("  1. Register your agent at https://exagent.io/deploy");
+    console.log("  2. Copy your agent ID into agent-config.json");
+    console.log("  3. Update agent-config.json with your name and LLM provider");
+    console.log("  4. Run: npx @exagent/agent paper");
+    console.log("     (paper trade first to validate your strategy)");
+    console.log("");
+    console.log("  5. When ready for real trading:");
+    console.log("     npx @exagent/agent run");
+    console.log("");
+    console.log("=".repeat(50));
+    console.log("");
+    process.exit(0);
+  } catch (error) {
+    console.error("Error:", error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
 program.command("run").description("Start the trading agent").option("-c, --config <path>", "Path to agent-config.json", "agent-config.json").option("-p, --passphrase <passphrase>", "Passphrase to decrypt .env.enc").action(async (options) => {
   try {
     await checkFirstRunSetup(options.config);

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { Address, Hash, PublicClient, HttpTransport, WalletClient } from 'viem';
-import { ExagentClient } from '@exagent/sdk';
+import { VaultTradeParams, ExagentClient } from '@exagent/sdk';
 import { base } from 'viem/chains';
 
 /** Risk state persisted across restarts */
@@ -596,6 +596,7 @@ declare const AgentConfigSchema: z.ZodObject<{
             isVerified?: boolean | undefined;
         } | undefined;
     }>>;
+    strategyPrompt: z.ZodOptional<z.ZodString>;
     allowedTokens: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -668,6 +669,7 @@ declare const AgentConfigSchema: z.ZodObject<{
             vaultAddress?: string | undefined;
         } | undefined;
     } | undefined;
+    strategyPrompt?: string | undefined;
     allowedTokens?: string[] | undefined;
 }, {
     name: string;
@@ -740,6 +742,7 @@ declare const AgentConfigSchema: z.ZodObject<{
             isVerified?: boolean | undefined;
         } | undefined;
     } | undefined;
+    strategyPrompt?: string | undefined;
     allowedTokens?: string[] | undefined;
 }>;
 type AgentConfig = z.infer<typeof AgentConfigSchema>;
@@ -762,6 +765,11 @@ interface MarketData {
         chainId: number;
         blockNumber?: number;
     };
+    /** Hourly price history (last 24h) per token. Array ordered oldest→newest. */
+    priceHistory?: Record<string, Array<{
+        timestamp: number;
+        price: number;
+    }>>;
 }
 interface TradeSignal {
     action: 'buy' | 'sell' | 'hold';
@@ -967,16 +975,16 @@ declare class VaultManager {
         error?: string;
     }>;
     /**
-     * Execute a trade through the vault (if it exists and policy allows)
-     * Returns null if should use direct trading instead
+     * Execute a trade through the vault using API-provided vaultParams.
+     * Dispatches to the correct vault function based on swapType.
+     * Returns null if vault trading shouldn't be used (no vault, policy disabled).
      */
     executeVaultTrade(params: {
         tokenIn: Address;
         tokenOut: Address;
         amountIn: bigint;
         minAmountOut: bigint;
-        aggregator: Address;
-        swapData: `0x${string}`;
+        vaultParams: VaultTradeParams;
         deadline?: bigint;
     }): Promise<{
         usedVault: boolean;
@@ -1505,16 +1513,15 @@ declare function loadStrategy(strategyPath?: string): Promise<StrategyFunction>;
 declare function validateStrategy(fn: unknown): fn is StrategyFunction;
 
 /**
- * Boilerplate Strategy Templates
+ * Strategy Templates
  *
- * These are example prompts and strategies users can customize.
- * Each template includes:
- * - A system prompt for the LLM
- * - Risk warnings
- * - Example implementation
+ * Self-contained, runnable strategy templates that users can scaffold via `init`.
+ * Each template includes all helper functions inline — no external imports needed
+ * beyond the @exagent/agent types.
  *
- * IMPORTANT: These are starting points. Users should customize
- * the prompts and logic for their specific needs.
+ * Templates output TradeSignal[] where amountIn is a bigint in token-native units (wei).
+ * The LLM returns a percentage (0-100) of the relevant balance, and the template
+ * converts it to the correct bigint amount.
  */
 interface StrategyTemplate {
     id: string;
@@ -1538,17 +1545,23 @@ declare function getAllStrategyTemplates(): StrategyTemplate[];
 /**
  * Trade Executor
  * Handles execution of trade signals through the ExagentRouter.
- * All trades go through the router — there is no direct DEX bypass.
- * Pre-checks token eligibility to avoid wasting gas on reverts.
+ * Tries vault trading first (if vault exists and policy allows),
+ * then falls back to wallet trading. All trades route through the router.
  */
 declare class TradeExecutor {
     private client;
     private config;
     private allowedTokens;
     private configHashFn?;
-    constructor(client: ExagentClient, config: RuntimeConfig, configHashFn?: () => string);
+    private vaultManager?;
+    constructor(client: ExagentClient, config: RuntimeConfig, configHashFn?: () => string, vaultManager?: VaultManager);
+    /**
+     * Set the vault manager (allows wiring after construction)
+     */
+    setVaultManager(vm: VaultManager): void;
     /**
-     * Execute a single trade signal
+     * Execute a single trade signal.
+     * Tries vault trading first if vault exists, falls back to wallet trading.
      */
     execute(signal: TradeSignal): Promise<{
         success: boolean;
@@ -1943,6 +1956,10 @@ declare class MarketDataService {
     private cachedVolume24h;
     /** Cached price change data */
     private cachedPriceChange24h;
+    /** Cached 24h hourly price history per token address */
+    private cachedPriceHistory;
+    /** Timestamp of last successful price history fetch */
+    private lastHistoryFetchAt;
     constructor(rpcUrl: string, store?: StrategyStore);
     /** Get the underlying TokenResolver for direct access */
     getResolver(): TokenResolver;
@@ -1965,6 +1982,12 @@ declare class MarketDataService {
      * Returns cached prices if still fresh (<60s old)
      */
     private fetchPrices;
+    /**
+     * Fetch 24h hourly price history from CoinGecko.
+     * Returns cached data if still fresh (< 60 min old).
+     * Only fetches for tokens with known CoinGecko IDs.
+     */
+    private fetchPriceHistory;
     /**
      * Fetch real on-chain balances: native ETH + ERC-20 tokens.
      * Uses Multicall3 to batch all balanceOf calls into a single RPC request.
@@ -3353,6 +3376,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.46";
+declare const AGENT_VERSION = "0.1.48";
 
 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

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { Address, Hash, PublicClient, HttpTransport, WalletClient } from 'viem';
-import { ExagentClient } from '@exagent/sdk';
+import { VaultTradeParams, ExagentClient } from '@exagent/sdk';
 import { base } from 'viem/chains';
 
 /** Risk state persisted across restarts */
@@ -596,6 +596,7 @@ declare const AgentConfigSchema: z.ZodObject<{
             isVerified?: boolean | undefined;
         } | undefined;
     }>>;
+    strategyPrompt: z.ZodOptional<z.ZodString>;
     allowedTokens: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -668,6 +669,7 @@ declare const AgentConfigSchema: z.ZodObject<{
             vaultAddress?: string | undefined;
         } | undefined;
     } | undefined;
+    strategyPrompt?: string | undefined;
     allowedTokens?: string[] | undefined;
 }, {
     name: string;
@@ -740,6 +742,7 @@ declare const AgentConfigSchema: z.ZodObject<{
             isVerified?: boolean | undefined;
         } | undefined;
     } | undefined;
+    strategyPrompt?: string | undefined;
     allowedTokens?: string[] | undefined;
 }>;
 type AgentConfig = z.infer<typeof AgentConfigSchema>;
@@ -762,6 +765,11 @@ interface MarketData {
         chainId: number;
         blockNumber?: number;
     };
+    /** Hourly price history (last 24h) per token. Array ordered oldest→newest. */
+    priceHistory?: Record<string, Array<{
+        timestamp: number;
+        price: number;
+    }>>;
 }
 interface TradeSignal {
     action: 'buy' | 'sell' | 'hold';
@@ -967,16 +975,16 @@ declare class VaultManager {
         error?: string;
     }>;
     /**
-     * Execute a trade through the vault (if it exists and policy allows)
-     * Returns null if should use direct trading instead
+     * Execute a trade through the vault using API-provided vaultParams.
+     * Dispatches to the correct vault function based on swapType.
+     * Returns null if vault trading shouldn't be used (no vault, policy disabled).
      */
     executeVaultTrade(params: {
         tokenIn: Address;
         tokenOut: Address;
         amountIn: bigint;
         minAmountOut: bigint;
-        aggregator: Address;
-        swapData: `0x${string}`;
+        vaultParams: VaultTradeParams;
         deadline?: bigint;
     }): Promise<{
         usedVault: boolean;
@@ -1505,16 +1513,15 @@ declare function loadStrategy(strategyPath?: string): Promise<StrategyFunction>;
 declare function validateStrategy(fn: unknown): fn is StrategyFunction;
 
 /**
- * Boilerplate Strategy Templates
+ * Strategy Templates
  *
- * These are example prompts and strategies users can customize.
- * Each template includes:
- * - A system prompt for the LLM
- * - Risk warnings
- * - Example implementation
+ * Self-contained, runnable strategy templates that users can scaffold via `init`.
+ * Each template includes all helper functions inline — no external imports needed
+ * beyond the @exagent/agent types.
  *
- * IMPORTANT: These are starting points. Users should customize
- * the prompts and logic for their specific needs.
+ * Templates output TradeSignal[] where amountIn is a bigint in token-native units (wei).
+ * The LLM returns a percentage (0-100) of the relevant balance, and the template
+ * converts it to the correct bigint amount.
  */
 interface StrategyTemplate {
     id: string;
@@ -1538,17 +1545,23 @@ declare function getAllStrategyTemplates(): StrategyTemplate[];
 /**
  * Trade Executor
  * Handles execution of trade signals through the ExagentRouter.
- * All trades go through the router — there is no direct DEX bypass.
- * Pre-checks token eligibility to avoid wasting gas on reverts.
+ * Tries vault trading first (if vault exists and policy allows),
+ * then falls back to wallet trading. All trades route through the router.
  */
 declare class TradeExecutor {
     private client;
     private config;
     private allowedTokens;
     private configHashFn?;
-    constructor(client: ExagentClient, config: RuntimeConfig, configHashFn?: () => string);
+    private vaultManager?;
+    constructor(client: ExagentClient, config: RuntimeConfig, configHashFn?: () => string, vaultManager?: VaultManager);
+    /**
+     * Set the vault manager (allows wiring after construction)
+     */
+    setVaultManager(vm: VaultManager): void;
     /**
-     * Execute a single trade signal
+     * Execute a single trade signal.
+     * Tries vault trading first if vault exists, falls back to wallet trading.
      */
     execute(signal: TradeSignal): Promise<{
         success: boolean;
@@ -1943,6 +1956,10 @@ declare class MarketDataService {
     private cachedVolume24h;
     /** Cached price change data */
     private cachedPriceChange24h;
+    /** Cached 24h hourly price history per token address */
+    private cachedPriceHistory;
+    /** Timestamp of last successful price history fetch */
+    private lastHistoryFetchAt;
     constructor(rpcUrl: string, store?: StrategyStore);
     /** Get the underlying TokenResolver for direct access */
     getResolver(): TokenResolver;
@@ -1965,6 +1982,12 @@ declare class MarketDataService {
      * Returns cached prices if still fresh (<60s old)
      */
     private fetchPrices;
+    /**
+     * Fetch 24h hourly price history from CoinGecko.
+     * Returns cached data if still fresh (< 60 min old).
+     * Only fetches for tokens with known CoinGecko IDs.
+     */
+    private fetchPriceHistory;
     /**
      * Fetch real on-chain balances: native ETH + ERC-20 tokens.
      * Uses Multicall3 to batch all balanceOf calls into a single RPC request.
@@ -3353,6 +3376,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.46";
+declare const AGENT_VERSION = "0.1.48";
 
 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 };