stealth 2.0.0.beta5 → 2.0.0.beta6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24ba7ba55d264e21395db7b9166ecf96064c2c0d8c8bc51d09dd274ecaf5fd34
-  data.tar.gz: c42254f819550577f249fddb13266cfa6bc8e2f27760994e3efdf7798447ecdd
+  metadata.gz: 691209f0b8b7a49ffa802cb57919c23dccb5f85f3da86e7bfec70c7e0ea85c5f
+  data.tar.gz: 3399604a657b73ba4d608d3516321d360b46dfd4ad6b5656845156ba61fee21a
 SHA512:
-  metadata.gz: 3f1af77ae1b811b4f53f85df2365fae399efe6caf9db77a801898250dfcdb732e366b06efa1641b255eda53e2a22fff38ca7a8ebd6577d6dcf860509d002c261
-  data.tar.gz: 7146a30ad60302ccc322e6691c6676b6b281dee1625bc1acf674e133b87d371b5cc470c5d3d4eb6d50526d33992a81f424364fbf4b10e23d93910aed815b5864
+  metadata.gz: 5f11b7d1acf10695012b0c253622d8cd7e4885265517f596f40364b60a9d0547a104aa700c5da78ec2015c5fb5de7a6314dbba716e5262353b50fee154b3c82e
+  data.tar.gz: 6abe7e7278d7c6a7e13d8c86044baf8d26c266f980decf5415ea9dc0fcf0b9f40e01b233524a933c0c11852b300b7243eff44e27c007c6274aa606ac44b54a5f

data/.gitbook.yaml

@@ -0,0 +1 @@
+root: ./docs/

data/.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "bundler" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "daily"

data/.github/workflows/ci.yml

@@ -0,0 +1,50 @@
+name: CI
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  tests:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-18.04, ubuntu-20.04, ubuntu-22.04, macos-latest]
+        ruby: [ 2.7, 3.0, 3.1, truffleruby-head ]
+        exclude:
+          - os: ubuntu-22.04
+            ruby: 2.7
+          - os: ubuntu-22.04
+            ruby: truffleruby-head
+
+    runs-on: ${{ matrix.os }}
+
+    name: ${{ matrix.os }} - ${{ matrix.ruby }}
+
+    env:
+      BUNDLE_GEMFILE: Gemfile
+      STEALTH_ENV: test
+
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+
+      - name: Run specs
+        if: startsWith(matrix.os, 'macos') || startsWith(matrix.os, 'ubuntu')
+        timeout-minutes: 10
+        run: bundle exec rspec
+        continue-on-error: ${{ startsWith(matrix.ruby, 'truffleruby') }}
+  check_status:
+    if: ${{ always() }}
+    runs-on: ubuntu-latest
+    name: CI Status (matrix)
+    needs: tests
+    steps:
+      - name: Check continue-on-error matrix status
+        if: ${{ needs.tests.result != 'success' }}
+        run: exit 1

data/CHANGELOG.md

@@ -72,6 +72,7 @@
 * [Catch All] Log output from all catch_all logging now includes the session_id so they can be included in log searches.
 * [NLP] Strip out values from single element arrays in the case of custom LUIS List entities.
 * [Config] Attempting to overwrite default config values with `nil` or `false` now correctly sets those config values.
+* [Server] Added support for Bandwidth respones. (thanks @emorissettegregoire)
 
 ## Deprecations
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    stealth (2.0.0.beta5)
+    stealth (2.0.0.beta6)
       activesupport (~> 6.0)
       multi_json (~> 1.12)
       puma (>= 4.2, < 6.0)
@@ -12,62 +12,63 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.1.5)
+    activesupport (6.1.7)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 1.6, < 2)
       minitest (>= 5.1)
       tzinfo (~> 2.0)
       zeitwerk (~> 2.3)
     concurrent-ruby (1.1.10)
-    connection_pool (2.2.5)
-    diff-lcs (1.3)
-    i18n (1.10.0)
+    connection_pool (2.3.0)
+    diff-lcs (1.5.0)
+    i18n (1.12.0)
       concurrent-ruby (~> 1.0)
-    minitest (5.15.0)
-    mock_redis (0.23.0)
+    minitest (5.16.3)
+    mock_redis (0.32.0)
+      ruby2_keywords
     multi_json (1.15.0)
-    mustermann (1.1.1)
+    mustermann (2.0.2)
       ruby2_keywords (~> 0.0.1)
     nio4r (2.5.8)
     oj (3.10.6)
-    puma (5.6.2)
+    puma (5.6.5)
       nio4r (~> 2.0)
-    rack (2.2.3)
-    rack-protection (2.2.0)
+    rack (2.2.4)
+    rack-protection (2.2.2)
       rack
-    rack-test (1.1.0)
-      rack (>= 1.0, < 3)
-    redis (4.6.0)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.1)
-      rspec-support (~> 3.9.1)
-    rspec-expectations (3.9.1)
+    rack-test (2.0.2)
+      rack (>= 1.3)
+    redis (4.8.0)
+    rspec (3.11.0)
+      rspec-core (~> 3.11.0)
+      rspec-expectations (~> 3.11.0)
+      rspec-mocks (~> 3.11.0)
+    rspec-core (3.11.0)
+      rspec-support (~> 3.11.0)
+    rspec-expectations (3.11.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
+      rspec-support (~> 3.11.0)
+    rspec-mocks (3.11.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.2)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.11.0)
     rspec_junit_formatter (0.4.1)
       rspec-core (>= 2, < 4, != 2.12.0)
     ruby2_keywords (0.0.5)
-    sidekiq (6.4.1)
-      connection_pool (>= 2.2.2)
+    sidekiq (6.5.6)
+      connection_pool (>= 2.2.5)
       rack (~> 2.0)
-      redis (>= 4.2.0)
-    sinatra (2.2.0)
-      mustermann (~> 1.0)
+      redis (>= 4.5.0, < 5)
+    sinatra (2.2.2)
+      mustermann (~> 2.0)
       rack (~> 2.2)
-      rack-protection (= 2.2.0)
+      rack-protection (= 2.2.2)
       tilt (~> 2.0)
     thor (1.2.1)
-    tilt (2.0.10)
-    tzinfo (2.0.4)
+    tilt (2.0.11)
+    tzinfo (2.0.5)
       concurrent-ruby (~> 1.0)
-    zeitwerk (2.5.4)
+    zeitwerk (2.6.0)
 
 PLATFORMS
   ruby
@@ -75,7 +76,7 @@ PLATFORMS
 DEPENDENCIES
   mock_redis (~> 0.22)
   oj (~> 3.10)
-  rack-test (~> 1.1)
+  rack-test (~> 2.0)
   rspec (~> 3.9)
   rspec_junit_formatter (~> 0.3)
   stealth!

data/MAINTENANCE.md

