smart_message 0.0.1

data/examples/tmux_chat/shared_chat_system.rb

@@ -0,0 +1,295 @@
+#!/usr/bin/env ruby
+# examples/tmux_chat/shared_chat_system.rb
+#
+# Shared messaging system for the tmux chat visualization
+# This provides the core message types and file-based transport for inter-pane communication
+
+require_relative '../../lib/smart_message'
+require 'fileutils'
+
+# Create shared message queues directory
+SHARED_DIR = '/tmp/smart_message_chat'
+FileUtils.mkdir_p(SHARED_DIR)
+
+# File-based transport for tmux communication
+class FileTransport < SmartMessage::Transport::Base
+  def default_options
+    {
+      queue_dir: SHARED_DIR,
+      poll_interval: 0.1
+    }
+  end
+
+  def configure
+    @queue_dir = @options[:queue_dir]
+    @poll_interval = @options[:poll_interval]
+    @running = false
+    @subscriber_thread = nil
+    
+    FileUtils.mkdir_p(@queue_dir)
+  end
+
+  def publish(message_header, message_payload)
+    message_data = {
+      header: message_header.to_h,
+      payload: message_payload,
+      timestamp: Time.now.to_f
+    }
+    
+    # Write to room-specific queue file
+    room_id = extract_room_id(message_payload)
+    queue_file = File.join(@queue_dir, "#{room_id}.queue")
+    
+    File.open(queue_file, 'a') do |f|
+      f.puts(JSON.generate(message_data))
+      f.flush
+    end
+  end
+
+  def start_subscriber
+    return if @running
+    
+    @running = true
+    @subscriber_thread = Thread.new do
+      processed_positions = {}
+      
+      while @running
+        Dir.glob(File.join(@queue_dir, "*.queue")).each do |queue_file|
+          room_id = File.basename(queue_file, '.queue')
+          
+          if File.exist?(queue_file)
+            lines = File.readlines(queue_file)
+            start_pos = processed_positions[room_id] || 0
+            
+            lines[start_pos..-1].each do |line|
+              begin
+                message_data = JSON.parse(line.strip)
+                header = SmartMessage::Header.new(message_data['header'])
+                receive(header, message_data['payload'])
+              rescue JSON::ParserError
+                # Skip malformed lines
+              end
+            end
+            
+            processed_positions[room_id] = lines.length
+          end
+        end
+        
+        sleep(@poll_interval)
+      end
+    end
+  end
+
+  def stop_subscriber
+    @running = false
+    @subscriber_thread&.join
+  end
+
+  private
+
+  def extract_room_id(payload)
+    begin
+      data = JSON.parse(payload)
+      data['room_id'] || 'global'
+    rescue
+      'global'
+    end
+  end
+end
+
+# Register the file transport
+SmartMessage::Transport.register(:file, FileTransport)
+
+# Define the Chat Message
+class ChatMessage < SmartMessage::Base
+  property :message_id
+  property :room_id
+  property :sender_id
+  property :sender_name
+  property :content
+  property :message_type  # 'user', 'bot', 'system'
+  property :timestamp
+  property :mentions
+  property :metadata
+
+  config do
+    transport SmartMessage::Transport.create(:file)
+    serializer SmartMessage::Serializer::JSON.new
+  end
+
+  def self.process(message_header, message_payload)
+    # Default processing - agents will override this
+  end
+end
+
+# Define Bot Command Message
+class BotCommandMessage < SmartMessage::Base
+  property :command_id
+  property :room_id
+  property :user_id
+  property :user_name
+  property :command
+  property :parameters
+  property :timestamp
+
+  config do
+    transport SmartMessage::Transport.create(:file)
+    serializer SmartMessage::Serializer::JSON.new
+  end
+
+  def self.process(message_header, message_payload)
+    # Default processing - bots will override this
+  end
+end
+
+# Define System Notification Message
+class SystemNotificationMessage < SmartMessage::Base
+  property :notification_id
+  property :room_id
+  property :notification_type
+  property :content
+  property :timestamp
+  property :metadata
+
+  config do
+    transport SmartMessage::Transport.create(:file)
+    serializer SmartMessage::Serializer::JSON.new
+  end
+
+  def self.process(message_header, message_payload)
+    # Default processing
+  end
+end
+
+# Base Agent class with display utilities
+class BaseAgent
+  attr_reader :agent_id, :name, :active_rooms
+
+  def initialize(agent_id:, name:, agent_type: 'agent')
+    @agent_id = agent_id
+    @name = name
+    @agent_type = agent_type
+    @active_rooms = []
+    @display_buffer = []
+    @transport = SmartMessage::Transport.create(:file)
+    
+    setup_display
+    setup_subscriptions
+    start_message_processing
+  end
+
+  def join_room(room_id)
+    return if @active_rooms.include?(room_id)
+    
+    @active_rooms << room_id
+    log_display("📥 Joined room: #{room_id}")
+    
+    send_system_notification(
+      room_id: room_id,
+      notification_type: 'user_joined',
+      content: "#{@name} joined the room"
+    )
+  end
+
+  def leave_room(room_id)
+    return unless @active_rooms.include?(room_id)
+    
+    @active_rooms.delete(room_id)
+    log_display("📤 Left room: #{room_id}")
+    
+    send_system_notification(
+      room_id: room_id,
+      notification_type: 'user_left',
+      content: "#{@name} left the room"
+    )
+  end
+
+  def send_message(room_id:, content:, message_type: 'user')
+    return unless @active_rooms.include?(room_id)
+    
+    message = ChatMessage.new(
+      message_id: generate_message_id,
+      room_id: room_id,
+      sender_id: @agent_id,
+      sender_name: @name,
+      content: content,
+      message_type: message_type,
+      timestamp: Time.now.iso8601,
+      mentions: extract_mentions(content),
+      metadata: { agent_type: @agent_type }
+    )
+    
+    log_display("💬 [#{room_id}] #{@name}: #{content}")
+    message.publish
+  end
+
+  def shutdown
+    @active_rooms.dup.each { |room_id| leave_room(room_id) }
+    @transport.stop_subscriber
+    log_display("🔴 #{@name} shutdown")
+  end
+
+  protected
+
+  def setup_display
+    puts "\033[2J\033[H"  # Clear screen
+    puts "┌─" + "─" * 50 + "┐"
+    puts "│ #{@agent_type.upcase}: #{@name.center(44)} │"
+    puts "├─" + "─" * 50 + "┤"
+    puts "│ Rooms: #{@active_rooms.join(', ').ljust(42)} │"
+    puts "├─" + "─" * 50 + "┤"
+    puts "│ Messages:".ljust(51) + " │"
+    puts "└─" + "─" * 50 + "┘"
+    puts
+  end
+
+  def log_display(message)
+    timestamp = Time.now.strftime("%H:%M:%S")
+    puts "[#{timestamp}] #{message}"
+  end
+
+  def setup_subscriptions
+    # Override in subclasses
+  end
+
+  def start_message_processing
+    @transport.start_subscriber
+  end
+
+  def send_system_notification(room_id:, notification_type:, content:)
+    notification = SystemNotificationMessage.new(
+      notification_id: "NOTIF-#{Time.now.to_i}-#{rand(1000)}",
+      room_id: room_id,
+      notification_type: notification_type,
+      content: content,
+      timestamp: Time.now.iso8601,
+      metadata: { triggered_by: @agent_id }
+    )
+    
+    notification.publish
+  end
+
+  def generate_message_id
+    "MSG-#{@agent_id}-#{Time.now.to_i}-#{rand(1000)}"
+  end
+
+  def extract_mentions(content)
+    content.scan(/@(\w+)/).flatten
+  end
+end
+
+# Cleanup utility
+def cleanup_shared_queues
+  FileUtils.rm_rf(SHARED_DIR) if Dir.exist?(SHARED_DIR)
+end
+
+# Signal handling for cleanup
+trap('INT') do
+  cleanup_shared_queues
+  exit
+end
+
+trap('TERM') do
+  cleanup_shared_queues
+  exit
+end

