smart_message 0.0.10 → 0.0.12

data/docs/README.md

@@ -1,57 +0,0 @@
-# SmartMessage Documentation
-
-Welcome to the comprehensive documentation for SmartMessage, a Ruby gem that abstracts messages from backend transport systems.
-
-## Table of Contents
-
-### Getting Started
-- [Installation & Quick Start](getting-started.md)
-- [Basic Usage Examples](examples.md)
-
-### Core Concepts
-- [Architecture Overview](architecture.md)
-- [Message Lifecycle](message-lifecycle.md)
-- [Plugin System](plugin-system.md)
-
-### Components
-- [SmartMessage::Base](base.md)
-- [Property System](properties.md)
-- [Entity Addressing](addressing.md)
-- [Message Filtering](message_filtering.md)
-- [Transport Layer](transports.md)
-- [Serializers](serializers.md)
-- [Logging System](logging.md)
-- [Dispatcher & Routing](dispatcher.md)
-- [Message Headers](headers.md)
-- [Dead Letter Queue](dead_letter_queue.md)
-
-### Advanced Topics
-- [Custom Transports](custom-transports.md)
-- [Custom Serializers](custom-serializers.md)
-- [Gateway Patterns](gateway-patterns.md)
-- [Statistics & Monitoring](monitoring.md)
-- [Thread Safety](thread-safety.md)
-
-### Development
-- [Testing Guide](testing.md)
-- [Contributing](contributing.md)
-- [Troubleshooting](troubleshooting.md)
-
-### Reference
-- [API Reference](api-reference.md)
-- [Configuration Options](configuration.md)
-- [Error Handling](error-handling.md)
-
-## Quick Navigation
-
-- **New to SmartMessage?** Start with [Getting Started](getting-started.md)
-- **Need examples?** Check out [Examples](examples.md)
-- **Understanding the architecture?** Read [Architecture Overview](architecture.md)
-- **Building custom components?** See [Custom Transports](custom-transports.md) and [Custom Serializers](custom-serializers.md)
-- **Having issues?** Visit [Troubleshooting](troubleshooting.md)
-
-## Version
-
-This documentation is for SmartMessage v0.0.8.
-
-For older versions, please check the git tags and corresponding documentation.

data/examples/dead_letters.jsonl

