@exagent/agent 0.1.0

package/dist/index.mjs

@@ -0,0 +1,54 @@
+import {
+  AgentConfigSchema,
+  AgentRuntime,
+  AnthropicAdapter,
+  BaseLLMAdapter,
+  LLMConfigSchema,
+  LLMProviderSchema,
+  MarketDataService,
+  OllamaAdapter,
+  OpenAIAdapter,
+  RiskManager,
+  RiskUniverseSchema,
+  STRATEGY_TEMPLATES,
+  TradeExecutor,
+  TradingConfigSchema,
+  VaultConfigSchema,
+  VaultManager,
+  VaultPolicySchema,
+  createLLMAdapter,
+  createSampleConfig,
+  getAllStrategyTemplates,
+  getStrategyTemplate,
+  loadConfig,
+  loadStrategy,
+  validateConfig,
+  validateStrategy
+} from "./chunk-JS7RJORF.mjs";
+export {
+  AgentConfigSchema,
+  AgentRuntime,
+  AnthropicAdapter,
+  BaseLLMAdapter,
+  LLMConfigSchema,
+  LLMProviderSchema,
+  MarketDataService,
+  OllamaAdapter,
+  OpenAIAdapter,
+  RiskManager,
+  RiskUniverseSchema,
+  STRATEGY_TEMPLATES,
+  TradeExecutor,
+  TradingConfigSchema,
+  VaultConfigSchema,
+  VaultManager,
+  VaultPolicySchema,
+  createLLMAdapter,
+  createSampleConfig,
+  getAllStrategyTemplates,
+  getStrategyTemplate,
+  loadConfig,
+  loadStrategy,
+  validateConfig,
+  validateStrategy
+};

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@exagent/agent",
+  "version": "0.1.0",
+  "description": "Autonomous trading agent runtime for Exagent",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "exagent": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts src/cli.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts src/cli.ts --format cjs,esm --dts --watch",
+    "start": "node dist/cli.js",
+    "test": "vitest",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@exagent/sdk": "workspace:*",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "dotenv": "^16.4.0",
+    "openai": "^4.0.0",
+    "tsx": "^4.7.0",
+    "viem": "^2.21.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^2.0.0"
+  },
+  "peerDependencies": {
+    "viem": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/templates/.env.template

@@ -0,0 +1,55 @@
+# Exagent Agent Configuration
+# WARNING: Never commit this file to version control!
+# Keep your private key and API keys secret.
+
+# ============================================
+# REQUIRED: Your wallet private key
+# ============================================
+# This wallet will be used to:
+# 1. Link to your agent identity on-chain
+# 2. Execute trades through the ExagentRouter
+# 3. Pay gas fees for transactions
+#
+# Format: 64 hex characters starting with 0x
+# Example: 0x1234567890abcdef...
+EXAGENT_PRIVATE_KEY=
+
+# ============================================
+# REQUIRED: Network (mainnet or testnet)
+# ============================================
+# Use 'testnet' for Base Sepolia (recommended for testing)
+# Use 'mainnet' for Base mainnet (real money!)
+EXAGENT_NETWORK=testnet
+
+# ============================================
+# LLM API Keys (choose one based on your config)
+# ============================================
+
+# OpenAI API Key
+# Get yours at: https://platform.openai.com/api-keys
+# OPENAI_API_KEY=sk-...
+
+# Anthropic API Key
+# Get yours at: https://console.anthropic.com/settings/keys
+# ANTHROPIC_API_KEY=sk-ant-...
+
+# Ollama (Local LLM - no API key needed)
+# Just install Ollama: https://ollama.com/download
+# Then run: ollama serve
+# And pull your model: ollama pull mistral
+# EXAGENT_LLM_URL=http://localhost:11434
+
+# ============================================
+# Optional: Override LLM model
+# ============================================
+# EXAGENT_LLM_MODEL=gpt-4-turbo-preview
+
+# ============================================
+# Optional: Custom config path
+# ============================================
+# EXAGENT_CONFIG=./agent-config.json
+
+# ============================================
+# Optional: Custom strategy path
+# ============================================
+# EXAGENT_STRATEGY=./strategy.ts

package/templates/docker-compose.yml

@@ -0,0 +1,60 @@
+# Docker Compose for Exagent Trading Agent
+#
+# Usage:
+#   1. Copy .env.template to .env and fill in your secrets
+#   2. Run: docker-compose up -d
+#   3. View logs: docker-compose logs -f
+#   4. Stop: docker-compose down
+
+version: '3.8'
+
+services:
+  agent:
+    image: node:20-alpine
+    container_name: exagent-${AGENT_NAME:-agent}
+    working_dir: /app
+    volumes:
+      - .:/app
+      - agent_node_modules:/app/node_modules
+    environment:
+      - NODE_ENV=production
+      - EXAGENT_PRIVATE_KEY=${EXAGENT_PRIVATE_KEY}
+      - EXAGENT_NETWORK=${EXAGENT_NETWORK:-testnet}
+      - OPENAI_API_KEY=${OPENAI_API_KEY:-}
+      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY:-}
+      - EXAGENT_LLM_URL=${EXAGENT_LLM_URL:-}
+    command: npm start
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "node", "-e", "console.log('healthy')"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+  # Optional: Local Ollama for on-device LLM
+  # Uncomment if using local LLM
+  #
+  # ollama:
+  #   image: ollama/ollama
+  #   container_name: exagent-ollama
+  #   volumes:
+  #     - ollama_models:/root/.ollama
+  #   ports:
+  #     - "11434:11434"
+  #   deploy:
+  #     resources:
+  #       reservations:
+  #         devices:
+  #           - driver: nvidia
+  #             count: all
+  #             capabilities: [gpu]
+  #   restart: unless-stopped
+
+volumes:
+  agent_node_modules:
+  # ollama_models:  # Uncomment if using Ollama

