@exagent/agent 0.3.5 → 0.3.7

package/src/diagnostics.ts

@@ -1,335 +0,0 @@
-/**
- * Diagnostics collector for the agent SDK.
- *
- * Tracks: per-cycle timing, error categorization, LLM call stats,
- * and produces health-check snapshots for the heartbeat payload.
- */
-
-import type { LLMUsageStats } from './llm/base.js';
-
-// ── Error Categories ─────────────────────────────────────────
-
-export type ErrorCategory =
-  | 'network'     // Timeout, ECONNREFUSED, DNS, socket errors
-  | 'auth'        // 401, 403, token expired
-  | 'venue'       // Order rejected, insufficient balance, venue API errors
-  | 'strategy'    // LLM parse failure, strategy threw, invalid signals
-  | 'risk'        // Daily limit hit, position size rejected, leverage rejected
-  | 'internal';   // Unexpected errors, code bugs
-
-export interface CategorizedError {
-  category: ErrorCategory;
-  message: string;
-  timestamp: number;
-}
-
-// ── Cycle Metrics ────────────────────────────────────────────
-
-export interface CycleTimings {
-  totalMs: number;
-  priceRefreshMs: number;
-  strategyMs: number;
-  riskFilterMs: number;
-  executionMs: number;
-}
-
-export interface CycleMetrics {
-  cycleNumber: number;
-  startedAt: number;
-  timings: CycleTimings;
-  signalsGenerated: number;
-  signalsFiltered: number;
-  tradesExecuted: number;
-  success: boolean;
-  error?: string;
-}
-
-// ── LLM Call Log ─────────────────────────────────────────────
-
-export interface LLMCallRecord {
-  timestamp: number;
-  provider: string;
-  model: string;
-  inputTokens: number;
-  outputTokens: number;
-  latencyMs: number;
-  success: boolean;
-  error?: string;
-  retries: number;
-}
-
-// ── Health Snapshot ───────────────────────────────────────────
-
-export interface HealthSnapshot {
-  uptime: number;
-  uptimeHuman: string;
-  memoryMB: number;
-  cycleStats: {
-    total: number;
-    succeeded: number;
-    failed: number;
-    successRate: number;
-    avgCycleMs: number;
-    lastCycleMs: number;
-  };
-  errorCounts: Record<ErrorCategory, number>;
-  recentErrors: CategorizedError[];
-  llmStats: {
-    totalCalls: number;
-    avgLatencyMs: number;
-    errorRate: number;
-    recentCalls: number;
-  };
-  signalQueue: {
-    pending: number;
-    flushedTotal: number;
-  };
-}
-
-// ── Diagnostics Collector ────────────────────────────────────
-
-/** Rolling window size for recent items */
-const MAX_RECENT_ERRORS = 50;
-const MAX_RECENT_CYCLES = 100;
-const MAX_LLM_CALLS = 200;
-
-export class DiagnosticsCollector {
-  private startTime = Date.now();
-
-  // Cycle tracking
-  private cycles: CycleMetrics[] = [];
-  private totalCycles = 0;
-  private succeededCycles = 0;
-  private failedCycles = 0;
-
-  // Error tracking
-  private errorCounts: Record<ErrorCategory, number> = {
-    network: 0,
-    auth: 0,
-    venue: 0,
-    strategy: 0,
-    risk: 0,
-    internal: 0,
-  };
-  private recentErrors: CategorizedError[] = [];
-
-  // LLM call tracking
-  private llmCalls: LLMCallRecord[] = [];
-  private totalLLMCalls = 0;
-  private failedLLMCalls = 0;
-  private totalLLMLatency = 0;
-
-  // Signal queue tracking
-  private flushedSignalsTotal = 0;
-
-  // ── Cycle Recording ──────────────────────────────────────
-
-  recordCycle(metrics: CycleMetrics): void {
-    this.totalCycles++;
-    if (metrics.success) {
-      this.succeededCycles++;
-    } else {
-      this.failedCycles++;
-    }
-
-    this.cycles.push(metrics);
-    if (this.cycles.length > MAX_RECENT_CYCLES) {
-      this.cycles.shift();
-    }
-  }
-
-  /** Get the latest cycle metrics (for heartbeat) */
-  getLastCycle(): CycleMetrics | null {
-    return this.cycles.length > 0 ? this.cycles[this.cycles.length - 1]! : null;
-  }
-
-  /** Average cycle duration from recent cycles */
-  getAvgCycleMs(): number {
-    if (this.cycles.length === 0) return 0;
-    const total = this.cycles.reduce((sum, c) => sum + c.timings.totalMs, 0);
-    return Math.round(total / this.cycles.length);
-  }
-
-  // ── Error Recording ──────────────────────────────────────
-
-  /** Categorize and record an error */
-  recordError(error: Error | string, category?: ErrorCategory): CategorizedError {
-    const msg = typeof error === 'string' ? error : error.message;
-    const cat = category ?? this.categorizeError(msg);
-
-    this.errorCounts[cat]++;
-
-    const entry: CategorizedError = {
-      category: cat,
-      message: msg,
-      timestamp: Date.now(),
-    };
-
-    this.recentErrors.push(entry);
-    if (this.recentErrors.length > MAX_RECENT_ERRORS) {
-      this.recentErrors.shift();
-    }
-
-    return entry;
-  }
-
-  /** Auto-categorize an error from its message */
-  categorizeError(msg: string): ErrorCategory {
-    const lower = msg.toLowerCase();
-
-    // Network errors
-    if (
-      lower.includes('timed out') ||
-      lower.includes('econnrefused') ||
-      lower.includes('econnreset') ||
-      lower.includes('etimedout') ||
-      lower.includes('enotfound') ||
-      lower.includes('socket hang up') ||
-      lower.includes('fetch failed') ||
-      lower.includes('network') ||
-      lower.includes('dns')
-    ) {
-      return 'network';
-    }
-
-    // Auth errors
-    if (
-      lower.includes('401') ||
-      lower.includes('403') ||
-      lower.includes('unauthorized') ||
-      lower.includes('forbidden') ||
-      lower.includes('auth') ||
-      lower.includes('token expired') ||
-      lower.includes('invalid token')
-    ) {
-      return 'auth';
-    }
-
-    // Venue errors
-    if (
-      lower.includes('order rejected') ||
-      lower.includes('insufficient balance') ||
-      lower.includes('insufficient margin') ||
-      lower.includes('not enough balance') ||
-      lower.includes('user does not exist') ||
-      lower.includes('max notional') ||
-      lower.includes('max leverage') ||
-      lower.includes('max swap') ||
-      lower.includes('max bridge') ||
-      lower.includes('reverted')
-    ) {
-      return 'venue';
-    }
-
-    // Strategy errors
-    if (
-      lower.includes('strategy') ||
-      lower.includes('llm') ||
-      lower.includes('parse') ||
-      lower.includes('json') ||
-      lower.includes('budget exceeded')
-    ) {
-      return 'strategy';
-    }
-
-    // Risk errors
-    if (
-      lower.includes('daily loss') ||
-      lower.includes('position size') ||
-      lower.includes('risk') ||
-      lower.includes('slippage')
-    ) {
-      return 'risk';
-    }
-
-    return 'internal';
-  }
-
-  getErrorCounts(): Record<ErrorCategory, number> {
-    return { ...this.errorCounts };
-  }
-
-  // ── LLM Call Recording ───────────────────────────────────
-
-  recordLLMCall(record: LLMCallRecord): void {
-    this.totalLLMCalls++;
-    this.totalLLMLatency += record.latencyMs;
-    if (!record.success) {
-      this.failedLLMCalls++;
-    }
-
-    this.llmCalls.push(record);
-    if (this.llmCalls.length > MAX_LLM_CALLS) {
-      this.llmCalls.shift();
-    }
-  }
-
-  getRecentLLMCalls(count = 10): LLMCallRecord[] {
-    return this.llmCalls.slice(-count);
-  }
-
-  // ── Signal Queue Tracking ────────────────────────────────
-
-  recordSignalFlush(count: number): void {
-    this.flushedSignalsTotal += count;
-  }
-
-  // ── Health Snapshot ──────────────────────────────────────
-
-  getHealthSnapshot(pendingSignals: number): HealthSnapshot {
-    const uptimeMs = Date.now() - this.startTime;
-    const memUsage = process.memoryUsage();
-
-    const lastCycle = this.getLastCycle();
-    const avgLLMLatency = this.totalLLMCalls > 0
-      ? Math.round(this.totalLLMLatency / this.totalLLMCalls)
-      : 0;
-    const llmErrorRate = this.totalLLMCalls > 0
-      ? this.failedLLMCalls / this.totalLLMCalls
-      : 0;
-
-    // Count LLM calls in the last 5 minutes
-    const fiveMinAgo = Date.now() - 300_000;
-    const recentLLMCalls = this.llmCalls.filter(c => c.timestamp > fiveMinAgo).length;
-
-    return {
-      uptime: uptimeMs,
-      uptimeHuman: this.formatUptime(uptimeMs),
-      memoryMB: Math.round(memUsage.rss / 1024 / 1024),
-      cycleStats: {
-        total: this.totalCycles,
-        succeeded: this.succeededCycles,
-        failed: this.failedCycles,
-        successRate: this.totalCycles > 0
-          ? Math.round((this.succeededCycles / this.totalCycles) * 10000) / 100
-          : 100,
-        avgCycleMs: this.getAvgCycleMs(),
-        lastCycleMs: lastCycle?.timings.totalMs ?? 0,
-      },
-      errorCounts: this.getErrorCounts(),
-      recentErrors: this.recentErrors.slice(-10),
-      llmStats: {
-        totalCalls: this.totalLLMCalls,
-        avgLatencyMs: avgLLMLatency,
-        errorRate: Math.round(llmErrorRate * 10000) / 100,
-        recentCalls: recentLLMCalls,
-      },
-      signalQueue: {
-        pending: pendingSignals,
-        flushedTotal: this.flushedSignalsTotal,
-      },
-    };
-  }
-
-  private formatUptime(ms: number): string {
-    const seconds = Math.floor(ms / 1000);
-    const minutes = Math.floor(seconds / 60);
-    const hours = Math.floor(minutes / 60);
-    const days = Math.floor(hours / 24);
-
-    if (days > 0) return `${days}d ${hours % 24}h`;
-    if (hours > 0) return `${hours}h ${minutes % 60}m`;
-    if (minutes > 0) return `${minutes}m ${seconds % 60}s`;
-    return `${seconds}s`;
-  }
-}

