conversation-flow-monitor

# Conversation Flow Monitor Prevents conversations from getting stuck by implementing comprehensive error handling, timeout management, and recovery strategies. ## Problem Statement Conversations frequently get stuck due to: - Skill registration failures (missing YAML front matter) - Browser automation hanging without proper timeouts - File operations on non-existent paths - Network operations that timeout or fail silently - Cascading failures in multi-step workflows ## Solution Overview This skill provides: 1. **Proactive Validation**: Validates skill files and system state before execution 2. **Robust Error Handling**: Implements proper try-catch patterns with fallbacks 3. **Timeout Management**: Enforces reasonable timeouts on all operations 4. **Recovery Mechanisms**: Provides graceful degradation when primary approaches fail 5. **Monitoring & Logging**: Tracks conversation health and logs potential issues ## Key Features ### 1. Skill Validation Helper Automatically validates SKILL.md files have proper YAML front matter before installation. ### 2. Safe Tool Execution Wrapper Wraps all tool calls with timeout protection and error recovery. ### 3. Conversation Health Monitoring Monitors conversation flow and detects potential stuck states. ### 4. Recovery Strategies Provides alternative approaches when primary methods fail. ### 5. Diagnostic Logging Logs detailed diagnostics for troubleshooting conversation issues. ## Usage Patterns ### Before Complex Operations ```python # Validate environment before starting complex workflows validate_skill_files() check_system_dependencies() ``` ### Safe Tool Execution ```python # Instead of direct tool calls result = safe_execute_tool( tool_name="browser_use", params={"action": "open", "url": "https://example.com"}, timeout=30, retries=2 ) ``` ### Conversation Health Check ```python # Periodic health check during long conversations if conversation_health_check(): continue_normal_operation() else: initiate_recovery_protocol() ``` ## Integration Points ### With self-improving-agent - Logs conversation flow issues to `.learnings/ERRORS.md` - Promotes successful recovery patterns to permanent memory - Tracks recurring conversation failure patterns ### With OpenClaw Workspace - Integrates with existing AGENTS.md guidelines - Updates SOUL.md with behavioral improvements - Enhances TOOLS.md with tool-specific reliability notes ## Installation This skill is automatically available when installed in the active_skills directory. ## Best Practices 1. **Always validate first**: Check skill files and system state before execution 2. **Use reasonable timeouts**: Never let operations run indefinitely 3. **Implement fallbacks**: Always have alternative approaches ready 4. **Log everything**: Detailed logging helps identify root causes 5. **Monitor proactively**: Don't wait for failures to implement monitoring ## Error Categories Handled | Error Type | Detection Method | Recovery Strategy | |------------|------------------|-------------------| | Skill Registration | YAML front matter validation | Auto-fix missing fields | | Browser Hang | Timeout monitoring | Switch to alternative browser method | | File Not Found | Pre-operation path validation | Create missing directories/files | | Network Timeout | Connection timeout enforcement | Retry with exponential backoff | | Memory Issues | Resource usage monitoring | Cleanup and restart lightweight operations | ## Performance Impact - Minimal overhead (<5% performance impact) - Only activates during potentially problematic operations - Configurable sensitivity levels ## Future Enhancements - Machine learning-based anomaly detection - Predictive failure prevention - Automated root cause analysis - Cross-session conversation pattern learning