@autonomaai/agent-core 1.0.2

package/dist/error-handler.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Standardized Error Handling for autonoma Agents
+ *
+ * Provides consistent error handling, logging, and user-friendly messages
+ * across all agent implementations.
+ */
+export interface ErrorMetadata {
+    executionTime: number;
+    errorType: string;
+    agentName: string;
+    timestamp: string;
+}
+export interface StandardErrorResponse {
+    error: string;
+    timestamp: string;
+    metadata?: ErrorMetadata;
+    statusCode?: number;
+}
+/**
+ * Configuration for agent-specific error messages
+ */
+export declare const AGENT_ERROR_CONFIGS: {
+    readonly 'market-maker': {
+        readonly name: "Market Maker Agent";
+        readonly defaultMessage: "I'm sorry, I encountered an error while processing your trading request. Please check your connection and try again.";
+        readonly errorPrefix: "Trading Error";
+    };
+    readonly apy: {
+        readonly name: "DeFi Yield Agent";
+        readonly defaultMessage: "I'm sorry, I encountered an error while processing your DeFi request. Please check your connection and try again.";
+        readonly errorPrefix: "DeFi Error";
+    };
+    readonly 'portfolio-manager': {
+        readonly name: "Portfolio Manager Agent";
+        readonly defaultMessage: "I'm sorry, I encountered an error while processing your portfolio request. Please check your connection and try again.";
+        readonly errorPrefix: "Portfolio Error";
+    };
+    readonly memecoin: {
+        readonly name: "Memecoin Agent";
+        readonly defaultMessage: "I'm sorry, I encountered an error while analyzing memecoins. Please check your connection and try again.";
+        readonly errorPrefix: "Memecoin Error";
+    };
+    readonly orchestrator: {
+        readonly name: "Agent Orchestrator";
+        readonly defaultMessage: "I'm sorry, I encountered an error while coordinating agents. Please check your connection and try again.";
+        readonly errorPrefix: "Orchestrator Error";
+    };
+};
+export type AgentType = keyof typeof AGENT_ERROR_CONFIGS;
+/**
+ * Standardized error handler for all autonoma agents
+ */
+export declare class AgentErrorHandler {
+    private agentType;
+    private startTime;
+    constructor(agentType: AgentType, startTime?: number);
+    /**
+     * Handle and format errors with consistent logging and user messages
+     */
+    handleError(error: unknown, customMessage?: string): StandardErrorResponse;
+    /**
+     * Handle validation errors specifically
+     */
+    handleValidationError(field: string, issue: string): StandardErrorResponse;
+    /**
+     * Handle service unavailable errors (like MCP servers down)
+     */
+    handleServiceUnavailable(serviceName: string): StandardErrorResponse;
+}
+/**
+ * Quick factory function for creating error handlers
+ */
+export declare function createErrorHandler(agentType: AgentType, startTime?: number): AgentErrorHandler;
+/**
+ * Simple error response for cases where we don't need the full handler
+ */
+export declare function createErrorResponse(agentType: AgentType, error: unknown, customMessage?: string): StandardErrorResponse;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BtB,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,mBAAmB,CAAC;AAEzD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,EAAE,SAAS,EAAE,SAAS,GAAE,MAAmB;IAKhE;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,qBAAqB;IAgC1E;;OAEG;IACH,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,qBAAqB;IAoB1E;;OAEG;IACH,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,qBAAqB;CAmBrE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAE9F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,OAAO,EACd,aAAa,CAAC,EAAE,MAAM,GACrB,qBAAqB,CAGvB"}

package/dist/error-handler.js

