jicksta-adhearsion 0.7.999

data/adhearsion.gemspec

@@ -0,0 +1,146 @@
+ADHEARSION_FILES = %w{
+  adhearsion.gemspec
+  app_generators/ahn/ahn_generator.rb
+  app_generators/ahn/templates/.ahnrc
+  app_generators/ahn/templates/components/ami_remote/ami_remote.rb
+  app_generators/ahn/templates/components/disabled/HOW_TO_ENABLE
+  app_generators/ahn/templates/components/disabled/stomp_gateway/config.yml
+  app_generators/ahn/templates/components/disabled/stomp_gateway/README.markdown
+  app_generators/ahn/templates/components/disabled/stomp_gateway/stomp_gateway.rb
+  app_generators/ahn/templates/components/restful_rpc/config.yml
+  app_generators/ahn/templates/components/restful_rpc/example-client.rb
+  app_generators/ahn/templates/components/restful_rpc/README.markdown
+  app_generators/ahn/templates/components/restful_rpc/restful_rpc.rb
+  app_generators/ahn/templates/components/simon_game/simon_game.rb
+  app_generators/ahn/templates/config/startup.rb
+  app_generators/ahn/templates/dialplan.rb
+  app_generators/ahn/templates/events.rb
+  app_generators/ahn/templates/Rakefile
+  app_generators/ahn/templates/README
+  app_generators/ahn/USAGE
+  bin/ahn
+  bin/ahnctl
+  bin/jahn
+  CHANGELOG
+  EVENTS
+  examples/asterisk_manager_interface/standalone.rb
+  lib/adhearsion.rb
+  lib/adhearsion/cli.rb
+  lib/adhearsion/component_manager.rb
+  lib/adhearsion/component_manager/spec_framework.rb
+  lib/adhearsion/events_support.rb
+  lib/adhearsion/foundation/all.rb
+  lib/adhearsion/foundation/blank_slate.rb
+  lib/adhearsion/foundation/custom_daemonizer.rb
+  lib/adhearsion/foundation/event_socket.rb
+  lib/adhearsion/foundation/future_resource.rb
+  lib/adhearsion/foundation/global.rb
+  lib/adhearsion/foundation/metaprogramming.rb
+  lib/adhearsion/foundation/numeric.rb
+  lib/adhearsion/foundation/pseudo_guid.rb
+  lib/adhearsion/foundation/relationship_properties.rb
+  lib/adhearsion/foundation/string.rb
+  lib/adhearsion/foundation/synchronized_hash.rb
+  lib/adhearsion/foundation/thread_safety.rb
+  lib/adhearsion/host_definitions.rb
+  lib/adhearsion/initializer.rb
+  lib/adhearsion/initializer/asterisk.rb
+  lib/adhearsion/initializer/configuration.rb
+  lib/adhearsion/initializer/database.rb
+  lib/adhearsion/initializer/drb.rb
+  lib/adhearsion/initializer/freeswitch.rb
+  lib/adhearsion/initializer/rails.rb
+  lib/adhearsion/logging.rb
+  lib/adhearsion/tasks.rb
+  lib/adhearsion/tasks/database.rb
+  lib/adhearsion/tasks/deprecations.rb
+  lib/adhearsion/tasks/generating.rb
+  lib/adhearsion/tasks/lint.rb
+  lib/adhearsion/tasks/testing.rb
+  lib/adhearsion/version.rb
+  lib/adhearsion/voip/asterisk.rb
+  lib/adhearsion/voip/asterisk/agi_server.rb
+  lib/adhearsion/voip/asterisk/commands.rb
+  lib/adhearsion/voip/asterisk/config_generators/agents.conf.rb
+  lib/adhearsion/voip/asterisk/config_generators/config_generator.rb
+  lib/adhearsion/voip/asterisk/config_generators/queues.conf.rb
+  lib/adhearsion/voip/asterisk/config_generators/voicemail.conf.rb
+  lib/adhearsion/voip/asterisk/config_manager.rb
+  lib/adhearsion/voip/asterisk/manager_interface.rb
+  lib/adhearsion/voip/asterisk/manager_interface/ami_lexer.rb
+  lib/adhearsion/voip/asterisk/manager_interface/ami_lexer.rl.rb
+  lib/adhearsion/voip/asterisk/manager_interface/ami_messages.rb
+  lib/adhearsion/voip/asterisk/manager_interface/ami_protocol_lexer_machine.rl
+  lib/adhearsion/voip/asterisk/special_dial_plan_managers.rb
+  lib/adhearsion/voip/asterisk/super_manager.rb
+  lib/adhearsion/voip/call.rb
+  lib/adhearsion/voip/call_routing.rb
+  lib/adhearsion/voip/commands.rb
+  lib/adhearsion/voip/constants.rb
+  lib/adhearsion/voip/conveniences.rb
+  lib/adhearsion/voip/dial_plan.rb
+  lib/adhearsion/voip/dsl/dialing_dsl.rb
+  lib/adhearsion/voip/dsl/dialing_dsl/dialing_dsl_monkey_patches.rb
+  lib/adhearsion/voip/dsl/dialplan/control_passing_exception.rb
+  lib/adhearsion/voip/dsl/dialplan/dispatcher.rb
+  lib/adhearsion/voip/dsl/dialplan/parser.rb
+  lib/adhearsion/voip/dsl/dialplan/thread_mixin.rb
+  lib/adhearsion/voip/dsl/numerical_string.rb
+  lib/adhearsion/voip/freeswitch/basic_connection_manager.rb
+  lib/adhearsion/voip/freeswitch/event_handler.rb
+  lib/adhearsion/voip/freeswitch/freeswitch_dialplan_command_factory.rb
+  lib/adhearsion/voip/freeswitch/inbound_connection_manager.rb
+  lib/adhearsion/voip/freeswitch/oes_server.rb
+  lib/adhearsion/voip/menu_state_machine/calculated_match.rb
+  lib/adhearsion/voip/menu_state_machine/matchers.rb
+  lib/adhearsion/voip/menu_state_machine/menu_builder.rb
+  lib/adhearsion/voip/menu_state_machine/menu_class.rb
+  lib/theatre.rb
+  lib/theatre/callback_definition_loader.rb
+  lib/theatre/guid.rb
+  lib/theatre/invocation.rb
+  lib/theatre/namespace_manager.rb
+  lib/theatre/README.markdown
+  lib/theatre/version.rb
+  LICENSE
+  Rakefile
+  README.txt
+}
+
+Gem::Specification.new do |s|
+  s.name = "adhearsion"
+  s.version = "0.7.999"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Jay Phillips"]
+
+  s.date = "2008-08-21"
+  s.description = "Adhearsion is an open-source telephony development framework"
+  s.email = "Jay -at- Codemecca.com"
+  s.executables = ["ahn", "ahnctl", "jahn"]
+  
+  s.files = ADHEARSION_FILES
+  
+  s.has_rdoc = false
+  s.homepage = "http://adhearsion.com"
+  s.require_paths = ["lib"]
+  s.rubyforge_project = "adhearsion"
+  s.rubygems_version = "1.2.0"
+  s.summary = "Adhearsion, open-source telephony development framework"
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if current_version >= 3 then
+      s.add_runtime_dependency("rubigen", [">= 1.0.6"])
+      s.add_runtime_dependency("log4r", [">= 1.0.5"])
+    else
+      s.add_dependency("rubigen", [">= 1.0.6"])
+      s.add_dependency("log4r", [">= 1.0.5"])
+    end
+  else
+    s.add_dependency("rubigen", [">= 1.0.6"])
+    s.add_dependency("log4r", [">= 1.0.5"])
+  end
+end