package/templates/strategy.template.ts

@@ -0,0 +1,153 @@
+/**
+ * Custom Trading Strategy
+ *
+ * This is YOUR strategy file - customize it to your needs.
+ * Your prompts and logic are your competitive advantage.
+ * We don't store or know what's in this file.
+ *
+ * IMPORTANT WARNINGS:
+ * - LLMs can hallucinate or make errors. Always validate outputs.
+ * - Test thoroughly on testnet before using real funds.
+ * - Agents may not behave exactly as expected based on your prompts.
+ * - You are fully responsible for your trading decisions.
+ */
+
+import type {
+  StrategyFunction,
+  MarketData,
+  TradeSignal,
+  LLMAdapter,
+  AgentConfig,
+} from '@exagent/agent';
+
+/**
+ * Your custom system prompt
+ *
+ * This is the secret sauce of your trading agent.
+ * Customize this to define how your agent thinks and trades.
+ */
+const SYSTEM_PROMPT = `You are an AI trading assistant analyzing cryptocurrency markets.
+
+Your role is to analyze market data and provide trading recommendations.
+
+IMPORTANT CONSTRAINTS:
+- Only recommend trades when you have high confidence
+- Consider risk/reward ratios
+- Never exceed position size limits
+- Be conservative - it's okay to recommend "hold"
+
+When analyzing market data, consider:
+1. Price trends and momentum
+2. Current portfolio allocation
+3. Risk management
+
+Respond with JSON in this exact format:
+{
+  "analysis": "Brief market analysis (1-2 sentences)",
+  "signals": [
+    {
+      "action": "buy" | "sell" | "hold",
+      "tokenIn": "0x...",
+      "tokenOut": "0x...",
+      "percentage": 0-100,
+      "confidence": 0-1,
+      "reasoning": "Why this trade"
+    }
+  ]
+}
+
+If you're unsure or market conditions are unclear, respond with:
+{
+  "analysis": "Market conditions unclear",
+  "signals": [{ "action": "hold", "confidence": 1.0, "reasoning": "Waiting for clearer signals" }]
+}`;
+
+/**
+ * Generate trading signals
+ *
+ * This function is called on each trading cycle.
+ * It receives market data, has access to the LLM, and returns trade signals.
+ *
+ * @param marketData - Current prices, balances, and portfolio value
+ * @param llm - LLM adapter for analysis
+ * @param config - Agent configuration
+ * @returns Array of trade signals
+ */
+export const generateSignals: StrategyFunction = async (
+  marketData: MarketData,
+  llm: LLMAdapter,
+  config: AgentConfig
+): Promise<TradeSignal[]> => {
+  // Format market data for the LLM
+  const userMessage = JSON.stringify({
+    timestamp: new Date(marketData.timestamp).toISOString(),
+    prices: marketData.prices,
+    portfolioValue: `$${marketData.portfolioValue.toFixed(2)}`,
+    balances: formatBalances(marketData.balances),
+    config: {
+      riskUniverse: config.riskUniverse,
+      maxPositionSize: `${config.trading.maxPositionSizeBps / 100}%`,
+      timeHorizon: config.trading.timeHorizon,
+    },
+  }, null, 2);
+
+  // Call the LLM
+  const response = await llm.chat([
+    { role: 'system', content: SYSTEM_PROMPT },
+    { role: 'user', content: userMessage },
+  ]);
+
+  // Parse and validate the response
+  try {
+    const parsed = JSON.parse(response.content);
+
+    if (!parsed.signals || !Array.isArray(parsed.signals)) {
+      console.warn('LLM response missing signals array');
+      return [];
+    }
+
+    // Log analysis
+    if (parsed.analysis) {
+      console.log(`Analysis: ${parsed.analysis}`);
+    }
+
+    // Convert to TradeSignal format
+    return parsed.signals
+      .filter((s: any) => s.action !== 'hold') // Filter out hold signals
+      .map((s: any) => ({
+        action: s.action as 'buy' | 'sell',
+        tokenIn: s.tokenIn || '',
+        tokenOut: s.tokenOut || '',
+        amountIn: calculateAmount(s.percentage, marketData),
+        confidence: s.confidence || 0.5,
+        reasoning: s.reasoning,
+      }));
+  } catch (error) {
+    console.error('Failed to parse LLM response:', error);
+    console.error('Raw response:', response.content);
+    return []; // Safe fallback: no trades
+  }
+};
+
+/**
+ * Format balances for LLM display
+ */
+function formatBalances(balances: Record<string, bigint>): Record<string, string> {
+  const formatted: Record<string, string> = {};
+  for (const [address, balance] of Object.entries(balances)) {
+    // Assume 18 decimals for simplicity
+    const amount = Number(balance) / 1e18;
+    formatted[address] = amount.toFixed(6);
+  }
+  return formatted;
+}
+
+/**
+ * Calculate trade amount from percentage
+ */
+function calculateAmount(percentage: number, marketData: MarketData): bigint {
+  // This is a simplified calculation
+  // In production, you'd want to calculate based on actual token balances
+  const value = (marketData.portfolioValue * percentage) / 100;
+  return BigInt(Math.floor(value * 1e18));
+}