bot_platform 0.2.3 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d96e8445f9a9c0076abb76466b1d303585f1c013604c04cce1455a5d008eeabd
-  data.tar.gz: 755fb77055dd2f6a325ece4f24b4e9892f9500b947586f16c81c8cc22139bc94
+  metadata.gz: 0c7889efb278cdccac2f362eba726567c20523b0f71295fd99dcf02c599dde66
+  data.tar.gz: 50eae5a0a56f0d024adaded78b83761b7a88a2ae03162bc573582f5d97863c0e
 SHA512:
-  metadata.gz: 85b765ba89d4e1b353d9b69619672cf9f9438d6ac035013beb6446b9cd23cab91d1e7cff70f320ef9f2b216c0a11bc20a0d989022d74323d88c3f5e47ac66306
-  data.tar.gz: 54ab28dbb708871b12ce01db343e3c42bf7a458d1f0b8c5a7cd629a138ae1da79eb2574aae2db5934492a9579f3ec470ceaf04dd86734d264a1359264f5ff03c
+  metadata.gz: e69556208d3f547699c078223e8d5669c87af5224f42ffb8d98adc063172a6bdf42d8094ee25168de1f24c037c8ddb55e9972b7b346d5cc988ecb908f1267d5f
+  data.tar.gz: 3a2b1ef5b894d09c0f1e1a222363db7af962bc4dd2bb92bb23c02374fb50485d89b9c928b91d32834f8a30b2228827b2e5b84901061c68a3a1fe06915ac97ba3

data/.gitignore

@@ -7,6 +7,8 @@
 /spec/reports/
 /tmp/
 