data/examples/tmux_chat/start_chat_demo.sh

@@ -0,0 +1,190 @@
+#!/bin/bash
+# examples/tmux_chat/start_chat_demo.sh
+#
+# Tmux session manager for the many-to-many chat visualization
+
+set -e
+
+SESSION_NAME="smart_message_chat"
+CHAT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+echo -e "${BLUE}🚀 Starting SmartMessage Tmux Chat Demo${NC}"
+echo -e "${BLUE}======================================${NC}"
+
+# Check if tmux is installed
+if ! command -v tmux &> /dev/null; then
+    echo -e "${RED}❌ tmux is not installed. Please install tmux first.${NC}"
+    echo "On macOS: brew install tmux"
+    echo "On Ubuntu: sudo apt-get install tmux"
+    exit 1
+fi
+
+# Check if Ruby is available
+if ! command -v ruby &> /dev/null; then
+    echo -e "${RED}❌ Ruby is not installed.${NC}"
+    exit 1
+fi
+
+# Clean up any existing session
+if tmux has-session -t $SESSION_NAME 2>/dev/null; then
+    echo -e "${YELLOW}🧹 Cleaning up existing session...${NC}"
+    tmux kill-session -t $SESSION_NAME
+fi
+
+# Clean up shared message queues
+echo -e "${YELLOW}🧹 Cleaning up message queues...${NC}"
+rm -rf /tmp/smart_message_chat
+
+echo -e "${GREEN}📺 Creating tmux session layout...${NC}"
+
+# Create new session with first window
+tmux new-session -d -s $SESSION_NAME -x 120 -y 40
+
+# Rename first window and set up control center
+tmux rename-window -t $SESSION_NAME:0 "Chat-Control"
+
+# Window 0: Control Center (2x2 layout)
+echo -e "${GREEN}🏢 Setting up Control Center...${NC}"
+
+# Top left: General room monitor
+tmux send-keys -t $SESSION_NAME:0 "cd '$CHAT_DIR'" C-m
+tmux send-keys -t $SESSION_NAME:0 "ruby room_monitor.rb general" C-m
+
+# Split horizontally for top right: Tech room monitor  
+tmux split-window -t $SESSION_NAME:0 -h
+tmux send-keys -t $SESSION_NAME:0.1 "cd '$CHAT_DIR'" C-m
+tmux send-keys -t $SESSION_NAME:0.1 "ruby room_monitor.rb tech" C-m
+
+# Split vertically (bottom left): Random room monitor
+tmux split-window -t $SESSION_NAME:0.0 -v
+tmux send-keys -t $SESSION_NAME:0.2 "cd '$CHAT_DIR'" C-m
+tmux send-keys -t $SESSION_NAME:0.2 "ruby room_monitor.rb random" C-m
+
+# Split vertically (bottom right): System overview
+tmux split-window -t $SESSION_NAME:0.1 -v
+tmux send-keys -t $SESSION_NAME:0.3 "cd '$CHAT_DIR'" C-m
+tmux send-keys -t $SESSION_NAME:0.3 "echo 'SmartMessage Chat System'; echo '========================'; echo 'Rooms: general, tech, random'; echo 'Agents starting up...'; echo ''; echo 'Instructions:'; echo '1. Switch to other windows to see agents'; echo '2. In agent windows, type messages or commands'; echo '3. Use /join <room> to join rooms'; echo '4. Use /help for more commands'; tail -f /dev/null" C-m
+
+# Wait a moment for room monitors to start
+sleep 2
+
+# Window 1: Human Agents (3 panes)
+echo -e "${GREEN}👥 Setting up Human Agents...${NC}"
+tmux new-window -t $SESSION_NAME -n "Human-Agents"
+
+# Alice (left pane)
+tmux send-keys -t $SESSION_NAME:1 "cd '$CHAT_DIR'" C-m
+tmux send-keys -t $SESSION_NAME:1 "ruby human_agent.rb alice Alice" C-m
+
+# Split for Bob (top right)
+tmux split-window -t $SESSION_NAME:1 -h
+tmux send-keys -t $SESSION_NAME:1.1 "cd '$CHAT_DIR'" C-m 
+tmux send-keys -t $SESSION_NAME:1.1 "ruby human_agent.rb bob Bob" C-m
+
+# Split for Carol (bottom right)
+tmux split-window -t $SESSION_NAME:1.1 -v
+tmux send-keys -t $SESSION_NAME:1.2 "cd '$CHAT_DIR'" C-m
+tmux send-keys -t $SESSION_NAME:1.2 "ruby human_agent.rb carol Carol" C-m
+
+# Wait for agents to start
+sleep 2
+
+# Window 2: Bot Agents (2 panes)  
+echo -e "${GREEN}🤖 Setting up Bot Agents...${NC}"
+tmux new-window -t $SESSION_NAME -n "Bot-Agents"
+
+# HelpBot (left pane)
+tmux send-keys -t $SESSION_NAME:2 "cd '$CHAT_DIR'" C-m
+tmux send-keys -t $SESSION_NAME:2 "ruby bot_agent.rb helpbot HelpBot help,stats,time" C-m
+
+# Split for FunBot (right pane)
+tmux split-window -t $SESSION_NAME:2 -h
+tmux send-keys -t $SESSION_NAME:2.1 "cd '$CHAT_DIR'" C-m
+tmux send-keys -t $SESSION_NAME:2.1 "ruby bot_agent.rb funbot FunBot joke,weather,echo" C-m
+
+# Wait for bots to start
+sleep 2
+
+# Auto-join agents to rooms for demo
+echo -e "${GREEN}🏠 Auto-joining agents to rooms...${NC}"
+
+# Alice joins general and tech
+tmux send-keys -t $SESSION_NAME:1.0 "/join general" C-m
+sleep 0.5
+tmux send-keys -t $SESSION_NAME:1.0 "/join tech" C-m
+
+# Bob joins general and random  
+tmux send-keys -t $SESSION_NAME:1.1 "/join general" C-m
+sleep 0.5
+tmux send-keys -t $SESSION_NAME:1.1 "/join random" C-m
+
+# Carol joins tech and random
+tmux send-keys -t $SESSION_NAME:1.2 "/join tech" C-m  
+sleep 0.5
+tmux send-keys -t $SESSION_NAME:1.2 "/join random" C-m
+
+# Bots join rooms
+tmux send-keys -t $SESSION_NAME:2.0 "/join general" C-m
+sleep 0.5
+tmux send-keys -t $SESSION_NAME:2.0 "/join tech" C-m
+
+tmux send-keys -t $SESSION_NAME:2.1 "/join general" C-m
+sleep 0.5  
+tmux send-keys -t $SESSION_NAME:2.1 "/join random" C-m
+
+sleep 1
+
+# Send some initial messages to demonstrate the system
+echo -e "${GREEN}💬 Sending demo messages...${NC}"
+
+tmux send-keys -t $SESSION_NAME:1.0 "Hello everyone! I'm Alice." C-m
+sleep 1
+tmux send-keys -t $SESSION_NAME:1.1 "Hi Alice! Bob here." C-m
+sleep 1
+tmux send-keys -t $SESSION_NAME:1.2 "Carol joining the conversation!" C-m
+sleep 1
+tmux send-keys -t $SESSION_NAME:1.0 "/help" C-m
+sleep 2
+tmux send-keys -t $SESSION_NAME:1.1 "/joke" C-m
+sleep 2
+
+# Set focus to Human Agents window
+tmux select-window -t $SESSION_NAME:1
+
+echo -e "${GREEN}✅ Chat demo is ready!${NC}"
+echo ""
+echo -e "${BLUE}Navigation:${NC}"
+echo "• Ctrl+b then 0: Control Center (room monitors)"  
+echo "• Ctrl+b then 1: Human Agents (Alice, Bob, Carol)"
+echo "• Ctrl+b then 2: Bot Agents (HelpBot, FunBot)"
+echo "• Ctrl+b then o: Cycle through panes"
+echo "• Ctrl+b then arrow keys: Navigate panes"
+echo ""
+echo -e "${BLUE}Commands in agent panes:${NC}"
+echo "• /join <room>: Join a room"
+echo "• /leave <room>: Leave a room"  
+echo "• /list: List your active rooms"
+echo "• /help: Show available commands"
+echo "• /quit: Exit the agent"
+echo ""
+echo -e "${BLUE}Bot commands:${NC}"
+echo "• /help: Show bot capabilities"
+echo "• /joke: Get a random joke"
+echo "• /weather <location>: Get weather"
+echo "• /stats: Show bot statistics"
+echo "• /time: Show current time"
+echo "• /echo <message>: Echo your message"
+echo ""
+echo -e "${YELLOW}💡 Tip: Type messages directly to chat in your active rooms!${NC}"
+echo ""
+echo -e "${GREEN}🎭 Attaching to tmux session...${NC}"
+
+# Attach to the session
+tmux attach-session -t $SESSION_NAME

