@exagent/agent 0.1.0

package/dist/cli.mjs

@@ -0,0 +1,322 @@
+#!/usr/bin/env node
+import {
+  AgentRuntime,
+  getAllStrategyTemplates,
+  loadConfig,
+  validateConfig
+} from "./chunk-JS7RJORF.mjs";
+
+// src/cli.ts
+import { Command } from "commander";
+import { config as loadEnvFile } from "dotenv";
+import * as readline from "readline";
+import * as fs from "fs";
+import * as path from "path";
+import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
+loadEnvFile();
+var program = new Command();
+program.name("exagent").description("Exagent autonomous trading agent").version("0.1.0");
+function prompt(question, hidden = false) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    if (hidden) {
+      process.stdout.write(question);
+      let input = "";
+      process.stdin.setRawMode(true);
+      process.stdin.resume();
+      process.stdin.setEncoding("utf8");
+      const onData = (char) => {
+        if (char === "\n" || char === "\r") {
+          process.stdin.setRawMode(false);
+          process.stdin.pause();
+          process.stdin.removeListener("data", onData);
+          console.log("");
+          rl.close();
+          resolve(input);
+        } else if (char === "") {
+          process.exit(0);
+        } else if (char === "\x7F") {
+          if (input.length > 0) {
+            input = input.slice(0, -1);
+          }
+        } else {
+          input += char;
+          process.stdout.write("*");
+        }
+      };
+      process.stdin.on("data", onData);
+    } else {
+      rl.question(question, (answer) => {
+        rl.close();
+        resolve(answer);
+      });
+    }
+  });
+}
+async function checkFirstRunSetup(configPath) {
+  const envPath = path.join(path.dirname(configPath), ".env");
+  if (fs.existsSync(envPath)) {
+    const envContent2 = fs.readFileSync(envPath, "utf-8");
+    const hasPrivateKey = envContent2.includes("EXAGENT_PRIVATE_KEY=") && !envContent2.includes("EXAGENT_PRIVATE_KEY=\n") && !envContent2.includes("EXAGENT_PRIVATE_KEY=$");
+    if (hasPrivateKey) {
+      return;
+    }
+  }
+  const config = loadConfig(configPath);
+  const walletSetup = config.wallet?.setup || "provide";
+  console.log("");
+  console.log("=".repeat(60));
+  console.log("  EXAGENT FIRST-RUN SETUP");
+  console.log("=".repeat(60));
+  console.log("");
+  console.log("  This appears to be your first time running this agent.");
+  console.log("  Let's set up your wallet and API keys.");
+  console.log("");
+  console.log("  Your secrets will be stored locally in .env");
+  console.log("  They are NEVER sent to Exagent servers.");
+  console.log("");
+  console.log("=".repeat(60));
+  console.log("");
+  let privateKey;
+  let walletAddress;
+  if (walletSetup === "generate") {
+    console.log("[WALLET] Generating a new wallet for your agent...");
+    console.log("");
+    const generatedKey = generatePrivateKey();
+    const account = privateKeyToAccount(generatedKey);
+    privateKey = generatedKey;
+    walletAddress = account.address;
+    console.log("  New wallet created!");
+    console.log("");
+    console.log("  +" + "-".repeat(58) + "+");
+    console.log("  | WALLET ADDRESS (fund this to start trading):              |");
+    console.log("  | " + walletAddress.padEnd(56) + " |");
+    console.log("  +" + "-".repeat(58) + "+");
+    console.log("");
+    console.log("  IMPORTANT: Your private key has been saved to .env");
+    console.log("  Back up this file securely. If lost, your funds are gone.");
+    console.log("");
+    const confirmed = await prompt("  Press Enter to continue, or Ctrl+C to cancel...");
+  } else {
+    console.log("[WALLET] Please enter your trading wallet private key.");
+    console.log("");
+    console.log("  Your input will be hidden for security.");
+    console.log("  The key should start with 0x and be 66 characters total.");
+    console.log("");
+    privateKey = await prompt("  Private key: ", true);
+    if (!privateKey.startsWith("0x")) {
+      privateKey = "0x" + privateKey;
+    }
+    if (privateKey.length !== 66) {
+      console.error("");
+      console.error("  ERROR: Invalid private key length. Expected 66 characters (with 0x prefix).");
+      process.exit(1);
+    }
+    try {
+      const account = privateKeyToAccount(privateKey);
+      walletAddress = account.address;
+      console.log("");
+      console.log(`  Wallet address: ${walletAddress}`);
+    } catch (error) {
+      console.error("");
+      console.error("  ERROR: Invalid private key format.");
+      process.exit(1);
+    }
+  }
+  console.log("");
+  const llmProvider = config.llm?.provider || "openai";
+  let llmApiKey = "";
+  let llmEnvVar = "";
+  if (llmProvider === "ollama") {
+    console.log("[LLM] Using Ollama (local). No API key needed.");
+    console.log("  Make sure Ollama is running: ollama serve");
+    console.log("");
+  } else if (llmProvider === "custom") {
+    console.log("[LLM] Using custom OpenAI-compatible endpoint.");
+    console.log("");
+    const llmUrl = await prompt("  Enter your API endpoint URL: ");
+    llmApiKey = await prompt("  Enter your API key (or press Enter if none): ", true);
+    llmEnvVar = `EXAGENT_LLM_URL=${llmUrl}
+`;
+    if (llmApiKey) {
+      llmEnvVar += `EXAGENT_LLM_API_KEY=${llmApiKey}
+`;
+    }
+  } else {
+    const providerNames = {
+      openai: { name: "OpenAI", envVar: "OPENAI_API_KEY", url: "https://platform.openai.com/api-keys" },
+      anthropic: { name: "Anthropic", envVar: "ANTHROPIC_API_KEY", url: "https://console.anthropic.com/settings/keys" },
+      google: { name: "Google AI", envVar: "GOOGLE_AI_API_KEY", url: "https://aistudio.google.com/apikey" },
+      deepseek: { name: "DeepSeek", envVar: "DEEPSEEK_API_KEY", url: "https://platform.deepseek.com/api_keys" },
+      mistral: { name: "Mistral AI", envVar: "MISTRAL_API_KEY", url: "https://console.mistral.ai/api-keys/" },
+      groq: { name: "Groq", envVar: "GROQ_API_KEY", url: "https://console.groq.com/keys" },
+      together: { name: "Together AI", envVar: "TOGETHER_API_KEY", url: "https://api.together.xyz/settings/api-keys" }
+    };
+    const provider = providerNames[llmProvider] || providerNames.openai;
+    console.log(`[LLM] Enter your ${provider.name} API key.`);
+    console.log(`  Get one at: ${provider.url}`);
+    console.log("");
+    llmApiKey = await prompt("  API key: ", true);
+    if (!llmApiKey) {
+      console.error("");
+      console.error("  ERROR: API key is required.");
+      process.exit(1);
+    }
+    llmEnvVar = `${provider.envVar}=${llmApiKey}
+`;
+  }
+  const envContent = `# Exagent Agent Configuration
+# Agent: ${config.name}
+# Agent ID: ${config.agentId}
+# Generated: ${(/* @__PURE__ */ new Date()).toISOString()}
+# WARNING: Never commit this file to version control!
+
+# Wallet
+EXAGENT_PRIVATE_KEY=${privateKey}
+
+# Network
+EXAGENT_NETWORK=${config.network || "testnet"}
+
+# LLM (${llmProvider})
+${llmEnvVar}EXAGENT_LLM_MODEL=${config.llm?.model || ""}
+`;
+  fs.writeFileSync(envPath, envContent, { mode: 384 });
+  console.log("");
+  console.log("=".repeat(60));
+  console.log("  SETUP COMPLETE");
+  console.log("=".repeat(60));
+  console.log("");
+  console.log("  Your .env file has been created.");
+  console.log("");
+  console.log(`  Wallet: ${walletAddress}`);
+  console.log(`  LLM:    ${llmProvider}`);
+  console.log("");
+  if (walletSetup === "generate") {
+    console.log("  NEXT: Fund your wallet before starting to trade.");
+    console.log(`        Send testnet ETH to: ${walletAddress}`);
+  }
+  console.log("");
+  console.log("  The agent will now start...");
+  console.log("");
+  loadEnvFile({ path: envPath, override: true });
+}
+program.command("run").description("Start the trading agent").option("-c, --config <path>", "Path to agent-config.json", "agent-config.json").action(async (options) => {
+  try {
+    await checkFirstRunSetup(options.config);
+    console.log("Loading configuration...");
+    const config = loadConfig(options.config);
+    validateConfig(config);
+    console.log("");
+    console.log("=".repeat(50));
+    console.log("  EXAGENT TRADING AGENT");
+    console.log("=".repeat(50));
+    console.log("");
+    console.log(`  Agent:    ${config.name} (ID: ${config.agentId})`);
+    console.log(`  Network:  ${config.network}`);
+    console.log(`  LLM:      ${config.llm.provider} (${config.llm.model || "default"})`);
+    console.log(`  Universe: ${config.riskUniverse}`);
+    console.log("");
+    console.log("=".repeat(50));
+    console.log("");
+    const agent = new AgentRuntime(config);
+    await agent.initialize();
+    process.on("SIGINT", () => {
+      console.log("\nReceived SIGINT, shutting down...");
+      agent.stop();
+      process.exit(0);
+    });
+    process.on("SIGTERM", () => {
+      console.log("\nReceived SIGTERM, shutting down...");
+      agent.stop();
+      process.exit(0);
+    });
+    await agent.run();
+  } catch (error) {
+    console.error("Error:", error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
+program.command("templates").description("List available strategy templates").action(() => {
+  console.log("");
+  console.log("Available Strategy Templates:");
+  console.log("=".repeat(50));
+  console.log("");
+  const templates = getAllStrategyTemplates();
+  for (const template of templates) {
+    console.log(`${template.id.toUpperCase()}`);
+    console.log(`  Name: ${template.name}`);
+    console.log(`  Risk: ${template.riskLevel}`);
+    console.log(`  ${template.description}`);
+    console.log("");
+    console.log("  Warnings:");
+    for (const warning of template.riskWarnings) {
+      console.log(`    - ${warning}`);
+    }
+    console.log("");
+    console.log("-".repeat(50));
+    console.log("");
+  }
+});
+program.command("status").description("Check agent configuration status").option("-c, --config <path>", "Path to agent-config.json", "agent-config.json").action(async (options) => {
+  try {
+    const config = loadConfig(options.config);
+    validateConfig(config);
+    console.log("");
+    console.log("Agent Configuration:");
+    console.log("=".repeat(50));
+    console.log(`  Agent ID:    ${config.agentId}`);
+    console.log(`  Name:        ${config.name}`);
+    console.log(`  Network:     ${config.network}`);
+    console.log(`  LLM:         ${config.llm.provider} (${config.llm.model || "default"})`);
+    console.log(`  Universe:    ${config.riskUniverse}`);
+    console.log("");
+    console.log("Trading Config:");
+    console.log(`  Horizon:     ${config.trading.timeHorizon}`);
+    console.log(`  Max Position: ${config.trading.maxPositionSizeBps / 100}%`);
+    console.log(`  Max Daily Loss: ${config.trading.maxDailyLossBps / 100}%`);
+    console.log(`  Interval:    ${config.trading.tradingIntervalMs}ms`);
+    console.log("");
+    console.log("Configuration is valid.");
+  } catch (error) {
+    console.error("Configuration error:", error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
+program.command("api-keys").description("Show how to get API keys for each LLM provider").action(() => {
+  console.log("");
+  console.log("LLM Provider API Keys:");
+  console.log("=".repeat(50));
+  console.log("");
+  console.log("OPENAI");
+  console.log("  Get your API key at: https://platform.openai.com/api-keys");
+  console.log("");
+  console.log("ANTHROPIC");
+  console.log("  Get your API key at: https://console.anthropic.com/settings/keys");
+  console.log("");
+  console.log("DEEPSEEK");
+  console.log("  Get your API key at: https://platform.deepseek.com/api_keys");
+  console.log("");
+  console.log("GOOGLE AI");
+  console.log("  Get your API key at: https://aistudio.google.com/apikey");
+  console.log("");
+  console.log("MISTRAL AI");
+  console.log("  Get your API key at: https://console.mistral.ai/api-keys/");
+  console.log("");
+  console.log("GROQ");
+  console.log("  Get your API key at: https://console.groq.com/keys");
+  console.log("");
+  console.log("TOGETHER AI");
+  console.log("  Get your API key at: https://api.together.xyz/settings/api-keys");
+  console.log("");
+  console.log("OLLAMA (Local - No API Key Required)");
+  console.log("  Install: https://ollama.com/download");
+  console.log("  Run: ollama serve");
+  console.log("  Pull model: ollama pull mistral");
+  console.log("");
+  console.log("Note: Your API keys are stored locally in .env and never sent to Exagent servers.");
+  console.log("");
+});
+program.parse();