package/src/index.ts

@@ -1,98 +0,0 @@
-export { AgentRuntime } from './runtime.js';
-export { RelayClient } from './relay.js';
-export { SignalReporter } from './signal.js';
-export { FileStore } from './store.js';
-export { PositionTracker } from './position-tracker.js';
-export { createLLMAdapter, BaseLLMAdapter } from './llm/index.js';
-export { loadStrategy, listTemplates, getTemplate } from './strategy/index.js';
-export { RiskManager } from './trading/risk.js';
-export { MarketDataService } from './trading/market.js';
-export { PaperExecutor } from './paper/index.js';
-export { loadConfig, generateSampleConfig, writeSampleConfig } from './config.js';
-export type { RuntimeConfig } from './config.js';
-export type { RelayClientConfig } from './relay.js';
-
-// Observability
-export { Logger, getLogger, configureLogger } from './logger.js';
-export type { LogLevel, LogCategory, LogEntry, LoggerConfig } from './logger.js';
-export { DiagnosticsCollector } from './diagnostics.js';
-export type {
-  ErrorCategory,
-  CategorizedError,
-  CycleTimings,
-  CycleMetrics,
-  LLMCallRecord,
-  HealthSnapshot,
-} from './diagnostics.js';
-
-// Hyperliquid perps
-export {
-  HyperliquidClient,
-  HyperliquidSigner,
-  HyperliquidOrderManager,
-  HyperliquidPositionManager,
-  HyperliquidWebSocket,
-  getNextNonce,
-  HYPERLIQUID_DOMAIN,
-  HYPERLIQUID_USER_DOMAIN,
-  USER_ACTION_TYPES,
-} from './perp/index.js';
-export type {
-  PerpConfig,
-  PerpTradeSignal,
-  PerpPosition,
-  AccountSummary,
-  PerpFill,
-  OrderResult as PerpOrderResult,
-  FillCallback,
-  FundingCallback,
-  LiquidationCallback,
-  FundingPayment,
-} from './perp/index.js';
-
-// Polymarket predictions
-export {
-  PolymarketClient,
-  PolymarketOrderManager,
-  encodePredictionInstrument,
-  decodePredictionInstrument,
-} from './prediction/index.js';
-export type {
-  PredictionConfig,
-  PredictionTradeSignal,
-  PredictionPosition,
-  PredictionMarket,
-  PredictionFill,
-} from './prediction/index.js';
-
-// Spot DEX trading
-export {
-  SpotDEXClient,
-  UniswapAdapter,
-  AerodromeAdapter,
-  SpotSwapManager,
-  DEFAULT_SPOT_CONFIG,
-} from './spot/index.js';
-export type {
-  SpotConfig,
-  SpotSwapParams,
-  SpotQuoteResult,
-  SpotSwapResult,
-} from './spot/index.js';
-
-// Cross-chain bridges
-export {
-  AcrossAdapter,
-  BridgeManager,
-  DEFAULT_BRIDGE_CONFIG,
-} from './bridge/index.js';
-export type {
-  BridgeConfig,
-  BridgeRequest,
-  BridgeFeeEstimate,
-  BridgeResult,
-} from './bridge/index.js';
-
-// Chain configs
-export { CHAIN_CONFIGS, getChainConfig, applyRpcOverrides } from './chains.js';
-export type { ChainConfig } from './chains.js';

