agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/agentic-flow/src/federation/debug/agent-debug-stream.js

@@ -0,0 +1,475 @@
+/**
+ * Single Agent Debug Streaming
+ *
+ * Provides detailed visibility into a single agent's operations,
+ * lifecycle, and internal state changes.
+ *
+ * Features:
+ * - Agent lifecycle tracking (spawn → work → shutdown)
+ * - Task execution tracing
+ * - Memory operations
+ * - Communication events
+ * - Decision logging
+ * - State transitions
+ * - Performance metrics
+ * - Timeline visualization
+ */
+import { EventEmitter } from 'events';
+import { DebugLevel, createDebugStream } from './debug-stream.js';
+// Re-export DebugLevel for convenience
+export { DebugLevel } from './debug-stream.js';
+export class AgentDebugStream extends EventEmitter {
+    config;
+    debug;
+    state;
+    decisions = [];
+    tasks = new Map();
+    communications = [];
+    timeline = [];
+    performanceMetrics = new Map();
+    constructor(config) {
+        super();
+        this.config = config;
+        // Initialize base debug stream
+        this.debug = createDebugStream({
+            level: config.level ?? DebugLevel.VERBOSE,
+            format: config.format === 'timeline' ? 'human' : config.format,
+            output: config.output ?? 'console',
+            outputFile: config.outputFile,
+            colorize: config.colorize ?? true,
+        });
+        // Initialize state
+        this.state = {
+            phase: 'spawning',
+            startTime: new Date().toISOString(),
+            metadata: {},
+        };
+        this.logAgentPhase('spawning', { agentId: config.agentId });
+    }
+    /**
+     * Log agent lifecycle phase change
+     */
+    logAgentPhase(phase, data) {
+        const oldPhase = this.state.phase;
+        this.state.phase = phase;
+        this.state.lastActivity = new Date().toISOString();
+        this.debug.log({
+            level: DebugLevel.BASIC,
+            category: 'agent_lifecycle',
+            operation: `phase_${phase}`,
+            agentId: this.config.agentId,
+            tenantId: this.config.tenantId,
+            data: {
+                old_phase: oldPhase,
+                new_phase: phase,
+                ...data,
+            },
+        });
+        if (this.config.timeline) {
+            this.timeline.push({
+                timestamp: new Date().toISOString(),
+                type: 'phase_change',
+                from: oldPhase,
+                to: phase,
+                data,
+            });
+        }
+        this.emit('phase_change', { from: oldPhase, to: phase, data });
+    }
+    /**
+     * Log agent initialization
+     */
+    logInitialization(config) {
+        this.logAgentPhase('initializing', { config });
+        this.debug.log({
+            level: DebugLevel.DETAILED,
+            category: 'agent_lifecycle',
+            operation: 'initialize',
+            agentId: this.config.agentId,
+            tenantId: this.config.tenantId,
+            data: config,
+        });
+    }
+    /**
+     * Log agent ready
+     */
+    logReady(capabilities) {
+        this.logAgentPhase('ready', { capabilities });
+        this.debug.log({
+            level: DebugLevel.BASIC,
+            category: 'agent_lifecycle',
+            operation: 'ready',
+            agentId: this.config.agentId,
+            tenantId: this.config.tenantId,
+            data: { capabilities },
+        });
+    }
+    /**
+     * Start tracking a task
+     */
+    startTask(taskId, description, data) {
+        const task = {
+            taskId,
+            description,
+            startTime: new Date().toISOString(),
+            status: 'running',
+            steps: [],
+        };
+        this.tasks.set(taskId, task);
+        this.state.task = description;
+        this.state.taskId = taskId;
+        this.logAgentPhase('working', { taskId, description });
+        this.debug.log({
+            level: DebugLevel.VERBOSE,
+            category: 'task',
+            operation: 'task_start',
+            agentId: this.config.agentId,
+            tenantId: this.config.tenantId,
+            data: { taskId, description, ...data },
+        });
+        if (this.config.timeline) {
+            this.timeline.push({
+                timestamp: new Date().toISOString(),
+                type: 'task_start',
+                taskId,
+                description,
+            });
+        }
+    }
+    /**
+     * Log task step
+     */
+    logTaskStep(taskId, step, operation, data) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return;
+        const stepData = {
+            step,
+            operation,
+            startTime: new Date().toISOString(),
+            data,
+        };
+        task.steps.push(stepData);
+        this.debug.log({
+            level: DebugLevel.VERBOSE,
+            category: 'task_step',
+            operation,
+            agentId: this.config.agentId,
+            tenantId: this.config.tenantId,
+            data: {
+                taskId,
+                step,
+                operation,
+                ...data,
+            },
+        });
+    }
+    /**
+     * Complete task step
+     */
+    completeTaskStep(taskId, step, duration, data) {
+        const task = this.tasks.get(taskId);
+        if (!task || !task.steps[step])
+            return;
+        task.steps[step].endTime = new Date().toISOString();
+        task.steps[step].duration = duration;
+        task.steps[step].data = { ...task.steps[step].data, ...data };
+        this.debug.log({
+            level: DebugLevel.VERBOSE,
+            category: 'task_step',
+            operation: 'step_complete',
+            agentId: this.config.agentId,
+            tenantId: this.config.tenantId,
+            data: {
+                taskId,
+                step,
+                duration,
+                ...data,
+            },
+        });
+        // Track performance
+        this.trackPerformance(`step_${task.steps[step].operation}`, duration);
+    }
+    /**
+     * Complete task
+     */
+    completeTask(taskId, result) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return;
+        task.endTime = new Date().toISOString();
+        task.status = 'completed';
+        task.result = result;
+        const duration = new Date(task.endTime).getTime() - new Date(task.startTime).getTime();
+        this.debug.log({
+            level: DebugLevel.VERBOSE,
+            category: 'task',
+            operation: 'task_complete',
+            agentId: this.config.agentId,
+            tenantId: this.config.tenantId,
+            data: {
+                taskId,
+                duration,
+                steps: task.steps.length,
+                result,
+            },
+        });
+        if (this.config.timeline) {
+            this.timeline.push({
+                timestamp: new Date().toISOString(),
+                type: 'task_complete',
+                taskId,
+                duration,
+            });
+        }
+        this.trackPerformance('task_completion', duration);
+        this.state.task = undefined;
+        this.state.taskId = undefined;
+        this.logAgentPhase('idle');
+    }
+    /**
+     * Fail task
+     */
+    failTask(taskId, error) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return;
+        task.endTime = new Date().toISOString();
+        task.status = 'failed';
+        task.error = error;
+        this.debug.log({
+            level: DebugLevel.BASIC,
+            category: 'task',
+            operation: 'task_failed',
+            agentId: this.config.agentId,
+            tenantId: this.config.tenantId,
+            data: {
+                taskId,
+                error: error.message,
+            },
+            error,
+        });
+        this.state.task = undefined;
+        this.state.taskId = undefined;
+        this.logAgentPhase('idle');
+    }
+    /**
+     * Log a decision
+     */
+    logDecision(context, options, selected, reasoning, confidence) {
+        if (!this.config.trackDecisions)
+            return;
+        const decision = {
+            timestamp: new Date().toISOString(),
+            context,
+            options,
+            selected,
+            reasoning,
+            confidence,
+        };
+        this.decisions.push(decision);
+        this.debug.log({
+            level: DebugLevel.VERBOSE,
+            category: 'decision',
+            operation: 'decision_made',
+            agentId: this.config.agentId,
+            tenantId: this.config.tenantId,
+            data: {
+                context,
+                options_count: options.length,
+                selected,
+                reasoning,
+                confidence,
+            },
+        });
+        this.emit('decision', decision);
+    }
+    /**
+     * Log communication
+     */
+    logCommunication(type, target, message) {
+        if (!this.config.trackCommunication)
+            return;
+        const comm = {
+            timestamp: new Date().toISOString(),
+            type,
+            target,
+            message,
+        };
+        this.communications.push(comm);
+        this.debug.log({
+            level: DebugLevel.VERBOSE,
+            category: 'communication',
+            operation: type === 'send' ? 'message_sent' : 'message_received',
+            agentId: this.config.agentId,
+            tenantId: this.config.tenantId,
+            data: {
+                target,
+                message_type: typeof message === 'object' ? message.type : 'unknown',
+                size: JSON.stringify(message).length,
+            },
+        });
+        this.emit('communication', comm);
+    }
+    /**
+     * Log memory operation
+     */
+    logMemoryOperation(operation, data, duration) {
+        this.debug.logMemory(operation, this.config.agentId, this.config.tenantId, data, duration);
+        if (duration) {
+            this.trackPerformance(`memory_${operation}`, duration);
+        }
+    }
+    /**
+     * Log thought/reasoning
+     */
+    logThought(thought, context) {
+        this.debug.log({
+            level: DebugLevel.TRACE,
+            category: 'reasoning',
+            operation: 'thought',
+            agentId: this.config.agentId,
+            tenantId: this.config.tenantId,
+            data: {
+                thought,
+                context,
+            },
+        });
+    }
+    /**
+     * Log agent shutdown
+     */
+    logShutdown(reason) {
+        this.logAgentPhase('shutting_down', { reason });
+        const uptime = new Date().getTime() - new Date(this.state.startTime).getTime();
+        this.debug.log({
+            level: DebugLevel.BASIC,
+            category: 'agent_lifecycle',
+            operation: 'shutdown',
+            agentId: this.config.agentId,
+            tenantId: this.config.tenantId,
+            data: {
+                reason,
+                uptime_ms: uptime,
+                total_tasks: this.tasks.size,
+                total_decisions: this.decisions.length,
+                total_communications: this.communications.length,
+            },
+        });
+        // Print final summary
+        this.printSummary();
+        this.logAgentPhase('dead');
+    }
+    /**
+     * Track performance metric
+     */
+    trackPerformance(operation, duration) {
+        if (!this.performanceMetrics.has(operation)) {
+            this.performanceMetrics.set(operation, []);
+        }
+        this.performanceMetrics.get(operation).push(duration);
+    }
+    /**
+     * Print agent summary
+     */
+    printSummary() {
+        const uptime = new Date().getTime() - new Date(this.state.startTime).getTime();
+        console.log('\n' + '='.repeat(60));
+        console.log(`📊 Agent Summary: ${this.config.agentId}`);
+        console.log('='.repeat(60));
+        console.log('');
+        console.log(`Uptime:          ${(uptime / 1000).toFixed(2)}s`);
+        console.log(`Tasks Completed: ${Array.from(this.tasks.values()).filter(t => t.status === 'completed').length}`);
+        console.log(`Tasks Failed:    ${Array.from(this.tasks.values()).filter(t => t.status === 'failed').length}`);
+        console.log(`Decisions Made:  ${this.decisions.length}`);
+        console.log(`Messages Sent:   ${this.communications.filter(c => c.type === 'send').length}`);
+        console.log(`Messages Recv:   ${this.communications.filter(c => c.type === 'receive').length}`);
+        console.log('');
+        // Performance metrics
+        if (this.performanceMetrics.size > 0) {
+            console.log('Performance Metrics:');
+            console.log('-'.repeat(60));
+            for (const [operation, durations] of this.performanceMetrics.entries()) {
+                const avg = durations.reduce((a, b) => a + b, 0) / durations.length;
+                const min = Math.min(...durations);
+                const max = Math.max(...durations);
+                console.log(`  ${operation.padEnd(30)} ${durations.length}x  avg: ${avg.toFixed(1)}ms  min: ${min.toFixed(1)}ms  max: ${max.toFixed(1)}ms`);
+            }
+            console.log('');
+        }
+        console.log('='.repeat(60) + '\n');
+    }
+    /**
+     * Print timeline
+     */
+    printTimeline() {
+        if (!this.config.timeline || this.timeline.length === 0)
+            return;
+        console.log('\n' + '='.repeat(60));
+        console.log('📅 Agent Timeline');
+        console.log('='.repeat(60) + '\n');
+        const startTime = new Date(this.timeline[0].timestamp).getTime();
+        for (const event of this.timeline) {
+            const elapsed = new Date(event.timestamp).getTime() - startTime;
+            const time = `+${(elapsed / 1000).toFixed(3)}s`;
+            console.log(`${time.padStart(10)} | ${event.type.padEnd(20)} | ${JSON.stringify(event.data || event)}`);
+        }
+        console.log('\n' + '='.repeat(60) + '\n');
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Get task history
+     */
+    getTasks() {
+        return Array.from(this.tasks.values());
+    }
+    /**
+     * Get decisions
+     */
+    getDecisions() {
+        return [...this.decisions];
+    }
+    /**
+     * Get communications
+     */
+    getCommunications() {
+        return [...this.communications];
+    }
+    /**
+     * Close debug stream
+     */
+    close() {
+        this.debug.close();
+    }
+}
+/**
+ * Create agent debug stream
+ */
+export function createAgentDebugStream(config) {
+    return new AgentDebugStream(config);
+}
+/**
+ * Create from environment variables
+ */
+export function createAgentDebugStreamFromEnv(agentId, tenantId) {
+    const debugLevel = process.env.DEBUG_LEVEL?.toUpperCase() || 'VERBOSE';
+    return new AgentDebugStream({
+        agentId,
+        tenantId: tenantId || process.env.FEDERATION_TENANT_ID,
+        level: DebugLevel[debugLevel] || DebugLevel.VERBOSE,
+        format: process.env.DEBUG_FORMAT || 'human',
+        output: process.env.DEBUG_OUTPUT || 'console',
+        outputFile: process.env.DEBUG_OUTPUT_FILE,
+        colorize: process.env.DEBUG_COLORIZE !== 'false',
+        trackState: process.env.DEBUG_TRACK_STATE !== 'false',
+        trackDecisions: process.env.DEBUG_TRACK_DECISIONS !== 'false',
+        trackCommunication: process.env.DEBUG_TRACK_COMMUNICATION !== 'false',
+        timeline: process.env.DEBUG_TIMELINE === 'true',
+    });
+}
+//# sourceMappingURL=agent-debug-stream.js.map