@@ -1,12 +0,0 @@
-{"timestamp":"2025-08-19T16:03:52-05:00","header":{"uuid":"ecb4c4f9-e9a7-47fd-918a-8dc5087218d6","message_class":"OrderMessage","published_at":"2025-08-19T16:03:52.374-05:00","publisher_pid":16266,"version":1,"from":"OrderService","serializer":"SmartMessage::Serializer::JSON"},"payload":"{\"order_id\":\"ORD-1001\",\"customer_id\":\"CUST-001\",\"amount\":99.99,\"currency\":\"USD\",\"payment_method\":\"credit_card\",\"items\":[\"Widget A\",\"Widget B\"]}","payload_format":"json","error":"wrong number of arguments (given 1, expected 2)","retry_count":0,"transport":"circuit_breaker","stack_trace":null}
-{"timestamp":"2025-08-19T16:03:52-05:00","header":{"uuid":"40dce8a2-1723-48f5-ad01-fe49814991a2","message_class":"OrderMessage","published_at":"2025-08-19T16:03:52.889-05:00","publisher_pid":16266,"version":1,"from":"OrderService","serializer":"SmartMessage::Serializer::JSON"},"payload":"{\"order_id\":\"ORD-1002\",\"customer_id\":\"CUST-002\",\"amount\":1299.99,\"currency\":\"USD\",\"payment_method\":\"debit_card\",\"items\":[\"Premium Widget\",\"Extended Warranty\"]}","payload_format":"json","error":"wrong number of arguments (given 1, expected 2)","retry_count":0,"transport":"circuit_breaker","stack_trace":null}
-{"timestamp":"2025-08-19T16:03:53-05:00","header":{"uuid":"0e1a228b-4069-4c05-b1ed-18193174d773","message_class":"OrderMessage","published_at":"2025-08-19T16:03:53.397-05:00","publisher_pid":16266,"version":1,"from":"OrderService","serializer":"SmartMessage::Serializer::JSON"},"payload":"{\"order_id\":\"ORD-1003\",\"customer_id\":\"CUST-003\",\"amount\":45.5,\"currency\":\"USD\",\"payment_method\":\"paypal\",\"items\":[\"Small Widget\"]}","payload_format":"json","error":"wrong number of arguments (given 1, expected 2)","retry_count":0,"transport":"circuit_breaker","stack_trace":null}
-{"timestamp":"2025-08-19T16:04:01-05:00","header":{"uuid":"60ca2ca3-8185-4946-ae20-85269073ce3e","message_class":"UserEventMessage","published_at":"2025-08-19T16:04:01.582-05:00","publisher_pid":16396,"version":1,"from":"UserManager","serializer":"SmartMessage::Serializer::JSON"},"payload":"{\"event_id\":\"EVT-1001\",\"event_type\":\"user_registered\",\"user_id\":\"USER-101\",\"user_email\":\"alice@example.com\",\"user_name\":\"Alice Johnson\",\"timestamp\":\"2025-08-19T16:04:01-05:00\",\"metadata\":{\"source\":\"web_registration\"}}","payload_format":"json","error":"wrong number of arguments (given 1, expected 2)","retry_count":0,"transport":"circuit_breaker","stack_trace":null}
-{"timestamp":"2025-08-19T16:23:07-05:00","header":{"uuid":"ebd1f61b-e5d9-48f4-a787-e1f9f4e09578","message_class":"SystemNotificationMessage","published_at":"2025-08-19T16:23:07.222-05:00","publisher_pid":24163,"version":1,"from":"user-001","serializer":"SmartMessage::Serializer::JSON"},"payload":"{\"notification_id\":\"NOTIF-1755638587-564\",\"room_id\":\"general\",\"notification_type\":\"user_joined\",\"content\":\"Alice joined the room\",\"timestamp\":\"2025-08-19T16:23:07-05:00\",\"metadata\":{\"triggered_by\":\"user-001\"}}","payload_format":"json","error":"undefined method 'handle_system_notification_user-001' for class 'HumanChatAgent'","retry_count":0,"transport":"circuit_breaker","stack_trace":null}
-{"timestamp":"2025-08-19T16:25:50-05:00","header":{"uuid":"e722ef85-7168-42e2-94c2-cc55c1ca6784","message_class":"PaymentMessage","published_at":"2025-08-19T16:25:50.310-05:00","publisher_pid":25696,"version":1,"from":"payment-service","to":"dev-payment-processor","serializer":"SmartMessage::Serializer::JSON"},"payload":"{\"service_id\":\"payment-core\",\"message_type\":\"transaction_complete\",\"data\":{\"merchant\":\"Online Store\"},\"environment\":\"dev\",\"timestamp\":\"2025-08-19T16:25:50-05:00\",\"transaction_id\":\"TXN-001\",\"amount\":99.99,\"currency\":\"USD\"}","payload_format":"json","error":"undefined method 'process_dev' for class 'PaymentMessage'","retry_count":0,"transport":"circuit_breaker","stack_trace":null}
-{"timestamp":"2025-08-19T16:25:50-05:00","header":{"uuid":"d36c3c66-bccc-49af-b919-b62bc6c9e1b2","message_class":"PaymentMessage","published_at":"2025-08-19T16:25:50.831-05:00","publisher_pid":25696,"version":1,"from":"payment-service","to":"prod-payment-processor","serializer":"SmartMessage::Serializer::JSON"},"payload":"{\"service_id\":\"payment-core\",\"message_type\":\"transaction_complete\",\"data\":{\"merchant\":\"Enterprise Store\"},\"environment\":\"prod\",\"timestamp\":\"2025-08-19T16:25:50-05:00\",\"transaction_id\":\"TXN-002\",\"amount\":299.99,\"currency\":\"USD\"}","payload_format":"json","error":"undefined method 'process_prod' for class 'PaymentMessage'","retry_count":0,"transport":"circuit_breaker","stack_trace":null}
-{"timestamp":"2025-08-19T16:25:52-05:00","header":{"uuid":"d3371fb3-ed6e-403c-8f3b-3b130958a013","message_class":"AlertMessage","published_at":"2025-08-19T16:25:52.351-05:00","publisher_pid":25696,"version":1,"from":"admin","to":"security-dashboard","serializer":"SmartMessage::Serializer::JSON"},"payload":"{\"service_id\":\"security-scanner\",\"message_type\":\"security_alert\",\"data\":{\"attempts\":50,\"ip\":\"192.168.1.100\"},\"environment\":\"prod\",\"timestamp\":\"2025-08-19T16:25:52-05:00\",\"alert_level\":\"critical\",\"component\":\"authentication\",\"description\":\"Multiple failed login attempts detected\"}","payload_format":"json","error":"undefined method 'process_admin' for class 'AlertMessage'","retry_count":0,"transport":"circuit_breaker","stack_trace":null}
-{"timestamp":"2025-08-19T16:25:52-05:00","header":{"uuid":"46a5b557-540c-4d50-a1f9-030907ba6275","message_class":"AlertMessage","published_at":"2025-08-19T16:25:52.860-05:00","publisher_pid":25696,"version":1,"from":"system-metrics","to":"ops-dashboard","serializer":"SmartMessage::Serializer::JSON"},"payload":"{\"service_id\":\"system-monitor\",\"message_type\":\"resource_alert\",\"data\":{\"usage_percent\":85,\"threshold\":80},\"environment\":\"staging\",\"timestamp\":\"2025-08-19T16:25:52-05:00\",\"alert_level\":\"warning\",\"component\":\"memory\",\"description\":\"Memory usage above threshold\"}","payload_format":"json","error":"Circuit 'message_processor' is open","retry_count":0,"transport":"circuit_breaker","stack_trace":null}
-{"timestamp":"2025-08-19T16:25:52-05:00","header":{"uuid":"46a5b557-540c-4d50-a1f9-030907ba6275","message_class":"AlertMessage","published_at":"2025-08-19T16:25:52.860-05:00","publisher_pid":25696,"version":1,"from":"system-metrics","to":"ops-dashboard","serializer":"SmartMessage::Serializer::JSON"},"payload":"{\"service_id\":\"system-monitor\",\"message_type\":\"resource_alert\",\"data\":{\"usage_percent\":85,\"threshold\":80},\"environment\":\"staging\",\"timestamp\":\"2025-08-19T16:25:52-05:00\",\"alert_level\":\"warning\",\"component\":\"memory\",\"description\":\"Memory usage above threshold\"}","payload_format":"json","error":"Circuit 'message_processor' is open","retry_count":0,"transport":"circuit_breaker","stack_trace":null}
-{"timestamp":"2025-08-19T16:25:53-05:00","header":{"uuid":"8ebceac3-8c5d-4253-b2a2-ce754084c3c2","message_class":"OrderMessage","published_at":"2025-08-19T16:25:53.365-05:00","publisher_pid":25696,"version":1,"from":"admin-dashboard","to":"prod-fulfillment","serializer":"SmartMessage::Serializer::JSON"},"payload":"{\"service_id\":\"admin-portal\",\"message_type\":\"admin_order_override\",\"data\":{\"priority\":\"high\",\"reason\":\"VIP customer\"},\"environment\":\"prod\",\"timestamp\":\"2025-08-19T16:25:53-05:00\",\"order_id\":\"ORD-999\",\"customer_id\":\"ADMIN\",\"status\":\"expedited\"}","payload_format":"json","error":"Circuit 'message_processor' is open","retry_count":0,"transport":"circuit_breaker","stack_trace":null}
-{"timestamp":"2025-08-19T16:25:53-05:00","header":{"uuid":"8dfa4fed-f2df-4f66-81c2-963a97489a31","message_class":"PaymentMessage","published_at":"2025-08-19T16:25:53.873-05:00","publisher_pid":25696,"version":1,"from":"admin","serializer":"SmartMessage::Serializer::JSON"},"payload":"{\"service_id\":\"payment-system\",\"message_type\":\"system_maintenance\",\"data\":{\"message\":\"Scheduled maintenance in 30 minutes\",\"duration\":\"2 hours\",\"affected_services\":[\"payment\",\"billing\"]},\"environment\":\"prod\",\"timestamp\":\"2025-08-19T16:25:53-05:00\",\"transaction_id\":\"MAINT-001\",\"amount\":0,\"currency\":\"USD\"}","payload_format":"json","error":"Circuit 'message_processor' is open","retry_count":0,"transport":"circuit_breaker","stack_trace":null}