+.DS_Store
+
 vendor/bundle
 
 # rspec failure tracking

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2021-09-06
+
+### Added
+- Waterfall dialog support
+- Waterfall sample
+- user_state
+
+### Fixed
+- end_of_turn response
+
 ## [0.2.2-0.2.3] - 2021-09-06
 
 ### Added

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    bot_platform (0.2.3)
+    bot_platform (0.3.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -1,6 +1,8 @@
 ##
 *This Project is still underconstruction.*
 
+![One Bot, Multiple Channels!](https://github.com/Lifevar/bot-platform/blob/main/images/bot-platform.png)
+
 # Bot Platform (Ruby Version)
 
 A ruby based Bot platform to let developers to focus on bot's business logic ONLY. You can connect your bot to channels such as slack, teams, lineworks, chatwork and etc within only a few steps of settings(without coding) to use the same bot's logic. check the [supported bot channels](https://github.com/lifevar/bot-platform/blob/main/docs/channels.md#supported).
@@ -27,20 +29,49 @@ And then execute:
 
 Or install it yourself as:
 
-    $ gem install bot_platform
+```bash
+$ gem install bot_platform
+```
 
 ## Usage
 
-    $ bin/cli samples/echo.rb
+Documents are under-construction.
+
+## Demos
+
+### CLI
 
+Clone this repository first. Go to the root directory and run:
 
-or
+```bash
+bin/cli [bot-script]
+```
+
+echo sample:
+
+```bash
+$ bin/cli samples/echo.rb
+```
 
-    $ bin/cli samples/dialogs/dialog_simple.rb
+simple dialog sample:
+
+```bash
+$ bin/cli samples/dialogs/dialog_simple.rb
+```
+
+waterfall dialog sample:
+
+```bash
+$ bin/cli samples/dialogs/waterfall_dialogs.rb
+```
+
+You can use 'exit' to quit bot shell. You can write your own bot scripts, be careful the file's name should be snake format.(We guess the class name from the file's name)
 
 ## Development
 
-We're working on both console bot and Line Works bot nowtime. 
+We're working on both console bot and Line Works bot nowtime and has plan to develop to other channels.
+
+It's welcome to share your channel's code to us.
 
 ## Contributing
 

data/lib/bot_platform/asserts.rb

@@ -34,6 +34,10 @@ module BotPlatform
       raise "dialog is aready added" if !hash[id.to_sym].nil?
     end
 
+    def assert_waterfall_step_context_is_valid(ctx)
+      raise "Waterfall Step Context is not valid" if ctx.nil? || !(ctx.is_a? Dialogs::WaterfallStepContext)
+    end
+
     def assert_activity_is_not_null(activity)
       raise "activity cannot be null" if activity.nil?
     end

data/lib/bot_platform/dialogs/dialog_context.rb

@@ -52,15 +52,20 @@ module BotPlatform
         return DialogResult.new :empty
       end
 
-      def stop_dialog(result)
+      def stop_dialog(result=nil)
+
         if @dialog_stack.any?
           @dialog_stack.pop
         end
-        dialog = active_dialog
+
+        instance = active_dialog
 
         #previous dialog
-        if dialog
-          dialog.resume self
+        if !instance.nil?
+          dialog = @dialogs.find instance.dialog_id
+          if dialog
+            return dialog.resume self, DialogReason::END_CALLED, result
+          end
         else
           return DialogResult.new :complete, result
         end

data/lib/bot_platform/dialogs/dialog_reason.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module BotPlatform
+  module Dialogs
+    class DialogReason
+      BEGIN_CALLED    = 1
+      CONTINUE_CALLED = 2
+      CANCEL_CALLED   = 3
+      END_CALLED      = 4
+      REPLACE_CALLED  = 5
+      NEXT_CALLED     = 6
+    end
+  end
+end

data/lib/bot_platform/dialogs/dialog_result.rb

@@ -7,6 +7,7 @@ module BotPlatform
         :empty => 0,
         :complete => 1,
         :canceled => 2,
+        :end_of_turn => 3,
       }
 
       attr_reader :status, :result

data/lib/bot_platform/dialogs/dialog_state.rb

@@ -1,10 +1,12 @@
+# frozen_string_literal: true
+
 module BotPlatform
   module Dialogs
     class DialogState
       attr_accessor :dialog_stack
 
-      def initialize
-        @dialog_stack = []
+      def initialize(state = [])
+        @dialog_stack = state
       end
     end
   end

data/lib/bot_platform/dialogs/prompts/confirm_prompt.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module BotPlatform
+  module Dialogs
+    module Prompts
+      class ConfirmPrompt < Prompt
+        attr_reader :choice_options, :confirm_choices, :choice_defaults, :default_locale
+
+        def initialize(dialog_id, validator=nil, default_locale=nil)
+          super(dialog_id, validator)
+          @default_locale = default_locale
+        end
+
+        def on_prompt(ctx, state, options, is_retry)
+          assert_turn_context_is_valid ctx
+          #assert_dialog_instance_state_is_valid state
+          assert_prompt_options_is_valid options
+
+          if is_retry && !options.retry_prompt.nil?
+            ctx.send_activity options.retry_prompt
+          else
+            ctx.send_activity options.prompt
+          end
+
+        end
+
+        def on_recognize(ctx, state, options)
+          assert_turn_context_is_valid ctx
+
+          result = PromptRecognizerResult.new
+          if ctx.activity.type == BotPlatform::Activity::TYPES[:message]
+            message = ctx.activity.text
+            if !message.nil? && !message.empty? 
+              case message.downcase
+              when 'y','yes','yeah', 'ok', 'okay'
+                result.succeeded = true
+                result.value = true
+              else
+                result.succeeded = true
+                result.value = false
+              end
+            end
+          end
+
+          return result
+        end
+      end
+    end
+  end
+end

data/lib/bot_platform/dialogs/prompts/number_prompt.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module BotPlatform
+  module Dialogs
+    module Prompts
+      class NumberPrompt < Prompt
+        attr_reader :default_locale
+
+        def initialize(dialog_id, validator=nil, default_locale=nil)
+          super(dialog_id, validator)
+          @default_locale = default_locale
+        end
+
+        def on_prompt(ctx, state, options, is_retry)
+          assert_turn_context_is_valid ctx
+          #assert_dialog_instance_state_is_valid state
+          assert_prompt_options_is_valid options
+
+          if is_retry && !options.retry_prompt.nil?
+            ctx.send_activity options.retry_prompt
+          else
+            ctx.send_activity options.prompt
+          end
+        end
+
+        def on_recognize(ctx, state, options)
+          assert_turn_context_is_valid ctx
+
+          result = PromptRecognizerResult.new
+          if ctx.activity.type == BotPlatform::Activity::TYPES[:message]
+            message = ctx.activity.text
+            if !message.nil? && !message.empty? && message =~ /\A[-+]?[0-9]*\.?[0-9]+\Z/
+              result.succeeded = true
+              result.value = message.to_i
+            end
+          end
+
+          return result
+        end
+      end
+    end
+  end
+end

data/lib/bot_platform/dialogs/prompts/prompt.rb

@@ -20,7 +20,7 @@ module BotPlatform
           state[:state] = {}
 
           on_prompt(dc.turn_context, state[:state], state[:options], false)
-          return BotPlatform::Dialogs::DialogResult.new :complete
+          return BotPlatform::Dialogs::DialogResult.new :end_of_turn
         end
 
         def continue(dc)
@@ -49,15 +49,17 @@ module BotPlatform
           if is_valid
             return dc.stop_dialog(recognized.value)
           else
-            return on_prompt(dc.turn_context, state, options, true)
+            on_prompt(dc.turn_context, state, options, true)
           end
+
+          return BotPlatform::Dialogs::DialogResult.new :end_of_turn
         end
 
         def resume(dc, result=null)
           assert_dialog_context_is_valid dc
 
           reprompt(dc.turn_context, dc.active_dialog)
-          return BotPlatform::Dialogs::DialogResult.new :complete
+          return BotPlatform::Dialogs::DialogResult.new :end_of_turn
         end
 
         def repromp(ttx, instance)

data/lib/bot_platform/dialogs/prompts/prompt_options.rb

@@ -6,6 +6,9 @@ module BotPlatform
       class PromptOptions
         attr_accessor :prompt, :retry_prompt, :choices, :validations
 
+        def initialize(prompt:nil)
+          @prompt = prompt
+        end
       end
     end
   end

data/lib/bot_platform/dialogs/waterfall_dialog.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+require 'logger'
+
+module BotPlatform
+  module Dialogs
+    class WaterfallDialog < Dialog
+      include BotPlatform::Asserts
+
+      LOGLEVELS = %w[DEBUG INFO WARN ERROR FATAL UNKNOWN].freeze
+      attr_reader :steps
+
+      def initialize(dialog_id, actions)
+        super(dialog_id)
+        @steps = actions.nil? ? [] : actions
+        @logger = Logger.new(STDOUT)
+        
+        level ||= LOGLEVELS.index ENV.fetch("BOT_LOG_LEVEL","WARN")
+        level ||= Logger::WARN
+        @logger.level = level
+      end
+
+      def version
+        return "#{@id}:#{@steps.count}"
+      end
+
+      def add_step(step)
+        @steps.push step
+        return self
+      end
+
+      def start(dc, options=nil)
+        assert_dialog_context_is_valid dc
+
+        state = dc.active_dialog.state
+        instance_id = SecureRandom.uuid
+
+        state[:options] = options
+        state[:values] = {}
+        state[:instace_id] = instance_id
+
+        # first step
+        run_step(dc, 0, DialogReason::BEGIN_CALLED, nil)
+      end
+
+      def continue(dc)
+        @logger.debug "continue dc:#{dc.inspect}"
+        assert_dialog_context_is_valid dc
+
+        if dc.turn_context.activity.type != Activity::TYPES[:message]
+          return DialogResult.new :complete
+        end
+
+        return resume(dc, DialogReason::CONTINUE_CALLED, dc.turn_context.activity.text)
+      end
+
+      def resume(dc, reason, result)
+        assert_dialog_context_is_valid dc
+
+        state = dc.active_dialog.state
+
+        index = state[:step_index]
+        run_step(dc, index+1, reason, result)
+      end
+
+      def stop(turn_ctx, instance, reason)
+        assert_turn_context_is_valid turn_ctx
+        assert_dialog_instance_is_valid instance
+        assert_dialog_reason_is_valid reason
+
+        if reason == DialogReason::CANCEL_CALLED
+          state = instance.state.dup
+          index = state[:step_index]
+          step_name = waterfall_step_name(index)
+          instance_id = state[:instance_id]
+
+          logger.debug {dialog_id:@id, step_name:step_name, instance_id:instance_id}.to_json
+        elsif reason == DialogReason::END_CALLED
+          state = instance.state.dup
+          index = state[:step_index]
+          instance_id = state[:instance_id]
+
+          logger.debug {dialog_id:@id, instance_id:instance_id}.to_json
+        end
+
+      end
+
+      def on_step(step_ctx)
+        step_name = waterfall_step_name(step_ctx.index)
+        instance_id = step_ctx.active_dialog.state[:instance_id]
+        return @steps[step_ctx.index][:method].call step_ctx
+      end
+
+      def run_step(dc, index, reason, result)
+        assert_dialog_context_is_valid dc
+
+        if index < @steps.count
+          state = dc.active_dialog.state
+          state[:step_index] = index
+
+          options = state[:options]
+          values = state[:values]
+          step_context = WaterfallStepContext.new self, dc, options, values, index, reason, result
+
+          return on_step(step_context)
+        end
+
+        return dc.end_dialog(result)
+      end
+
+      def waterfall_step_name(index)
+        step_name = @steps[index][:name]
+
+        if step_name.nil? || step_name.empty? || step_name.include?("<")
+          step_name = "Step#{index+1}of#{@steps.count}"
+        end
+
+        step_name
+      end
+
+    end
+  end
+end

data/lib/bot_platform/dialogs/waterfall_step.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module BotPlatform
+  module Dialogs
+    # a delegate class
+    class WaterfallStep
+
+      def initialize(&step)
+        @step = step
+      end
+
+      def do_step(step_ctx)
+        @step.call step_ctx
+      end
+    end
+  end
+end

data/lib/bot_platform/dialogs/waterfall_step_context.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module BotPlatform
+  module Dialogs
+    class WaterfallStepContext < DialogContext
+      attr_reader :parent_waterfall_dialog, :index, :options,:result, :reason, :values
+      attr_accessor :next_called
+
+      def initialize(parent, dc, options, values, index, reason, result)
+        super(dc.dialogs, dc.turn_context, DialogState.new(dc.dialog_stack))
+        @parent_waterfall_dialog = parent
+        @next_called = false
+        @options = options
+        @index = index
+        @reason = reason
+        @result = result
+        @values = values
+      end
+
+      def next(result=nil)
+        raise "cannot use next() twice." if @next_called
+
+        @next_called = true
+        return @parent_waterfall_dialog.resume(self, DialogReason::NEXT_CALLED, result)
+      end
+
+    end
+  end
+end

data/lib/bot_platform/dialogs.rb

@@ -4,12 +4,21 @@ require_relative 'dialogs/dialog_instance'
 require_relative 'dialogs/dialog_result'
 require_relative 'dialogs/dialog_set'
 require_relative 'dialogs/dialog_state'
+require_relative 'dialogs/dialog_reason'
 
 require_relative 'dialogs/prompts/prompt'
 require_relative 'dialogs/prompts/prompt_options'
+require_relative 'dialogs/prompts/confirm_prompt'
+require_relative 'dialogs/prompts/number_prompt'
 require_relative 'dialogs/prompts/text_prompt'
 require_relative 'dialogs/prompts/prompt_recognizer_result'
 
+
+require_relative 'dialogs/waterfall_dialog'
+require_relative 'dialogs/waterfall_step'
+require_relative 'dialogs/waterfall_step_context'
+
+
 module BotPlatform
   module Dialogs
 

data/lib/bot_platform/state/bot_state.rb

@@ -11,6 +11,15 @@ module BotPlatform
         @service_key = service_key
       end
 
+      def create_property(key)
+        @storage.data[key.to_sym] = {}
+        return @storage.data[key.to_sym]
+      end
+
+      def get_property(key)
+        return @storage.data[key.to_sym]
+      end
+
       def save_changes(turn_context, force=false)
         assert_turn_context_is_valid turn_context
 

data/lib/bot_platform/state/user_state.rb

@@ -1 +1,17 @@
 # frozen_string_literal: true
+
+module BotPlatform
+  module State
+    class UserState < BotState
+      def initialize(storage)
+        super(storage, "user_state")
+      end
+
+      def get_storage_key(turn_context)
+        channel_id = turn_context.activity.channel_id
+        user_id = turn_context.from.user_id
+        "#{channel_id}/users/#{user_id}"
+      end
+    end
+  end
+end

data/lib/bot_platform/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BotPlatform
-  VERSION = "0.2.3"
+  VERSION = "0.3.0"
 end

data/lib/bot_platform.rb

@@ -12,6 +12,7 @@ require_relative "bot_platform/storage/storageable"
 require_relative "bot_platform/storage/memory_storage"
 require_relative "bot_platform/state/bot_state"
 require_relative "bot_platform/state/conversation_state"
+require_relative "bot_platform/state/user_state"
 
 module BotPlatform
   class Error < StandardError; end

data/samples/dialogs/dialog_simple.rb

@@ -12,12 +12,13 @@ class DialogSimple
   def on_turn(ctx)
     dialog_ctx = @dialogs.create_dialog_context(ctx)
     results = dialog_ctx.continue_dialog
-    options = BotPlatform::Dialogs::Prompts::PromptOptions.new
-    options.prompt = BotPlatform::MessageFactory.Text("Input your name please:")
+
     if results.status == :empty
       dialog_ctx.prompt(
         "name",
-        options
+        BotPlatform::Dialogs::Prompts::PromptOptions.new(
+          prompt: BotPlatform::MessageFactory.Text("Input your name please:")
+        )
       )
     elsif results.status == :complete
       unless results.result.nil?

data/samples/dialogs/waterfall_dialogs.rb

@@ -0,0 +1,46 @@
+require_relative 'waterfall_steps'
+class WaterfallDialogs
+  include Waterfall::Steps
+
+  attr_accessor :dialogs
+
+  def initialize
+    storage = BotPlatform::Storage::MemoryStorage.instance
+    @user_state = BotPlatform::State::UserState.new storage
+    profile = @user_state.create_property("user_profile")
+    @dialogs = BotPlatform::Dialogs::DialogSet.new
+    steps = [
+      {name:'request-name', method:->(ctx) { request_name_step(ctx) }},
+      {name: 'confirm_asking_age_step', method:->(ctx) { confirm_asking_age_step(ctx, profile) }},
+      {name: 'request_age_step', method:->(ctx) { request_age_step(ctx) }},
+      {name: 'confirm_register_step', method: ->(ctx) { confirm_register_step(ctx, profile) }},
+      {name: 'summary', method: ->(ctx) { summary_step(ctx) }},
+    ]
+    @dialogs.add BotPlatform::Dialogs::WaterfallDialog.new("profile", steps)
+    @dialogs.add BotPlatform::Dialogs::Prompts::TextPrompt.new("name")
+    @dialogs.add BotPlatform::Dialogs::Prompts::NumberPrompt.new("age")
+    @dialogs.add BotPlatform::Dialogs::Prompts::ConfirmPrompt.new("confirm")
+
+    @conversation_state = BotPlatform::State::ConversationState.new storage
+  end
+
+  def on_turn(ctx)
+    if ctx.activity.type == BotPlatform::Activity::TYPES[:message]
+      dialog_ctx = @dialogs.create_dialog_context(ctx)
+      
+      # run continue is there're some existed dialogs
+      results = dialog_ctx.continue_dialog
+
+      # there's no existed dialog
+      if results.status == :empty
+        dialog_ctx.start_dialog "profile", nil
+      elsif results.status == :complete
+        user_profile = @user_state.get_property(:user_profile)
+      end
+
+      # save user_profile and dialog_state
+      @user_state.save_changes(ctx, false)
+      @conversation_state.save_changes(ctx, false)
+    end
+  end
+end

data/samples/dialogs/waterfall_steps.rb

@@ -0,0 +1,50 @@
+module Waterfall
+  module Steps
+    def request_name_step(step_ctx)
+      return step_ctx.prompt(
+        "name", 
+        BotPlatform::Dialogs::Prompts::PromptOptions.new(
+          prompt:BotPlatform::MessageFactory.Text("Input your name please.")
+        )
+      )
+    end
+
+    def confirm_asking_age_step(step_ctx, user_profile)
+      profile = user_profile
+      profile[:name] = step_ctx.result
+      return step_ctx.prompt(
+        "confirm", 
+        BotPlatform::Dialogs::Prompts::PromptOptions.new(
+          prompt:BotPlatform::MessageFactory.Text("May I ask your age?")
+        )
+      )
+    end
+
+    def request_age_step(step_ctx)
+      if step_ctx.result
+        step_ctx.prompt("age", BotPlatform::Dialogs::Prompts::PromptOptions.new(prompt:BotPlatform::MessageFactory.Text("Input your age please")))
+      else
+        step_ctx.next(-1)
+      end
+    end
+
+    def confirm_register_step(step_ctx, profile)
+      age = step_ctx.result.to_i
+
+      profile[:age] = '(unknown)'
+      profile[:age] = age if age != -1
+
+      prompt = "Register user profile as below. Is it okay?\n Name:#{profile[:name]}\n Age: #{profile[:age]}"
+      step_ctx.prompt("confirm", BotPlatform::Dialogs::Prompts::PromptOptions.new(prompt:BotPlatform::MessageFactory.Text(prompt)))
+    end
+
+    def summary_step(step_ctx)
+      if step_ctx.result
+        step_ctx.turn_context.send_message "Profile saved."
+      else
+        step_ctx.turn_context.send_message "Profile registration has been canceled."
+      end
+      step_ctx.stop_dialog
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bot_platform
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.3.0
 platform: ruby
 authors:
 - Ningfeng Yang
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-09-05 00:00:00.000000000 Z
+date: 2021-09-06 00:00:00.000000000 Z
 dependencies: []
 description: One bot, multiple channels supported
 email:
@@ -41,6 +41,7 @@ files:
 - bot_platform.gemspec
 - docs/channels.md
 - exe/welcome
+- images/bot-platform.png
 - lib/bot_platform.rb
 - lib/bot_platform/activity.rb
 - lib/bot_platform/adapter.rb
@@ -65,13 +66,19 @@ files:
 - lib/bot_platform/dialogs/dialog.rb
 - lib/bot_platform/dialogs/dialog_context.rb
 - lib/bot_platform/dialogs/dialog_instance.rb
+- lib/bot_platform/dialogs/dialog_reason.rb
 - lib/bot_platform/dialogs/dialog_result.rb
 - lib/bot_platform/dialogs/dialog_set.rb
 - lib/bot_platform/dialogs/dialog_state.rb
+- lib/bot_platform/dialogs/prompts/confirm_prompt.rb
+- lib/bot_platform/dialogs/prompts/number_prompt.rb
 - lib/bot_platform/dialogs/prompts/prompt.rb
 - lib/bot_platform/dialogs/prompts/prompt_options.rb
 - lib/bot_platform/dialogs/prompts/prompt_recognizer_result.rb
 - lib/bot_platform/dialogs/prompts/text_prompt.rb
+- lib/bot_platform/dialogs/waterfall_dialog.rb
+- lib/bot_platform/dialogs/waterfall_step.rb
+- lib/bot_platform/dialogs/waterfall_step_context.rb
 - lib/bot_platform/message_factory.rb
 - lib/bot_platform/state/bot_state.rb
 - lib/bot_platform/state/conversation_state.rb
@@ -83,6 +90,8 @@ files:
 - lib/bot_platform/turn_context.rb
 - lib/bot_platform/version.rb
 - samples/dialogs/dialog_simple.rb
+- samples/dialogs/waterfall_dialogs.rb
+- samples/dialogs/waterfall_steps.rb
 - samples/echo.rb
 homepage: https://github.com/lifevar/bot-platform
 licenses: