smart_message 0.0.10 → 0.0.12

data/examples/city_scenario/ai_visitor_intelligence_flow.svg

@@ -0,0 +1,108 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="700" height="500" viewBox="0 0 700 500" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <style>
+      .bg { fill: transparent; }
+      .visitor { fill: #2a1a3a; stroke: #aa4aff; stroke-width: 2; rx: 8; }
+      .ai { fill: #1a3a3a; stroke: #4affaa; stroke-width: 2; rx: 8; }
+      .emergency { fill: #3a1a1a; stroke: #ff4a4a; stroke-width: 2; rx: 8; }
+      .message { stroke: #aa4aff; stroke-width: 2; fill: none; marker-end: url(#arrowhead); }
+      .analysis { stroke: #4affaa; stroke-width: 2; fill: none; marker-end: url(#arrowhead-green); stroke-dasharray: 5,3; }
+      .publish { stroke: #ff4a4a; stroke-width: 3; fill: none; marker-end: url(#arrowhead-red); }
+      .text { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 12px; }
+      .title { fill: #4a9eff; font-family: 'Arial', sans-serif; font-size: 18px; font-weight: bold; }
+      .subtitle { fill: #ffaa4a; font-family: 'Arial', sans-serif; font-size: 11px; }
+      .note { fill: #aaaaaa; font-family: 'Arial', sans-serif; font-size: 10px; }
+      .self-message { fill: #2a1a3a; stroke: #aa4aff; stroke-width: 1; rx: 4; }
+    </style>
+    <marker id="arrowhead" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#aa4aff" />
+    </marker>
+    <marker id="arrowhead-green" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#4affaa" />
+    </marker>
+    <marker id="arrowhead-red" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#ff4a4a" />
+    </marker>
+  </defs>
+  
+  <!-- Background -->
+  <rect class="bg" width="700" height="500"/>
+  
+  <!-- Title -->
+  <text x="350" y="25" text-anchor="middle" class="title">AI Visitor Intelligence Flow</text>
+  <text x="350" y="45" text-anchor="middle" class="subtitle">AI-Powered Emergency Incident Reporting System</text>
+  
+  <!-- Participants -->
+  <rect x="50" y="80" width="140" height="80" class="visitor"/>
+  <text x="120" y="105" text-anchor="middle" class="text">🧑‍💼 Visitor (AI)</text>
+  <text x="120" y="125" text-anchor="middle" class="subtitle">Incident Observer</text>
+  <text x="120" y="145" text-anchor="middle" class="subtitle">Smart Reporter</text>
+  
+  <rect x="280" y="80" width="140" height="80" class="ai"/>
+  <text x="350" y="105" text-anchor="middle" class="text">🤖 RubyLLM</text>
+  <text x="350" y="125" text-anchor="middle" class="subtitle">AI Analysis Engine</text>
+  <text x="350" y="145" text-anchor="middle" class="subtitle">Message Intelligence</text>
+  
+  <rect x="510" y="80" width="140" height="80" class="emergency"/>
+  <text x="580" y="105" text-anchor="middle" class="text">🚨 Emergency</text>
+  <text x="580" y="125" text-anchor="middle" class="text">Services</text>
+  <text x="580" y="145" text-anchor="middle" class="subtitle">Response Network</text>
+  
+  <!-- Vertical lifelines -->
+  <line x1="120" y1="160" x2="120" y2="450" stroke="#666" stroke-width="2" stroke-dasharray="3,3"/>
+  <line x1="350" y1="160" x2="350" y2="450" stroke="#666" stroke-width="2" stroke-dasharray="3,3"/>
+  <line x1="580" y1="160" x2="580" y2="450" stroke="#666" stroke-width="2" stroke-dasharray="3,3"/>
+  
+  <!-- Message Flow -->
+  <!-- 1. Witness incident (self message) -->
+  <rect x="80" y="180" width="80" height="25" class="self-message"/>
+  <text x="120" y="197" text-anchor="middle" class="note">Witness incident</text>
+  
+  <!-- 2. Analyze message types -->
+  <path d="M 120 220 L 350 220" class="message"/>
+  <text x="235" y="215" text-anchor="middle" class="text">Analyze available message types</text>
+  <rect x="160" y="230" width="160" height="40" fill="#1a1a1a" stroke="#aa4aff" rx="4"/>
+  <text x="240" y="245" text-anchor="middle" class="note">Dynamic message discovery</text>
+  <text x="240" y="260" text-anchor="middle" class="note">Property analysis</text>
+  
+  <!-- 3. AI selection response -->
+  <path d="M 350 290 L 120 290" class="analysis"/>
+  <text x="235" y="285" text-anchor="middle" class="text">Select appropriate message type</text>
+  <rect x="180" y="300" width="140" height="40" fill="#2a3a2a" stroke="#4affaa" rx="4"/>
+  <text x="250" y="315" text-anchor="middle" class="note">SilentAlarmMessage for robbery</text>
+  <text x="250" y="330" text-anchor="middle" class="note">FireEmergencyMessage for fire</text>
+  
+  <!-- 4. Generate properties -->
+  <path d="M 120 360 L 350 360" class="message"/>
+  <text x="235" y="355" text-anchor="middle" class="text">Generate realistic properties</text>
+  <rect x="160" y="370" width="160" height="40" fill="#1a1a1a" stroke="#aa4aff" rx="4"/>
+  <text x="240" y="385" text-anchor="middle" class="note">Bank names, locations</text>
+  <text x="240" y="400" text-anchor="middle" class="note">Fire types, severities</text>
+  
+  <!-- 5. Publish emergency message -->
+  <path d="M 120 430 L 580 430" class="publish"/>
+  <text x="350" y="425" text-anchor="middle" class="text">Publish selected message</text>
+  <text x="350" y="445" text-anchor="middle" class="note">Emergency services respond based on message type</text>
+  
+  <!-- AI Intelligence Box -->
+  <rect x="50" y="350" width="200" height="80" fill="#1a2a1a" stroke="#4affaa" rx="6"/>
+  <text x="60" y="370" class="text">AI Intelligence Features:</text>
+  <text x="60" y="385" class="note">• Dynamic message type discovery</text>
+  <text x="60" y="400" class="note">• Context-aware message selection</text>
+  <text x="60" y="415" class="note">• Realistic property generation</text>
+  <text x="60" y="430" class="note">• Comprehensive interaction logging</text>
+  
+  <!-- Response Examples Box -->
+  <rect x="420" y="220" width="230" height="120" fill="#1a1a1a" stroke="#ff4a4a" rx="6"/>
+  <text x="430" y="240" class="text">Emergency Response Examples:</text>
+  <text x="430" y="260" class="note">🏦 Bank Robbery → SilentAlarmMessage</text>
+  <text x="430" y="275" class="note">   • Location: "First National Bank"</text>
+  <text x="430" y="290" class="note">   • Threat level: "high"</text>
+  <text x="430" y="310" class="note">🔥 Building Fire → FireEmergencyMessage</text>
+  <text x="430" y="325" class="note">   • Fire type: "electrical"</text>
+  <text x="430" y="340" class="note">   • Severity: "critical"</text>
+</svg>

data/examples/city_scenario/citizen.rb

@@ -0,0 +1,195 @@
+#!/usr/bin/env ruby
+# examples/multi_program_demo/citizen.rb
+
+require_relative '../../lib/smart_message'
+require_relative 'messages/emergency_911_message'
+
+require_relative 'common/logger'
+
+class Citizen
+  include Common::Logger
+
+  def initialize
+    @service_name = 'citizen'
+    @names = ['John Smith', 'Mary Johnson', 'Robert Williams', 'Patricia Brown', 'Michael Davis']
+    @locations = [
+      '123 Main Street',
+      '456 Oak Avenue',
+      '789 Pine Lane',
+      '321 Elm Drive',
+      '654 Maple Road',
+      '987 Cedar Court',
+      '147 Birch Way',
+      '258 Spruce Boulevard'
+    ]
+
+    @emergency_scenarios = [
+      # Fires
+      { type: 'fire', severity: 'high',
+        description: 'House is on fire! Smoke everywhere!',
+        fire: true, injuries: true, victims: 2 },
+      { type: 'fire', severity: 'critical',
+        description: 'Kitchen grease fire spreading to cabinets!',
+        fire: true, injuries: false },
+
+      # Medical
+      { type: 'medical', severity: 'critical',
+        description: 'Heart attack! Person unconscious!',
+        injuries: true, victims: 1 },
+      { type: 'medical', severity: 'high',
+        description: 'Elderly person fell down stairs, bleeding heavily',
+        injuries: true, victims: 1 },
+
+      # Crimes
+      { type: 'crime', severity: 'high',
+        description: 'Break-in in progress! I can see them in my neighbor\'s house!',
+        weapons: false, suspects: true },
+      { type: 'crime', severity: 'critical',
+        description: 'Armed robbery at the corner store!',
+        weapons: true, suspects: true },
+      { type: 'crime', severity: 'medium',
+        description: 'My car was stolen from my driveway',
+        weapons: false, suspects: false },
+
+      # Accidents
+      { type: 'accident', severity: 'medium',
+        description: 'Two car collision at the intersection',
+        vehicles: 2, injuries: true, victims: 2 },
+      { type: 'accident', severity: 'critical',
+        description: 'Multi-car pileup on the highway! At least 5 cars!',
+        vehicles: 5, injuries: true, victims: 8, fire: true },
+      { type: 'accident', severity: 'low',
+        description: 'Fender bender in parking lot',
+        vehicles: 2, injuries: false },
+
+      # Rescue
+      { type: 'rescue', severity: 'high',
+        description: 'Child stuck in storm drain!',
+        injuries: false, victims: 1 },
+      { type: 'rescue', severity: 'critical',
+        description: 'Person trapped in collapsed building!',
+        injuries: true, victims: 2 },
+
+      # Hazmat
+      { type: 'hazmat', severity: 'critical',
+        description: 'Chemical spill from overturned truck! Strong fumes!',
+        hazmat: true, injuries: true, victims: 3 },
+
+      # Other
+      { type: 'other', severity: 'low',
+        description: 'Suspicious person looking into car windows',
+        suspects: true },
+      { type: 'other', severity: 'medium',
+        description: 'Power lines down across the road',
+        hazmat: false }
+    ]
+
+    Messages::Emergency911Message.from = @service_name
+  end
+
+  # def setup_logging
+  #   log_file = File.join(__dir__, 'citizen.log')
+  #   logger = Logger.new(log_file)
+  #   logger.level = Logger::INFO
+  #   logger.formatter = proc do |severity, datetime, progname, msg|
+  #     "#{datetime.strftime('%Y-%m-%d %H:%M:%S')} [#{severity}] #{msg}\n"
+  #   end
+  #   logger.info("Citizen 911 caller started")
+  # end
+
+  def make_emergency_call
+    scenario = @emergency_scenarios.sample
+    caller_name = @names.sample
+    location = @locations.sample
+    phone = "555-#{rand(1000..9999)}"
+
+    puts "\n📱 Citizen making 911 call..."
+    puts "   Caller: #{caller_name}"
+    puts "   Location: #{location}"
+    puts "   Emergency: #{scenario[:type]} - #{scenario[:description]}"
+
+    call = Messages::Emergency911Message.new(
+      caller_name: caller_name,
+      caller_phone: phone,
+      caller_location: location,
+      emergency_type: scenario[:type],
+      description: scenario[:description],
+      severity: scenario[:severity],
+      injuries_reported: scenario[:injuries],
+      number_of_victims: scenario[:victims],
+      fire_involved: scenario[:fire],
+      weapons_involved: scenario[:weapons],
+      hazardous_materials: scenario[:hazmat],
+      vehicles_involved: scenario[:vehicles],
+      suspects_on_scene: scenario[:suspects],
+      timestamp: Time.now.iso8601,
+      from: "citizen-#{caller_name.downcase.gsub(' ', '_')}",
+      to: '911'
+    )
+
+    call.publish
+
+    puts "   ✅ 911 call placed successfully"
+    logger.info("911 call placed: #{scenario[:type]} at #{location} - #{scenario[:description]}")
+
+    call
+  rescue => e
+    puts "   ❌ Error making 911 call: #{e.message}"
+    logger.error("Error making 911 call: #{e.message}")
+    nil
+  end
+
+  def run_interactive
+    puts "👤 Citizen 911 Emergency Caller"
+    puts "   Press Enter to make a random 911 call"
+    puts "   Type 'auto' for automatic calls every 15-30 seconds"
+    puts "   Type 'quit' to exit\n\n"
+
+    loop do
+      print "Action (enter/auto/quit): "
+      input = gets&.chomp&.downcase
+
+      case input
+      when '', nil
+        make_emergency_call
+      when 'auto'
+        run_automatic
+        break
+      when 'quit', 'q', 'exit'
+        puts "👤 Citizen exiting..."
+        break
+      else
+        puts "Unknown command. Press Enter for call, 'auto' for automatic, 'quit' to exit"
+      end
+    end
+  end
+
+  def run_automatic
+    puts "\n👤 Starting automatic 911 calls (every 15-30 seconds)"
+    puts "   Press Ctrl+C to stop\n\n"
+
+    Signal.trap('INT') do
+      puts "\n👤 Stopping automatic calls..."
+      exit(0)
+    end
+
+    loop do
+      make_emergency_call
+      wait_time = rand(15..30)
+      puts "   ⏰ Next call in #{wait_time} seconds...\n"
+      sleep(wait_time)
+    end
+  end
+end
+
+# Run the citizen caller
+if __FILE__ == $0
+  citizen = Citizen.new
+
+  # Check for command line argument
+  if ARGV[0] == 'auto'
+    citizen.run_automatic
+  else
+    citizen.run_interactive
+  end
+end

data/examples/city_scenario/city_diagram.svg

@@ -0,0 +1,125 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="1200" height="800" xmlns="http://www.w3.org/2000/svg">
+  <style>
+    .service-box { fill: #f0f8ff; stroke: #4169e1; stroke-width: 2; }
+    .message-arrow { stroke: #2e8b57; stroke-width: 2; marker-end: url(#arrowhead); }
+    .emergency-arrow { stroke: #dc143c; stroke-width: 3; marker-end: url(#arrowhead); }
+    .health-arrow { stroke: #1e90ff; stroke-width: 2; marker-end: url(#arrowhead); }
+    .response-arrow { stroke: #ff8c00; stroke-width: 2; marker-end: url(#arrowhead); }
+    .service-text { font-family: Arial, sans-serif; font-size: 14px; font-weight: bold; text-anchor: middle; }
+    .message-text { font-family: Arial, sans-serif; font-size: 12px; fill: #333; }
+    .title-text { font-family: Arial, sans-serif; font-size: 18px; font-weight: bold; text-anchor: middle; }
+    .legend-text { font-family: Arial, sans-serif; font-size: 12px; }
+  </style>
+  
+  <defs>
+    <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#333"/>
+    </marker>
+  </defs>
+  
+  <!-- Title -->
+  <text x="600" y="30" class="title-text">SmartMessage City Demo - Service Communication</text>
+  
+  <!-- Services -->
+  
+  <!-- Health Department (Central Hub) -->
+  <rect x="500" y="60" width="200" height="80" class="service-box" rx="10"/>
+  <text x="600" y="85" class="service-text">Health Department</text>
+  <text x="600" y="105" class="message-text">Broadcasts HealthCheck every 5s</text>
+  <text x="600" y="120" class="message-text">Displays HealthStatus with colors</text>
+  
+  <!-- Police Department -->
+  <rect x="100" y="200" width="180" height="80" class="service-box" rx="10"/>
+  <text x="190" y="225" class="service-text">Police Department</text>
+  <text x="190" y="245" class="message-text">Responds to health checks</text>
+  <text x="190" y="260" class="message-text">Dispatches cars to bank alarms</text>
+  
+  <!-- Fire Department -->
+  <rect x="920" y="200" width="180" height="80" class="service-box" rx="10"/>
+  <text x="1010" y="225" class="service-text">Fire Department</text>
+  <text x="1010" y="245" class="message-text">Responds to health checks</text>
+  <text x="1010" y="260" class="message-text">Dispatches engines to fires</text>
+  
+  <!-- Local Bank -->
+  <rect x="300" y="400" width="180" height="80" class="service-box" rx="10"/>
+  <text x="390" y="425" class="service-text">Local Bank</text>
+  <text x="390" y="445" class="message-text">Responds to health checks</text>
+  <text x="390" y="460" class="message-text">Triggers silent alarms</text>
+  
+  <!-- Houses -->
+  <rect x="720" y="400" width="180" height="80" class="service-box" rx="10"/>
+  <text x="810" y="425" class="service-text">Houses</text>
+  <text x="810" y="445" class="message-text">Respond to health checks</text>
+  <text x="810" y="460" class="message-text">Occasionally catch fire</text>
+  
+  <!-- Health Check Broadcasts (Blue arrows) -->
+  <path d="M 580 140 L 220 200" class="health-arrow"/>
+  <text x="350" y="165" class="message-text">HealthCheck</text>
+  
+  <path d="M 620 140 L 990 200" class="health-arrow"/>
+  <text x="750" y="165" class="message-text">HealthCheck</text>
+  
+  <path d="M 570 140 L 420 400" class="health-arrow"/>
+  <text x="450" y="270" class="message-text">HealthCheck</text>
+  
+  <path d="M 630 140 L 780 400" class="health-arrow"/>
+  <text x="750" y="270" class="message-text">HealthCheck</text>
+  
+  <!-- Health Status Responses (Orange arrows) -->
+  <path d="M 220 200 L 580 140" class="response-arrow"/>
+  <text x="350" y="185" class="message-text">HealthStatus</text>
+  
+  <path d="M 990 200 L 620 140" class="response-arrow"/>
+  <text x="750" y="185" class="message-text">HealthStatus</text>
+  
+  <path d="M 420 400 L 570 140" class="response-arrow"/>
+  <text x="470" y="290" class="message-text">HealthStatus</text>
+  
+  <path d="M 780 400 L 630 140" class="response-arrow"/>
+  <text x="730" y="290" class="message-text">HealthStatus</text>
+  
+  <!-- Emergency Communications (Red arrows) -->
+  
+  <!-- Bank Silent Alarm -->
+  <path d="M 360 400 L 220 280" class="emergency-arrow"/>
+  <text x="250" y="340" class="message-text">SilentAlarm</text>
+  
+  <!-- Police Dispatch Response -->
+  <path d="M 220 280 L 360 400" class="emergency-arrow"/>
+  <text x="250" y="360" class="message-text">PoliceDispatch</text>
+  
+  <!-- House Fire Emergency -->
+  <path d="M 840 400 L 980 280" class="emergency-arrow"/>
+  <text x="950" y="340" class="message-text">FireEmergency</text>
+  
+  <!-- Fire Dispatch Response -->
+  <path d="M 980 280 L 840 400" class="emergency-arrow"/>
+  <text x="950" y="360" class="message-text">FireDispatch</text>
+  
+  <!-- Emergency Resolution (Green arrows) -->
+  <path d="M 300 440 L 500 140" class="message-arrow"/>
+  <text x="350" y="320" class="message-text">EmergencyResolved</text>
+  
+  <path d="M 900 440 L 700 140" class="message-arrow"/>
+  <text x="850" y="320" class="message-text">EmergencyResolved</text>
+  
+  <!-- Legend -->
+  <rect x="50" y="600" width="400" height="150" fill="#f9f9f9" stroke="#ccc" stroke-width="1" rx="5"/>
+  <text x="60" y="620" class="legend-text" font-weight="bold">Message Types:</text>
+  
+  <line x1="60" y1="635" x2="90" y2="635" class="health-arrow"/>
+  <text x="100" y="640" class="legend-text">HealthCheck - Broadcast every 5 seconds</text>
+  
+  <line x1="60" y1="655" x2="90" y2="655" class="response-arrow"/>
+  <text x="100" y="660" class="legend-text">HealthStatus - Response with status (healthy/warning/critical/failed)</text>
+  
+  <line x1="60" y1="675" x2="90" y2="675" class="emergency-arrow"/>
+  <text x="100" y="680" class="legend-text">Emergency Messages - SilentAlarm, FireEmergency, Dispatch responses</text>
+  
+  <line x1="60" y1="695" x2="90" y2="695" class="message-arrow"/>
+  <text x="100" y="700" class="legend-text">EmergencyResolved - Services report when emergency is handled</text>
+  
+  <text x="60" y="725" class="legend-text" font-weight="bold">Status Colors (health_department output):</text>
+  <text x="60" y="740" class="legend-text">• Green: healthy • Yellow: warning • Orange: critical • Red: failed</text>
+</svg>

data/examples/city_scenario/common/health_monitor.rb

@@ -0,0 +1,80 @@
+#!/usr/bin/env ruby
+# examples/multi_program_demo/common/health_monitor.rb
+# A common module used for system health monitoring
+#
+# Any class that inclues this module MUST define a method named get_status_details
+# which is works like this:
+#
+# def get_status_details
+#   # calculate @status and @details
+#   [@status, @details]
+# end
+#
+# The class MUST also have an instance variable @service_name
+#
+
+require_relative '../messages/health_check_message'
+require_relative '../messages/health_status_message'
+
+module Common
+  module HealthMonitor
+    FAIL_SAFE = 15 # seconds
+
+    def setup_health_monitor
+      @health_timer_mutex = Mutex.new
+      @health_timer       = nil
+
+      Messages::HealthCheckMessage.subscribe(broadcast: true) do |message|
+        respond_to_health_check(message)
+      end
+
+      Messages::HealthStatusMessage.from = @service_name
+
+      start_health_countdown_timer
+    end
+
+    def start_health_countdown_timer
+      @health_timer_mutex.synchronize do
+        @health_timer&.kill  # Kill existing timer if any
+        @health_timer = Thread.new do
+          sleep(FAIL_SAFE)
+          shutdown_due_to_health_failure
+        end
+      end
+    end
+
+    def reset_health_timer
+      start_health_countdown_timer
+    end
+
+    def shutdown_due_to_health_failure
+      emoji = respond_to?(:service_emoji) ? service_emoji : "🔧"
+      warning_message = "⚠️  WARNING: No health checks received for over #{FAIL_SAFE} seconds!"
+      puts "\n#{warning_message}"
+      puts "#{emoji} #{self.class.name} services are going offline..."
+      @logger.fatal(warning_message)
+      @logger.fatal("#{self.class.name} shutting down - no health checks received")
+      exit(1)
+    end
+
+    def respond_to_health_check(health_check)
+      reset_health_timer
+
+      status, details = get_status_details
+
+      status_msg = Messages::HealthStatusMessage.new(
+        service_name:    @service_name,
+        status:          status,
+        check_id:        health_check.check_id,
+        details:         details
+      )
+
+      status_msg.publish
+      @logger.info("Sent health status: #{status} (#{details})")
+    rescue => e
+      emoji = respond_to?(:service_emoji) ? service_emoji : "🔧"
+      puts "#{emoji} Error responding to health check: #{e.message}"
+      @logger.error("Error responding to health check: #{e.message}")
+    end
+  end
+end

data/examples/city_scenario/common/logger.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+# examples/multi_program_demo/common/logger.rb
+
+module Common
+  module Logger
+    def setup_logger(options = {})
+      # Auto-detect program name from filename if not provided
+      program_name = options.delete(:name) || File.basename($0, '.rb')
+
+      # Build options with defaults
+      opts = {
+        log_file: "log/#{program_name}.log",
+        level: ::Logger::INFO
+      }.merge(options)
+
+      # Configure SmartMessage with the logger
+      SmartMessage.configure do |config|
+        config.logger = SmartMessage::Logger::Default.new(**opts)
+      end
+
+      # Store and return the logger instance
+      @logger = SmartMessage::Logger.default
+    end
+
+    def logger
+      # Return existing logger or create with defaults
+      @logger ||= setup_logger
+    end
+  end
+end