data/examples/temp.txt

@@ -1,94 +0,0 @@
-=== SmartMessage Example: Point-to-Point Order Processing ===
-
-🚀 Starting Order Processing Demo
-🏪 OrderService: Starting up...
-💳 PaymentService: Starting up...
-
-============================================================
-Processing Sample Orders
-============================================================
-
---- Order 1 ---
-
-🏪 OrderService: Creating order ORD-1001
-🏪 OrderService: Sending order to payment processing...
-
-===================================================
-== SmartMessage Published via STDOUT Transport
-== Single-Tier Serialization:
-== Message Class: OrderMessage
-== Serialized Message: {"_sm_header":{"uuid":"d9a7f410-b902-4a67-9e22-694d3bf01b5f","message_class":"OrderMessage","published_at":"2025-08-20 12:02:21 -0500","publisher_pid":50033,"version":1,"from":"OrderService","serializer":"SmartMessage::Serializer::Json"},"_sm_payload":{"order_id":"ORD-1001","customer_id":"CUST-001","amount":99.99,"currency":"USD","payment_method":"credit_card","items":["Widget A","Widget B"]}}
-===================================================
-
-💳 PaymentService: Starting up...
-💳 PaymentService: Processing payment for order ORD-1001
-💳 PaymentService: Sending payment response...
-
-===================================================
-== SmartMessage Published via STDOUT Transport
-== Single-Tier Serialization:
-== Message Class: PaymentResponseMessage
-== Serialized Message: {"_sm_header":{"uuid":"ca09a331-d5b9-4250-ab4c-542a1b1db9c7","message_class":"PaymentResponseMessage","published_at":"2025-08-20 12:02:21 -0500","publisher_pid":50033,"version":1,"from":"PaymentService","serializer":"SmartMessage::Serializer::Json"},"_sm_payload":{"order_id":"ORD-1001","payment_id":"PAY-5001","status":"success","message":"Payment processed successfully","processed_at":"2025-08-20T12:02:21-05:00"}}
-===================================================
-
-✅ Payment success: Order ORD-1001 - Payment processed successfully
-
---- Order 2 ---
-
-🏪 OrderService: Creating order ORD-1002
-🏪 OrderService: Sending order to payment processing...
-
-===================================================
-== SmartMessage Published via STDOUT Transport
-== Single-Tier Serialization:
-== Message Class: OrderMessage
-== Serialized Message: {"_sm_header":{"uuid":"85ee7a93-ad19-48b3-9366-b6ed6dbb9e0e","message_class":"OrderMessage","published_at":"2025-08-20 12:02:22 -0500","publisher_pid":50033,"version":1,"from":"OrderService","serializer":"SmartMessage::Serializer::Json"},"_sm_payload":{"order_id":"ORD-1002","customer_id":"CUST-002","amount":1299.99,"currency":"USD","payment_method":"debit_card","items":["Premium Widget","Extended Warranty"]}}
-===================================================
-
-💳 PaymentService: Starting up...
-💳 PaymentService: Processing payment for order ORD-1002
-💳 PaymentService: Sending payment response...
-
-===================================================
-== SmartMessage Published via STDOUT Transport
-== Single-Tier Serialization:
-== Message Class: PaymentResponseMessage
-== Serialized Message: {"_sm_header":{"uuid":"773c1dc9-5ee2-4866-a5d0-95701f436250","message_class":"PaymentResponseMessage","published_at":"2025-08-20 12:02:22 -0500","publisher_pid":50033,"version":1,"from":"PaymentService","serializer":"SmartMessage::Serializer::Json"},"_sm_payload":{"order_id":"ORD-1002","payment_id":"PAY-5001","status":"failed","message":"Insufficient funds","processed_at":"2025-08-20T12:02:22-05:00"}}
-===================================================
-
-❌ Payment failed: Order ORD-1002 - Insufficient funds
-
---- Order 3 ---
-
-🏪 OrderService: Creating order ORD-1003
-🏪 OrderService: Sending order to payment processing...
-
-===================================================
-== SmartMessage Published via STDOUT Transport
-== Single-Tier Serialization:
-== Message Class: OrderMessage
-== Serialized Message: {"_sm_header":{"uuid":"5b3cb763-8c3e-470f-b6f9-dd5e0929f926","message_class":"OrderMessage","published_at":"2025-08-20 12:02:22 -0500","publisher_pid":50033,"version":1,"from":"OrderService","serializer":"SmartMessage::Serializer::Json"},"_sm_payload":{"order_id":"ORD-1003","customer_id":"CUST-003","amount":45.5,"currency":"USD","payment_method":"paypal","items":["Small Widget"]}}
-===================================================
-
-💳 PaymentService: Starting up...
-💳 PaymentService: Processing payment for order ORD-1003
-💳 PaymentService: Sending payment response...
-
-===================================================
-== SmartMessage Published via STDOUT Transport
-== Single-Tier Serialization:
-== Message Class: PaymentResponseMessage
-== Serialized Message: {"_sm_header":{"uuid":"dc35ea12-28a5-4926-854a-d2cc52f6c91b","message_class":"PaymentResponseMessage","published_at":"2025-08-20 12:02:22 -0500","publisher_pid":50033,"version":1,"from":"PaymentService","serializer":"SmartMessage::Serializer::Json"},"_sm_payload":{"order_id":"ORD-1003","payment_id":"PAY-5001","status":"success","message":"Payment processed successfully","processed_at":"2025-08-20T12:02:22-05:00"}}
-===================================================
-
-✅ Payment success: Order ORD-1003 - Payment processed successfully
-
-⏳ Waiting for all payments to process...
-
-✨ Demo completed!
-
-This example demonstrated:
-• Point-to-point messaging between OrderService and PaymentService
-• Bidirectional communication with request/response pattern
-• JSON serialization of complex message data
-• STDOUT transport with loopback for local demonstration