package/dist/agentic-flow/src/federation/debug/agent-debug-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-debug-stream.js","sourceRoot":"","sources":["../../../../../src/federation/debug/agent-debug-stream.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Single Agent Debug Streaming\n *\n * Provides detailed visibility into a single agent's operations,\n * lifecycle, and internal state changes.\n *\n * Features:\n * - Agent lifecycle tracking (spawn → work → shutdown)\n * - Task execution tracing\n * - Memory operations\n * - Communication events\n * - Decision logging\n * - State transitions\n * - Performance metrics\n * - Timeline visualization\n */\n\nimport { EventEmitter } from 'events';\nimport { DebugStream, DebugLevel, createDebugStream } from './debug-stream.js';\n\n// Re-export DebugLevel for convenience\nexport { DebugLevel } from './debug-stream.js';\n\nexport interface AgentDebugConfig {\n  agentId: string;\n  tenantId?: string;\n  level?: DebugLevel;\n  format?: 'human' | 'json' | 'compact' | 'timeline';\n  output?: 'console' | 'file' | 'both';\n  outputFile?: string;\n  colorize?: boolean;\n  trackState?: boolean;\n  trackDecisions?: boolean;\n  trackCommunication?: boolean;\n  timeline?: boolean;\n}\n\nexport interface AgentState {\n  phase: 'spawning' | 'initializing' | 'ready' | 'working' | 'idle' | 'shutting_down' | 'dead';\n  task?: string;\n  taskId?: string;\n  startTime: string;\n  lastActivity?: string;\n  metadata?: Record<string, any>;\n}\n\nexport interface AgentDecision {\n  timestamp: string;\n  context: string;\n  options: any[];\n  selected: any;\n  reasoning?: string;\n  confidence?: number;\n}\n\nexport interface AgentTask {\n  taskId: string;\n  description: string;\n  startTime: string;\n  endTime?: string;\n  status: 'pending' | 'running' | 'completed' | 'failed';\n  steps: AgentTaskStep[];\n  result?: any;\n  error?: Error;\n}\n\nexport interface AgentTaskStep {\n  step: number;\n  operation: string;\n  startTime: string;\n  endTime?: string;\n  duration?: number;\n  data?: any;\n  error?: Error;\n}\n\nexport class AgentDebugStream extends EventEmitter {\n  private config: AgentDebugConfig;\n  private debug: DebugStream;\n  private state: AgentState;\n  private decisions: AgentDecision[] = [];\n  private tasks: Map<string, AgentTask> = new Map();\n  private communications: any[] = [];\n  private timeline: any[] = [];\n  private performanceMetrics: Map<string, number[]> = new Map();\n\n  constructor(config: AgentDebugConfig) {\n    super();\n    this.config = config;\n\n    // Initialize base debug stream\n    this.debug = createDebugStream({\n      level: config.level ?? DebugLevel.VERBOSE,\n      format: config.format === 'timeline' ? 'human' : config.format,\n      output: config.output ?? 'console',\n      outputFile: config.outputFile,\n      colorize: config.colorize ?? true,\n    });\n\n    // Initialize state\n    this.state = {\n      phase: 'spawning',\n      startTime: new Date().toISOString(),\n      metadata: {},\n    };\n\n    this.logAgentPhase('spawning', { agentId: config.agentId });\n  }\n\n  /**\n   * Log agent lifecycle phase change\n   */\n  logAgentPhase(phase: AgentState['phase'], data?: any): void {\n    const oldPhase = this.state.phase;\n    this.state.phase = phase;\n    this.state.lastActivity = new Date().toISOString();\n\n    this.debug.log({\n      level: DebugLevel.BASIC,\n      category: 'agent_lifecycle',\n      operation: `phase_${phase}`,\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        old_phase: oldPhase,\n        new_phase: phase,\n        ...data,\n      },\n    });\n\n    if (this.config.timeline) {\n      this.timeline.push({\n        timestamp: new Date().toISOString(),\n        type: 'phase_change',\n        from: oldPhase,\n        to: phase,\n        data,\n      });\n    }\n\n    this.emit('phase_change', { from: oldPhase, to: phase, data });\n  }\n\n  /**\n   * Log agent initialization\n   */\n  logInitialization(config: any): void {\n    this.logAgentPhase('initializing', { config });\n\n    this.debug.log({\n      level: DebugLevel.DETAILED,\n      category: 'agent_lifecycle',\n      operation: 'initialize',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: config,\n    });\n  }\n\n  /**\n   * Log agent ready\n   */\n  logReady(capabilities?: any): void {\n    this.logAgentPhase('ready', { capabilities });\n\n    this.debug.log({\n      level: DebugLevel.BASIC,\n      category: 'agent_lifecycle',\n      operation: 'ready',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: { capabilities },\n    });\n  }\n\n  /**\n   * Start tracking a task\n   */\n  startTask(taskId: string, description: string, data?: any): void {\n    const task: AgentTask = {\n      taskId,\n      description,\n      startTime: new Date().toISOString(),\n      status: 'running',\n      steps: [],\n    };\n\n    this.tasks.set(taskId, task);\n    this.state.task = description;\n    this.state.taskId = taskId;\n\n    this.logAgentPhase('working', { taskId, description });\n\n    this.debug.log({\n      level: DebugLevel.VERBOSE,\n      category: 'task',\n      operation: 'task_start',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: { taskId, description, ...data },\n    });\n\n    if (this.config.timeline) {\n      this.timeline.push({\n        timestamp: new Date().toISOString(),\n        type: 'task_start',\n        taskId,\n        description,\n      });\n    }\n  }\n\n  /**\n   * Log task step\n   */\n  logTaskStep(taskId: string, step: number, operation: string, data?: any): void {\n    const task = this.tasks.get(taskId);\n    if (!task) return;\n\n    const stepData: AgentTaskStep = {\n      step,\n      operation,\n      startTime: new Date().toISOString(),\n      data,\n    };\n\n    task.steps.push(stepData);\n\n    this.debug.log({\n      level: DebugLevel.VERBOSE,\n      category: 'task_step',\n      operation,\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        taskId,\n        step,\n        operation,\n        ...data,\n      },\n    });\n  }\n\n  /**\n   * Complete task step\n   */\n  completeTaskStep(taskId: string, step: number, duration: number, data?: any): void {\n    const task = this.tasks.get(taskId);\n    if (!task || !task.steps[step]) return;\n\n    task.steps[step].endTime = new Date().toISOString();\n    task.steps[step].duration = duration;\n    task.steps[step].data = { ...task.steps[step].data, ...data };\n\n    this.debug.log({\n      level: DebugLevel.VERBOSE,\n      category: 'task_step',\n      operation: 'step_complete',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        taskId,\n        step,\n        duration,\n        ...data,\n      },\n    });\n\n    // Track performance\n    this.trackPerformance(`step_${task.steps[step].operation}`, duration);\n  }\n\n  /**\n   * Complete task\n   */\n  completeTask(taskId: string, result?: any): void {\n    const task = this.tasks.get(taskId);\n    if (!task) return;\n\n    task.endTime = new Date().toISOString();\n    task.status = 'completed';\n    task.result = result;\n\n    const duration = new Date(task.endTime).getTime() - new Date(task.startTime).getTime();\n\n    this.debug.log({\n      level: DebugLevel.VERBOSE,\n      category: 'task',\n      operation: 'task_complete',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        taskId,\n        duration,\n        steps: task.steps.length,\n        result,\n      },\n    });\n\n    if (this.config.timeline) {\n      this.timeline.push({\n        timestamp: new Date().toISOString(),\n        type: 'task_complete',\n        taskId,\n        duration,\n      });\n    }\n\n    this.trackPerformance('task_completion', duration);\n    this.state.task = undefined;\n    this.state.taskId = undefined;\n    this.logAgentPhase('idle');\n  }\n\n  /**\n   * Fail task\n   */\n  failTask(taskId: string, error: Error): void {\n    const task = this.tasks.get(taskId);\n    if (!task) return;\n\n    task.endTime = new Date().toISOString();\n    task.status = 'failed';\n    task.error = error;\n\n    this.debug.log({\n      level: DebugLevel.BASIC,\n      category: 'task',\n      operation: 'task_failed',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        taskId,\n        error: error.message,\n      },\n      error,\n    });\n\n    this.state.task = undefined;\n    this.state.taskId = undefined;\n    this.logAgentPhase('idle');\n  }\n\n  /**\n   * Log a decision\n   */\n  logDecision(context: string, options: any[], selected: any, reasoning?: string, confidence?: number): void {\n    if (!this.config.trackDecisions) return;\n\n    const decision: AgentDecision = {\n      timestamp: new Date().toISOString(),\n      context,\n      options,\n      selected,\n      reasoning,\n      confidence,\n    };\n\n    this.decisions.push(decision);\n\n    this.debug.log({\n      level: DebugLevel.VERBOSE,\n      category: 'decision',\n      operation: 'decision_made',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        context,\n        options_count: options.length,\n        selected,\n        reasoning,\n        confidence,\n      },\n    });\n\n    this.emit('decision', decision);\n  }\n\n  /**\n   * Log communication\n   */\n  logCommunication(type: 'send' | 'receive', target: string, message: any): void {\n    if (!this.config.trackCommunication) return;\n\n    const comm = {\n      timestamp: new Date().toISOString(),\n      type,\n      target,\n      message,\n    };\n\n    this.communications.push(comm);\n\n    this.debug.log({\n      level: DebugLevel.VERBOSE,\n      category: 'communication',\n      operation: type === 'send' ? 'message_sent' : 'message_received',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        target,\n        message_type: typeof message === 'object' ? message.type : 'unknown',\n        size: JSON.stringify(message).length,\n      },\n    });\n\n    this.emit('communication', comm);\n  }\n\n  /**\n   * Log memory operation\n   */\n  logMemoryOperation(operation: 'store' | 'retrieve' | 'search', data: any, duration?: number): void {\n    this.debug.logMemory(\n      operation,\n      this.config.agentId,\n      this.config.tenantId,\n      data,\n      duration\n    );\n\n    if (duration) {\n      this.trackPerformance(`memory_${operation}`, duration);\n    }\n  }\n\n  /**\n   * Log thought/reasoning\n   */\n  logThought(thought: string, context?: any): void {\n    this.debug.log({\n      level: DebugLevel.TRACE,\n      category: 'reasoning',\n      operation: 'thought',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        thought,\n        context,\n      },\n    });\n  }\n\n  /**\n   * Log agent shutdown\n   */\n  logShutdown(reason?: string): void {\n    this.logAgentPhase('shutting_down', { reason });\n\n    const uptime = new Date().getTime() - new Date(this.state.startTime).getTime();\n\n    this.debug.log({\n      level: DebugLevel.BASIC,\n      category: 'agent_lifecycle',\n      operation: 'shutdown',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        reason,\n        uptime_ms: uptime,\n        total_tasks: this.tasks.size,\n        total_decisions: this.decisions.length,\n        total_communications: this.communications.length,\n      },\n    });\n\n    // Print final summary\n    this.printSummary();\n\n    this.logAgentPhase('dead');\n  }\n\n  /**\n   * Track performance metric\n   */\n  private trackPerformance(operation: string, duration: number): void {\n    if (!this.performanceMetrics.has(operation)) {\n      this.performanceMetrics.set(operation, []);\n    }\n    this.performanceMetrics.get(operation)!.push(duration);\n  }\n\n  /**\n   * Print agent summary\n   */\n  printSummary(): void {\n    const uptime = new Date().getTime() - new Date(this.state.startTime).getTime();\n\n    console.log('\\n' + '='.repeat(60));\n    console.log(`📊 Agent Summary: ${this.config.agentId}`);\n    console.log('='.repeat(60));\n    console.log('');\n    console.log(`Uptime:          ${(uptime / 1000).toFixed(2)}s`);\n    console.log(`Tasks Completed: ${Array.from(this.tasks.values()).filter(t => t.status === 'completed').length}`);\n    console.log(`Tasks Failed:    ${Array.from(this.tasks.values()).filter(t => t.status === 'failed').length}`);\n    console.log(`Decisions Made:  ${this.decisions.length}`);\n    console.log(`Messages Sent:   ${this.communications.filter(c => c.type === 'send').length}`);\n    console.log(`Messages Recv:   ${this.communications.filter(c => c.type === 'receive').length}`);\n    console.log('');\n\n    // Performance metrics\n    if (this.performanceMetrics.size > 0) {\n      console.log('Performance Metrics:');\n      console.log('-'.repeat(60));\n\n      for (const [operation, durations] of this.performanceMetrics.entries()) {\n        const avg = durations.reduce((a, b) => a + b, 0) / durations.length;\n        const min = Math.min(...durations);\n        const max = Math.max(...durations);\n\n        console.log(`  ${operation.padEnd(30)} ${durations.length}x  avg: ${avg.toFixed(1)}ms  min: ${min.toFixed(1)}ms  max: ${max.toFixed(1)}ms`);\n      }\n      console.log('');\n    }\n\n    console.log('='.repeat(60) + '\\n');\n  }\n\n  /**\n   * Print timeline\n   */\n  printTimeline(): void {\n    if (!this.config.timeline || this.timeline.length === 0) return;\n\n    console.log('\\n' + '='.repeat(60));\n    console.log('📅 Agent Timeline');\n    console.log('='.repeat(60) + '\\n');\n\n    const startTime = new Date(this.timeline[0].timestamp).getTime();\n\n    for (const event of this.timeline) {\n      const elapsed = new Date(event.timestamp).getTime() - startTime;\n      const time = `+${(elapsed / 1000).toFixed(3)}s`;\n\n      console.log(`${time.padStart(10)} | ${event.type.padEnd(20)} | ${JSON.stringify(event.data || event)}`);\n    }\n\n    console.log('\\n' + '='.repeat(60) + '\\n');\n  }\n\n  /**\n   * Get current state\n   */\n  getState(): AgentState {\n    return { ...this.state };\n  }\n\n  /**\n   * Get task history\n   */\n  getTasks(): AgentTask[] {\n    return Array.from(this.tasks.values());\n  }\n\n  /**\n   * Get decisions\n   */\n  getDecisions(): AgentDecision[] {\n    return [...this.decisions];\n  }\n\n  /**\n   * Get communications\n   */\n  getCommunications(): any[] {\n    return [...this.communications];\n  }\n\n  /**\n   * Close debug stream\n   */\n  close(): void {\n    this.debug.close();\n  }\n}\n\n/**\n * Create agent debug stream\n */\nexport function createAgentDebugStream(config: AgentDebugConfig): AgentDebugStream {\n  return new AgentDebugStream(config);\n}\n\n/**\n * Create from environment variables\n */\nexport function createAgentDebugStreamFromEnv(agentId: string, tenantId?: string): AgentDebugStream {\n  const debugLevel = process.env.DEBUG_LEVEL?.toUpperCase() as keyof typeof DebugLevel || 'VERBOSE';\n\n  return new AgentDebugStream({\n    agentId,\n    tenantId: tenantId || process.env.FEDERATION_TENANT_ID,\n    level: DebugLevel[debugLevel] || DebugLevel.VERBOSE,\n    format: (process.env.DEBUG_FORMAT as any) || 'human',\n    output: (process.env.DEBUG_OUTPUT as any) || 'console',\n    outputFile: process.env.DEBUG_OUTPUT_FILE,\n    colorize: process.env.DEBUG_COLORIZE !== 'false',\n    trackState: process.env.DEBUG_TRACK_STATE !== 'false',\n    trackDecisions: process.env.DEBUG_TRACK_DECISIONS !== 'false',\n    trackCommunication: process.env.DEBUG_TRACK_COMMUNICATION !== 'false',\n    timeline: process.env.DEBUG_TIMELINE === 'true',\n  });\n}\n"]}