@autonomaai/agent-core 1.0.2

package/src/index.ts

@@ -0,0 +1,24 @@
+/**
+ * @autonoma/agent-core
+ * 
+ * Standardized agent core for autonoma AI trading platform.
+ * Provides consistent agent architecture with LangGraph + AgentKit integration.
+ */
+
+// Core agent implementation
+export { StandardAgent, AgentUtils } from './core.js';
+
+// Base agent class for reusability
+export { BaseAgent } from './base-agent.js';
+
+// Agent factory functions  
+export * from './factory.js';
+
+// Type definitions
+export * from './types.js';
+
+// Streaming helpers
+export * from './streaming.js';
+
+// Standardized error handling
+export * from './error-handler.js';

package/src/streaming.ts

@@ -0,0 +1,50 @@
+/**
+ * Lightweight streaming event store for agents.
+ * Agents publish partial responses so external subscribers can poll for streaming updates.
+ */
+
+export type StreamingEventType = 'start' | 'progress' | 'done' | 'error';
+
+export interface StreamingEvent {
+  sessionId: string;
+  type: StreamingEventType;
+  content: string;
+  timestamp: string;
+  metadata?: Record<string, any>;
+}
+
+class StreamingService {
+  private events = new Map<string, StreamingEvent[]>();
+  private readonly maxEventsPerSession = 50;
+
+  publish(sessionId: string, event: Omit<StreamingEvent, 'sessionId' | 'timestamp'> & { timestamp?: string }): void {
+    const timestamp = event.timestamp || new Date().toISOString();
+    const payload: StreamingEvent = {
+      sessionId,
+      content: event.content,
+      type: event.type,
+      metadata: event.metadata,
+      timestamp
+    };
+
+    const existing = this.events.get(sessionId) || [];
+    existing.push(payload);
+    if (existing.length > this.maxEventsPerSession) {
+      existing.shift();
+    }
+
+    this.events.set(sessionId, existing);
+  }
+
+  consume(sessionId: string): StreamingEvent[] {
+    const stored = this.events.get(sessionId) || [];
+    this.events.delete(sessionId);
+    return stored;
+  }
+
+  clear(sessionId: string): void {
+    this.events.delete(sessionId);
+  }
+}
+
+export const streamingService = new StreamingService();

package/src/trading/formatters.ts