@@ -0,0 +1,129 @@
+/**
+ * Standardized Error Handling for autonoma Agents
+ *
+ * Provides consistent error handling, logging, and user-friendly messages
+ * across all agent implementations.
+ */
+/**
+ * Configuration for agent-specific error messages
+ */
+export const AGENT_ERROR_CONFIGS = {
+    'market-maker': {
+        name: 'Market Maker Agent',
+        defaultMessage: "I'm sorry, I encountered an error while processing your trading request. Please check your connection and try again.",
+        errorPrefix: "Trading Error"
+    },
+    'apy': {
+        name: 'DeFi Yield Agent',
+        defaultMessage: "I'm sorry, I encountered an error while processing your DeFi request. Please check your connection and try again.",
+        errorPrefix: "DeFi Error"
+    },
+    'portfolio-manager': {
+        name: 'Portfolio Manager Agent',
+        defaultMessage: "I'm sorry, I encountered an error while processing your portfolio request. Please check your connection and try again.",
+        errorPrefix: "Portfolio Error"
+    },
+    'memecoin': {
+        name: 'Memecoin Agent',
+        defaultMessage: "I'm sorry, I encountered an error while analyzing memecoins. Please check your connection and try again.",
+        errorPrefix: "Memecoin Error"
+    },
+    'orchestrator': {
+        name: 'Agent Orchestrator',
+        defaultMessage: "I'm sorry, I encountered an error while coordinating agents. Please check your connection and try again.",
+        errorPrefix: "Orchestrator Error"
+    }
+};
+/**
+ * Standardized error handler for all autonoma agents
+ */
+export class AgentErrorHandler {
+    constructor(agentType, startTime = Date.now()) {
+        this.agentType = agentType;
+        this.startTime = startTime;
+    }
+    /**
+     * Handle and format errors with consistent logging and user messages
+     */
+    handleError(error, customMessage) {
+        const config = AGENT_ERROR_CONFIGS[this.agentType];
+        const timestamp = new Date().toISOString();
+        const executionTime = Date.now() - this.startTime;
+        // Enhanced error logging for debugging
+        const errorDetails = {
+            agent: config.name,
+            message: error instanceof Error ? error.message : 'Unknown error',
+            stack: error instanceof Error ? error.stack : undefined,
+            timestamp,
+            executionTime
+        };
+        console.error(`${config.errorPrefix}:`, errorDetails);
+        // User-friendly error message
+        const userMessage = customMessage || config.defaultMessage;
+        return {
+            error: userMessage,
+            timestamp,
+            statusCode: 500,
+            metadata: {
+                executionTime,
+                errorType: error instanceof Error ? error.constructor.name : 'UnknownError',
+                agentName: config.name,
+                timestamp
+            }
+        };
+    }
+    /**
+     * Handle validation errors specifically
+     */
+    handleValidationError(field, issue) {
+        const config = AGENT_ERROR_CONFIGS[this.agentType];
+        const timestamp = new Date().toISOString();
+        const executionTime = Date.now() - this.startTime;
+        console.error(`${config.errorPrefix} - Validation:`, { field, issue, timestamp });
+        return {
+            error: `Invalid request: ${field} ${issue}`,
+            timestamp,
+            statusCode: 400,
+            metadata: {
+                executionTime,
+                errorType: 'ValidationError',
+                agentName: config.name,
+                timestamp
+            }
+        };
+    }
+    /**
+     * Handle service unavailable errors (like MCP servers down)
+     */
+    handleServiceUnavailable(serviceName) {
+        const config = AGENT_ERROR_CONFIGS[this.agentType];
+        const timestamp = new Date().toISOString();
+        const executionTime = Date.now() - this.startTime;
+        console.warn(`${config.errorPrefix} - Service Unavailable:`, { serviceName, timestamp });
+        return {
+            error: `I'm currently unable to access the ${serviceName} service. I can still help with general questions and guidance. Please try again later for advanced features.`,
+            timestamp,
+            statusCode: 503,
+            metadata: {
+                executionTime,
+                errorType: 'ServiceUnavailableError',
+                agentName: config.name,
+                timestamp
+            }
+        };
+    }
+}
+/**
+ * Quick factory function for creating error handlers
+ */
+export function createErrorHandler(agentType, startTime) {
+    return new AgentErrorHandler(agentType, startTime);
+}
+/**
+ * Simple error response for cases where we don't need the full handler
+ */
+export function createErrorResponse(agentType, error, customMessage) {
+    const handler = new AgentErrorHandler(agentType);
+    return handler.handleError(error, customMessage);
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"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"}

package/dist/factory.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Factory functions for creating pre-configured agents.
+ *
+ * Provides convenient functions for creating agents optimized for specific use cases
+ * with appropriate defaults and capabilities.
+ */
+import { AgentConfig, TradingAgentConfig, DataAnalysisAgentConfig, CustomerServiceAgentConfig } from './types.js';
+import { StandardAgent, AgentBuilder } from './core.js';
+/**
+ * Create a trading agent with pre-configured capabilities for market making,
+ * exchange connectivity, and risk management.
+ */
+export declare function createTradingAgent(config?: Partial<TradingAgentConfig>): StandardAgent;
+/**
+ * Create a data analysis agent optimized for market research,
+ * pattern recognition, and report generation.
+ */
+export declare function createDataAnalysisAgent(config?: Partial<DataAnalysisAgentConfig>): StandardAgent;
+/**
+ * Create a customer service agent optimized for answering questions,
+ * knowledge base search, and issue resolution.
+ */
+export declare function createCustomerServiceAgent(config?: Partial<CustomerServiceAgentConfig>): StandardAgent;
+/**
+ * Create a general-purpose agent with minimal configuration.
+ * Good starting point for custom implementations.
+ */
+export declare function createGenericAgent(config: Partial<AgentConfig>): StandardAgent;
+/**
+ * Create an agent using a fluent builder pattern for complex configurations.
+ */
+export declare function createAgentBuilder(): AgentBuilder;
+/**
+ * Create a Solana token analysis agent using DexScreener MCP tools.
+ * Specialized for discovering trending tokens, market analysis, and risk assessment.
+ */
+export declare function createSolanaAnalysisAgent(config?: Partial<DataAnalysisAgentConfig>): StandardAgent;
+/**
+ * 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 declare function createMarketDataAgent(config?: Partial<DataAnalysisAgentConfig>): StandardAgent;
+/**
+ * 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 declare function createRAGEnhancedTradingAgent(config?: Partial<TradingAgentConfig>): StandardAgent;
+/**
+ * Create an agent from environment variables.
+ * Useful for deployment scenarios where configuration comes from env vars.
+ */
+export declare function createAgentFromEnvironment(overrides?: Partial<AgentConfig>): StandardAgent;
+/**
+ * Create a DeFi Yield Optimization agent with comprehensive yield farming,
+ * risk assessment, and portfolio optimization capabilities.
+ */
+export declare function createDeFiYieldAgent(config?: Partial<DataAnalysisAgentConfig>): StandardAgent;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAClH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAc,MAAM,WAAW,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAAG,aAAa,CA+D1F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAAG,aAAa,CA4DpG;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAAG,aAAa,CAyD1G;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,aAAa,CAsC9E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAAG,aAAa,CAyEtG;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAAG,aAAa,CA8ElG;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAAG,aAAa,CAuGrG;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,aAAa,CAU9F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAAG,aAAa,CAgIjG"}