data/app_generators/ahn/USAGE

@@ -0,0 +1,5 @@
+Description:
+  
+  
+Usage:
+  

data/app_generators/ahn/ahn_generator.rb

@@ -0,0 +1,87 @@
+class AhnGenerator < RubiGen::Base
+  
+  DEFAULT_SHEBANG = File.join(Config::CONFIG['bindir'],
+                              Config::CONFIG['ruby_install_name'])
+  
+  default_options :author => nil
+  
+  attr_reader :name, :component
+  
+  def initialize(runtime_args, runtime_options = {})
+    super
+    usage if args.empty?
+    @destination_root = File.expand_path(args.shift)
+    @name = base_name
+    @component = 'simon_game'
+    extract_options
+  end
+
+  def manifest
+    record do |m|
+      # Ensure appropriate folder(s) exists
+      m.directory ''
+      BASEDIRS.each { |path| m.directory path }
+
+      m.file  *[".ahnrc"]*2
+      
+      m.file  *["components/simon_game/simon_game.rb"]*2
+      m.file  *["components/ami_remote/ami_remote.rb"]*2
+
+      m.file  *["components/disabled/stomp_gateway/stomp_gateway.rb"]*2
+      m.file  *["components/disabled/stomp_gateway/config.yml"]*2
+      m.file  *["components/disabled/stomp_gateway/README.markdown"]*2
+      
+      m.file  *["components/restful_rpc/restful_rpc.rb"]*2
+      m.file  *["components/restful_rpc/config.yml"]*2
+      m.file  *["components/restful_rpc/README.markdown"]*2
+      m.file  *["components/restful_rpc/example-client.rb"]*2
+      m.file  *["components/restful_rpc/spec/restful_rpc_spec.rb"]*2
+      
+      m.file  *["config/startup.rb"]*2
+      m.file  *["dialplan.rb"]*2
+      m.file  *["events.rb"]*2
+      m.file  *["README"]*2
+      m.file  *["Rakefile"]*2
+      
+      # m.dependency "install_rubigen_scripts", [destination_root, 'ahn', 'adhearsion', 'test_spec'], 
+      #   :shebang => options[:shebang], :collision => :force
+    end
+  end
+
+  protected
+    def banner
+      <<-EOS
+Creates a ...
+
+USAGE: #{spec.name} name"
+EOS
+    end
+
+    def add_options!(opts)
+      opts.separator ''
+      opts.separator 'Options:'
+      # For each option below, place the default
+      # at the top of the file next to "default_options"
+      # opts.on("-a", "--author=\"Your Name\"", String,
+      #         "Some comment about this option",
+      #         "Default: none") { |options[:author]| }
+      opts.on("-v", "--version", "Show the #{File.basename($0)} version number and quit.")
+    end
+    
+    def extract_options
+      # for each option, extract it into a local variable (and create an "attr_reader :author" at the top)
+      # Templates can access these value via the attr_reader-generated methods, but not the
+      # raw instance variable value.
+      # @author = options[:author]
+    end
+
+    # Installation skeleton.  Intermediate directories are automatically
+    # created so don't sweat their absence here.
+    BASEDIRS = %w(
+      components/simon_game
+      components/disabled/stomp_gateway
+      components/ami_remote
+      components/restful_rpc/spec
+      config
+    )
+end

