@runflow-ai/sdk 1.0.18 → 1.0.19

package/dist/core/agent.js

@@ -4,33 +4,42 @@ exports.Agent = void 0;
 const trace_collector_1 = require("../observability/trace-collector");
 const api_client_1 = require("./api-client");
 const context_1 = require("./context");
+const logger_1 = require("./logger");
+const performance_logger_1 = require("./performance-logger");
+const agent_memory_1 = require("./helpers/agent-memory");
+const agent_rag_1 = require("./helpers/agent-rag");
+const agent_context_1 = require("./helpers/agent-context");
+const agent_utils_1 = require("./helpers/agent-utils");
 // ============================================================================
 // AGENT CLASS
 // ============================================================================
 class Agent {
     constructor(config) {
         this.config = config;
+        // Configurar logger
+        this.logger = (0, logger_1.createLogger)({
+            name: `agent:${config.name}`,
+            level: this.resolveLogLevel(config.debug),
+            enabled: config.debug !== false,
+        });
         // ============================================================================
         // AUTO-CREATE RAG TOOLS (Agentic RAG)
         // ============================================================================
         // Se RAG configurado, criar tools automaticamente
         // LLM decide quando buscar (não busca sempre)
         if (config.rag) {
-            console.log('🔍 [SDK Agent] Creating RAG tools automatically...');
-            const ragTools = this.createRAGTools(config.rag);
+            this.logger.debug('RAG configuration detected, creating tools');
+            const ragTools = (0, agent_rag_1.createRAGTools)(config.rag, this.logger);
             this.config.tools = {
                 ...ragTools,
                 ...config.tools,
             };
-            console.log(`✅ [SDK Agent] Created ${Object.keys(ragTools).length} RAG tool(s):`, Object.keys(ragTools));
             // Injetar searchPrompt nas instructions (orienta quando buscar)
             if (config.rag.searchPrompt) {
                 this.config.instructions += `\n\n${config.rag.searchPrompt}`;
-                console.log('📝 [SDK Agent] Injected searchPrompt into instructions');
+                this.logger.debug('Search prompt injected into instructions');
             }
         }
-        // Configurar debug
-        this.debugConfig = this.resolveDebugConfig(config.debug);
         // Auto-initialize API client if not in execution context
         if (!this.apiClient) {
             this.apiClient = (0, api_client_1.createRunflowAPIClient)();
@@ -40,32 +49,34 @@ class Agent {
                 batchSize: 1, // Flush imediatamente após cada trace
                 flushInterval: 1000,
             });
-            console.log('🔍 [SDK Agent] Trace collector initialized in constructor with projectId:', projectId);
         }
     }
     // Injetar API client (feito pela execution engine)
     _setAPIClient(apiClient) {
-        this.apiClient = apiClient;
-        // Use agentId from environment or config name as fallback
         const projectId = process.env.RUNFLOW_AGENT_ID || this.config.name.toLowerCase().replace(/\s+/g, '-');
+        this.logger.debug('Setting API client', { projectId });
+        this.apiClient = apiClient;
         this.traceCollector = (0, trace_collector_1.createTraceCollector)(apiClient, projectId, {
             batchSize: 1, // Flush imediatamente após cada trace
             flushInterval: 1000,
         });
-        console.log('🔍 [SDK Agent] Trace collector initialized via _setAPIClient with projectId:', projectId);
     }
     // Geração simples (aceita string ou array de messages)
     async generate(input) {
         const isMessagesArray = Array.isArray(input);
-        console.log('💬 [SDK Agent] Generate called with', isMessagesArray ? `${input.length} messages` : `prompt length: ${input.length}`);
         if (!this.apiClient) {
-            console.error('❌ [SDK Agent] API client not initialized!');
+            this.logger.error('API client not initialized');
             throw new Error('Agent not initialized. API client not set.');
         }
-        console.log('🌐 [SDK Agent] Calling chat API...');
         const messages = isMessagesArray
             ? input
             : [{ role: 'user', content: input }];
+        this.logger.debug('Starting generation', {
+            messagesCount: messages.length,
+            isMessagesArray,
+            provider: this.config.model.provider,
+            model: this.config.model.model
+        });
         const chatRequest = {
             projectId: '', // Será injetado pela engine
             provider: this.config.model.provider,
@@ -80,22 +91,32 @@ class Agent {
             stop: this.config.modelConfig?.stop,
             seed: this.config.modelConfig?.seed,
         };
-        console.log('📡 [SDK Agent] Chat request:', JSON.stringify(chatRequest, null, 2));
         try {
             const response = await this.apiClient.chat(chatRequest);
-            console.log('✅ [SDK Agent] Chat response received:', response);
+            this.logger.debug('Generation completed', {
+                responseLength: response.text?.length || 0,
+                usage: response.usage
+            });
             return { text: response.text };
         }
         catch (error) {
-            console.error('❌ [SDK Agent] Chat API failed:', error);
+            this.logger.error('Chat API failed', {
+                error: error instanceof Error ? error.message : 'Unknown error'
+            });
             throw error;
         }
     }
     // Geração com streaming
     async generateStream(prompt) {
         if (!this.apiClient) {
+            this.logger.error('API client not initialized for streaming');
             throw new Error('Agent not initialized. API client not set.');
         }
+        this.logger.debug('Starting stream generation', {
+            promptLength: prompt.length,
+            provider: this.config.model.provider,
+            model: this.config.model.model
+        });
         const stream = this.apiClient.chatStream({
             projectId: '',
             provider: this.config.model.provider,
@@ -110,26 +131,38 @@ class Agent {
             stop: this.config.modelConfig?.stop,
             seed: this.config.modelConfig?.seed,
         });
-        return this.processStreamChunks(stream);
+        return (0, agent_utils_1.processStreamChunks)(stream, this.logger);
     }
     // Geração com tools (implementa loop de tool calling)
     async generateWithTools(input) {
         if (!this.apiClient) {
+            this.logger.error('API client not initialized for tool generation');
             throw new Error('Agent not initialized. API client not set.');
         }
         if (!this.config.tools || Object.keys(this.config.tools).length === 0) {
+            this.logger.debug('No tools configured, falling back to simple generation');
             return this.generate(input);
         }
         const isMessagesArray = Array.isArray(input);
         let messages = isMessagesArray
             ? [...input]
             : [{ role: 'user', content: input }];
+        this.logger.debug('Starting generation with tools', {
+            messagesCount: messages.length,
+            toolsCount: Object.keys(this.config.tools).length,
+            toolNames: Object.keys(this.config.tools)
+        });
         const maxIterations = this.config.maxToolIterations || 10; // Prevenir loops infinitos
         let iteration = 0;
         while (iteration < maxIterations) {
             iteration++;
-            console.log(`🔄 [SDK Agent] Tool calling iteration ${iteration}/${maxIterations}`);
+            this.logger.debug('Tool calling iteration', {
+                iteration,
+                maxIterations,
+                messagesCount: messages.length
+            });
             // 🔍 Trace: LLM Call
+            performance_logger_1.performanceLogger.start(`llm.call.${iteration}`);
             const llmStartTime = Date.now();
             const llmSpan = this.traceCollector?.startSpan('llm_call', {
                 provider: this.config.model.provider,
@@ -138,16 +171,12 @@ class Agent {
                 hasTools: true,
                 toolsCount: Object.keys(this.config.tools).length,
             });
-            // 🔍 Input do trace (detalhado se debug ativado)
+            // 🔍 Input do trace
             const llmInput = {
                 messagesCount: messages.length,
                 temperature: this.config.modelConfig?.temperature,
                 maxTokens: this.config.modelConfig?.maxTokens,
             };
-            if (this.debugConfig.logLLMCalls || this.debugConfig.logMessages) {
-                llmInput.messages = messages;
-                llmInput.instructions = this.config.instructions;
-            }
             llmSpan?.setInput(llmInput);
             const chatRequest = {
                 projectId: '', // Será injetado pela engine
@@ -165,17 +194,26 @@ class Agent {
                 seed: this.config.modelConfig?.seed,
             };
             const response = await this.apiClient.chat(chatRequest);
-            // 🔍 Output do trace (detalhado se debug ativado)
+            performance_logger_1.performanceLogger.end(`llm.call.${iteration}`, {
+                iteration,
+                hasToolCalls: !!response.toolCalls && response.toolCalls.length > 0,
+                toolCallsCount: response.toolCalls?.length || 0,
+                promptTokens: response.usage?.promptTokens,
+                completionTokens: response.usage?.completionTokens
+            });
+            this.logger.debug('LLM response received', {
+                iteration,
+                responseLength: response.text?.length || 0,
+                hasToolCalls: !!response.toolCalls && response.toolCalls.length > 0,
+                toolCallsCount: response.toolCalls?.length || 0,
+                usage: response.usage
+            });
+            // 🔍 Output do trace
             const llmOutput = {
                 responseLength: response.text?.length || 0,
                 hasToolCalls: !!response.toolCalls && response.toolCalls.length > 0,
                 toolCallsCount: response.toolCalls?.length || 0,
             };
-            if (this.debugConfig.logLLMCalls) {
-                llmOutput.responseText = response.text;
-                llmOutput.toolCalls = response.toolCalls;
-                llmOutput.usage = response.usage;
-            }
             llmSpan?.setOutput(llmOutput);
             llmSpan?.setMetadata({
                 provider: this.config.model.provider,
@@ -199,10 +237,12 @@ class Agent {
             llmSpan?.finish();
             // Se não há tool calls, retornar resposta final
             if (!response.toolCalls || response.toolCalls.length === 0) {
-                console.log('✅ [SDK Agent] No tool calls - returning final response');
+                this.logger.info('Generation completed without tool calls', {
+                    iteration,
+                    responseLength: response.text?.length || 0
+                });
                 return { text: response.text };
             }
-            console.log(`🛠️  [SDK Agent] Processing ${response.toolCalls.length} tool call(s)`);
             // Adicionar mensagem do assistente com tool calls
             messages.push({
                 role: 'assistant',
@@ -212,6 +252,11 @@ class Agent {
             // Executar cada tool call
             for (const toolCall of response.toolCalls) {
                 const toolName = toolCall.name;
+                this.logger.debug('Processing tool call', {
+                    toolName,
+                    toolCallId: toolCall.id,
+                    iteration
+                });
                 // Buscar tool por ID (pode estar com nome diferente da key no config)
                 let tool = this.config.tools[toolName];
                 // Se não encontrou, buscar por ID da tool
@@ -222,8 +267,10 @@ class Agent {
                     }
                 }
                 if (!tool) {
-                    console.error(`❌ [SDK Agent] Tool not found: ${toolName}`);
-                    console.error(`   Available tools:`, Object.keys(this.config.tools));
+                    this.logger.warn('Tool not found', {
+                        toolName,
+                        availableTools: Object.keys(this.config.tools)
+                    });
                     // Adicionar mensagem de erro
                     messages.push({
                         role: 'tool',
@@ -234,7 +281,6 @@ class Agent {
                     continue;
                 }
                 try {
-                    console.log(`🔧 [SDK Agent] Executing tool: ${toolName}`);
                     // 🔍 Iniciar trace da tool execution
                     const toolStartTime = Date.now();
                     const toolSpan = this.traceCollector?.startSpan('tool_call', {
@@ -249,20 +295,28 @@ class Agent {
                     }
                     // 🔍 Input sempre vai completo para o trace
                     toolSpan?.setInput(args);
-                    // Executar tool
-                    const toolResult = await tool.execute(args, {
-                        runflowAPI: this.apiClient,
-                        projectId: process.env.RUNFLOW_AGENT_ID || '',
-                        companyId: process.env.RUNFLOW_TENANT_ID || '',
-                    });
-                    console.log(`✅ [SDK Agent] Tool executed successfully: ${toolName}`, toolResult);
+                    // Executar tool com performance tracking
+                    const toolResult = await performance_logger_1.performanceLogger.measure(`tool.${toolName}`, async () => {
+                        return await tool.execute(args, {
+                            runflowAPI: this.apiClient,
+                            projectId: process.env.RUNFLOW_AGENT_ID || '',
+                            companyId: process.env.RUNFLOW_TENANT_ID || '',
+                        });
+                    }, { toolId: tool.id, iteration });
                     // 🔍 Output sempre vai completo para o trace
                     const toolEndTime = Date.now();
+                    const processingTimeMs = toolEndTime - toolStartTime;
+                    this.logger.info('Tool execution completed', {
+                        toolName,
+                        toolId: tool.id,
+                        processingTimeMs,
+                        iteration
+                    });
                     toolSpan?.setOutput(toolResult);
                     toolSpan?.setMetadata({
                         toolName,
                         toolId: tool.id,
-                        processingTimeMs: toolEndTime - toolStartTime,
+                        processingTimeMs,
                         success: true,
                     });
                     toolSpan?.finish();
@@ -275,7 +329,12 @@ class Agent {
                     });
                 }
                 catch (error) {
-                    console.error(`❌ [SDK Agent] Tool execution failed: ${toolName}`, error);
+                    this.logger.error('Tool execution failed', {
+                        toolName,
+                        toolId: tool.id,
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                        iteration
+                    });
                     // 🔍 Registrar erro no trace (se existe)
                     const toolSpan = this.traceCollector?.startSpan('tool_call', {
                         toolName,
@@ -303,30 +362,26 @@ class Agent {
             }
         }
         // Se chegou aqui, atingiu o limite de iterações
-        console.warn('⚠️ [SDK Agent] Max tool calling iterations reached');
+        this.logger.warn('Max tool calling iterations reached', {
+            maxIterations,
+            finalMessagesCount: messages.length
+        });
         return { text: 'Maximum tool calling iterations reached. Please try again.' };
     }
     // Processamento principal (chamado pela execution engine)
     async process(input, context) {
-        console.log('🤖 [SDK Agent] Starting process...');
-        console.log('📥 [SDK Agent] Input:', JSON.stringify(input, null, 2));
-        console.log('🔧 [SDK Agent] Config:', {
-            name: this.config.name,
-            model: this.config.model,
-            hasMemory: !!this.config.memory,
-            hasRAG: !!this.config.rag,
-            hasTools: !!(this.config.tools && Object.keys(this.config.tools).length > 0),
+        const processStartTime = Date.now();
+        performance_logger_1.performanceLogger.start('agent.process');
+        this.logger.info('Agent processing started', {
+            agentName: this.config.name,
+            messageLength: input.message?.length || 0,
+            sessionId: input.sessionId,
+            companyId: input.companyId
         });
         // Configurar API client com contexto
         if (context?.apiClient) {
-            console.log('🔗 [SDK Agent] Using injected API client from context');
             this._setAPIClient(context.apiClient);
         }
-        else {
-            console.log('🔗 [SDK Agent] Using auto-configured API client');
-            // this.apiClient já foi inicializado no constructor
-        }
-        console.log('🌐 [SDK Agent] API Client configured:', !!this.apiClient);
         // ============================================================================
         // RESOLVER EXECUTION CONTEXT (prioridade: input > state > env > inferência)
         // ============================================================================
@@ -334,27 +389,26 @@ class Agent {
         const executionId = input.executionId
             || state.executionId
             || process.env.RUNFLOW_EXECUTION_ID
-            || this.generateExecutionId();
+            || (0, agent_context_1.generateExecutionId)();
         const threadId = input.threadId
             || state.threadId
             || process.env.RUNFLOW_THREAD_ID
-            || this.generateThreadId(input);
+            || (0, agent_context_1.generateThreadId)(input, this.logger);
         const entityType = input.entityType
             || state.entityType
-            || this.inferEntityType(input);
+            || (0, agent_context_1.inferEntityType)(input, this.logger);
         const entityValue = input.entityValue
             || state.entityValue
-            || this.inferEntityValue(input);
+            || (0, agent_context_1.inferEntityValue)(input, this.logger);
         const userId = input.userId
             || state.userId
-            || this.inferUserId(input);
-        console.log('🔍 [SDK Agent] Execution Context:', {
+            || (0, agent_context_1.inferUserId)(input, this.logger);
+        this.logger.debug('Execution context resolved', {
             executionId,
             threadId,
             entityType,
-            entityValue: entityValue || '(none)',
-            userId: userId || '(none)',
-            source: input.threadId ? 'input' : state.threadId ? 'state' : 'inferred',
+            entityValue,
+            userId
         });
         // Configurar trace collector com contexto
         if (this.traceCollector) {
@@ -403,6 +457,10 @@ class Agent {
         span?.setInput(input);
         // Se tem multi-agents, usar supervisor pattern
         if (this.config.agents && Object.keys(this.config.agents).length > 0) {
+            this.logger.debug('Multi-agent configuration detected, delegating to supervisor', {
+                agentsCount: Object.keys(this.config.agents).length,
+                agentNames: Object.keys(this.config.agents)
+            });
             return this.processMultiAgent(input, context);
         }
         // Memory management se configurado
@@ -412,21 +470,24 @@ class Agent {
             // Prioridade 1: Custom memoryKey (override completo)
             if (this.config.memory.memoryKey) {
                 memoryId = this.config.memory.memoryKey;
-                console.log('🧠 [SDK Agent] Loading memory with custom key:', memoryId);
             }
             // Prioridade 2: entityType + entityValue (do identify())
             else if (entityType && entityValue) {
                 memoryId = `${entityType}:${entityValue}`;
-                console.log('🧠 [SDK Agent] Loading memory for entity:', memoryId);
             }
             // Prioridade 3: sessionId (backward compatibility)
             else if (input.sessionId) {
                 memoryId = `session:${input.sessionId}`;
-                console.log('🧠 [SDK Agent] Loading memory for session (fallback):', memoryId);
             }
             if (memoryId) {
-                memoryMessages = await this.loadMemory(memoryId);
-                console.log('🧠 [SDK Agent] Memory loaded:', memoryMessages.length > 0 ? `${memoryMessages.length} messages` : 'No history');
+                this.logger.debug('Loading memory', {
+                    memoryId,
+                    memoryType: this.config.memory.type
+                });
+                const memoryLoadTime = await performance_logger_1.performanceLogger.measure('memory.load', async () => {
+                    return await (0, agent_memory_1.loadMemory)(memoryId, this.apiClient, this.config.memory, this.traceCollector, this.logger);
+                }, { memoryId, memoryType: this.config.memory.type });
+                memoryMessages = memoryLoadTime;
             }
         }
         // ============================================================================
@@ -438,7 +499,6 @@ class Agent {
         let messages = [];
         // 2. Se tem messages[] no input, adicionar como contexto
         if (input.messages && input.messages.length > 0) {
-            console.log('💬 [SDK Agent] Using provided messages as context:', input.messages.length);
             const inputMessages = input.messages.map(msg => ({
                 role: msg.role,
                 content: msg.content // Pode ser string ou array multimodal
@@ -447,23 +507,33 @@ class Agent {
         }
         // 3. Adicionar historical messages da memória
         if (memoryMessages.length > 0) {
-            console.log('🧠 [SDK Agent] Adding memory messages:', memoryMessages.length);
             messages.push(...memoryMessages);
         }
         // 4. Adicionar mensagem atual do usuário
         messages.push({ role: 'user', content: input.message });
-        console.log('📝 [SDK Agent] Final messages for LLM:', messages.length);
-        console.log('🤖 [SDK Agent] Calling LLM...');
         // Processar com ou sem tools
-        const result = this.config.tools && Object.keys(this.config.tools).length > 0
+        const hasTools = this.config.tools && Object.keys(this.config.tools).length > 0;
+        this.logger.debug('Processing messages', {
+            messagesCount: messages.length,
+            hasTools,
+            toolsCount: hasTools ? Object.keys(this.config.tools).length : 0
+        });
+        performance_logger_1.performanceLogger.start('llm.processing');
+        const result = hasTools
             ? await this.generateWithTools(messages)
             : await this.generate(messages);
-        console.log('✅ [SDK Agent] LLM response received:', result.text.substring(0, 100) + '...');
+        const llmProcessingTime = performance_logger_1.performanceLogger.end('llm.processing', {
+            hasTools,
+            messagesCount: messages.length
+        });
         // Salvar na memória se configurado
+        let memorySaveTime = 0;
         if (this.config.memory && memoryId) {
-            console.log('💾 [SDK Agent] Saving to memory:', memoryId);
-            await this.saveToMemory(memoryId, input.message, result.text);
-            console.log('💾 [SDK Agent] Memory saved');
+            this.logger.debug('Saving to memory', { memoryId });
+            await performance_logger_1.performanceLogger.measure('memory.save', async () => {
+                await (0, agent_memory_1.saveToMemory)(memoryId, input.message, result.text, this.apiClient, this.config.memory, this.config.model, this.traceCollector, this.logger);
+            }, { memoryId });
+            memorySaveTime = Date.now() - processStartTime - llmProcessingTime;
         }
         const output = {
             message: result.text,
@@ -475,16 +545,42 @@ class Agent {
                 sessionId: input.sessionId,
             },
         };
-        console.log('📤 [SDK Agent] Final output:', JSON.stringify(output, null, 2));
         // Finalizar trace com métricas de performance
-        const executionEndTime = Date.now();
-        const processingTimeMs = executionEndTime - executionStartTime;
+        const processingTimeMs = Date.now() - processStartTime;
+        // Performance summary (se ativado)
+        if (performance_logger_1.performanceLogger.isEnabled()) {
+            const memoryLoadTime = memoryMessages.length > 0 ?
+                (processStartTime + 100) : 0; // Estimativa se não medido diretamente
+            performance_logger_1.performanceLogger.summary('agent.process', {
+                'context_resolution': 5, // Tempo mínimo de setup
+                'memory_load': memoryLoadTime,
+                'llm_processing': llmProcessingTime,
+                'memory_save': memorySaveTime,
+            }, processingTimeMs);
+        }
+        performance_logger_1.performanceLogger.end('agent.process', {
+            agentName: this.config.name,
+            responseLength: result.text?.length || 0,
+            memoryUsed: memoryMessages.length > 0,
+            toolsUsed: (0, agent_utils_1.getUsedTools)(this.config.tools).length,
+            executionId,
+            threadId
+        });
+        this.logger.info('Agent processing completed', {
+            agentName: this.config.name,
+            processingTimeMs,
+            responseLength: result.text?.length || 0,
+            memoryUsed: memoryMessages.length > 0,
+            toolsUsed: (0, agent_utils_1.getUsedTools)(this.config.tools),
+            executionId,
+            threadId
+        });
         span?.setOutput(output);
         span?.setMetadata({
             // Feature usage atualizado
             ragUsed: false, // Agora detectado via tool calls
             memoryUsed: memoryMessages.length > 0,
-            toolsUsed: this.getUsedTools(),
+            toolsUsed: (0, agent_utils_1.getUsedTools)(this.config.tools),
             // Performance metrics
             processingTimeMs,
             // Quality metrics
@@ -509,17 +605,19 @@ class Agent {
         span?.finish();
         // Forçar flush dos traces pendentes
         if (this.traceCollector) {
-            console.log('🚀 [SDK Agent] Forcing trace flush...');
             await this.traceCollector.flush();
         }
-        console.log('🎉 [SDK Agent] Process completed successfully');
         return output;
     }
     // Multi-agent processing (supervisor pattern)
     async processMultiAgent(input, context) {
+        this.logger.debug('Starting multi-agent processing with supervisor pattern');
         // Criar supervisor automático
         const supervisor = this.createSupervisor();
         // Supervisor decide qual agent usar
+        this.logger.debug('Supervisor analyzing agent selection', {
+            availableAgents: Object.keys(this.config.agents)
+        });
         const decision = await supervisor.generate(`
 Available agents:
 ${Object.entries(this.config.agents).map(([name, config]) => `- ${name}: ${config.instructions}`).join('\n')}
@@ -531,12 +629,19 @@ Which agent should handle this? Respond with just the agent name.
         const selectedAgentName = decision.text.trim();
         const selectedAgentConfig = this.config.agents[selectedAgentName];
         if (!selectedAgentConfig) {
-            // Fallback para primeiro agent
             const firstAgentName = Object.keys(this.config.agents)[0];
+            this.logger.warn('Supervisor selected invalid agent, using fallback', {
+                selectedAgentName,
+                fallbackAgentName: firstAgentName
+            });
+            // Fallback para primeiro agent
             const firstAgentConfig = this.config.agents[firstAgentName];
             const agent = new Agent(firstAgentConfig);
             return agent.process(input, context);
         }
+        this.logger.info('Supervisor selected agent', {
+            selectedAgentName
+        });
         // Executar agent selecionado
         const selectedAgent = new Agent(selectedAgentConfig);
         return selectedAgent.process(input, context);
@@ -550,170 +655,26 @@ Which agent should handle this? Respond with just the agent name.
         });
     }
     // ============================================================================
-    // AGENTIC RAG - Create Tools Automatically
+    // LOGGER CONFIGURATION
     // ============================================================================
     /**
-     * Cria tools de RAG automaticamente baseado na configuração
-     * LLM decide quando buscar (não busca sempre)
+     * Resolve o nível de log baseado na configuração de debug
      */
-    createRAGTools(ragConfig) {
-        const tools = {};
-        // Caso 1: KB única (simples)
-        if (ragConfig.vectorStore) {
-            tools['searchKnowledge'] = this.createRAGTool({
-                id: 'knowledge',
-                name: ragConfig.vectorStore,
-                threshold: ragConfig.threshold || 0.7,
-                k: ragConfig.k || 5,
-                description: ragConfig.toolDescription || `Search in ${ragConfig.vectorStore} knowledge base for relevant information`,
-            });
-            console.log(`📚 [SDK Agent] Created RAG tool: searchKnowledge (${ragConfig.vectorStore})`);
+    resolveLogLevel(debug) {
+        // Se debug é false, desativar logs
+        if (debug === false) {
+            return 'silent';
         }
-        // Caso 2: Múltiplas KBs (avançado) - ARRAY
-        if (ragConfig.vectorStores && Array.isArray(ragConfig.vectorStores)) {
-            for (const vs of ragConfig.vectorStores) {
-                const toolName = `search_${vs.id}`;
-                tools[toolName] = this.createRAGTool({
-                    id: vs.id,
-                    name: vs.name,
-                    threshold: vs.threshold || ragConfig.threshold || 0.7,
-                    k: vs.k || ragConfig.k || 5,
-                    description: vs.description || `Search in ${vs.name} knowledge base`,
-                });
-                console.log(`📚 [SDK Agent] Created RAG tool: ${toolName} (${vs.name})`);
-            }
+        // Se debug é true, usar debug level
+        if (debug === true) {
+            return 'debug';
         }
-        return tools;
-    }
-    /**
-     * Cria uma tool individual de RAG
-     */
-    createRAGTool(config) {
-        return {
-            id: `search-${config.id}`,
-            name: `search_${config.id}`,
-            description: config.description,
-            parameters: {
-                query: {
-                    type: 'string',
-                    description: 'Search query to find relevant information',
-                    required: true,
-                },
-            },
-            execute: async (params, context) => {
-                console.log(`🔍 [RAG Tool] Searching in ${config.name}...`, {
-                    query: params.query,
-                    k: config.k,
-                    threshold: config.threshold,
-                });
-                try {
-                    const results = await context.runflowAPI.vectorSearch(params.query, {
-                        vectorStore: config.name,
-                        k: config.k,
-                        threshold: config.threshold,
-                    });
-                    const formattedResults = results.results.map((r) => ({
-                        content: r.content,
-                        score: r.score,
-                        metadata: r.metadata,
-                    }));
-                    console.log(`✅ [RAG Tool] Found ${formattedResults.length} results (threshold: ${config.threshold})`);
-                    // Retornar em formato que o LLM possa usar
-                    if (formattedResults.length === 0) {
-                        return {
-                            found: false,
-                            message: 'No relevant information found in knowledge base',
-                            results: [],
-                        };
-                    }
-                    return {
-                        found: true,
-                        count: formattedResults.length,
-                        results: formattedResults,
-                        context: formattedResults.map((r, i) => `[Result ${i + 1}] (score: ${r.score.toFixed(2)})\n${r.content}`).join('\n\n---\n\n'),
-                    };
-                }
-                catch (error) {
-                    console.error(`❌ [RAG Tool] Search failed:`, error);
-                    return {
-                        found: false,
-                        error: error instanceof Error ? error.message : 'Search failed',
-                        results: [],
-                    };
-                }
-            },
-        };
-    }
-    // RAG automático (DEPRECATED - mantido para compatibilidade temporária)
-    async performRAG(query) {
-        if (!this.config.rag || !this.apiClient) {
-            return null;
-        }
-        // 🔍 Trace: RAG Search
-        const ragStartTime = Date.now();
-        const ragSpan = this.traceCollector?.startSpan('rag_search', {
-            operation: 'vector_search',
-            vectorStore: this.config.rag.vectorStore,
-            k: this.config.rag.k || 5,
-            threshold: this.config.rag.threshold || 0.7,
-        });
-        ragSpan?.setInput({ query });
-        try {
-            const searchResults = await this.apiClient.vectorSearch(query, {
-                vectorStore: this.config.rag.vectorStore,
-                k: this.config.rag.k || 5,
-                threshold: this.config.rag.threshold || 0.7,
-            });
-            if (searchResults.results.length === 0) {
-                ragSpan?.setOutput({ resultsCount: 0, hasResults: false });
-                ragSpan?.setMetadata({
-                    operation: 'vector_search',
-                    vectorStore: this.config.rag.vectorStore,
-                    resultsCount: 0,
-                    processingTimeMs: Date.now() - ragStartTime,
-                    success: true,
-                });
-                ragSpan?.finish();
-                return null;
-            }
-            const context = searchResults.results
-                .map((result) => result.content)
-                .join('\n\n');
-            // 🔍 Finalizar trace (com dados completos se debug ativado)
-            const ragOutput = {
-                resultsCount: searchResults.results.length,
-                hasResults: true,
-                contextLength: context.length,
-            };
-            if (this.debugConfig.logRAG) {
-                ragOutput.results = searchResults.results;
-                ragOutput.contextGenerated = context;
-            }
-            ragSpan?.setOutput(ragOutput);
-            ragSpan?.setMetadata({
-                operation: 'vector_search',
-                vectorStore: this.config.rag.vectorStore,
-                resultsCount: searchResults.results.length,
-                k: this.config.rag.k || 5,
-                threshold: this.config.rag.threshold || 0.7,
-                processingTimeMs: Date.now() - ragStartTime,
-                success: true,
-            });
-            ragSpan?.finish();
-            return context;
-        }
-        catch (error) {
-            console.error('RAG search failed:', error);
-            ragSpan?.setMetadata({
-                operation: 'vector_search',
-                vectorStore: this.config.rag.vectorStore,
-                success: false,
-                error: error instanceof Error ? error.message : 'Unknown error',
-                processingTimeMs: Date.now() - ragStartTime,
-            });
-            ragSpan?.finish();
-            return null;
+        // Se debug é objeto com level, usar o nível especificado
+        if (typeof debug === 'object' && debug.level) {
+            return debug.level;
         }
+        // Default: info em produção, debug em desenvolvimento
+        return process.env.NODE_ENV === 'production' ? 'info' : 'debug';
     }
     // Getters
     get name() {
@@ -731,293 +692,19 @@ Which agent should handle this? Respond with just the agent name.
     get isMultiAgent() {
         return !!(this.config.agents && Object.keys(this.config.agents).length > 0);
     }
-    // Obter tools utilizadas (para traces)
-    getUsedTools() {
-        if (!this.config.tools)
-            return [];
-        return Object.keys(this.config.tools);
-    }
-    // ============================================================================
-    // DEBUG HELPERS
-    // ============================================================================
-    /**
-     * Resolver configuração de debug
-     */
-    resolveDebugConfig(debug) {
-        // Verificar variável de ambiente
-        const envDebug = process.env.RUNFLOW_DEBUG === 'true' || process.env.RUNFLOW_LOG_LEVEL === 'verbose';
-        if (debug === true || envDebug) {
-            // Debug simples = todos logs ativados
-            return {
-                enabled: true,
-                logMessages: true,
-                logLLMCalls: true,
-                logToolCalls: true,
-                logRAG: true,
-                logMemory: true,
-                truncateAt: undefined,
-            };
-        }
-        else if (typeof debug === 'object' && debug.enabled) {
-            // Debug customizado
-            return {
-                enabled: true,
-                logMessages: debug.logMessages !== false,
-                logLLMCalls: debug.logLLMCalls !== false,
-                logToolCalls: debug.logToolCalls !== false,
-                logRAG: debug.logRAG !== false,
-                logMemory: debug.logMemory !== false,
-                truncateAt: debug.truncateAt,
-            };
-        }
-        return { enabled: false };
-    }
-    // ============================================================================
-    // CONTEXT RESOLUTION HELPERS
-    // ============================================================================
-    /**
-     * Generate unique execution ID
-     */
-    generateExecutionId() {
-        return `exec_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
-    }
-    /**
-     * Generate threadId based on input (fallback quando não fornecido)
-     */
-    generateThreadId(input) {
-        const companyId = input.companyId || 'default';
-        // Se tem sessionId, usar como thread
-        if (input.sessionId) {
-            return `session_${companyId}_${input.sessionId}`;
-        }
-        // Fallback: gerar único
-        return `thread_${companyId}_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
-    }
-    /**
-     * Infer entityType from input metadata
-     */
-    inferEntityType(input) {
-        if (input.metadata?.phone)
-            return 'phone';
-        if (input.metadata?.email)
-            return 'email';
-        if (input.metadata?.contactId)
-            return 'hubspot_contact';
-        if (input.sessionId)
-            return 'session';
-        return 'session'; // Default
-    }
-    /**
-     * Infer entityValue from input metadata
-     */
-    inferEntityValue(input) {
-        if (input.metadata?.phone)
-            return input.metadata.phone;
-        if (input.metadata?.email)
-            return input.metadata.email;
-        if (input.metadata?.contactId)
-            return input.metadata.contactId;
-        if (input.sessionId)
-            return input.sessionId;
-        return null;
-    }
-    /**
-     * Infer userId from input metadata
-     */
-    inferUserId(input) {
-        if (input.metadata?.phone)
-            return input.metadata.phone;
-        if (input.metadata?.email)
-            return input.metadata.email;
-        if (input.metadata?.contactId)
-            return input.metadata.contactId;
-        return null;
-    }
-    // ============================================================================
-    // MEMORY MANAGEMENT
-    // ============================================================================
-    // Carregar memória da entidade (retorna array de messages)
-    async loadMemory(memoryId) {
-        if (!this.apiClient || !this.config.memory) {
-            return [];
-        }
-        // 🔍 Trace: Memory Load
-        const memoryLoadStartTime = Date.now();
-        const memoryLoadSpan = this.traceCollector?.startSpan('memory_operation', {
-            operation: 'load',
-            memoryId,
-            memoryType: this.config.memory.type,
-        });
-        try {
-            const memoryData = await this.apiClient.memory.get(memoryId);
-            if (!memoryData.messages || memoryData.messages.length === 0) {
-                memoryLoadSpan?.setOutput({ messagesCount: 0, hasHistory: false });
-                memoryLoadSpan?.setMetadata({
-                    operation: 'load',
-                    memoryId,
-                    messagesCount: 0,
-                    processingTimeMs: Date.now() - memoryLoadStartTime,
-                    success: true,
-                });
-                memoryLoadSpan?.finish();
-                return [];
-            }
-            // Aplicar configurações de memória
-            let messages = memoryData.messages;
-            // Limitar por número de turnos
-            if (this.config.memory.maxTurns) {
-                messages = messages.slice(-this.config.memory.maxTurns * 2); // user + assistant = 2 messages per turn
-            }
-            // Limitar por tokens (aproximado)
-            if (this.config.memory.maxTokens) {
-                let totalTokens = 0;
-                const filteredMessages = [];
-                for (let i = messages.length - 1; i >= 0; i--) {
-                    const messageTokens = Math.ceil(messages[i].content.length / 4);
-                    if (totalTokens + messageTokens <= this.config.memory.maxTokens) {
-                        filteredMessages.unshift(messages[i]);
-                        totalTokens += messageTokens;
-                    }
-                    else {
-                        break;
-                    }
-                }
-                messages = filteredMessages;
-            }
-            // Retornar messages como array (formato nativo do LLM)
-            const result = messages.map((msg) => ({
-                role: msg.role,
-                content: msg.content,
-            }));
-            // 🔍 Finalizar trace (com dados completos se debug ativado)
-            const memoryOutput = {
-                messagesCount: messages.length,
-                hasHistory: result.length > 0,
-            };
-            if (this.debugConfig.logMemory) {
-                memoryOutput.messages = result;
-            }
-            memoryLoadSpan?.setOutput(memoryOutput);
-            memoryLoadSpan?.setMetadata({
-                operation: 'load',
-                memoryId,
-                messagesCount: messages.length,
-                maxTurns: this.config.memory.maxTurns,
-                processingTimeMs: Date.now() - memoryLoadStartTime,
-                success: true,
-            });
-            memoryLoadSpan?.finish();
-            return result;
-        }
-        catch (error) {
-            console.error('Failed to load memory:', error);
-            // 🔍 Trace de erro
-            memoryLoadSpan?.setMetadata({
-                operation: 'load',
-                memoryId,
-                success: false,
-                error: error instanceof Error ? error.message : 'Unknown error',
-                processingTimeMs: Date.now() - memoryLoadStartTime,
-            });
-            memoryLoadSpan?.finish();
-            return [];
-        }
-    }
-    // Salvar na memória
-    async saveToMemory(memoryId, userMessage, assistantMessage) {
-        if (!this.apiClient || !this.config.memory) {
-            return;
-        }
-        // 🔍 Trace: Memory Save
-        const memorySaveStartTime = Date.now();
-        const memorySaveSpan = this.traceCollector?.startSpan('memory_operation', {
-            operation: 'save',
-            memoryId,
-            memoryType: this.config.memory.type,
-        });
-        try {
-            // Adicionar mensagem do usuário
-            await this.apiClient.memory.append(memoryId, {
-                role: 'user',
-                content: userMessage,
-                timestamp: new Date(),
-            });
-            // Adicionar resposta do assistant
-            await this.apiClient.memory.append(memoryId, {
-                role: 'assistant',
-                content: assistantMessage,
-                timestamp: new Date(),
-                metadata: {
-                    model: this.config.model.model,
-                },
-            });
-            // Resumir se necessário
-            let summarized = false;
-            if (this.config.memory.summarizeAfter) {
-                const currentMemory = await this.apiClient.memory.get(memoryId);
-                if (currentMemory.messages.length >= this.config.memory.summarizeAfter) {
-                    await this.apiClient.memory.summarize(memoryId);
-                    summarized = true;
-                }
-            }
-            // 🔍 Finalizar trace (com dados completos se debug ativado)
-            const memorySaveOutput = {
-                messagesSaved: 2,
-                summarized,
-            };
-            if (this.debugConfig.logMemory) {
-                memorySaveOutput.userMessage = userMessage;
-                memorySaveOutput.assistantMessage = assistantMessage;
-            }
-            memorySaveSpan?.setOutput(memorySaveOutput);
-            memorySaveSpan?.setMetadata({
-                operation: 'save',
-                memoryId,
-                messagesSaved: 2,
-                summarized,
-                summarizeAfter: this.config.memory.summarizeAfter,
-                processingTimeMs: Date.now() - memorySaveStartTime,
-                success: true,
-            });
-            memorySaveSpan?.finish();
-        }
-        catch (error) {
-            console.error('Failed to save to memory:', error);
-            // 🔍 Trace de erro
-            memorySaveSpan?.setMetadata({
-                operation: 'save',
-                memoryId,
-                success: false,
-                error: error instanceof Error ? error.message : 'Unknown error',
-                processingTimeMs: Date.now() - memorySaveStartTime,
-            });
-            memorySaveSpan?.finish();
-        }
-    }
-    // Processar stream chunks (helper)
-    async *processStreamChunks(stream) {
-        for await (const chunk of stream) {
-            if (chunk.type === 'content') {
-                yield { text: chunk.content || '', done: false };
-            }
-            else if (chunk.type === 'done') {
-                yield { text: '', done: true };
-                break;
-            }
-            else if (chunk.type === 'error') {
-                throw new Error(chunk.error || 'Streaming error');
-            }
-        }
-    }
     // Streaming com memória
     async processStream(input, context) {
+        this.logger.debug('Starting stream processing', {
+            messageLength: input.message?.length || 0,
+            sessionId: input.sessionId
+        });
         if (context?.apiClient) {
             this.apiClient = context.apiClient;
         }
         // Resolver entity context
         const state = context_1.Runflow.getState();
-        const entityType = input.entityType || state.entityType || this.inferEntityType(input);
-        const entityValue = input.entityValue || state.entityValue || this.inferEntityValue(input);
+        const entityType = input.entityType || state.entityType || (0, agent_context_1.inferEntityType)(input, this.logger);
+        const entityValue = input.entityValue || state.entityValue || (0, agent_context_1.inferEntityValue)(input, this.logger);
         // Resolver memoryId com mesma prioridade do process()
         let memoryId = null;
         if (this.config.memory) {
@@ -1037,7 +724,8 @@ Which agent should handle this? Respond with just the agent name.
         // Carregar memória se configurado
         let memoryMessages = [];
         if (this.config.memory && memoryId) {
-            memoryMessages = await this.loadMemory(memoryId);
+            this.logger.debug('Loading memory for streaming', { memoryId });
+            memoryMessages = await (0, agent_memory_1.loadMemory)(memoryId, this.apiClient, this.config.memory, this.traceCollector, this.logger);
         }
         // ============================================================================
         // RAG agora é TOOL - LLM decide quando buscar
@@ -1073,6 +761,11 @@ Which agent should handle this? Respond with just the agent name.
         });
         // Criar async generator
         const self = this;
+        const logger = this.logger;
+        const apiClient = this.apiClient;
+        const memoryConfig = this.config.memory;
+        const modelConfig = this.config.model;
+        const traceCollector = this.traceCollector;
         return (async function* () {
             let fullResponse = '';
             for await (const chunk of stream) {
@@ -1082,13 +775,18 @@ Which agent should handle this? Respond with just the agent name.
                 }
                 else if (chunk.type === 'done') {
                     // Salvar na memória quando streaming terminar
-                    if (self.config.memory && memoryId) {
-                        await self.saveToMemory(memoryId, input.message, fullResponse);
+                    if (memoryConfig && memoryId && apiClient) {
+                        logger.debug('Saving stream response to memory', { memoryId });
+                        await (0, agent_memory_1.saveToMemory)(memoryId, input.message, fullResponse, apiClient, memoryConfig, modelConfig, traceCollector, logger);
                     }
+                    logger.info('Stream processing completed', {
+                        responseLength: fullResponse.length
+                    });
                     yield { text: '', done: true };
                     break;
                 }
                 else if (chunk.type === 'error') {
+                    logger.error('Streaming error', { error: chunk.error });
                     throw new Error(chunk.error || 'Streaming error');
                 }
             }