data/examples/tmux_chat/README.md

@@ -1,283 +0,0 @@
-# SmartMessage Tmux Chat Visualization
-
-This is an enhanced version of the many-to-many chat example that uses tmux to provide a clear, visual representation of the messaging interactions between different agents across multiple chat rooms.
-
-## Overview
-
-Instead of having all output mixed together in a single terminal, this tmux version separates:
-
-- **Room Monitors**: Visual displays showing activity in each chat room
-- **Human Agents**: Interactive chat clients for simulated users
-- **Bot Agents**: Automated responders with various capabilities
-
-## Layout
-
-The tmux session creates three windows:
-
-### Window 0: Chat Control Center (2x2 grid)
-```
-┌─────────────────┬─────────────────┐
-│   General Room  │    Tech Room    │
-│     Monitor     │     Monitor     │
-├─────────────────┼─────────────────┤
-│   Random Room   │  System Info &  │
-│     Monitor     │   Instructions  │
-└─────────────────┴─────────────────┘
-```
-
-### Window 1: Human Agents (3 panes)
-```
-┌─────────────────┬─────────────────┐
-│                 │      Bob        │
-│     Alice       ├─────────────────┤
-│                 │     Carol       │
-└─────────────────┴─────────────────┘
-```
-
-### Window 2: Bot Agents (2 panes)
-```
-┌─────────────────┬─────────────────┐
-│    HelpBot      │    FunBot       │
-│                 │                 │
-└─────────────────┴─────────────────┘
-```
-
-## Features
-
-### Room Monitors
-Each room monitor shows:
-- Real-time message activity for that specific room
-- User join/leave notifications
-- Command detections
-- Activity status (active/quiet/inactive)
-- Message count and participant statistics
-
-### Human Agents
-Interactive chat clients with:
-- Command support (`/join`, `/leave`, `/list`, `/help`, `/quit`)
-- Multi-room messaging
-- Auto-response to mentions
-- Real-time message display
-
-### Bot Agents
-Automated agents with capabilities like:
-- **HelpBot**: `/help`, `/stats`, `/time`
-- **FunBot**: `/joke`, `/weather`, `/echo`
-- Keyword responses (hello, help, thank you)
-- Command processing with visual feedback
-
-## Quick Start
-
-### Prerequisites
-- tmux installed (`brew install tmux` on macOS)
-- Ruby with SmartMessage gem
-- Terminal with decent size (recommended: 120x40 or larger)
-
-### Running the Demo
-
-```bash
-# Start the entire chat system
-cd examples/tmux_chat
-./start_chat_demo.sh
-```
-
-### Navigation
-
-Once in tmux:
-
-**Switch Between Windows:**
-- **Ctrl+b then 0**: Switch to Control Center (room monitors)
-- **Ctrl+b then 1**: Switch to Human Agents (Alice, Bob, Carol)
-- **Ctrl+b then 2**: Switch to Bot Agents (HelpBot, FunBot)
-
-**Move Between Panes (within a window):**
-- **Ctrl+b then o**: Cycle through all panes in current window
-- **Ctrl+b then arrow keys**: Move directly to pane in that direction (↑↓←→)
-- **Ctrl+b then ;**: Toggle between current and last pane
-
-**Other Useful Commands:**
-- **Ctrl+b then z**: Zoom current pane (toggle fullscreen)
-- **Ctrl+b then d**: Detach from session (keeps it running)
-- **Ctrl+b then ?**: Show all tmux commands
-
-### Getting Started Workflow
-
-1. **After starting the demo**, you'll be in the Human Agents window (window 1)
-2. **Look for the active pane** (has colored border) - usually Alice's pane
-3. **Start typing immediately** - you're in the chat interface, not bash
-4. **Try these first commands:**
-   ```
-   /join general
-   Hello everyone!
-   /help
-   ```
-5. **Switch to other agents** using `Ctrl+b then o` to see different perspectives
-6. **Watch room activity** by switching to Control Center: `Ctrl+b then 0`
-
-### Interacting with Agents
-
-In any human agent pane (Alice, Bob, Carol):
-```bash
-# Join rooms
-/join general
-/join tech
-/join random
-
-# Send messages (goes to all your active rooms)
-Hello everyone!
-
-# Use bot commands
-/help
-/joke
-/weather Tokyo
-/stats
-
-# Mention other users
-@alice how are you?
-
-# Leave rooms
-/leave tech
-
-# Exit
-/quit
-```
-
-### Stopping the Demo
-
-```bash
-# From outside tmux
-./stop_chat_demo.sh
-
-# Or from inside tmux
-Ctrl+b then d  # Detach
-./stop_chat_demo.sh
-```
-
-## Architecture
-
-### File-Based Transport
-
-This example uses a custom `FileTransport` that:
-- Writes messages to room-specific queue files in `/tmp/smart_message_chat/`
-- Polls files for new messages
-- Enables inter-process communication between tmux panes
-- Cleans up automatically on shutdown
-
-### Message Types
-
-Three types of messages flow through the system:
-
-1. **ChatMessage**: Regular chat messages
-2. **BotCommandMessage**: Commands directed to bots
-3. **SystemNotificationMessage**: Join/leave/system events
-
-### Agent Types
-
-- **BaseAgent**: Common functionality for all agents
-- **HumanChatAgent**: Interactive user simulation
-- **BotChatAgent**: Automated response agents
-- **RoomMonitor**: Display-only room activity monitors
-
-## Advantages Over Single-Terminal Version
-
-### Visual Clarity
-- **Room Separation**: See each room's activity independently
-- **Agent Separation**: Each agent has its own display space
-- **Real-time Updates**: Monitors show live activity as it happens
-
-### Better Understanding
-- **Message Flow**: Clearly see how messages route between rooms
-- **Agent Behavior**: Watch how different agents respond to events
-- **System Dynamics**: Observe the many-to-many messaging patterns
-
-### Interactive Experience
-- **Multiple Perspectives**: Switch between different agent viewpoints
-- **Live Interaction**: Type and send messages in real-time
-- **System Monitoring**: Watch room activity while participating
-
-## Example Workflow
-
-1. **Start the demo**: `./start_chat_demo.sh`
-2. **Watch the Control Center**: See rooms come online and initial messages
-3. **Switch to Human Agents**: Navigate to Alice, Bob, or Carol
-4. **Join rooms**: Use `/join general` to participate
-5. **Send messages**: Type anything to chat in your active rooms
-6. **Try bot commands**: Use `/joke`, `/weather`, `/help`
-7. **Watch interactions**: Switch back to Control Center to see message flow
-8. **Monitor bots**: Check Bot Agents window to see bot responses
-
-## Customization
-
-### Adding New Rooms
-Edit `start_chat_demo.sh` to add more room monitors:
-```bash
-tmux new-window -t $SESSION_NAME -n "New-Room"
-tmux send-keys "ruby room_monitor.rb newroom" C-m
-```
-
-### Adding New Agents
-Create additional panes:
-```bash
-tmux split-window -t $SESSION_NAME:1 -v
-tmux send-keys "ruby human_agent.rb david David" C-m
-```
-
-### Custom Bot Capabilities
-Modify `bot_agent.rb` or create new bots:
-```bash
-ruby bot_agent.rb mybot MyBot "custom,commands,here"
-```
-
-## Troubleshooting
-
-### Common Issues
-
-**Tmux not found**:
-```bash
-# macOS
-brew install tmux
-
-# Ubuntu/Debian
-sudo apt-get install tmux
-```
-
-**Messages not appearing**:
-- Check that `/tmp/smart_message_chat/` directory exists
-- Verify agents have joined the same rooms
-- Try stopping and restarting the demo
-
-**Pane too small**:
-- Resize terminal window to at least 120x40
-- Use `Ctrl+b then z` to zoom a pane temporarily
-
-**Agents not responding**:
-- Check that agents are in the same rooms (`/list` command)
-- Verify bot capabilities match the commands being used
-
-**Agents crash with console errors**:
-- Fixed in latest version - agents now handle missing IO.console gracefully
-- If issues persist, check Ruby version and terminal compatibility
-
-### Manual Cleanup
-
-If the automatic cleanup doesn't work:
-```bash
-# Kill tmux session
-tmux kill-session -t smart_message_chat
-
-# Remove message queues
-rm -rf /tmp/smart_message_chat
-```
-
-## Educational Value
-
-This visualization helps understand:
-
-- **Many-to-many messaging patterns**
-- **Room-based routing and filtering** 
-- **Agent coordination and communication**
-- **Event-driven architecture**
-- **Real-time system monitoring**
-- **Service discovery and capabilities**
-
-Perfect for demonstrating SmartMessage's power in complex, distributed scenarios!