data/app_generators/ahn/templates/.ahnrc

@@ -0,0 +1,34 @@
+# Adhearsion Runtime Configuration.
+
+# You can use the "gems" section to force Adhearsion to load a particular version of a gem.
+# This is useful when a component require()s a gem, but you don't want it to use the latest one installed on the system.
+# For example, if a component require()s activerecord, sucking in the latest on the system, and then you enable a Rails app
+# which wants a particular version of activerecord, RubyGems will raise an error saying "you cannot activate two versions of
+# the same gem". Note: specifying the version, source and require names is optional, but you must include a : after the gem name to make it a YAML key/value pair (with a nil value).
+gems:
+#  twitter:
+#  hpricot:
+#  rack:
+#    # require() one library when initializing:
+#    require: rack
+#  memcache-client:
+#    version >= 1.5.2
+#    require:
+#      # require() an Array of libraries when initializing:
+#      - memcache
+#      - memcache_util
+#  activerecord:
+#    version: >= 2.1.0
+#  aasm:
+#    source: http://gems.github.com
+
+paths:
+
+  # All paths are relative to this file's directory
+  init: config/startup.rb
+
+  dialplan: dialplan.rb
+
+  events: events.rb
+
+  models: models/*.rb

data/app_generators/ahn/templates/README

@@ -0,0 +1,8 @@
+Start your new app with "ahn start /path/to/your/app"
+
+If you wish to use Adhearsion to control Asterisk's dialplan,
+change the contexts you wish to be affected in your
+/etc/asterisk/extensions.conf file to the following:
+
+[your_context_name]
+exten => _X.,1,AGI(agi://1.2.3.4) ; This IP here

data/app_generators/ahn/templates/Rakefile

@@ -0,0 +1,23 @@
+require 'rubygems'
+
+begin
+  require 'adhearsion'
+  require 'adhearsion/tasks'
+rescue LoadError
+  STDERR.puts "\nCannot load Adhearsion! Not all Rake tasks will be loaded!\n\n"
+end
+
+desc "Writes a .gitignore file that ignores certain SCM annoyances such as log files"
+task :gitignore do
+  ignore_file = "#{Dir.pwd}/.gitignore"
+  if File.exists? ignore_file
+    STDERR.puts "File #{ignore_file} already exists!"
+  else
+    File.open ignore_file, 'w' do |file|
+      # Add other files to the Array below
+      %w[ log ].each do |pattern|
+        file.puts pattern
+      end
+    end
+  end
+end

data/app_generators/ahn/templates/components/ami_remote/ami_remote.rb

@@ -0,0 +1,15 @@
+methods_for :rpc do
+  
+  # Simply create proxy methods for the high-level AMI methods
+  
+  [:send_action, :introduce, :originate, :call_into_context, :call_and_exec].each do |method_name|
+    define_method(method_name) do |*args|
+      if VoIP::Asterisk.manager_interface
+        VoIP::Asterisk.manager_interface.send(method_name, *args)
+      else
+        ahn_log.ami_remote.error "AMI has not been enabled in startup.rb!"
+      end
+    end
+  end
+  
+end

data/app_generators/ahn/templates/components/disabled/HOW_TO_ENABLE

@@ -0,0 +1,7 @@
+Type "ahn enable component COMPONENT_NAME_FROM_DISABLED_FOLDER
+
+For example:
+
+~/Desktop $ ahn create myapp
+~/Desktop $ cd myapp
+~/Desktop/myapp $ ahn enable component stomp_gateway

data/app_generators/ahn/templates/components/disabled/stomp_gateway/README.markdown

@@ -0,0 +1,47 @@
+What is Stomp?
+==============
+
+Stomp is a very simple message-queue protocol with which two separate systems can communicate. Because the protocol is so simple, there are many Stomp server implementations from which you can choose. Some of these include
+
+ - ActiveMQ (http://activemq.com)
+ - Ruby "stompserver" gem (gem install stompserver)
+ - RabbitMQ (http://rabbitmq.com)
+
+If you wish to get up and running with a development environment, the Ruby stompserver gem is a fantastic starting point. For a critical production system, ActiveMQ should probably be used but it bears the cumbersome paradigm of many "enterprisey" Java applications.
+
+How does it work?
+=================
+
+Stomp is used when certain processes have defined responsibilities. For example, your Adhearsion application's responsibility is to communicate with your Asterisk machine. Other processes (e.g. a Rails web application) will probably need to instruct Adhearsion to do something. Instructions may include
+
+ - Start a new call between two given phone numbers
+ - Have a particular call do something based on a new event
+ - Hangup a call
+
+Below is a diagram which should give you a better idea of how it works.
+
+    Process  Process  Process (e.g. Rails)
+         \      |      /
+          \     |     /
+           Stomp Server       (e.g. ActiveMQ)
+                |
+                |
+             Process          (e.g. Adhearsion)
+
+Note: Adhearsion could also be the sender of messages through the Stomp server which are consumed by a number of handlers.
+
+Setting up a Ruby Stomp server
+==============================
+
+Install the pure-Ruby Stomp server by doing "gem install stompserver". This will add the "stompserver" command to your system. When running it without any parameters, it starts without requiring authentication. If you're wanting to get a quick experiment running, I recommend simply doing that.
+
+Open the config.yml file in the stomp_gateway component folder. Comment out the four settings at the top of the file named "user", "pass", "host" and "port" by prepending a "#" to their line. This will cause the component to choose defaults for those properties. The component's defaults will match the expected credentials for the experimental stompserver you're already running on your computer.
+
+You also need specify a subscription name in 
+
+    events.stomp.start_call.each do |event|
+      # The "event" variable holds a Stomp::Message object.
+      name = event.headers
+    end
+
+You a

data/app_generators/ahn/templates/components/disabled/stomp_gateway/config.yml

@@ -0,0 +1,12 @@
+# Comment out any of these properties to use a default.
+
+user: stomp_user
+pass: secret_password
+host: localhost
+port: 61613
+
+### Add your list of subscriptions below that this gateway should proxy to events.rb
+
+# subscriptions:
+#   - start_call
+#   - hangup_call

data/app_generators/ahn/templates/components/disabled/stomp_gateway/stomp_gateway.rb

@@ -0,0 +1,34 @@
+require 'stomp'
+
+# TODO: Recover from a disconnect!
+
+initialization do
+  user = COMPONENTS.stomp_gateway[:user] || ""
+  pass = COMPONENTS.stomp_gateway[:pass] || ""
+  host = COMPONENTS.stomp_gateway[:host] || "localhost"
+  port = COMPONENTS.stomp_gateway[:port] || 61613
+  
+  ::StompGatewayConnection = Stomp::Client.open(user, pass, host, port)
+  
+  subscriptions = COMPONENTS.stomp_gateway["subscriptions"]
+  
+  ahn_log.stomp_gateway "Connection established. Subscriptions: #{subscriptions.inspect}"
+  
+  Events.register_namespace_name "/stomp"
+  
+  subscriptions.each do |subscription|
+    Events.register_namespace_name "/stomp/#{subscription}"
+    ::StompGatewayConnection.subscribe subscription do |event|
+      Adhearsion::Events.trigger ["stomp", subscription], event
+    end
+  end
+  
+end
+
+methods_for :global do
+  def send_stomp(destination, message, headers={})
+    ::StompGatewayConnection.send(destination, message, headers)
+  end
+end
+
+# In the future, I may add a methods_for(:events) method which allows synchronous messaging.

data/app_generators/ahn/templates/components/restful_rpc/README.markdown

@@ -0,0 +1,11 @@
+Adhearsion RESTful RPC Component
+================================
+
+This is a component for people want to integrate their telephony systems with non-Ruby systems. When enabled, this component
+will start up a HTTP server within the Adhearsion process and accept POST requests to invoke Ruby methods shared in the
+`methods_for(:rpc)` context.
+
+Protocol Notes
+--------------
+
+When POSTing your data to.

data/app_generators/ahn/templates/components/restful_rpc/config.yml

@@ -0,0 +1,34 @@
+# Use path_nesting to specify an arbitrarily nested. Could be used for additional security or in HTTP reverse proxy server.
+path_nesting: /
+
+port: 5000
+
+# The "handler" option here can be any valid Rack::Handler constant name.
+# Other options: WEBrick, EventedMongrel.
+# If you don't know the differences between these, "Mongrel" is definitely a good choice.
+handler: Mongrel
+
+# In a production system, you should make this "false" since
+show_exceptions: true
+
+# The "authentication" config option can either be "false" or key/value pairs representing allowed usernames and passwords.
+
+#authentication: false
+authentication:
+  jicksta: roflcopterz
+  foo: bar6213671682
+
+access: everyone   # When allowing "everyone" access, no IPs are blocked.
+#access: whitelist # When using a whitelist, the "whitelist" data below will be used.
+#access: blacklist # When using a blacklist, the "blacklist" data below will be used.
+
+# This is a list of IPs which are exclusively allowed to call this web service.
+# Note: whitelists are far more secure than blacklists.
+whitelist:
+  - 127.0.0.1
+  - 192.168.*.*
+
+# This is a list of the IPs which are explicitly NOT allowed to call this web service. This will only be used if "access" is
+# set to "blacklist" above.
+blacklist:
+  - 100.200.100.200

data/app_generators/ahn/templates/components/restful_rpc/example-client.rb

@@ -0,0 +1,48 @@
+require 'rubygems'
+require 'rest_client'
+require 'json'
+
+# You must have the "rest-client" and "json" gems installed for this file to work.
+
+class RESTfulAdhearsion
+  
+  DEFAULT_OPTIONS = {
+    # Note: :user and :password are non-existent by default
+    :host => "localhost",
+    :port => "5000",
+    :path_nesting => "/"
+  }
+  
+  def initialize(options={})
+    @options = DEFAULT_OPTIONS.merge options
+    
+    @path_nesting = @options.delete :path_nesting
+    @host = @options.delete :host
+    @port = @options.delete :port
+    
+    @url_beginning = "http://#{@host}:#{@port}#{@path_nesting}"
+  end
+  
+  def method_missing(method_name, *args)
+    JSON.parse RestClient::Resource.new(@url_beginning + method_name.to_s, @options).post(args.to_json)
+  end
+  
+end
+
+Adhearsion = RESTfulAdhearsion.new :host => "localhost", :port => 5000, :user => "jicksta", :password => "roflcopterz"
+
+# ### Sample component code. Try doing "ahn create component testing123" and pasting this code in.
+#
+# methods_for :rpc do
+#   def i_like_hashes(options={})
+#     options.has_key?(:foo)
+#   end
+#   def i_like_arrays(*args)
+#     args.reverse
+#   end
+# end
+
+# Note: everything returned will be wrapped in an Array
+
+p Adhearsion.i_like_hashes(:foo => "bar")
+p Adhearsion.i_like_arrays(1,2,3,4,5)

data/app_generators/ahn/templates/components/restful_rpc/restful_rpc.rb

@@ -0,0 +1,87 @@
+require 'rack'
+require 'json'
+
+# Don't you love regular expressions? Matches only 0-255 octets. Recognizes "*" as an octet wildcard.
+VALID_IP_ADDRESS = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|\*)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|\*)$/
+
+def ip_allowed?(ip)
+  raise ArgumentError, "#{ip.inspect} is not a valid IP address!" unless ip.kind_of?(String) && ip =~ VALID_IP_ADDRESS
+  
+  octets = ip.split "."
+  
+  case COMPONENTS.restful_rpc["access"]
+    when "everyone"
+      true
+    when "whitelist"
+      whitelist = COMPONENTS.restful_rpc["whitelist"]
+      !! whitelist.find do |pattern|
+        pattern_octets = pattern.split "."
+        # Traverse both arrays in parallel
+        octets.zip(pattern_octets).map do |octet, octet_pattern|
+          octet_pattern == "*" ? true : (octet == octet_pattern)
+        end == [true, true, true, true]
+      end
+    when "blacklist"
+      blacklist = COMPONENTS.restful_rpc["blacklist"]
+      ! blacklist.find do |pattern|
+        pattern_octets = pattern.split "."
+        # Traverse both arrays in parallel
+        octets.zip(pattern_octets).map do |octet, octet_pattern|
+          octet_pattern == "*" ? true : (octet == octet_pattern)
+        end == [true, true, true, true]
+      end
+    else
+      raise Adhearsion::Components::ConfigurationError, 'Unrecognized "access" configuration value!'
+  end
+end
+
+RESTFUL_API_HANDLER = lambda do |env|
+  json = env["rack.input"].read
+  
+  # Return "Bad Request" HTTP error if the client forgot
+  return [400, {}, "You must POST a valid JSON object!"] if json.blank?
+  
+  json = JSON.parse json
+  
+  nesting = COMPONENTS.restful_rpc["path_nesting"]
+  path = env["PATH_INFO"]
+  
+  return [404, {}, "This resource does not respond to #{path.inspect}"] unless path[0...nesting.size] == nesting
+  
+  path = path[nesting.size..-1]
+  
+  return [404, {"Content-Type" => "application/json"}, "You cannot nest method names!"] if path.include?("/")
+  
+  rpc_object = Adhearsion::Components.component_manager.extend_object_with(Object.new, :rpc)
+  
+  # TODO: set the content-type and other HTTP headers
+  response_object = Array rpc_object.send(path, *json)
+  [200, {"Content-Type" => "application/json"}, response_object.to_json]
+  
+end
+
+initialization do
+  config = COMPONENTS.restful_rpc
+  
+  api = RESTFUL_API_HANDLER
+
+  port            = config["port"] || 5000
+  authentication  = config["authentication"]
+  show_exceptions = config["show_exceptions"]
+  handler         = Rack::Handler.const_get(config["handler"] || "Mongrel")
+  
+  if authentication
+    api = Rack::Auth::Basic.new(api) do |username, password|
+      authentication[username] == password
+    end
+    api.realm = "Adhearsion API"
+  end
+  
+  if show_exceptions
+    api = Rack::ShowStatus.new(Rack::ShowExceptions.new(api))
+  end
+  
+  Thread.new do
+    handler.run api, :Port => port  
+  end
+end

data/app_generators/ahn/templates/components/simon_game/simon_game.rb

@@ -0,0 +1,56 @@
+methods_for :dialplan do
+  def simon_game
+    SimonGame.new(self).start
+  end
+end
+
+class SimonGame
+
+  def initialize(call)
+    @call = call
+    reset
+  end
+  
+  def start
+    loop do
+      say_number
+      collect_attempt
+      verify_attempt
+    end
+  end
+
+  def random_number
+    rand(10).to_s
+  end
+
+  def update_number
+    @number << random_number
+  end
+
+  def say_number
+    update_number
+    @call.say_digits @number
+  end
+
+  def collect_attempt
+    @attempt = @call.input @number.length
+  end
+
+  def verify_attempt
+    if attempt_correct? 
+      @call.play 'good'
+    else
+      @call.play %W[#{@number.length-1} times wrong-try-again-smarty]
+      reset
+    end
+  end
+
+  def attempt_correct?
+    @attempt == @number
+  end
+  
+  def reset
+    @attempt, @number = '', ''
+  end
+  
+end