@@ -0,0 +1,28 @@
+## Maintenance Policy
+
+<a href='https://hellostealth.org'><img src='logo.svg' height='120' alt='Xip Logo' aria-label='hellostealth.org' /></a>
+
+## Versioning
+
+Stealth follows [semantic versioning](https://semver.org).
+
+```
+MAJOR.MINOR.PATCH
+```
+
+While we intend to do our best to ensure that even MAJOR version changes do not introduce breaking changes, we can't guarantee it yet at this point in the project.
+
+Rest assured, though, that all feature deprecations will be either "gently" removed or just permanently deprecated.
+
+
+## Currently Maintained Versions
+
+* :white_check_mark: - These versions will receive feature updates, bugfixes, and security updates.
+* :heavy_check_mark: - These versions will only receive bugfixes and security updates.
+* :x: - These versions are no longer maintained. Please upgrade.
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 2.x     | :white_check_mark: |
+| 1.1.x   | :heavy_check_mark: |
+| < 1.1   | :x:                |

data/SECURITY.md

@@ -0,0 +1,13 @@
+## Security Policy
+
+<a href='https://hiremav.com/security'><img src='logo.svg' height='120' alt='Stealth Logo' aria-label='Stealth security' /></a>
+
+## Reporting a Vulnerability
+
+**Do not open up a GitHub issue if the bug is a security vulnerability in Stealth**.
+
+Instead, please refer to Mav's [security policy](https://hiremav.com/security).
+
+## Supported Versions
+
+Please see our [maintenance policy](https://github.com/hellostealth/stealth/blob/master/MAINTENANCE.md) for currently supported versions.

data/VERSION

@@ -1 +1 @@
-2.0.0.beta5
+2.0.0.beta6

data/docs/.gitbook/assets/logo.svg

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="180px" height="180px" viewBox="0 0 180 180" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+    <title>stealth_app_logo</title>
+    <defs>
+        <rect id="path-1" x="0" y="0" width="180" height="180"></rect>
+        <path d="M51.3778558,-2.07572687e-15 L128.622144,2.07572687e-15 C146.487344,-1.20605709e-15 152.965697,1.86013822 159.496947,5.35308895 C166.028197,8.84603967 171.15396,13.9718029 174.646911,20.5030529 C178.139862,27.0343029 180,33.512656 180,51.3778558 L180,128.622144 C180,146.487344 178.139862,152.965697 174.646911,159.496947 C171.15396,166.028197 166.028197,171.15396 159.496947,174.646911 C152.965697,178.139862 146.487344,180 128.622144,180 L51.3778558,180 C33.512656,180 27.0343029,178.139862 20.5030529,174.646911 C13.9718029,171.15396 8.84603967,166.028197 5.35308895,159.496947 C1.86013822,152.965697 8.04038057e-16,146.487344 -1.38381791e-15,128.622144 L1.38381791e-15,51.3778558 C-8.04038057e-16,33.512656 1.86013822,27.0343029 5.35308895,20.5030529 C8.84603967,13.9718029 13.9718029,8.84603967 20.5030529,5.35308895 C27.0343029,1.86013822 33.512656,1.20605709e-15 51.3778558,-2.07572687e-15 Z" id="path-3"></path>
+    </defs>
+    <g id="Page-1" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
+        <g id="icon@180">
+            <g id="icon">
+                <mask id="mask-2" fill="white">
+                    <use xlink:href="#path-1"></use>
+                </mask>
+                <g id="Mask"></g>
+                <g id="Rectangle" mask="url(#mask-2)">
+                    <mask id="mask-4" fill="white">
+                        <use xlink:href="#path-3"></use>
+                    </mask>
+                    <use id="Mask" fill="#FFFFFF" xlink:href="#path-3"></use>
+                </g>
+            </g>
+            <g id="logo" transform="translate(24.960938, 18.984375)" fill="#000A38">
+                <path d="M65.0390625,0 L44.0583093,20.9046079 L41.9615065,22.9953504 L23.077556,41.8106246 L20.9807532,43.9013672 L0,64.8073839 L23.077556,87.8027344 L44.0583093,66.8967176 L65.0390625,87.8027344 L86.0198157,66.8967176 L106.999155,87.8027344 L130.078125,64.8073839 L109.098786,43.9013672 L106.999155,41.8106246 L88.1180324,22.9953504 L86.0198157,20.9046079 L65.0390625,0 Z M55.5970873,32.403692 L46.156526,22.9953504 L65.0390625,4.18007626 L83.921599,22.9953504 L74.4810377,32.403692 L65.0390625,41.8106246 L55.5970873,32.403692 Z M67.1372792,43.9013672 L76.5778405,34.4944345 L86.0198157,25.086093 L104.902352,43.9013672 L95.460377,53.3097087 L86.0198157,62.7166414 L67.1372792,43.9013672 Z M34.617748,53.3097087 L25.1771867,43.9013672 L44.0583093,25.086093 L53.5002845,34.4944345 L62.9408458,43.9013672 L44.0583093,62.7166414 L34.617748,53.3097087 Z M88.1180324,64.8073839 L97.5585938,55.3990424 L106.999155,45.9921097 L125.883105,64.8073839 L106.999155,83.6226581 L88.1180324,64.8073839 Z M46.156526,64.8073839 L65.0390625,45.9921097 L83.921599,64.8073839 L65.0390625,83.6226581 L46.156526,64.8073839 Z M4.19501953,64.8073839 L23.077556,45.9921097 L32.5195313,55.3990424 L41.9615065,64.8073839 L23.077556,83.6226581 L4.19501953,64.8073839 Z" id="glyph"></path>
+                <path d="M7.93868906,127.899703 C11.7243984,127.899703 14.7190641,125.865591 14.7190641,122.305894 C14.7190641,119.621995 13.0804734,118.011656 10.1140594,117.305367 L6.72387188,116.514323 C5.81982188,116.316562 5.28304219,115.892789 5.28304219,115.129997 C5.28304219,114.169444 6.15884063,113.604412 7.4584125,113.604412 C8.95574531,113.604412 9.74678906,114.338953 10.1140594,115.299506 L14.5495547,115.299506 C14.0692781,112.304841 11.6678953,109.988213 7.43016094,109.988213 C3.58794844,109.988213 0.762792188,112.220086 0.762792188,115.610273 C0.762792188,118.548436 2.68389844,119.876259 5.22653906,120.441291 L8.56022344,121.14758 C9.66203438,121.401844 10.1988141,121.769114 10.1988141,122.588409 C10.1988141,123.661969 9.23826094,124.255252 7.85393438,124.255252 C6.44135625,124.255252 5.4243,123.661969 5.05702969,122.475403 L0.33901875,122.475403 C0.960553125,125.893842 3.78570938,127.899703 7.93868906,127.899703 Z M28.539987,127.617187 L28.539987,114.169444 L33.9077839,114.169444 L33.9077839,110.270728 L18.6519401,110.270728 L18.6519401,114.169444 L23.9914855,114.169444 L23.9914855,127.617187 L28.539987,127.617187 Z M51.1753975,127.617187 L51.1753975,123.69022 L43.2367084,123.69022 L43.2367084,120.695555 L50.49736,120.695555 L50.49736,116.881594 L43.2367084,116.881594 L43.2367084,114.169444 L51.1753975,114.169444 L51.1753975,110.270728 L38.7729615,110.270728 L38.7729615,127.617187 L51.1753975,127.617187 Z M59.8262845,127.617187 L61.0411017,124.255252 L67.3412001,124.255252 L68.5842689,127.617187 L73.1892736,127.617187 L66.5784079,110.270728 L61.9451517,110.270728 L55.3342861,127.617187 L59.8262845,127.617187 Z M65.9851251,120.526045 L62.4254283,120.526045 L64.2052767,115.638525 L65.9851251,120.526045 Z M90.0048622,127.617187 L90.0048622,123.69022 L82.2356825,123.69022 L82.2356825,110.270728 L77.6871809,110.270728 L77.6871809,127.617187 L90.0048622,127.617187 Z M101.650415,127.617187 L101.650415,114.169444 L107.018212,114.169444 L107.018212,110.270728 L91.7623679,110.270728 L91.7623679,114.169444 L97.1019132,114.169444 L97.1019132,127.617187 L101.650415,127.617187 Z M116.431891,127.617187 L116.431891,120.752058 L123.127511,120.752058 L123.127511,127.617187 L127.676013,127.617187 L127.676013,110.270728 L123.127511,110.270728 L123.127511,116.853342 L116.431891,116.853342 L116.431891,110.270728 L111.883389,110.270728 L111.883389,127.617187 L116.431891,127.617187 Z" id="STEALTH" fill-rule="nonzero"></path>
+            </g>
+        </g>
+    </g>
+</svg>

data/docs/README.md

@@ -0,0 +1,35 @@
+---
+description: >-
+  Stealth includes everything you need to build amazing conversational bots with
+  tools you know and love. From two-way SMS-based bots to Facebook Messenger,
+  Stealth offers the best developer experience.
+---
+
+# Intro
+
+## ![](.gitbook/assets/logo.svg)
+
+## What's Stealth?
+
+Stealth is an open source, <img src=".gitbook/assets/ruby.png" alt="" data-size="line"> Ruby framework for conversational voice and text chatbots.
+
+Stealth is inspired by the Model-View-Controller (MVC) pattern. However, instead of calling them _Views,_ Stealth refers to them as _Replies_ to better match the chatbot domain.
+
+* The [Model](models/overview.md) layer represents your data model (such as Account, User, Quote, etc.) and encapsulates the business logic that is specific to your bot. By default, Stealth uses [ActiveRecord](models/activerecord.md), but you can use any library that you prefer.
+* The [Controller](controllers/controller-overview.md) layer is responsible for handling incoming requests from messaging platforms and providing and transmitting the response (reply).
+* The [Reply](replies/reply-overview.md) layer is composed of “templates” that are responsible for constructing the respective reply.
+
+In addition to being inspired by Model-View-Controller (MVC) pattern, Stealth has a few other awesome things built in for you.
+
+* **Plug and play components.** Every service integration in Stealth is a Ruby gem. One bot can support multiple [messaging platforms](platforms/overview.md) (i.e. Facebook Messenger, SMS, Alexa, and more) and multiple NLP/NLU services.
+* **Innovative.** Stealth is constantly improving and evolving. There are many innovations in Stealth such as: [interrupt detection](controllers/interrupt-detection.md), [homophone detection](controllers/handle\_message/homophone-detection.md), [hot-code reloading](dev-environment/hot-code-reloading.md), [multi-level catch-all handling](controllers/catch-alls.md), and more that make your bots perform better.
+* **Advanced tooling.** From web servers to continuous integration testing, Stealth is built to take advantage of all the great work done by the web development community.
+* **Hosting you trust.** Stealth bots are Rack applications. That means your bots can be [deployed](deployment/overview.md) using familiar services like Docker and Heroku.
+* **Ready for production.** Stealth already powers bots for large, well-known brands. You can rest assured your bot will be in good hands with Stealth.
+* **Open source.** Stealth is MIT licensed to ensure you own your bot's source code. More importantly, we welcome contributors to help make Stealth even better for everyone.
+
+## Prerequisites
+
+While it's helpful to have some familiarity with Ruby, we think you can get started with Stealth without yet knowing Ruby or even programming. Building text-based bots or Alexa Skills is a great starting point into the world of programming and we think Ruby is an excellent first programming language.
+
+We welcome contributors and questions from programmers of all experience levels.

data/docs/SUMMARY.md

@@ -0,0 +1,99 @@
+# Table of contents
+
+* [Intro](README.md)
+* [Getting Started](getting-started.md)
+* [Basics](basics.md)
+* [Dev Environment](dev-environment/README.md)
+  * [Booting Up](dev-environment/booting-up.md)
+  * [Hot-Code Reloading](dev-environment/hot-code-reloading.md)
+  * [Procfile](dev-environment/procfile.md)
+  * [Tunnels](dev-environment/tunnels.md)
+  * [Environment Variables](dev-environment/environment-variables.md)
+  * [Logs](dev-environment/logs.md)
+* [Glossary](glossary.md)
+
+## Flows
+
+* [Flows & States](flows/overview.md)
+* [State Naming](flows/state-naming.md)
+* [FlowMap](flows/flowmap.md)
+* [State Options](flows/state-options.md)
+
+## Controllers
+
+* [Controller Overview](controllers/controller-overview.md)
+* [Sessions](controllers/sessions/README.md)
+  * [Session Overview](controllers/sessions/intro.md)
+  * [step\_to](controllers/sessions/step\_to.md)
+  * [step\_to\_in](controllers/sessions/step\_to\_in.md)
+  * [step\_to\_at](controllers/sessions/step\_to\_at.md)
+  * [update\_session\_to](controllers/sessions/update\_session\_to.md)
+  * [step\_back](controllers/sessions/step\_back.md)
+  * [do\_nothing](controllers/sessions/do\_nothing.md)
+* [route](controllers/route.md)
+* [Available Data](controllers/available-data.md)
+* [handle\_message](controllers/handle\_message/README.md)
+  * [String Matcher](controllers/handle\_message/string-mather.md)
+  * [Alpha Ordinal Matcher](controllers/handle\_message/alpha-ordinal-matcher.md)
+  * [Homophone Detection](controllers/handle\_message/homophone-detection.md)
+  * [NLP Matcher](controllers/handle\_message/nlp-matcher.md)
+  * [Regex Matcher](controllers/handle\_message/regex-matcher.md)
+  * [Nil Matcher](controllers/handle\_message/nil-matcher.md)
+* [get\_match](controllers/get\_match/README.md)
+  * [Exact Match](controllers/get\_match/exact-match.md)
+  * [Alpha Ordinals](controllers/get\_match/alpha-ordinals.md)
+  * [Entity Match](controllers/get\_match/entity-match.md)
+* [Catch-Alls](controllers/catch-alls.md)
+* [Dev Jumps](controllers/dev-jumps.md)
+* [Interrupt Detection](controllers/interrupt-detection.md)
+* [Unrecognized Messages](controllers/unrecognized-messages.md)
+* [Platform Errors](controllers/platform-errors.md)
+
+## Replies
+
+* [Reply Overview](replies/reply-overview.md)
+* [YAML Replies](replies/yaml-replies.md)
+* [ERB](replies/erb.md)
+* [Delays](replies/delays.md)
+* [Variants](replies/variants.md)
+* [Inline Replies](replies/inline-replies.md)
+
+## Models
+
+* [Model Overview](models/overview.md)
+* [ActiveRecord](models/activerecord.md)
+* [Mongoid](models/mongoid.md)
+
+## Platforms
+
+* [Platform Overview](platforms/overview.md)
+* [Facebook Messenger](platforms/facebook-messenger.md)
+* [SMS/Whatsapp](platforms/sms-whatsapp.md)
+* [Alexa Skills](platforms/alexa-skills.md)
+* [Voice](platforms/voice.md)
+
+## NLP/NLU
+
+* [NLP Overview](nlp-nlu/overview.md)
+* [Microsoft LUIS](nlp-nlu/microsoft-luis.md)
+* [OpenAI](nlp-nlu/openai.md)
+
+## Config
+
+* [Settings](config/settings.md)
+* [services.yml](config/services.yml.md)
+
+## Testing
+
+* [Specs](testing/untitled.md)
+* [Integration Testing](testing/integration-testing.md)
+
+## Deployment
+
+* [Deployment Overview](deployment/overview.md)
+* [Heroku](deployment/heroku.md)
+
+## Building Components
+
+* [Message Services](building-components/message-services.md)
+* [NLP](building-components/nlp.md)

data/docs/basics.md

@@ -0,0 +1,77 @@
+---
+description: A quick primer of the various pieces that comprise Stealth.
+---
+
+# Basics
+
+## Anatomy of a Stealth Bot
+
+A Stealth bot has two primary processes: a _web server_, and a _background job processer_. If the messaging platform being used supports it, Stealth will push a message to a queue where a reply will be constructured by a background job. This allows you to easily scale your Stealth bot across many threads and processes.
+
+### Data Store
+
+Stealth requires Redis. Redis is used for [session storage](controllers/sessions/intro.md) as well as the queue for background jobs. You can access the Redis store yourself via the global variable: `$redis`. You can use it as your primary data store if you are building a simple bot, but you'll likely want to use a SQL or NoSQL database for more complex bots.
+
+### Environments
+
+Stealth bots can be booted into three environment types: `development`, `testing`, `production`. By default, if an environment is not specified via the `STEALTH_ENV` environment variable, the `development` environment will be used. The `testing` environment is automatically used when running your specs.
+
+### ActiveSupport
+
+Stealth automatically includes [active\_support](https://guides.rubyonrails.org/active\_support\_core\_extensions.html). So if you're used to using certain core extensions in Ruby on Rails, you can continue to use them in your Stealth bots!
+
+## Lifecycle of a Message
+
+This is just a brief outline of the lifecycle of a message to help you understand how Stealth processes messages. For more detailed information that you can use to build your own message platform components, check out [those docs](building-components/message-services.md).
+
+1. A message is received by the web server.
+2. If the message platform supports it, the message is backgrounded to be processed by a background job. If the message platform does not support it ([Alexa Skill](platforms/alexa-skills.md) or [Voice](platforms/voice.md)), the message is processed inline by the web server process.
+3. Stealth uses the respective message platform component to normalize the message into a standard format.
+4. Stealth calls the [route](controllers/route.md) method in `BotController`. If a session exists for the user, they are routed to their current state. If a session does not exist, by default the `route` method will route the user to the `HellosController#say_hello` method.
+5. The controller action will either do nothing, step to another state, update the session, or generate a reply. In the latter case, the reply will be delivered via the message platform component.
+
+## Directory Structure
+
+When you use the generator `stealth new` to instantiate a new bot, here is the directory structure that will be created:
+
+```
+├── Gemfile
+├── Procfile.dev
+├── README.md
+├── Rakefile
+├── bot
+│   ├── controllers
+│   │   ├── bot_controller.rb
+│   │   ├── catch_alls_controller.rb
+│   │   ├── concerns
+│   │   ├── goodbyes_controller.rb
+│   │   ├── hellos_controller.rb
+│   │   ├── interrupts_controller.rb
+│   │   └── unrecognized_messages_controller.rb
+│   ├── helpers
+│   │   └── bot_helper.rb
+│   ├── models
+│   │   ├── bot_record.rb
+│   │   └── concerns
+│   └── replies
+│       ├── catch_alls
+│       │   └── level1.yml
+│       ├── goodbyes
+│       │   └── say_goodbye.yml
+│       └── hellos
+│           └── say_hello.yml
+├── config
+│   ├── boot.rb
+│   ├── database.yml
+│   ├── environment.rb
+│   ├── flow_map.rb
+│   ├── initializers
+│   │   ├── autoload.rb
+│   │   └── inflections.rb
+│   ├── puma.rb
+│   ├── services.yml
+│   └── sidekiq.yml
+├── config.ru
+└── db
+    └── seeds.rb
+```

data/docs/building-components/message-services.md

@@ -0,0 +1,7 @@
+---
+description: Guide to creating your own message platform component.
+---
+
+# Message Services
+
+## Coming Soon...

data/docs/building-components/nlp.md

@@ -0,0 +1,7 @@
+---
+description: Guide to creating your own NLP component.
+---
+
+# NLP
+
+## Coming Soon...

data/docs/config/services.yml.md

@@ -0,0 +1,2 @@
+# services.yml
+

data/docs/config/settings.md

@@ -0,0 +1,2 @@
+# Settings
+

data/docs/controllers/available-data.md

@@ -0,0 +1,77 @@
+# Available Data
+
+Within each controller action, you have access to a few objects containing information about the session and the received message. 
+
+{% hint style="info" %}
+Other Stealth components might make additional data available (e.g., sentiment analysis, etc).
+{% endhint %}
+
+## `current_message`
+
+The current message being processed is available via `current_message`. This is a `Stealth::ServiceMessage` object. It has a few important methods:
+
+`sender_id`: The ID of the user sending the message. This will vary based on the message service component. This is also the ID that will be used as the user's session ID.
+
+`target_id`: The ID of the target. This will vary based on the service sending the message, but for Facebook it will be the `page_id` of the Facebook page receiving the message and for SMS will be the number receiving the SMS message. For other services, this may be `nil`. 
+
+`timestamp`: Ruby `DateTime` object containing the timestamp of when the message was transmitted. This might differ from the current time.
+
+`service`: String indicating the message service from where the message originated (i.e., `facebook`, or `twilio`). 
+
+`message`: String of the message contents.
+
+`payload`: This will vary per message service component.
+
+`nlp_result`: The raw result of the NLP performed on this message. This will vary per NLP component.
+
+`catch_all_reason`: This is a hash that contains two keys: `:err` and `:err_msg`. The `:err` key is a string of the exception class that was raised and the `:err_msg` is the message associated with that exception. See [Catch-All Reasons](catch-alls.md#catch-all-reasons) for more info.
+
+`location`: This will vary per message service component. 
+
+`attachments`: This will vary per message service component. 
+
+`referral`: This will vary per message service component.
+
+## `current_session`
+
+The user's session is accessible via `current_session`. This is a `Stealth::Session` object. It has a few important methods:
+
+`flow_string`: Returns the name of the flow. 
+
+`state_string`: Returns the name of the state.
+
+`to_s`: Returns the session canonical session slug string. 
+
+`current_session + 2.states`: Returns a new session object 2 states after the current state. If we've exceeded the last state in flow (as defined in the [FlowMap](../flows/flowmap.md)), the last state is returned.
+
+`current_session - 2.states`: Returns a new session object 2 states before the current state. If we've exceeded the first state in the flow (as defined in the [FlowMap](../flows/flowmap.md)), the first state is returned.
+
+`==`: Compare two sessions and returns `true` if they point to the same flow and state and `false` if they do not.
+
+{% hint style="warning" %}
+Use the session arithmetic operators (`+` and `-`) sparingly. They are primarily designed for use in [Catch](catch-alls.md)[Alls](catch-alls.md) when a `fails_to` state has not been specified.
+{% endhint %}
+
+## `current_service`
+
+Returns a string indicating the message platform from where the message originated (i.e., `facebook`, or `twilio`). 
+
+{% hint style="info" %}
+This is an alias of `current_message.service`
+{% endhint %}
+
+## `current_session_id`
+
+Returns the session ID. This will vary by message service, but for Facebook Messenger this will be the user's PSID and for SMS and Whatsapp this will be the user's phone number in [E.164](https://en.m.wikipedia.org/wiki/E.164) format.
+
+{% hint style="info" %}
+This is an alias of `current_message.sender_id`
+{% endhint %}
+
+## `has_location?`
+
+Returns `true` or `false` depending on whether or not the `current_message` contains location data.
+
+## `has_attachments?`
+
+Returns `true` or `false` depending on whether or not the `current_message` contains file or media attachments.