@exagent/agent 0.3.6 → 0.3.8

package/dist/cli.js

@@ -9,7 +9,7 @@ import {
   updateSecureStore,
   writeConfigFile,
   writeSampleConfig
-} from "./chunk-ZRAOPQQW.js";
+} from "./chunk-GYYW4EKM.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -359,7 +359,7 @@ async function ensureLocalSetup(configPath) {
 // src/cli.ts
 import * as clack2 from "@clack/prompts";
 var program = new Command();
-program.name("exagent").description("Exagent \u2014 LLM trading agent runtime").version("0.3.5");
+program.name("exagent").description("Exagent \u2014 LLM trading agent runtime").version("0.3.8");
 program.command("init").description("Create a sample agent configuration file").option("--agent-id <id>", "Agent ID (from dashboard)", "my-agent").option("--api-url <url>", "API server URL", "http://localhost:3002").option("--config <path>", "Config file path", "agent-config.json").action((opts) => {
   printBanner();
   writeSampleConfig(opts.agentId, opts.apiUrl, opts.config);

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { LLMProvider, RelayCommand, AgentStatusPayload, MessageType, MessageLevel, TradeSignal, StrategyStore, PositionSummary, TrackedPosition, TradeRecord, LLMAdapter, LLMConfig, LLMMessage, LLMResponse, LLMMetadata, StrategyFunction, StrategyTemplate, RiskParams, MarketData, OHLCV, PaperTrade, PaperMetrics } from '@exagent/sdk';
+import { LLMProvider, StrategyProvenance, StrategyPermissions, RelayCommand, AgentStatusPayload, MessageType, MessageLevel, TradeSignal, StrategyStore, PositionSummary, TrackedPosition, TradeRecord, LLMAdapter, LLMConfig, LLMMessage, LLMResponse, LLMMetadata, StrategyFunction, StrategyTemplate, RiskParams, MarketData, OHLCV, PaperTrade, PaperMetrics } from '@exagent/sdk';
 import { WalletClient, PublicClient, Transport, Chain as Chain$1, Account } from 'viem';
 import { Chain } from 'viem/chains';
 
@@ -22,6 +22,8 @@ interface RuntimeConfig {
         code?: string;
         template?: string;
         venues?: string[];
+        provenance?: StrategyProvenance;
+        permissions?: StrategyPermissions;
         prompt?: {
             name?: string;
             systemPrompt: string;
@@ -137,6 +139,8 @@ declare class AgentRuntime {
     private buildRuntimeVenuesFromSelection;
     private buildStrategyFallbackPrompt;
     private extractStrategyConfigFromAgentConfig;
+    private extractStrategyProvenance;
+    private extractStrategyPermissions;
     private applyExecutionMode;
     private initializeVenues;
     private startTrading;
@@ -436,6 +440,8 @@ declare function loadStrategy(config: {
         systemPrompt: string;
         venues?: string[];
     };
+    provenance?: StrategyProvenance;
+    permissions?: StrategyPermissions;
 }): Promise<StrategyFunction>;
 
 declare function getTemplate(id: string): StrategyTemplate | undefined;
@@ -456,6 +462,7 @@ declare class RiskManager {
     getDailyPnL(): number;
     getDailyLossLimit(): number;
     private resetIfNewDay;
+    private validateUpdate;
 }
 
 declare class MarketDataService implements MarketData {
@@ -559,6 +566,7 @@ interface PerpConfig {
     wsUrl: string;
     maxLeverage: number;
     maxNotionalUSD: number;
+    marketOrderSlippageBps?: number;
     allowedInstruments?: string[];
 }
 type PerpAction = 'open_long' | 'open_short' | 'close_long' | 'close_short' | 'hold';
@@ -847,6 +855,13 @@ declare class HyperliquidSigner {
  * No builder fee — private group, not needed.
  */
 
+interface CancelAllResult {
+    success: boolean;
+    total: number;
+    cancelled: number;
+    failed: number;
+    errors: string[];
+}
 declare class HyperliquidOrderManager {
     private readonly client;
     private readonly signer;
@@ -854,11 +869,15 @@ declare class HyperliquidOrderManager {
     constructor(client: HyperliquidClient, signer: HyperliquidSigner, config: PerpConfig);
     placeOrder(signal: PerpTradeSignal): Promise<OrderResult>;
     cancelOrder(instrument: string, orderId: number): Promise<boolean>;
-    closePosition(instrument: string, positionSize: number): Promise<OrderResult>;
+    cancelAllOrders(userAddress?: `0x${string}`): Promise<CancelAllResult>;
+    closePosition(instrument: string, positionSize: number, referencePrice?: number): Promise<OrderResult>;
     updateLeverage(instrument: string, leverage: number, isCross?: boolean): Promise<boolean>;
     private getMarketPrice;
+    private getReferencePrice;
+    private formatDecimal;
     private parseOrderResponse;
     private exchangeRequest;
+    private signedExchangeRequest;
 }
 
 /**
@@ -964,6 +983,7 @@ interface PredictionTradeSignal {
     amount: number;
     limitPrice: number;
     orderType: 'limit' | 'market';
+    marketOrderType?: 'FOK' | 'FAK';
     confidence: number;
     reasoning?: string;
 }
@@ -1078,6 +1098,8 @@ declare class PolymarketClient {
         tokenId: string;
         amount: number;
         side: 'BUY' | 'SELL';
+        price?: number;
+        orderType?: 'FOK' | 'FAK';
     }): Promise<{
         orderId: string;
         success: boolean;

package/dist/index.js

@@ -43,7 +43,7 @@ import {
   loadConfig,
   loadStrategy,
   writeSampleConfig
-} from "./chunk-ZRAOPQQW.js";
+} from "./chunk-GYYW4EKM.js";
 export {
   AcrossAdapter,
   AerodromeAdapter,

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@exagent/agent",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
   "bin": {
     "exagent": "dist/cli.js"
   },
@@ -13,8 +16,14 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "scripts": {
+    "build": "tsup src/index.ts src/cli.ts --format esm --dts",
+    "dev": "tsup src/index.ts src/cli.ts --format esm --dts --watch",
+    "test": "tsx --test test/**/*.test.ts"
+  },
   "dependencies": {
     "@clack/prompts": "^1.1.0",
+    "@exagent/sdk": "0.2.2",
     "@polymarket/clob-client": "^5.8.1",
     "boxen": "^8.0.1",
     "commander": "^12.1.0",
@@ -23,8 +32,7 @@
     "picocolors": "^1.1.1",
     "viem": "^2.48.11",
     "ws": "^8.20.0",
-    "zod": "^3.25.76",
-    "@exagent/sdk": "0.2.2"
+    "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/figlet": "^1.7.0",
@@ -34,10 +42,5 @@
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
-  },
-  "scripts": {
-    "build": "tsup src/index.ts src/cli.ts --format esm --dts",
-    "dev": "tsup src/index.ts src/cli.ts --format esm --dts --watch",
-    "test": "tsx --test test/**/*.test.ts"
   }
-}
+}

package/src/bridge/across.ts

@@ -1,240 +0,0 @@
-import { getChainConfig } from '../chains.js';
-import { ERC20_ABI } from '../spot/types.js';
-import type { SpotDEXClient } from '../spot/client.js';
-import {
-  ACROSS_SPOKE_POOL_ABI,
-  type BridgeRequest,
-  type BridgeFeeEstimate,
-  type BridgeResult,
-  type BridgeConfig,
-} from './types.js';
-
-const ACROSS_API_BASE = 'https://app.across.to/api';
-const ZERO_ADDRESS: `0x${string}` = '0x0000000000000000000000000000000000000000';
-
-export class AcrossAdapter {
-  private client: SpotDEXClient;
-  private config: BridgeConfig;
-
-  constructor(client: SpotDEXClient, config: BridgeConfig) {
-    this.client = client;
-    this.config = config;
-  }
-
-  async estimateFee(request: BridgeRequest): Promise<BridgeFeeEstimate> {
-    const fromChain = getChainConfig(request.fromChain);
-    const toChain = getChainConfig(request.toChain);
-    if (!fromChain) throw new Error(`Unknown source chain: ${request.fromChain}`);
-    if (!toChain) throw new Error(`Unknown destination chain: ${request.toChain}`);
-
-    // Resolve output token on destination chain (same token, different address)
-    const outputToken = this.resolveOutputToken(request.token, request.fromChain, request.toChain);
-
-    const params = new URLSearchParams({
-      inputToken: request.token,
-      outputToken,
-      originChainId: fromChain.chainId.toString(),
-      destinationChainId: toChain.chainId.toString(),
-      amount: request.amount.toString(),
-      recipient: request.recipient ?? this.client.address,
-    });
-
-    const url = `${ACROSS_API_BASE}/suggested-fees?${params}`;
-    const res = await fetch(url);
-    if (!res.ok) {
-      const body = await res.text();
-      throw new Error(`Across fee API error (${res.status}): ${body}`);
-    }
-
-    const data = await res.json() as {
-      totalRelayFee: { pct: string };
-      relayerCapitalFee: { pct: string };
-      relayerGasFee: { pct: string };
-      lpFee: { pct: string };
-      timestamp: string;
-      estimatedFillTimeSec: number;
-      isAmountTooLow: boolean;
-      limits?: { minDeposit: string };
-    };
-
-    // Calculate output amount: inputAmount - totalFee
-    const totalFeePct = parseFloat(data.totalRelayFee.pct) / 1e18;
-    const feeAmount = BigInt(Math.floor(Number(request.amount) * totalFeePct));
-    const outputAmount = request.amount - feeAmount;
-
-    return {
-      totalRelayFeePct: totalFeePct * 100,
-      capitalFeePct: parseFloat(data.relayerCapitalFee.pct) / 1e18 * 100,
-      lpFeePct: parseFloat(data.lpFee.pct) / 1e18 * 100,
-      relayGasFeePct: parseFloat(data.relayerGasFee.pct) / 1e18 * 100,
-      timestamp: parseInt(data.timestamp),
-      estimatedFillTimeSec: data.estimatedFillTimeSec,
-      isAmountTooLow: data.isAmountTooLow,
-      outputAmount,
-    };
-  }
-
-  async deposit(request: BridgeRequest): Promise<BridgeResult> {
-    const fromChain = getChainConfig(request.fromChain);
-    const toChain = getChainConfig(request.toChain);
-    if (!fromChain?.acrossSpokePool) throw new Error(`No Across SpokePool on ${request.fromChain}`);
-    if (!toChain) throw new Error(`Unknown destination chain: ${request.toChain}`);
-
-    const spokePool = fromChain.acrossSpokePool;
-    const outputToken = this.resolveOutputToken(request.token, request.fromChain, request.toChain) as `0x${string}`;
-    const recipient = request.recipient ?? this.client.address;
-
-    // IMPORTANT: Approve BEFORE getting the fee quote.
-    // The Across SpokePool has a tight depositQuoteTimeBuffer — if there's any
-    // delay between getting the quoteTimestamp and submitting depositV3, the tx
-    // reverts with InvalidQuoteTimestamp. Approval can take 10+ seconds on L2s.
-    await this.client.ensureApproval(request.token, spokePool, request.amount, request.fromChain);
-
-    // Get fee estimate (immediately before submitting — no awaits after this!)
-    const feeEstimate = await this.estimateFee(request);
-    if (feeEstimate.isAmountTooLow) {
-      return {
-        success: false,
-        depositTxHash: '0x0' as `0x${string}`,
-        fromChain: request.fromChain,
-        toChain: request.toChain,
-        token: request.token,
-        amount: request.amount,
-        fee: 0n,
-        error: 'Amount too low for Across bridge',
-      };
-    }
-
-    const { publicClient, walletClient } = this.client.getClients(request.fromChain);
-
-    // Fill deadline: 6 hours from now
-    const fillDeadline = Math.floor(Date.now() / 1000) + 21600;
-
-    try {
-      const hash = await walletClient.writeContract({
-        address: spokePool,
-        abi: ACROSS_SPOKE_POOL_ABI,
-        functionName: 'depositV3',
-        args: [
-          this.client.address,          // depositor
-          recipient,                     // recipient
-          request.token,                 // inputToken
-          outputToken,                   // outputToken
-          request.amount,               // inputAmount
-          feeEstimate.outputAmount,     // outputAmount (inputAmount - fees)
-          BigInt(toChain.chainId),      // destinationChainId
-          ZERO_ADDRESS,                 // exclusiveRelayer (none)
-          feeEstimate.timestamp,        // quoteTimestamp
-          fillDeadline,                 // fillDeadline
-          0,                            // exclusivityDeadline (none)
-          '0x',                         // message (empty)
-        ],
-      });
-
-      const receipt = await publicClient.waitForTransactionReceipt({ hash });
-      const fee = request.amount - feeEstimate.outputAmount;
-
-      console.log(`[bridge] Across deposit: ${hash} (${request.fromChain} → ${request.toChain})`);
-
-      const result: BridgeResult = {
-        success: true,
-        depositTxHash: hash,
-        fromChain: request.fromChain,
-        toChain: request.toChain,
-        token: request.token,
-        amount: request.amount,
-        fee,
-      };
-
-      // Poll for fill
-      const fill = await this.waitForFill(hash, request.fromChain);
-      if (fill.filled) {
-        result.fillTxHash = fill.fillTxHash;
-        result.fillTimestamp = Date.now();
-        console.log(`[bridge] Across fill confirmed: ${fill.fillTxHash}`);
-      } else {
-        // Deposit tx succeeded but fill was not confirmed within the timeout.
-        // Mark as failure so the trade signal system doesn't report a completed bridge.
-        result.success = false;
-        result.error = 'Bridge deposit submitted but fill not confirmed within timeout. Deposit tx may still be filled — check the Across explorer.';
-        console.warn(`[bridge] Across fill not confirmed within timeout (deposit: ${hash})`);
-      }
-
-      return result;
-    } catch (err) {
-      return {
-        success: false,
-        depositTxHash: '0x0' as `0x${string}`,
-        fromChain: request.fromChain,
-        toChain: request.toChain,
-        token: request.token,
-        amount: request.amount,
-        fee: 0n,
-        error: (err as Error).message,
-      };
-    }
-  }
-
-  async waitForFill(
-    depositTxHash: string,
-    originChain: string,
-  ): Promise<{ filled: boolean; fillTxHash?: `0x${string}` }> {
-    const chainConfig = getChainConfig(originChain);
-    if (!chainConfig) return { filled: false };
-
-    const startTime = Date.now();
-    const timeout = this.config.fillTimeoutMs;
-    const interval = this.config.pollIntervalMs;
-
-    while (Date.now() - startTime < timeout) {
-      try {
-        const params = new URLSearchParams({
-          depositTxHash,
-          originChainId: chainConfig.chainId.toString(),
-        });
-
-        const res = await fetch(`${ACROSS_API_BASE}/deposit/status?${params}`);
-        if (res.ok) {
-          const data = await res.json() as {
-            status: string;
-            fillTx?: string;
-          };
-
-          if (data.status === 'filled' && data.fillTx) {
-            return { filled: true, fillTxHash: data.fillTx as `0x${string}` };
-          }
-
-          if (data.status === 'expired' || data.status === 'refunded') {
-            return { filled: false };
-          }
-        }
-      } catch {
-        // Non-critical — retry on next poll
-      }
-
-      await new Promise(resolve => setTimeout(resolve, interval));
-    }
-
-    return { filled: false };
-  }
-
-  /** Resolve the equivalent token address on the destination chain */
-  private resolveOutputToken(inputToken: `0x${string}`, fromChain: string, toChain: string): string {
-    const from = getChainConfig(fromChain);
-    const to = getChainConfig(toChain);
-    if (!from || !to) return inputToken;
-
-    // If input is USDC on source chain, output is USDC on destination chain
-    if (inputToken.toLowerCase() === from.usdcAddress.toLowerCase()) {
-      return to.usdcAddress;
-    }
-
-    // If input is WETH on source chain, output is WETH on destination chain
-    if (inputToken.toLowerCase() === from.wethAddress.toLowerCase()) {
-      return to.wethAddress;
-    }
-
-    // Default: same address (for tokens deployed at same address on both chains)
-    return inputToken;
-  }
-}

package/src/bridge/bridge-manager.ts

@@ -1,87 +0,0 @@
-import { getChainConfig } from '../chains.js';
-import type { SpotDEXClient } from '../spot/client.js';
-import { AcrossAdapter } from './across.js';
-import type { BridgeConfig, BridgeRequest, BridgeFeeEstimate, BridgeResult } from './types.js';
-
-const MIN_GAS_WEI = 100_000_000_000_000n; // 0.0001 ETH/POL
-
-export class BridgeManager {
-  private across: AcrossAdapter;
-  private client: SpotDEXClient;
-  private config: BridgeConfig;
-
-  constructor(client: SpotDEXClient, config: BridgeConfig) {
-    this.config = config;
-    this.client = client;
-    this.across = new AcrossAdapter(client, config);
-  }
-
-  async estimateFee(request: BridgeRequest): Promise<BridgeFeeEstimate> {
-    const bridge = request.bridge ?? this.config.defaultBridge;
-    if (bridge !== 'across') {
-      throw new Error(`Unsupported bridge: ${bridge}. Only "across" is currently supported.`);
-    }
-    return this.across.estimateFee(request);
-  }
-
-  async bridge(request: BridgeRequest): Promise<BridgeResult> {
-    const bridge = request.bridge ?? this.config.defaultBridge;
-    if (bridge !== 'across') {
-      return {
-        success: false,
-        depositTxHash: '0x0' as `0x${string}`,
-        fromChain: request.fromChain,
-        toChain: request.toChain,
-        token: request.token,
-        amount: request.amount,
-        fee: 0n,
-        error: `Unsupported bridge: ${bridge}. Only "across" is currently supported.`,
-      };
-    }
-
-    // Enforce max bridge value cap
-    // Bridge amounts are in token decimals — estimate USD for common tokens (USDC = 6 decimals)
-    try {
-      const decimals = await this.client.getDecimals(request.token, request.fromChain);
-      const amountFloat = Number(request.amount) / 10 ** decimals;
-      if (amountFloat > this.config.maxBridgeValueUSD) {
-        return {
-          success: false,
-          depositTxHash: '0x0' as `0x${string}`,
-          fromChain: request.fromChain,
-          toChain: request.toChain,
-          token: request.token,
-          amount: request.amount,
-          fee: 0n,
-          error: `Bridge value ${amountFloat.toFixed(2)} exceeds max $${this.config.maxBridgeValueUSD}. Reduce amount or increase maxBridgeValueUSD.`,
-        };
-      }
-    } catch {
-      // If decimals lookup fails, proceed — let the bridge itself validate
-    }
-
-    // Pre-check native gas balance on origin chain
-    try {
-      const nativeBalance = await this.client.getNativeBalance(request.fromChain);
-      if (nativeBalance < MIN_GAS_WEI) {
-        const chainConfig = getChainConfig(request.fromChain);
-        const nativeName = chainConfig?.nativeCurrency ?? 'ETH';
-        return {
-          success: false,
-          depositTxHash: '0x0' as `0x${string}`,
-          fromChain: request.fromChain,
-          toChain: request.toChain,
-          token: request.token,
-          amount: request.amount,
-          fee: 0n,
-          error: `Insufficient ${nativeName} for gas on ${request.fromChain}. Balance: ${nativeBalance} wei. Need at least 0.0001 ${nativeName}.`,
-        };
-      }
-    } catch {
-      // Non-critical — proceed and let the bridge itself surface the error
-    }
-
-    console.log(`[bridge] Bridging via Across: ${request.fromChain} → ${request.toChain} (${request.amount})`);
-    return this.across.deposit(request);
-  }
-}

package/src/bridge/index.ts

@@ -1,9 +0,0 @@
-export { AcrossAdapter } from './across.js';
-export { BridgeManager } from './bridge-manager.js';
-export type {
-  BridgeConfig,
-  BridgeRequest,
-  BridgeFeeEstimate,
-  BridgeResult,
-} from './types.js';
-export { DEFAULT_BRIDGE_CONFIG } from './types.js';

package/src/bridge/types.ts

@@ -1,77 +0,0 @@
-// ─── Bridge Config ──────────────────────────────────────────────
-
-export interface BridgeConfig {
-  enabled: boolean;
-  defaultBridge: string;
-  maxBridgeValueUSD: number;
-  fillTimeoutMs: number;
-  pollIntervalMs: number;
-}
-
-export const DEFAULT_BRIDGE_CONFIG: BridgeConfig = {
-  enabled: false,
-  defaultBridge: 'across',
-  maxBridgeValueUSD: 10_000,
-  fillTimeoutMs: 300_000,    // 5 minutes
-  pollIntervalMs: 2_000,     // 2 seconds
-};
-
-// ─── Bridge Request & Results ───────────────────────────────────
-
-export interface BridgeRequest {
-  token: `0x${string}`;
-  amount: bigint;
-  fromChain: string;
-  toChain: string;
-  recipient?: `0x${string}`;
-  bridge?: string;
-}
-
-export interface BridgeFeeEstimate {
-  totalRelayFeePct: number;
-  capitalFeePct: number;
-  lpFeePct: number;
-  relayGasFeePct: number;
-  timestamp: number;
-  estimatedFillTimeSec: number;
-  isAmountTooLow: boolean;
-  outputAmount: bigint;
-}
-
-export interface BridgeResult {
-  success: boolean;
-  depositTxHash: `0x${string}`;
-  fromChain: string;
-  toChain: string;
-  token: `0x${string}`;
-  amount: bigint;
-  fee: bigint;
-  fillTxHash?: `0x${string}`;
-  fillTimestamp?: number;
-  error?: string;
-}
-
-// ─── Across SpokePool ABI Fragment ──────────────────────────────
-
-export const ACROSS_SPOKE_POOL_ABI = [
-  {
-    type: 'function' as const,
-    name: 'depositV3' as const,
-    inputs: [
-      { name: 'depositor', type: 'address' as const },
-      { name: 'recipient', type: 'address' as const },
-      { name: 'inputToken', type: 'address' as const },
-      { name: 'outputToken', type: 'address' as const },
-      { name: 'inputAmount', type: 'uint256' as const },
-      { name: 'outputAmount', type: 'uint256' as const },
-      { name: 'destinationChainId', type: 'uint256' as const },
-      { name: 'exclusiveRelayer', type: 'address' as const },
-      { name: 'quoteTimestamp', type: 'uint32' as const },
-      { name: 'fillDeadline', type: 'uint32' as const },
-      { name: 'exclusivityDeadline', type: 'uint32' as const },
-      { name: 'message', type: 'bytes' as const },
-    ],
-    outputs: [],
-    stateMutability: 'payable' as const,
-  },
-] as const;