data/examples/tmux_chat/stop_chat_demo.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+# examples/tmux_chat/stop_chat_demo.sh
+#
+# Cleanup script for the tmux chat demo
+
+SESSION_NAME="smart_message_chat"
+
+echo "🧹 Stopping SmartMessage Tmux Chat Demo..."
+
+# Kill the tmux session if it exists
+if tmux has-session -t $SESSION_NAME 2>/dev/null; then
+    echo "🔴 Terminating tmux session..."
+    tmux kill-session -t $SESSION_NAME
+else
+    echo "ℹ️  No active tmux session found."
+fi
+
+# Clean up shared message queues
+echo "🗑️  Cleaning up message queues..."
+rm -rf /tmp/smart_message_chat
+
+echo "✅ Cleanup complete!"

data/lib/simple_stats.rb

@@ -0,0 +1,57 @@
+# lib/simple_stats.rb
+
+require 'ap'
+
+# A dirt simple way of collecting statistics for use in testing
+# that has a multi-level key structure
+class SimpleStats
+  @@stat = Hash.new
+
+  class << self
+
+    # return the internal Hash
+    def stat
+      @@stat
+    end
+
+
+    # return the count for a specific multi-level key
+    def get(*args)
+      return 0 if args.empty?
+      key = get_key(args)
+      @@stat.key?(key) ? @@stat[key] : @@stat[key] = 0
+    end
+
+
+    # increment (add) counts to a multi-level key
+    def add(*args, how_many: 1)
+      return 0 if args.empty?
+      key = get_key(args)
+      @@stat.key?(key) ? @@stat[key] += how_many : @@stat[key] = how_many
+    end
+
+
+    def reset(*args)
+      if args.empty?
+        @@stat = {}
+        return 0
+      end
+      key = get_key(args)
+      @@stat[key] = 0
+    end
+
+
+    # simulate a multi-level key using a level seperater
+    def get_key(an_array, sep:'+')
+      an_array.join(sep)
+    end
+
+
+    # return a pretty printed representation of the statistics
+    def to_s
+      ap @@stat
+    end
+  end
+end # class SimpleStat
+
+SS = SimpleStats