@@ -0,0 +1,363 @@
+/**
+ * Trading Formatters for autonoma Agent Core
+ * 
+ * Formatting utilities for displaying trading data in a consistent manner.
+ */
+
+import { Order, Position, Portfolio, TokenPrice, YieldOpportunity } from './types.js';
+
+// =============================================================================
+// Number Formatting
+// =============================================================================
+
+/**
+ * Format currency amount with appropriate decimal places
+ */
+export function formatCurrency(
+  amount: number, 
+  currency: string = 'USD',
+  decimals?: number
+): string {
+  // Auto-determine decimal places based on amount
+  if (decimals === undefined) {
+    if (amount >= 1000) decimals = 0;
+    else if (amount >= 1) decimals = 2;
+    else if (amount >= 0.01) decimals = 4;
+    else decimals = 8;
+  }
+
+  return new Intl.NumberFormat('en-US', {
+    style: 'currency',
+    currency: currency,
+    minimumFractionDigits: decimals,
+    maximumFractionDigits: decimals
+  }).format(amount);
+}
+
+/**
+ * Format cryptocurrency amount with appropriate precision
+ */
+export function formatCrypto(amount: number, symbol: string, decimals?: number): string {
+  if (decimals === undefined) {
+    // Common crypto decimal places
+    const cryptoDecimals: Record<string, number> = {
+      'BTC': 8,
+      'ETH': 6,
+      'USDT': 2,
+      'USDC': 2,
+      'BNB': 4,
+      'SOL': 4,
+      'ADA': 6,
+      'DOT': 4
+    };
+    decimals = cryptoDecimals[symbol.toUpperCase()] || 6;
+  }
+
+  return `${amount.toFixed(decimals)} ${symbol}`;
+}
+
+/**
+ * Format percentage with color coding
+ */
+export function formatPercentage(
+  value: number, 
+  decimals: number = 2,
+  showSign: boolean = true
+): { text: string; color: 'green' | 'red' | 'gray' } {
+  const sign = showSign && value >= 0 ? '+' : '';
+  const text = `${sign}${value.toFixed(decimals)}%`;
+  
+  let color: 'green' | 'red' | 'gray';
+  if (value > 0) color = 'green';
+  else if (value < 0) color = 'red';
+  else color = 'gray';
+
+  return { text, color };
+}
+
+/**
+ * Format large numbers with appropriate units (K, M, B)
+ */
+export function formatLargeNumber(value: number, decimals: number = 1): string {
+  const units = [
+    { threshold: 1e12, suffix: 'T' },
+    { threshold: 1e9, suffix: 'B' },
+    { threshold: 1e6, suffix: 'M' },
+    { threshold: 1e3, suffix: 'K' }
+  ];
+
+  for (const unit of units) {
+    if (Math.abs(value) >= unit.threshold) {
+      return `${(value / unit.threshold).toFixed(decimals)}${unit.suffix}`;
+    }
+  }
+
+  return value.toFixed(decimals);
+}
+
+// =============================================================================
+// Date & Time Formatting
+// =============================================================================
+
+/**
+ * Format date for trading displays
+ */
+export function formatTradingDate(date: Date): string {
+  return new Intl.DateTimeFormat('en-US', {
+    month: 'short',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    hour12: false
+  }).format(date);
+}
+
+/**
+ * Format relative time (e.g., "2 minutes ago")
+ */
+export function formatRelativeTime(date: Date): string {
+  const now = new Date();
+  const diffMs = now.getTime() - date.getTime();
+  const diffSeconds = Math.floor(diffMs / 1000);
+  const diffMinutes = Math.floor(diffSeconds / 60);
+  const diffHours = Math.floor(diffMinutes / 60);
+  const diffDays = Math.floor(diffHours / 24);
+
+  if (diffSeconds < 60) return 'just now';
+  if (diffMinutes < 60) return `${diffMinutes}m ago`;
+  if (diffHours < 24) return `${diffHours}h ago`;
+  if (diffDays < 7) return `${diffDays}d ago`;
+  
+  return formatTradingDate(date);
+}
+
+/**
+ * Format duration in human readable format
+ */
+export function formatDuration(milliseconds: number): string {
+  const seconds = Math.floor(milliseconds / 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`;
+}
+
+// =============================================================================
+// Trading Object Formatting
+// =============================================================================
+
+/**
+ * Format order for display
+ */
+export function formatOrder(order: Order): {
+  id: string;
+  symbol: string;
+  side: string;
+  type: string;
+  amount: string;
+  price: string;
+  status: string;
+  filled: string;
+  time: string;
+} {
+  return {
+    id: order.id.slice(0, 8),
+    symbol: order.symbol,
+    side: order.side.toUpperCase(),
+    type: order.type.toUpperCase(),
+    amount: formatCrypto(order.quantity, order.symbol.split('/')[0] ?? ''),
+    price: order.price ? formatCurrency(order.price) : 'Market',
+    status: order.status.toUpperCase(),
+    filled: `${((order.filledQuantity / order.quantity) * 100).toFixed(1)}%`,
+    time: formatRelativeTime(order.createdAt)
+  };
+}
+
+/**
+ * Format position for display
+ */
+export function formatPosition(position: Position): {
+  symbol: string;
+  quantity: string;
+  avgPrice: string;
+  marketValue: string;
+  pnl: { text: string; color: 'green' | 'red' | 'gray' };
+  change: { text: string; color: 'green' | 'red' | 'gray' };
+} {
+  const currentPrice = position.marketValue / position.quantity;
+  const change = ((currentPrice - position.averagePrice) / position.averagePrice) * 100;
+
+  return {
+    symbol: position.symbol,
+    quantity: formatCrypto(position.quantity, position.symbol.split('/')[0] ?? ''),
+    avgPrice: formatCurrency(position.averagePrice),
+    marketValue: formatCurrency(position.marketValue),
+    pnl: formatPercentage(position.unrealizedPnL),
+    change: formatPercentage(change)
+  };
+}
+
+/**
+ * Format portfolio summary
+ */
+export function formatPortfolioSummary(portfolio: Portfolio): {
+  totalValue: string;
+  cash: string;
+  invested: string;
+  dayPnL: { text: string; color: 'green' | 'red' | 'gray' };
+  totalPnL: { text: string; color: 'green' | 'red' | 'gray' };
+  lastUpdate: string;
+} {
+  const investedValue = portfolio.totalValue - portfolio.cash;
+  
+  return {
+    totalValue: formatCurrency(portfolio.totalValue),
+    cash: formatCurrency(portfolio.cash),
+    invested: formatCurrency(investedValue),
+    dayPnL: formatPercentage(portfolio.dayPnL),
+    totalPnL: formatPercentage(portfolio.totalPnL),
+    lastUpdate: formatRelativeTime(portfolio.lastUpdate)
+  };
+}
+
+/**
+ * Format token price for display
+ */
+export function formatTokenPrice(price: TokenPrice): {
+  symbol: string;
+  price: string;
+  change: { text: string; color: 'green' | 'red' | 'gray' };
+  volume: string;
+  marketCap: string;
+  lastUpdate: string;
+} {
+  return {
+    symbol: price.symbol,
+    price: formatCurrency(price.price),
+    change: formatPercentage(price.change24h),
+    volume: formatLargeNumber(price.volume24h),
+    marketCap: price.marketCap ? formatLargeNumber(price.marketCap) : 'N/A',
+    lastUpdate: formatRelativeTime(price.timestamp)
+  };
+}
+
+/**
+ * Format yield opportunity for display
+ */
+export function formatYieldOpportunity(opportunity: YieldOpportunity): {
+  protocol: string;
+  pool: string;
+  apy: { text: string; color: 'green' | 'red' | 'gray' };
+  tvl: string;
+  risk: { text: string; color: 'green' | 'yellow' | 'red' };
+  category: string;
+  blockchain: string;
+  minDeposit: string;
+} {
+  const riskColors = {
+    low: 'green' as const,
+    medium: 'yellow' as const,
+    high: 'red' as const
+  };
+
+  return {
+    protocol: opportunity.protocol,
+    pool: opportunity.pool,
+    apy: { text: `${opportunity.apy.toFixed(2)}%`, color: 'green' },
+    tvl: formatLargeNumber(opportunity.tvl),
+    risk: { text: opportunity.risk.toUpperCase(), color: riskColors[opportunity.risk] },
+    category: opportunity.category.charAt(0).toUpperCase() + opportunity.category.slice(1),
+    blockchain: opportunity.blockchain,
+    minDeposit: opportunity.minimumDeposit ? formatCurrency(opportunity.minimumDeposit) : 'No minimum'
+  };
+}
+
+// =============================================================================
+// Status & Badge Formatting
+// =============================================================================
+
+/**
+ * Format order status with color coding
+ */
+export function formatOrderStatus(status: string): {
+  text: string;
+  color: 'green' | 'yellow' | 'red' | 'blue' | 'gray';
+} {
+  const statusMap = {
+    pending: { text: 'PENDING', color: 'yellow' as const },
+    open: { text: 'OPEN', color: 'blue' as const },
+    filled: { text: 'FILLED', color: 'green' as const },
+    canceled: { text: 'CANCELED', color: 'gray' as const },
+    rejected: { text: 'REJECTED', color: 'red' as const }
+  };
+
+  return statusMap[status.toLowerCase() as keyof typeof statusMap] || 
+         { text: status.toUpperCase(), color: 'gray' };
+}
+
+/**
+ * Format risk level with color coding
+ */
+export function formatRiskLevel(risk: string): {
+  text: string;
+  color: 'green' | 'yellow' | 'red';
+  icon: string;
+} {
+  const riskMap = {
+    low: { text: 'LOW RISK', color: 'green' as const, icon: '🟢' },
+    medium: { text: 'MEDIUM RISK', color: 'yellow' as const, icon: '🟡' },
+    high: { text: 'HIGH RISK', color: 'red' as const, icon: '🔴' }
+  };
+
+  return riskMap[risk.toLowerCase() as keyof typeof riskMap] || 
+         { text: risk.toUpperCase(), color: 'yellow', icon: '⚪' };
+}
+
+// =============================================================================
+// Chart Data Formatting
+// =============================================================================
+
+/**
+ * Format data for chart display
+ */
+export function formatChartData(
+  data: Array<{ timestamp: Date; value: number }>,
+  type: 'price' | 'percentage' | 'volume'
+): Array<{ x: string; y: number; formatted: string }> {
+  return data.map(point => ({
+    x: point.timestamp.toISOString(),
+    y: point.value,
+    formatted: type === 'price' ? formatCurrency(point.value) :
+               type === 'percentage' ? formatPercentage(point.value).text :
+               formatLargeNumber(point.value)
+  }));
+}
+
+/**
+ * Format trading session summary
+ */
+export function formatTradingSession(session: {
+  duration: number;
+  trades: number;
+  pnl: number;
+  winRate: number;
+  avgTradeSize: number;
+}): {
+  duration: string;
+  trades: string;
+  pnl: { text: string; color: 'green' | 'red' | 'gray' };
+  winRate: { text: string; color: 'green' | 'red' | 'gray' };
+  avgTradeSize: string;
+} {
+  return {
+    duration: formatDuration(session.duration),
+    trades: session.trades.toString(),
+    pnl: formatPercentage(session.pnl),
+    winRate: formatPercentage(session.winRate, 1),
+    avgTradeSize: formatCurrency(session.avgTradeSize)
+  };
+} 

package/src/trading/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Trading Utilities for autonoma Agents
+ * 
+ * Common trading functions, types, and utilities used across trading agents.
+ */
+
+export * from './types.js';
+export * from './utils.js';
+export * from './validation.js';
+// Formatters exports removed to avoid conflicts with utils 

package/src/trading/types.ts

@@ -0,0 +1,263 @@
+/**
+ * Trading Types for autonoma Agent Core
+ * 
+ * Standardized trading types used across all trading agents.
+ */
+
+// =============================================================================
+// Market Data Types
+// =============================================================================
+
+export interface TokenPrice {
+  symbol: string;
+  price: number;
+  change24h: number;
+  volume24h: number;
+  marketCap?: number;
+  timestamp: Date;
+  source: string;
+}
+
+export interface OHLCV {
+  open: number;
+  high: number;
+  low: number;
+  close: number;
+  volume: number;
+  timestamp: Date;
+}
+
+export interface OrderBook {
+  symbol: string;
+  bids: OrderBookLevel[];
+  asks: OrderBookLevel[];
+  timestamp: Date;
+}
+
+export interface OrderBookLevel {
+  price: number;
+  quantity: number;
+}
+
+// =============================================================================
+// Trading Order Types
+// =============================================================================
+
+export type OrderSide = 'buy' | 'sell';
+export type OrderType = 'market' | 'limit' | 'stop' | 'stop-limit';
+export type OrderStatus = 'pending' | 'open' | 'filled' | 'canceled' | 'rejected';
+export type TimeInForce = 'GTC' | 'IOC' | 'FOK' | 'DAY';
+
+export interface Order {
+  id: string;
+  symbol: string;
+  side: OrderSide;
+  type: OrderType;
+  quantity: number;
+  price?: number;
+  stopPrice?: number;
+  timeInForce: TimeInForce;
+  status: OrderStatus;
+  filledQuantity: number;
+  averagePrice?: number;
+  createdAt: Date;
+  updatedAt: Date;
+  exchange: string;
+}
+
+export interface OrderRequest {
+  symbol: string;
+  side: OrderSide;
+  type: OrderType;
+  quantity: number;
+  price?: number;
+  stopPrice?: number;
+  timeInForce?: TimeInForce;
+}
+
+// =============================================================================
+// Portfolio & Position Types
+// =============================================================================
+
+export interface Position {
+  symbol: string;
+  quantity: number;
+  averagePrice: number;
+  marketValue: number;
+  unrealizedPnL: number;
+  realizedPnL: number;
+  costBasis: number;
+  exchange: string;
+  lastUpdate: Date;
+}
+
+export interface Portfolio {
+  id: string;
+  totalValue: number;
+  cash: number;
+  positions: Position[];
+  totalPnL: number;
+  dayPnL: number;
+  lastUpdate: Date;
+}
+
+// =============================================================================
+// DeFi Specific Types
+// =============================================================================
+
+export interface YieldOpportunity {
+  protocol: string;
+  pool: string;
+  token: string;
+  apy: number;
+  tvl: number;
+  risk: 'low' | 'medium' | 'high';
+  blockchain: string;
+  category: 'lending' | 'liquidity' | 'staking' | 'farming';
+  minimumDeposit?: number;
+  lockPeriod?: number; // in days
+}
+
+export interface LiquidityPool {
+  id: string;
+  protocol: string;
+  tokens: string[];
+  reserves: number[];
+  fee: number;
+  apy: number;
+  volume24h: number;
+  tvl: number;
+}
+
+export interface StakingPosition {
+  protocol: string;
+  token: string;
+  amount: number;
+  apy: number;
+  claimableRewards: number;
+  lockEndDate?: Date;
+  autoCompound: boolean;
+}
+
+// =============================================================================
+// Risk Management Types
+// =============================================================================
+
+export interface RiskLimits {
+  maxPositionSize: number; // as percentage of portfolio
+  maxDailyLoss: number; // in USD
+  maxDrawdown: number; // as percentage
+  maxLeverage: number;
+  blacklistedSymbols: string[];
+  allowedExchanges: string[];
+}
+
+export interface RiskMetrics {
+  portfolioVar: number; // Value at Risk
+  sharpeRatio: number;
+  maxDrawdown: number;
+  volatility: number;
+  beta: number;
+  alpha: number;
+  positionConcentration: number;
+}
+
+// =============================================================================
+// Trading Strategy Types
+// =============================================================================
+
+export interface StrategyConfig {
+  name: string;
+  type: 'market_making' | 'arbitrage' | 'yield_farming' | 'momentum' | 'mean_reversion';
+  enabled: boolean;
+  parameters: Record<string, any>;
+  riskLimits: RiskLimits;
+  targetAllocation: number; // percentage of portfolio
+}
+
+export interface StrategyPerformance {
+  strategyName: string;
+  totalTrades: number;
+  winRate: number;
+  totalPnL: number;
+  sharpeRatio: number;
+  maxDrawdown: number;
+  averageHoldTime: number; // in hours
+  lastExecuted: Date;
+}
+
+// =============================================================================
+// Exchange Integration Types
+// =============================================================================
+
+export interface ExchangeConfig {
+  name: string;
+  apiKey: string;
+  apiSecret: string;
+  passphrase?: string;
+  sandbox: boolean;
+  rateLimit: number; // requests per second
+}
+
+export interface ExchangeStatus {
+  name: string;
+  connected: boolean;
+  lastHeartbeat: Date;
+  latency: number; // in milliseconds
+  orderCount24h: number;
+  rateLimitRemaining: number;
+}
+
+// =============================================================================
+// Market Making Specific Types
+// =============================================================================
+
+export interface MarketMakingConfig {
+  symbol: string;
+  bidSpread: number; // as percentage
+  askSpread: number; // as percentage
+  orderAmount: number; // base currency
+  maxInventory: number;
+  skewFactor: number; // inventory skew adjustment
+  minOrderGap: number; // minimum gap between orders
+}
+
+export interface SpreadAnalysis {
+  symbol: string;
+  currentSpread: number;
+  averageSpread24h: number;
+  spreadVolatility: number;
+  optimalSpread: number;
+  competitorAnalysis: {
+    topBid: number;
+    topAsk: number;
+    bidDepth: number;
+    askDepth: number;
+  };
+}
+
+// =============================================================================
+// Utility Types
+// =============================================================================
+
+export interface TimeFrame {
+  value: number;
+  unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month';
+}
+
+export interface PriceRange {
+  min: number;
+  max: number;
+  current: number;
+}
+
+export interface TradingSession {
+  id: string;
+  startTime: Date;
+  endTime?: Date;
+  initialBalance: number;
+  currentBalance: number;
+  totalTrades: number;
+  pnl: number;
+  strategies: string[];
+}