@autonomaai/agent-core 1.0.2

package/src/factory.ts

@@ -0,0 +1,687 @@
+/**
+ * Factory functions for creating pre-configured agents.
+ * 
+ * Provides convenient functions for creating agents optimized for specific use cases
+ * with appropriate defaults and capabilities.
+ */
+
+// Node.js process global
+declare const process: {
+  env: Record<string, string | undefined>;
+};
+
+import { AgentConfig, TradingAgentConfig, DataAnalysisAgentConfig, CustomerServiceAgentConfig } from './types.js';
+import { StandardAgent, AgentBuilder, AgentUtils } from './core.js';
+
+/**
+ * Create a trading agent with pre-configured capabilities for market making,
+ * exchange connectivity, and risk management.
+ */
+export function createTradingAgent(config: Partial<TradingAgentConfig> = {}): StandardAgent {
+  const defaultConfig: AgentConfig = {
+    name: config.name || 'Trading Agent',
+    description: config.description || 'AI trading agent with Hummingbot integration',
+    
+    tools: {
+      enableAgentKit: true,
+      enableMCP: true,
+      enableRAG: true,
+      mcpServerUrl: config.tools?.mcpServerUrl || process.env.HUMMINGBOT_MCP_URL || 'http://localhost:8000',
+      ragServerUrl: config.tools?.ragServerUrl || process.env.RAG_MCP_URL || 'http://localhost:3002',
+      ...config.tools
+    },
+    
+    prompt: {
+      systemMessage: `You are an AI Trading Agent that controls a revolutionary Hummingbot trading system through the Model Context Protocol (MCP). You are empowered to create, manage, and execute automated trading strategies with professional-grade capabilities.`,
+      capabilities: [
+        'trading_controller_management',
+        'exchange_connectivity', 
+        'market_data_analysis',
+        'risk_management',
+        'portfolio_optimization',
+        'automated_trading',
+        'performance_analytics'
+      ],
+      context: `
+        **🚀 Core Trading System:**
+        - Controller-Based Architecture with 90% resource reduction and 60x faster deployment
+        - Live Exchange Connectivity: Real trading on Hyperliquid, Binance, Bybit
+        - Multi-Strategy Support: Pure market making, Avellaneda, TWAP, Grid trading, Arbitrage
+        - Real-Time Management: Hot configuration updates, performance monitoring, risk management
+        
+        **📊 Available Trading Operations:**
+        - System Health: Monitor system status, capabilities, and performance metrics
+        - Controller Management: Create, start, stop, configure trading controllers
+        - Exchange Integration: Connect controllers to live exchanges
+        - Live Trading: Execute real trades, monitor positions, manage account balances
+        - Market Data: Access real-time market data, order books, price feeds
+        - Performance Analytics: Track PnL, win rates, trading volumes, health scores
+      `,
+      enableConversationMemory: true,
+      ...config.prompt
+    },
+    
+    memory: {
+      enabled: true,
+      persistentThreadId: true,
+      maxMessages: 100,
+      ...config.memory
+    },
+    
+    services: {
+      messageService: true,
+      ragService: true,
+      analyticsService: true,
+      loggingEnabled: true,
+      ...config.services
+    },
+    
+    ...config
+  };
+
+  return StandardAgent.createTradingAgent(defaultConfig);
+}
+
+/**
+ * Create a data analysis agent optimized for market research,
+ * pattern recognition, and report generation.
+ */
+export function createDataAnalysisAgent(config: Partial<DataAnalysisAgentConfig> = {}): StandardAgent {
+  const defaultConfig: AgentConfig = {
+    name: config.name || 'Data Analysis Agent',
+    description: config.description || 'AI agent specialized in data analysis and market research',
+    
+    tools: {
+      enableMCP: true,
+      enableRAG: true,
+      mcpServerUrl: config.tools?.mcpServerUrl || process.env.DATA_COLLECTOR_MCP_URL || 'http://localhost:8003',
+      ragServerUrl: config.tools?.ragServerUrl || process.env.RAG_MCP_URL || 'http://localhost:3002',
+      ...config.tools
+    },
+    
+    prompt: {
+      systemMessage: `You are an AI Data Analysis Agent specialized in cryptocurrency market research, statistical analysis, and pattern recognition. You can access and analyze comprehensive market data to provide insights and recommendations.`,
+      capabilities: [
+        'data_collection',
+        'statistical_analysis',
+        'pattern_recognition',
+        'report_generation',
+        'visualization',
+        'market_research',
+        'trend_analysis'
+      ],
+      context: `
+        **📊 Data Analysis Capabilities:**
+        - Multi-Chain, Multi-DEX data access: EVM chains and Hyperliquid L1
+        - Real-time and historical price data, order books, spreads
+        - Token-level analytics and trading volume insights
+        - Statistical analysis and pattern recognition
+        - Report generation and data visualization
+        
+        **🔍 Available Data Sources:**
+        - Hyperliquid L1: Native API integration for orderbook, trades, volume, OHLCV
+        - EVM DEXs: Moralis and 0x API for token prices, swaps, aggregation
+        - Historical data: OHLCV, volume, spreads, market metrics
+      `,
+      enableConversationMemory: true,
+      ...config.prompt
+    },
+    
+    memory: {
+      enabled: true,
+      persistentThreadId: true,
+      maxMessages: 150,
+      ...config.memory
+    },
+    
+    services: {
+      messageService: true,
+      ragService: true,
+      analyticsService: true,
+      loggingEnabled: true,
+      ...config.services
+    },
+    
+    ...config
+  };
+
+  return StandardAgent.createDataAnalysisAgent(defaultConfig);
+}
+
+/**
+ * Create a customer service agent optimized for answering questions,
+ * knowledge base search, and issue resolution.
+ */
+export function createCustomerServiceAgent(config: Partial<CustomerServiceAgentConfig> = {}): StandardAgent {
+  const defaultConfig: AgentConfig = {
+    name: config.name || 'Customer Service Agent',
+    description: config.description || 'AI customer service agent with knowledge base integration',
+    
+    tools: {
+      enableRAG: true,
+      ragServerUrl: config.tools?.ragServerUrl || process.env.RAG_MCP_URL || 'http://localhost:3002',
+      ...config.tools
+    },
+    
+    prompt: {
+      systemMessage: `You are an AI Customer Service Agent designed to help users with questions, troubleshooting, and guidance. You have access to comprehensive documentation and can search through knowledge bases to provide accurate and helpful responses.`,
+      capabilities: [
+        'question_answering',
+        'knowledge_base_search',
+        'issue_escalation',
+        'conversation_management',
+        'sentiment_analysis',
+        'troubleshooting',
+        'documentation_retrieval'
+      ],
+      context: `
+        **🎯 Customer Service Capabilities:**
+        - Knowledge Base Access: Search through documentation, guides, and technical resources
+        - Issue Resolution: Troubleshoot problems and provide step-by-step solutions
+        - Conversation Management: Maintain context and provide personalized assistance
+        - Escalation: Identify when issues need human intervention
+        
+        **📚 Available Knowledge Tools:**
+        - search_knowledge_base: Search for specific documentation or information
+        - get_contextual_information: Get relevant context for current discussion
+        - comprehensive_search: Deep research on complex topics
+        - check_knowledge_base_status: Verify knowledge base availability
+      `,
+      enableConversationMemory: true,
+      ...config.prompt
+    },
+    
+    memory: {
+      enabled: true,
+      persistentThreadId: true,
+      maxMessages: 200,
+      ...config.memory
+    },
+    
+    services: {
+      messageService: true,
+      ragService: true,
+      loggingEnabled: true,
+      ...config.services
+    },
+    
+    ...config
+  };
+
+  return StandardAgent.createCustomerServiceAgent(defaultConfig);
+}
+
+/**
+ * Create a general-purpose agent with minimal configuration.
+ * Good starting point for custom implementations.
+ */
+export function createGenericAgent(config: Partial<AgentConfig>): StandardAgent {
+  const defaultConfig: AgentConfig = {
+    name: config.name || 'Generic Agent',
+    description: config.description || 'General-purpose AI agent',
+    
+    tools: {
+      enableRAG: false,
+      enableMCP: false,
+      enableAgentKit: false,
+      ...config.tools
+    },
+    
+    prompt: {
+      systemMessage: config.prompt?.systemMessage || 'You are a helpful AI assistant.',
+      capabilities: config.prompt?.capabilities || ['general_assistance'],
+      enableConversationMemory: true,
+      ...config.prompt
+    },
+    
+    memory: {
+      enabled: true,
+      persistentThreadId: false,
+      maxMessages: 50,
+      ...config.memory
+    },
+    
+    services: {
+      messageService: false,
+      ragService: false,
+      analyticsService: false,
+      loggingEnabled: true,
+      ...config.services
+    },
+    
+    ...config
+  };
+
+  return new StandardAgent(defaultConfig);
+}
+
+/**
+ * Create an agent using a fluent builder pattern for complex configurations.
+ */
+export function createAgentBuilder(): AgentBuilder {
+  return new AgentBuilder();
+}
+
+/**
+ * Create a Solana token analysis agent using DexScreener MCP tools.
+ * Specialized for discovering trending tokens, market analysis, and risk assessment.
+ */
+export function createSolanaAnalysisAgent(config: Partial<DataAnalysisAgentConfig> = {}): StandardAgent {
+  const defaultConfig: AgentConfig = {
+    name: config.name || 'Solana Analysis Agent',
+    description: config.description || 'AI agent specialized in Solana token analysis and market discovery',
+    
+    tools: {
+      enableMCP: true,
+      enableRAG: true,
+      mcpServerUrl: config.tools?.mcpServerUrl || process.env.DEXSCREENER_MCP_URL || 'http://localhost:3010',
+      ragServerUrl: config.tools?.ragServerUrl || process.env.RAG_MCP_URL || 'http://localhost:3002',
+      ...config.tools
+    },
+    
+    prompt: {
+      systemMessage: `You are an AI Solana Token Analysis Agent with access to real-time DexScreener data. You specialize in discovering trending tokens, analyzing market conditions, and providing risk assessments for the high-volatility Solana ecosystem.`,
+      capabilities: [
+        'solana_token_discovery',
+        'trending_analysis',
+        'risk_assessment',
+        'market_insights',
+        'liquidity_analysis',
+        'momentum_tracking',
+        'opportunity_identification'
+      ],
+      context: `
+        **🌟 Solana Token Analysis Capabilities:**
+        - Real-time trending token discovery via DexScreener API
+        - Quality filtering with minimum liquidity, volume, and price change thresholds
+        - Multi-DEX coverage: Raydium, Orca, Jupiter, Serum, and more
+        - Advanced market insights and risk categorization
+        
+        **🔍 Available DexScreener Tools:**
+        - get_trending_tokens: Find momentum opportunities and popular tokens
+        - get_latest_tokens: Discover new launches and emerging opportunities
+        - analyze_trending_tokens: Comprehensive market analysis with risk assessment
+        - get_server_context: AI agent guidance and best practices
+        
+        **⚠️ Risk Assessment Framework:**
+        - High Risk: <$10k liquidity, >100% price moves, new tokens, single DEX
+        - Medium Risk: $10-100k liquidity, 20-100% moves, limited history
+        - Lower Risk: >$100k liquidity, multiple DEXs, stable trading patterns
+        
+        **🚀 Solana Ecosystem Context:**
+        - Fast transactions (400ms blocks), low fees (<$0.01)
+        - High volatility environment with community-driven tokens
+        - DEX-centric trading with Pump.fun launches common
+        - Quick momentum shifts in meme token ecosystem
+        
+        **🎯 Always emphasize the high-risk nature of new/trending tokens and provide clear risk levels with every recommendation.**
+      `,
+      enableConversationMemory: true,
+      ...config.prompt
+    },
+    
+    memory: {
+      enabled: true,
+      persistentThreadId: true,
+      maxMessages: 100,
+      ...config.memory
+    },
+    
+    services: {
+      messageService: true,
+      ragService: true,
+      analyticsService: true,
+      loggingEnabled: true,
+      ...config.services
+    },
+    
+    ...config
+  };
+
+  return StandardAgent.createDataAnalysisAgent(defaultConfig);
+}
+
+/**
+ * Create a multi-chain market data agent using the enhanced data-collector MCP tools.
+ * Supports Hyperliquid L1 and EVM chains with advanced market intelligence.
+ */
+export function createMarketDataAgent(config: Partial<DataAnalysisAgentConfig> = {}): StandardAgent {
+  const defaultConfig: AgentConfig = {
+    name: config.name || 'Market Data Agent',
+    description: config.description || 'AI agent for multi-chain market data analysis with enhanced OHLCV capabilities',
+    
+    tools: {
+      enableMCP: true,
+      enableRAG: true,
+      mcpServerUrl: config.tools?.mcpServerUrl || process.env.DATA_COLLECTOR_MCP_URL || 'http://localhost:8003',
+      ragServerUrl: config.tools?.ragServerUrl || process.env.RAG_MCP_URL || 'http://localhost:3002',
+      ...config.tools
+    },
+    
+    prompt: {
+      systemMessage: `You are an AI Market Data Agent with access to cutting-edge multi-chain market intelligence. You can analyze price data, orderbooks, trading intensity, and provide enhanced OHLCV data across Hyperliquid L1 and EVM chains.`,
+      capabilities: [
+        'multi_chain_analysis',
+        'enhanced_ohlcv_construction',
+        'orderbook_analysis',
+        'trading_intensity_metrics',
+        'token_discovery',
+        'symbol_resolution',
+        'performance_monitoring',
+        'cross_chain_comparison'
+      ],
+      context: `
+        **🔥 Enhanced Market Data Capabilities:**
+        - Multi-Chain Support: Hyperliquid L1 (94% complete) + EVM chains (Ethereum, Arbitrum, Base, etc.)
+        - Enhanced OHLCV: Breakthrough intelligent ticks-to-candlesticks aggregation
+        - Real-time orderbook data with bid-ask spread analysis
+        - Trading intensity metrics with activity scoring
+        - Universal symbol resolution across all supported chains
+        
+        **🛠️ Available MCP Tools:**
+        - get_token_price: Latest prices for any token on supported chains
+        - get_token_volume: Volume data with configurable intervals and token formats
+        - get_orderbook: Real-time orderbook with depth control
+        - get_enhanced_ohlcv: Professional OHLCV data from high-resolution ticks (BREAKTHROUGH!)
+        - discover_tokens: AI-optimized token discovery with filtering and sorting
+        - get_trading_intensity: Activity metrics with automated scoring
+        - resolve_symbol: Universal symbol-to-metadata resolution
+        - get_performance_metrics: System latency and optimization insights
+        
+        **🎯 Key Features:**
+        - Hyperliquid Token Format Support: spot, perp, auto-detection
+        - Configurable parameters via centralized calculation engine
+        - Cost-optimized on-demand architecture (90%+ API cost reduction)
+        - ~264ms average latency for complex Enhanced OHLCV operations
+        
+        **💡 AI Optimization Notes:**
+        - Use tokenFormat=spot for spot tokens like PURR/USDC
+        - Use tokenFormat=perp for perpetual tokens like BTC, ETH
+        - Use tokenFormat=auto for intelligent detection (tries perp first)
+        - Enhanced OHLCV is the first system to overcome Hyperliquid API limitations
+      `,
+      enableConversationMemory: true,
+      ...config.prompt
+    },
+    
+    memory: {
+      enabled: true,
+      persistentThreadId: true,
+      maxMessages: 120,
+      ...config.memory
+    },
+    
+    services: {
+      messageService: true,
+      ragService: true,
+      analyticsService: true,
+      loggingEnabled: true,
+      ...config.services
+    },
+    
+    ...config
+  };
+
+  return StandardAgent.createDataAnalysisAgent(defaultConfig);
+}
+
+/**
+ * Create a RAG-enhanced trading agent with comprehensive knowledge retrieval and decision support.
+ * Integrates dual-layer RAG (concept + history) with market data and Solana analysis capabilities.
+ * 
+ * This agent represents the Phase 2 RAG-Agent Integration from the Consolidation Memorandum.
+ */
+export function createRAGEnhancedTradingAgent(config: Partial<TradingAgentConfig> = {}): StandardAgent {
+  const defaultConfig: AgentConfig = {
+    name: config.name || 'RAG-Enhanced Trading Agent',
+    description: config.description || 'Advanced AI trading agent with dual-layer RAG knowledge retrieval, historical decision analysis, and comprehensive market intelligence',
+    
+    tools: {
+      enableMCP: true,
+      enableRAG: true,
+      enableAgentKit: true,
+      mcpServerUrl: config.tools?.mcpServerUrl || process.env.HUMMINGBOT_MCP_URL || 'http://localhost:8000',
+      ragServerUrl: config.tools?.ragServerUrl || process.env.RAG_MCP_URL || 'http://localhost:3002',
+      ...config.tools
+    },
+    
+    prompt: {
+      systemMessage: `You are an advanced RAG-Enhanced Trading Agent with comprehensive knowledge retrieval and decision support capabilities. You combine real-time market data with historical analysis and conceptual knowledge for informed trading decisions.`,
+      capabilities: [
+        'dual_layer_rag_search',
+        'historical_decision_analysis',
+        'market_context_enrichment',
+        'knowledge_base_search',
+        'comprehensive_market_intelligence',
+        'risk_assessment_with_history',
+        'trading_strategy_optimization',
+        'decision_feedback_loop'
+      ],
+      context: `
+        **🧠 Dual-Layer RAG Architecture:**
+        - **Concept Layer**: Trading documentation, strategy guides, risk management principles, market analysis frameworks
+        - **History Layer**: Past trading decisions, performance data, execution logs, market patterns, strategy outcomes
+        - **Parallel Processing**: Simultaneous search across both layers for comprehensive context
+        - **Source Provenance**: Clear attribution of information sources for trust and verification
+        
+        **📊 RAG-Enhanced Trading Capabilities:**
+        
+        **Knowledge Base Search:**
+        - search_knowledge_base: Find relevant trading concepts and historical patterns
+        - retrieve_contextual_information: Get comprehensive context from both concept and history layers
+        - comprehensive_search: Deep analysis with layer statistics and performance tracking
+        
+        **Historical Decision Analysis:**
+        - get_historical_decisions: Lookup past trading decisions and their outcomes
+        - Performance feedback loop: Learn from historical successes and failures
+        - Pattern recognition: Identify recurring market conditions and strategy effectiveness
+        
+        **Market Context Enrichment:**
+        - enrich_market_context: Combine conceptual knowledge with historical patterns
+        - Multi-dimensional analysis: Technical, fundamental, and sentiment perspectives
+        - Risk-adjusted insights: Historical context for current market conditions
+        
+        **🔄 Decision-Making Framework:**
+        1. **Context Retrieval**: Search knowledge base for relevant trading concepts
+        2. **Historical Analysis**: Review similar past decisions and outcomes
+        3. **Market Enrichment**: Combine current data with historical patterns
+        4. **Risk Assessment**: Historical risk analysis with current market conditions
+        5. **Strategy Selection**: Data-driven strategy choice based on historical performance
+        6. **Execution Decision**: Informed decision with full context and risk awareness
+        7. **Feedback Loop**: Store decision and outcome for future learning
+        
+        **⚠️ RAG-Enhanced Risk Management:**
+        - Historical volatility patterns and their outcomes
+        - Past strategy performance in similar market conditions
+        - Risk-adjusted returns based on historical data
+        - Market regime identification using historical patterns
+        - Adaptive position sizing based on historical drawdowns
+        
+        **🎯 Trading Integration:**
+        - Combine RAG insights with real-time market data (Hyperliquid, Solana DEXs)
+        - Historical context for technical analysis and pattern recognition
+        - Strategy validation using historical backtesting data
+        - Continuous learning and adaptation based on decision outcomes
+        
+        **📈 Performance Enhancement:**
+        - Historical decision lookup for strategy optimization
+        - Market context enrichment for better timing decisions
+        - Comprehensive search for edge case handling
+        - Knowledge base status monitoring for system health
+        
+        **Always leverage both historical experience and conceptual knowledge to make well-informed trading decisions with proper risk management based on historical patterns.**
+      `,
+      enableConversationMemory: true,
+      ...config.prompt
+    },
+    
+    memory: {
+      enabled: true,
+      persistentThreadId: true,
+      maxMessages: 150,
+      ...config.memory
+    },
+    
+    services: {
+      messageService: true,
+      ragService: true,
+      analyticsService: true,
+      loggingEnabled: true,
+      ...config.services
+    },
+    
+    ...config
+  };
+
+  return StandardAgent.createTradingAgent(defaultConfig);
+}
+
+/**
+ * Create an agent from environment variables.
+ * Useful for deployment scenarios where configuration comes from env vars.
+ */
+export function createAgentFromEnvironment(overrides: Partial<AgentConfig> = {}): StandardAgent {
+  const envConfig = AgentUtils.getEnvironmentConfig();
+  const finalConfig = { ...envConfig, ...overrides };
+  
+  const validation = AgentUtils.validateConfig(finalConfig);
+  if (!validation.valid) {
+    throw new Error(`Invalid agent configuration: ${validation.errors.join(', ')}`);
+  }
+  
+  return new StandardAgent(finalConfig);
+} 
+
+/**
+ * Create a DeFi Yield Optimization agent with comprehensive yield farming,
+ * risk assessment, and portfolio optimization capabilities.
+ */
+export function createDeFiYieldAgent(config: Partial<DataAnalysisAgentConfig> = {}): StandardAgent {
+  const defaultConfig: AgentConfig = {
+    name: config.name || 'DeFi Yield Optimizer',
+    description: config.description || 'AI agent specialized in DeFi yield optimization, risk assessment, and portfolio management',
+    
+    tools: {
+      enableMCP: true,
+      enableRAG: true,
+      enableAgentKit: true,
+      mcpServerUrl: config.tools?.mcpServerUrl || process.env.APY_STRATEGY_MCP_URL || 'http://localhost:3008',
+      ragServerUrl: config.tools?.ragServerUrl || process.env.RAG_MCP_URL || 'http://localhost:3002',
+      ...config.tools
+    },
+    
+    prompt: {
+      systemMessage: `You are an AI DeFi Yield Optimization Agent with access to comprehensive yield farming, liquidity mining, and protocol analysis capabilities. You specialize in finding optimal yield opportunities, managing portfolio risk, and maximizing returns across DeFi protocols.`,
+      capabilities: [
+        'defi_yield_optimization',
+        'protocol_risk_assessment',
+        'cross_chain_arbitrage',
+        'portfolio_optimization',
+        'yield_strategy_backtesting',
+        'automated_rebalancing',
+        'mev_protection',
+        'smart_contract_analysis',
+        'liquidity_mining',
+        'yield_farming_strategies'
+      ],
+      context: `
+        **🏦 DeFi Yield Optimization Capabilities:**
+        - **Multi-Chain Yield Discovery**: Find optimal yield opportunities across Ethereum, Arbitrum, Polygon, Base, Optimism
+        - **Advanced Portfolio Optimization**: AI-driven allocation using Maximum Sharpe, Risk Parity, and Mean-Variance optimization
+        - **Real-Time Risk Assessment**: VaR calculation, correlation analysis, stress testing, and protocol risk evaluation
+        - **Strategy Backtesting**: Historical performance simulation with transaction costs and slippage modeling
+        - **Cross-Chain Arbitrage**: Detect and analyze arbitrage opportunities across chains and protocols
+        - **Performance Tracking**: Real-time yield monitoring with attribution analysis and benchmark comparison
+        - **Automated Rebalancing**: Smart rebalancing with MEV protection and gas optimization
+        - **Protocol Analysis**: Deep-dive risk assessment of DeFi protocols including smart contract audits
+        
+        **⚡ Available DeFi Operations:**
+        
+        **Yield Discovery & Analysis:**
+        - find_yield_opportunities: Discover high-APY opportunities across 200+ DeFi protocols
+        - get_apy_history: Analyze historical yield data with trend analysis and volatility metrics
+        - assess_protocol_risk: Comprehensive protocol risk evaluation including audit scores
+        
+        **Portfolio Optimization:**
+        - optimize_yield_allocation: AI-driven portfolio optimization with risk constraints
+        - calculate_portfolio_risk: Real-time VaR, correlation, and concentration risk analysis
+        - track_yield_performance: Performance monitoring with attribution and benchmark analysis
+        
+        **Advanced Analytics:**
+        - analyze_arbitrage_opportunities: Cross-chain and cross-protocol arbitrage detection
+        - backtest_strategy: Historical strategy simulation with comprehensive cost modeling
+        
+        **🔄 DeFi Workflow:**
+        1. **Market Scanning**: Scan yield opportunities across multiple chains and protocols
+        2. **Risk Assessment**: Evaluate protocol risks, smart contract audits, and market conditions
+        3. **Portfolio Optimization**: Use mathematical optimization to determine optimal allocations
+        4. **Strategy Backtesting**: Test strategies against historical data with realistic costs
+        5. **Execution Planning**: Plan deposits, withdrawals, and rebalancing with MEV protection
+        6. **Performance Monitoring**: Track yields, attributions, and risk metrics in real-time
+        7. **Continuous Optimization**: Automated rebalancing and strategy refinement
+        
+        **🎯 Supported Protocols & Features:**
+        - **Lending Protocols**: Aave, Compound, Euler, Radiant Capital, etc.
+        - **DEX Liquidity**: Uniswap V3, Curve, Balancer, Velodrome, etc.
+        - **Yield Farming**: Convex, Yearn, Beefy, etc.
+        - **Liquid Staking**: Lido, Rocket Pool, Frax, etc.
+        - **Cross-Chain**: Native bridges, LayerZero, Synapse, etc.
+        
+        **⚙️ Configuration Guidelines:**
+        - **Risk Tolerance**: Set max protocol allocation (default 25%), max risk score limits
+        - **Optimization Strategy**: Choose Maximum Sharpe Ratio, Risk Parity, or Mean-Variance
+        - **Rebalancing**: Configure thresholds (default 2%) and frequency (daily/weekly/monthly)
+        - **Gas Optimization**: Consider transaction costs in all strategy decisions
+        - **MEV Protection**: Use private mempools and slippage protection for large transactions
+        
+        **🛡️ Risk Management Framework:**
+        - **Portfolio Risk Limits**: VaR thresholds, concentration limits, correlation constraints
+        - **Protocol Due Diligence**: Smart contract audits, TVL stability, governance analysis
+        - **Liquidity Assessment**: Exit liquidity, impermanent loss analysis, slippage estimation
+        - **Market Risk**: Volatility analysis, correlation monitoring, stress testing scenarios
+        
+        **📈 Performance Analytics:**
+        - **Yield Attribution**: Break down performance by protocol, asset, chain, and strategy
+        - **Risk-Adjusted Returns**: Sharpe ratio, Sortino ratio, maximum drawdown analysis
+        - **Benchmark Comparison**: Compare against passive strategies and market indices
+        - **Cost Analysis**: Track gas costs, slippage, and protocol fees impact on returns
+        
+        **🚨 Alert System:**
+        - **Risk Alerts**: Portfolio VaR breaches, concentration risk, protocol issues
+        - **Performance Alerts**: Underperformance, negative yields, high slippage
+        - **Market Alerts**: Significant APY changes, new opportunities, protocol updates
+        - **Rebalancing Alerts**: When portfolio drift exceeds thresholds
+        
+        Before making any DeFi recommendations, always:
+        1. Assess current market conditions and protocol health
+        2. Evaluate risk-adjusted returns, not just raw APY
+        3. Consider transaction costs and gas fees in all calculations
+        4. Check for protocol audits and security track record
+        5. Analyze liquidity and potential exit scenarios
+        
+        **Always prioritize capital preservation and risk management over maximum yield. Focus on sustainable, risk-adjusted returns with proper diversification across protocols and chains.**
+      `,
+      enableConversationMemory: true,
+      ...config.prompt
+    },
+    
+    memory: {
+      enabled: true,
+      persistentThreadId: true,
+      maxMessages: 150,
+      ...config.memory
+    },
+    
+    services: {
+      messageService: true,
+      ragService: true,
+      analyticsService: true,
+      loggingEnabled: true,
+      ...config.services
+    },
+    
+    ...config
+  };
+
+  return StandardAgent.createDataAnalysisAgent(defaultConfig);
+} 

package/src/global.d.ts

@@ -0,0 +1,12 @@
+// Global type declarations for Node.js environment
+declare namespace NodeJS {
+  interface ProcessEnv {
+    [key: string]: string | undefined;
+  }
+
+  interface Process {
+    env: ProcessEnv;
+  }
+}
+
+declare const process: NodeJS.Process;