package/src/llm/anthropic.ts

@@ -1,63 +0,0 @@
-import type { LLMMessage, LLMResponse, LLMMetadata, LLMConfig } from '@exagent/sdk';
-import { BaseLLMAdapter } from './base.js';
-
-export class AnthropicAdapter extends BaseLLMAdapter {
-  private endpoint: string;
-
-  constructor(config: LLMConfig) {
-    super(config);
-    this.endpoint = config.endpoint || 'https://api.anthropic.com';
-  }
-
-  protected async chatImpl(messages: LLMMessage[]): Promise<LLMResponse> {
-    const systemMessage = messages.find(m => m.role === 'system');
-    const nonSystemMessages = messages.filter(m => m.role !== 'system');
-
-    const body: Record<string, unknown> = {
-      model: this.config.model || 'claude-sonnet-4-20250514',
-      messages: nonSystemMessages.map(m => ({ role: m.role, content: m.content })),
-      max_tokens: this.getMaxTokens(),
-      temperature: this.getTemperature(),
-    };
-
-    if (systemMessage) {
-      body.system = systemMessage.content;
-    }
-
-    const res = await this.fetchWithTimeout(`${this.endpoint}/v1/messages`, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'x-api-key': this.config.apiKey || '',
-        'anthropic-version': '2023-06-01',
-      },
-      body: JSON.stringify(body),
-    });
-
-    if (!res.ok) {
-      const text = await res.text();
-      throw new Error(`Anthropic API error ${res.status}: ${text}`);
-    }
-
-    const data = await res.json() as {
-      content: { type: string; text: string }[];
-      usage?: { input_tokens: number; output_tokens: number };
-    };
-
-    const textContent = data.content.find(c => c.type === 'text');
-
-    return {
-      content: textContent?.text || '',
-      tokens: data.usage
-        ? { input: data.usage.input_tokens, output: data.usage.output_tokens }
-        : undefined,
-    };
-  }
-
-  getMetadata(): LLMMetadata {
-    return {
-      provider: 'anthropic',
-      model: this.config.model || 'claude-sonnet-4-20250514',
-    };
-  }
-}