smart_message 0.0.10 → 0.0.13

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!

data/examples/tmux_chat/bot_agent.rb

@@ -1,278 +0,0 @@
-#!/usr/bin/env ruby
-# examples/tmux_chat/bot_agent.rb
-#
-# Bot agent for tmux chat visualization
-
-require_relative 'shared_chat_system'
-
-class BotChatAgent < BaseAgent
-  def initialize(bot_id:, name:, capabilities: [])
-    @capabilities = capabilities
-    @command_count = 0
-    super(agent_id: bot_id, name: name, agent_type: 'bot')
-    
-    log_display("🤖 Bot #{@name} online!")
-    log_display("🔧 Capabilities: #{@capabilities.join(', ')}")
-    log_display("⚡ Listening for commands and messages...")
-    log_display("")
-  end
-
-  def setup_subscriptions
-    # Subscribe to bot commands and chat messages
-    BotCommandMessage.subscribe("BotChatAgent.handle_bot_command_#{@agent_id}")
-    ChatMessage.subscribe("BotChatAgent.handle_chat_message_#{@agent_id}")
-    
-    # Register this instance
-    @@bots ||= {}
-    @@bots[@agent_id] = self
-  end
-
-  def run
-    # Start processing messages and wait
-    begin
-      while true
-        sleep(1)
-      end
-    rescue Interrupt
-      shutdown
-    end
-  end
-
-  # Class method routing for SmartMessage
-  def self.method_missing(method_name, *args)
-    if method_name.to_s.start_with?('handle_bot_command_')
-      bot_id = method_name.to_s.split('_').last
-      bot = (@@bots ||= {})[bot_id]
-      bot&.handle_bot_command(*args)
-    elsif method_name.to_s.start_with?('handle_chat_message_')
-      bot_id = method_name.to_s.split('_').last
-      bot = (@@bots ||= {})[bot_id]
-      bot&.handle_chat_message(*args)
-    else
-      super
-    end
-  end
-
-  def handle_bot_command(wrapper)
-    message_header, message_payload = wrapper.split
-    command_data = JSON.parse(message_payload)
-    
-    # Only handle commands in rooms we're in and commands we can handle
-    return unless @active_rooms.include?(command_data['room_id'])
-    return unless can_handle_command?(command_data['command'])
-    
-    @command_count += 1
-    log_display("⚡ Processing command: /#{command_data['command']} (#{@command_count})")
-    
-    process_command(command_data)
-  end
-
-  def handle_chat_message(wrapper)
-    message_header, message_payload = wrapper.split
-    chat_data = JSON.parse(message_payload)
-    
-    # Only process messages from rooms we're in and not our own messages
-    return unless @active_rooms.include?(chat_data['room_id'])
-    return if chat_data['sender_id'] == @agent_id
-    
-    # Don't respond to other bots to avoid infinite loops
-    return if chat_data['message_type'] == 'bot'
-    
-    # Log the message
-    log_display("👁️  [#{chat_data['room_id']}] #{chat_data['sender_name']}: #{chat_data['content']}")
-    
-    # Check if it's a bot command
-    if chat_data['content'].start_with?('/')
-      handle_inline_command(chat_data)
-    else
-      # Respond to certain keywords from human users only
-      respond_to_keywords(chat_data)
-    end
-  end
-
-  def can_handle_command?(command)
-    @capabilities.include?(command)
-  end
-
-  private
-
-  def handle_inline_command(chat_data)
-    content = chat_data['content']
-    command_parts = content[1..-1].split(' ')
-    command = command_parts.first
-    parameters = command_parts[1..-1]
-    
-    return unless can_handle_command?(command)
-    
-    # Create bot command message
-    bot_command = BotCommandMessage.new(
-      command_id: "CMD-#{@agent_id}-#{Time.now.to_i}-#{rand(1000)}",
-      room_id: chat_data['room_id'],
-      user_id: chat_data['sender_id'],
-      user_name: chat_data['sender_name'],
-      command: command,
-      parameters: parameters,
-      timestamp: Time.now.iso8601,
-      from: chat_data['sender_id']
-    )
-    
-    bot_command.publish
-  end
-
-  def process_command(command_data)
-    case command_data['command']
-    when 'weather'
-      handle_weather_command(command_data)
-    when 'joke'
-      handle_joke_command(command_data)
-    when 'help'
-      handle_help_command(command_data)
-    when 'stats'
-      handle_stats_command(command_data)
-    when 'time'
-      handle_time_command(command_data)
-    when 'echo'
-      handle_echo_command(command_data)
-    else
-      send_bot_response(
-        room_id: command_data['room_id'],
-        content: "🤷‍♂️ Sorry, I don't know how to handle /#{command_data['command']}"
-      )
-    end
-  end
-
-  def respond_to_keywords(chat_data)
-    content = chat_data['content'].downcase
-    
-    if content.include?('hello') || content.include?('hi')
-      send_bot_response(
-        room_id: chat_data['room_id'],
-        content: "Hello #{chat_data['sender_name']}! 👋"
-      )
-    elsif content.include?('help') && !content.start_with?('/')
-      send_bot_response(
-        room_id: chat_data['room_id'],
-        content: "Type /help to see my commands! 🤖"
-      )
-    elsif content.include?('thank')
-      send_bot_response(
-        room_id: chat_data['room_id'], 
-        content: "You're welcome! 😊"
-      )
-    end
-  end
-
-  def handle_weather_command(command_data)
-    location = command_data['parameters'].first || 'your location'
-    weather_responses = [
-      "☀️ It's sunny and 72°F in #{location}!",
-      "🌧️ Looks like rain and 65°F in #{location}",
-      "❄️ Snow expected, 32°F in #{location}",
-      "⛅ Partly cloudy, 68°F in #{location}",
-      "🌪️ Tornado warning in #{location}! (Just kidding, it's nice)"
-    ]
-    
-    # Simulate API delay
-    Thread.new do
-      sleep(0.5)
-      send_bot_response(
-        room_id: command_data['room_id'],
-        content: weather_responses.sample
-      )
-    end
-  end
-
-  def handle_joke_command(command_data)
-    jokes = [
-      "Why don't scientists trust atoms? Because they make up everything! 😄",
-      "Why did the scarecrow win an award? He was outstanding in his field! 🌾",
-      "What do you call a fake noodle? An impasta! 🍝",
-      "Why don't eggs tell jokes? They'd crack each other up! 🥚",
-      "What do you call a sleeping bull? A bulldozer! 😴",
-      "Why don't robots ever panic? They have enough bytes! 🤖"
-    ]
-    
-    send_bot_response(
-      room_id: command_data['room_id'],
-      content: jokes.sample
-    )
-  end
-
-  def handle_help_command(command_data)
-    help_text = @capabilities.map do |cmd|
-      "  /#{cmd} - #{get_command_description(cmd)}"
-    end.join("\n")
-    
-    send_bot_response(
-      room_id: command_data['room_id'],
-      content: "🤖 #{@name} Commands:\n#{help_text}"
-    )
-  end
-
-  def handle_stats_command(command_data)
-    send_bot_response(
-      room_id: command_data['room_id'],
-      content: "📊 Bot Stats:\n" +
-               "  • Active rooms: #{@active_rooms.length}\n" +
-               "  • Commands processed: #{@command_count}\n" +
-               "  • Capabilities: #{@capabilities.length}\n" +
-               "  • Uptime: #{Time.now.strftime('%H:%M:%S')}"
-    )
-  end
-
-  def handle_time_command(command_data)
-    timezone = command_data['parameters'].first || 'local'
-    current_time = Time.now.strftime('%Y-%m-%d %H:%M:%S')
-    
-    send_bot_response(
-      room_id: command_data['room_id'],
-      content: "🕒 Current time (#{timezone}): #{current_time}"
-    )
-  end
-
-  def handle_echo_command(command_data)
-    message = command_data['parameters'].join(' ')
-    if message.empty?
-      message = "Echo! Echo! Echo! 📢"
-    end
-    
-    send_bot_response(
-      room_id: command_data['room_id'],
-      content: "🔊 Echo: #{message}"
-    )
-  end
-
-  def get_command_description(command)
-    descriptions = {
-      'weather' => 'Get weather information',
-      'joke' => 'Tell a random joke',
-      'help' => 'Show this help message',
-      'stats' => 'Show bot statistics',
-      'time' => 'Show current time',
-      'echo' => 'Echo your message'
-    }
-    
-    descriptions[command] || 'No description available'
-  end
-
-  def send_bot_response(room_id:, content:)
-    send_message(room_id: room_id, content: content, message_type: 'bot')
-    log_display("💬 Replied to [#{room_id}]: #{content}")
-  end
-end
-
-# Main execution
-if __FILE__ == $0
-  if ARGV.length < 2
-    puts "Usage: #{$0} <bot_id> <name> [capability1,capability2,...]"
-    puts "Example: #{$0} helpbot HelpBot help,stats,time"
-    exit 1
-  end
-  
-  bot_id = ARGV[0]
-  name = ARGV[1]
-  capabilities = ARGV[2] ? ARGV[2].split(',') : ['help']
-  
-  bot = BotChatAgent.new(bot_id: bot_id, name: name, capabilities: capabilities)
-  bot.run
-end