build(bridge/python): 1.2.0

This reverts commit 0b16eebfbd.

.babelrc

@@ -1,23 +0,0 @@
-{
-  "presets": [
-    ["env", {
-      "targets": {
-        "node": "current"
-      }
-    }]
-  ],
-  "plugins": [
-    ["module-resolver", {
-      "alias": {
-        "@@": ".",
-        "@": "./server/src"
-      },
-      "compilerOptions": {
-        "paths": {
-          "@@": ".",
-          "@": "./server/src"
-        }
-      }
-    }]
-  ]
-}

.circleci/config.yml

@@ -1,151 +0,0 @@
-version: 2
-
-defaults: &defaults
-  working_directory: ~/project/leon-ai/leon
-  docker:
-    - image: leonai/ci:latest
-  environment:
-    LC_ALL: C.UTF-8 # Fix https://click.palletsprojects.com/en/7.x/python3/#python-3-surrogate-handling
-    LANG: C.UTF-8 # Fix https://click.palletsprojects.com/en/7.x/python3/#python-3-surrogate-handling
-    PIPENV_PIPFILE: bridges/python/Pipfile
-
-jobs:
-  check-stack:
-    <<: *defaults
-    steps:
-      - checkout
-      - run:
-          name: Checking Node.js
-          command: node --version
-      - run:
-          name: Checking npm
-          command: npm --version
-      - run:
-          name: Checking Python
-          command: python3 --version
-      - run:
-          name: Checking Pipenv
-          command: pipenv --version
-      - persist_to_workspace:
-          root: ~/project/leon-ai
-          paths:
-            - leon
-
-  install-npm-dep:
-    <<: *defaults
-    steps:
-      - attach_workspace:
-          at: ~/project/leon-ai
-      - restore_cache:
-          keys:
-            - v1-leon-ai-leon-{{ .Branch }}-{{ checksum "package-lock.json" }}
-            - v1-leon-ai-leon-{{ .Branch }}-
-            - v1-leon-ai-leon-
-      - run:
-          name: Installing npm dependencies
-          command: npm install
-      - save_cache:
-          key: v1-leon-ai-leon-{{ .Branch }}-{{ checksum "package-lock.json" }}
-          paths:
-            - node_modules
-      - persist_to_workspace:
-          root: ~/project/leon-ai
-          paths:
-            - leon
-
-  init:
-    <<: *defaults
-    steps:
-      - attach_workspace:
-          at: ~/project/leon-ai
-      - restore_cache:
-          keys:
-            - v1-leon-ai-leon-{{ .Branch }}-{{ checksum "bridges/python/Pipfile.lock" }}
-            - v1-leon-ai-leon-{{ .Branch }}-
-            - v1-leon-ai-leon-
-      - run:
-          name: Setting up
-          command: npm run postinstall
-      - save_cache:
-          key: v1-leon-ai-leon-{{ .Branch }}-{{ checksum "bridges/python/Pipfile.lock" }}
-          paths:
-            - bridges/python/.venv
-      - persist_to_workspace:
-          root: ~/project/leon-ai
-          paths:
-            - leon
-
-  lint:
-    <<: *defaults
-    steps:
-      - attach_workspace:
-          at: ~/project/leon-ai
-      - run:
-          name: Linting
-          command: npm run lint
-
-  test-json:
-    <<: *defaults
-    steps:
-      - attach_workspace:
-          at: ~/project/leon-ai
-      - run:
-          name: JSON testing
-          command: npm run test:json
-
-  test-e2e:
-    <<: *defaults
-    steps:
-      - attach_workspace:
-          at: ~/project/leon-ai
-      - run:
-          name: End-to-end testing
-          command: npm run test:e2e
-
-  test-unit:
-    <<: *defaults
-    steps:
-      - attach_workspace:
-          at: ~/project/leon-ai
-      - run:
-          name: Installing offline STT
-          command: npm run setup:offline-stt
-      - run:
-          name: Installing offline TTS
-          command: npm run setup:offline-tts
-      - run:
-          name: Unit testing
-          command: npm run test:unit
-
-workflows:
-  version: 2
-  install-test:
-    jobs:
-      - check-stack
-      - install-npm-dep:
-          requires:
-            - check-stack
-      - init:
-          requires:
-            - check-stack
-            - install-npm-dep
-      - lint:
-          requires:
-            - check-stack
-            - install-npm-dep
-            - init
-      - test-json:
-          requires:
-            - check-stack
-            - install-npm-dep
-            - init
-      - test-e2e:
-          requires:
-            - check-stack
-            - install-npm-dep
-            - init
-      - test-unit:
-          requires:
-            - check-stack
-            - install-npm-dep
-            - init

.dockerignore

@@ -0,0 +1,9 @@
+__pycache__/
+**/dist/*
+**/build/
+**/node_modules/
+**/tmp/*
+**/src/.venv/*
+logs/*
+*.pyc
+.DS_Store

.editorconfig

@@ -1,4 +1,4 @@
-# EditorConfig is awesome: http://EditorConfig.org
+# EditorConfig is awesome: https://EditorConfig.org
 
 # top-most EditorConfig file
 root = true
@@ -10,3 +10,6 @@ indent_size = 2
 charset = utf-8
 end_of_line = lf
 insert_final_newline = true
+
+[*.py]
+indent_size = 4

.env.sample

@@ -1,16 +1,12 @@
+# Main settings of Leon
+# https://docs.getleon.ai/configuration
+
 # Language currently used
 LEON_LANG=en-US
 
-# Current env
-LEON_NODE_ENV=development
-
 # Server
-LEON_SERVER_HOST=localhost
-LEON_SERVER_PORT=1337
-
-# Web app
-LEON_WEBAPP_HOST=localhost
-LEON_WEBAPP_PORT=4242
+LEON_HOST=http://localhost
+LEON_PORT=1337
 
 # Time zone (current one by default)
 LEON_TIME_ZONE=
@@ -21,22 +17,29 @@ LEON_AFTER_SPEECH=false
 # Enable/disable Leon's speech-to-text
 LEON_STT=false
 # Speech-to-text provider
-LEON_STT_PROVIDER=deepspeech
+LEON_STT_PROVIDER=coqui-stt
 
 # Enable/disable Leon's text-to-speech
 LEON_TTS=false
 # Text-to-speech provider
 LEON_TTS_PROVIDER=flite
 
-# Enable/disable collaborative logger
-LEON_LOGGER=true
+# Enable/disable skills to be available over HTTP
+LEON_OVER_HTTP=true
+# HTTP API key (use "npm run generate:http-api-key" to regenerate one)
+LEON_HTTP_API_KEY=
+# Language used for the HTTP API
+LEON_HTTP_API_LANG=en-US
+
+# Enable/disable telemetry
+LEON_TELEMETRY=true
+
+# Python TCP server
+LEON_PY_TCP_SERVER_HOST=0.0.0.0
+LEON_PY_TCP_SERVER_PORT=1342
 
 # Path to the Pipfile
-PIPENV_PIPFILE=bridges/python/Pipfile
+PIPENV_PIPFILE=bridges/python/src/Pipfile
 
 # Path to the virtual env in .venv/
 PIPENV_VENV_IN_PROJECT=true
-
-# Fix https://click.palletsprojects.com/en/7.x/python3/#python-3-surrogate-handling
-LC_ALL=C.UTF-8
-LANG=C.UTF-8

.eslintrc.json

@@ -1,39 +1,83 @@
 {
-  "extends": "airbnb-base",
-  "env": {
-    "node": true,
-    "es6": true,
-    "browser": true,
-    "jest/globals": true
-  },
-  "globals": {
-    "io": true,
-    "webkitSpeechRecognition": true
-  },
-  "plugins": [
-    "import",
-    "jest"
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:import/recommended",
+    "plugin:import/typescript",
+    "prettier"
   ],
   "settings": {
     "import/resolver": {
-      "babel-module": { }
+      "typescript": true,
+      "node": true
     }
   },
+  "parser": "@typescript-eslint/parser",
+  "env": {
+    "node": true,
+    "browser": true
+  },
+  "parserOptions": {
+    "ecmaVersion": 2021
+  },
+  "globals": {
+    "io": true
+  },
+  "plugins": ["@typescript-eslint", "unicorn", "import"],
+  "ignorePatterns": "*.spec.js",
   "rules": {
-    "no-multi-assign": "off",
-    "no-trailing-spaces": "off",
-    "linebreak-style": "off",
-    "indent": "off",
-    "strict": "off",
-    "no-console": "off",
-    "no-param-reassign": "off",
-    "no-shadow": "off",
-    "import/no-extraneous-dependencies": "off",
-    "import/no-dynamic-require": "off",
+    "@typescript-eslint/no-non-null-assertion": ["off"],
+    "no-async-promise-executor": ["off"],
     "no-underscore-dangle": ["error", { "allowAfterThis": true }],
-    "space-before-function-paren": ["error", "always"],
-    "prefer-destructuring": ["error", { "array": true, "object": true }],
+    "prefer-destructuring": ["error"],
     "comma-dangle": ["error", "never"],
-    "semi": ["error", "never"]
-  }
+    "semi": ["error", "never"],
+    "object-curly-spacing": ["error", "always"],
+    "unicorn/prefer-node-protocol": "error",
+    "@typescript-eslint/member-delimiter-style": [
+      "error",
+      {
+        "multiline": {
+          "delimiter": "none",
+          "requireLast": true
+        },
+        "singleline": {
+          "delimiter": "comma",
+          "requireLast": false
+        }
+      }
+    ],
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/consistent-type-definitions": "error",
+    "import/no-named-as-default": "off",
+    "import/no-named-as-default-member": "off",
+    "import/order": [
+      "error",
+      {
+        "groups": [
+          "builtin",
+          "external",
+          "internal",
+          "parent",
+          "sibling",
+          "index"
+        ],
+        "newlines-between": "always"
+      }
+    ]
+  },
+  "overrides": [
+    {
+      "files": ["skills/**/*.ts"],
+      "rules": {
+        "import/order": "off"
+      }
+    },
+    {
+      "files": ["*.ts"],
+      "rules": {
+        "@typescript-eslint/explicit-function-return-type": "error"
+      }
+    }
+  ]
 }

.github/CODE_OF_CONDUCT.md

@@ -14,21 +14,21 @@ appearance, race, religion, or sexual identity and orientation.
 Examples of behavior that contributes to creating a positive environment
 include:
 
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
 
 Examples of unacceptable behavior by participants include:
 
-* The use of sexualized language or imagery and unwelcome sexual attention or
+- The use of sexualized language or imagery and unwelcome sexual attention or
   advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic
+- Trolling, insulting/derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or electronic
   address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
+- Other conduct which could reasonably be considered inappropriate in a
   professional setting
 
 ## Our Responsibilities
@@ -55,7 +55,7 @@ further defined and clarified by project maintainers.
 ## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at <louis.grenard@gmail.com>. All
+reported by contacting the project team at <louis@getleon.ai>. All
 complaints will be reviewed and investigated and will result in a response that
 is deemed necessary and appropriate to the circumstances. The project team is
 obligated to maintain confidentiality with regard to the reporter of an incident.

.github/CONTRIBUTING.md

@@ -2,7 +2,7 @@
 
 Thanks a lot for your interest in contributing to Leon! :heart:
 
-**Leon needs open-source to live**, the more modules he has, the more skillful he becomes.
+**Leon needs open source to live**, the more skills he has, the more skillful he becomes.
 
 **Before submitting your contribution**, please take a moment to review this document.
 
@@ -12,59 +12,90 @@ Please note we have a [code of conduct](https://github.com/leon-ai/leon/blob/dev
 
 Here are few examples about how you could help on Leon, by:
 
-- [Creating a new module](https://docs.getleon.ai/packages-modules.html).
-- [Working on new features](https://roadmap.getleon.ai) (what is in backlog or todo).
+- [Creating a new module](https://docs.getleon.ai/packages-modules).
+- [Working on new features](http://roadmap.getleon.ai) (what is in backlog or todo).
 - [Suggesting new ideas](https://github.com/leon-ai/leon/issues/new/choose).
 - [Reporting a bug](https://github.com/leon-ai/leon/issues/new?labels=bug&template=BUG.md).
 - [Improving the documentation](https://github.com/leon-ai/docs.getleon.ai) (translations, typos, better writing, etc.).
-- [Buying me a fruit juice](https://donate.getleon.ai).
-
+- [Sponsoring Leon](http://sponsor.getleon.ai).
 
 ## Pull Requests
 
-**Working on your first Pull Request?** You can learn how from this *free* series [How to Contribute to an Open Source Project on GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github).
+**Working on your first Pull Request?** You can learn how from this _free_ series [How to Contribute to an Open Source Project on GitHub](https://egghead.io/courses/how-to-contribute-to-an-open-source-project-on-github).
 
 - **Please first discuss** the change you wish to make via [issue](https://github.com/leon-ai/leon/issues),
-email, or any other method with the owners of this repository before making a change.
-It might avoid a waste of your time.
+  email, or any other method with the owners of this repository before making a change.
+  It might avoid a waste of your time.
+
 - The `master` branch is actually used as a snapshot of the latest stable release. **Do not submit your PRs
-against the `master` branch**.
+  against the `master` branch**.
+
 - Ensure your code **respect our coding standards** (cf. [.eslintrc.json](https://github.com/leon-ai/leon/blob/develop/.eslintrc.json)).
-To do so, you can run:
+  To do so, you can run:
 
   ```sh
   npm run lint
   ```
+
 - Make sure your **code passes the tests**. You can run the tests via the following command:
-  
+
   ```sh
   npm test
   ```
-  
+
   If you're adding new features to Leon, please include tests.
-  
+
 ## Development Setup
 
-- Follow the [basic setup](https://github.com/leon-ai/leon/blob/develop/README.md#getting-started).
-- Then:
+Choose the setup method you want to go for.
 
-  ```sh
-  # run development server
-  npm run dev:server
-  
-  # run development web app
-  npm run dev:app
-  
-  # run the wake word node (optional)
-  npm run wake
-  ```
+### Single-Click
+
+Gitpod will automatically set up an environment and run an instance for you.
+
+[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/leon-ai/leon)
+
+### Basic
+
+```sh
+# Clone the repository
+git clone https://github.com/leon-ai/leon.git leon
+
+# Go to the project root
+cd leon
+
+# Install
+npm install
+
+# Check the setup went well
+npm run check
+
+# Run the development server
+npm run dev:server
+
+# Run the development web app
+npm run dev:app
+```
+
+### Docker
+
+```sh
+# Clone the repository
+git clone https://github.com/leon-ai/leon.git leon
+
+# Go to the project root
+cd leon
+
+# Build
+npm run docker:build
+
+# Run the development server and the development web app
+npm run docker:dev
+```
 
 ## Versioning
 
 - We use [Semantic Versioning](https://semver.org) for releases.
-- A new Leon module creation increases the MINOR version number of its relevant Leon package.
-- Each time a MAJOR or MINOR version number of a Leon package is increased, then the MINOR version number of the project should also be increased.
-- Each time a PATCH version number of a Leon package is increased, then the PATCH version number of the projet should also be increased.
 
 ## Commits
 
@@ -74,41 +105,124 @@ The commit message guideline is adapted from the [AngularJS Git Commit Guideline
 
 Types define which kind of changes you made to the project.
 
-| Types         | Description |
-| ------------- |-------------|
-| BREAKING      | Changes including breaking changes. |
-| build         | New build version. |
-| chore         | Changes to the build process or auxiliary tools such as changelog generation. No production code change. |
-| docs          | Documentation only changes. |
-| feat          | A new feature. |
-| fix           | A big fix. |
-| perf          | A code change that improves performance. |
-| refactor      | A code change that neither fixes a bug nor adds a feature. |
-| style         | Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc.). |
-| test          | Adding missing or correcting existing tests. |
+| Types    | Description                                                                                              |
+| -------- | -------------------------------------------------------------------------------------------------------- |
+| BREAKING | Changes including breaking changes.                                                                      |
+| build    | New build version.                                                                                       |
+| chore    | Changes to the build process or auxiliary tools such as changelog generation. No production code change. |
+| ci       | Changes related to continuous integration only (GitHub Actions, CircleCI, etc.).                         |
+| docs     | Documentation only changes.                                                                              |
+| feat     | A new feature.                                                                                           |
+| fix      | A bug fix.                                                                                               |
+| perf     | A code change that improves performance.                                                                 |
+| refactor | A code change that neither fixes a bug nor adds a feature.                                               |
+| style    | Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc.). |
+| test     | Adding missing or correcting existing tests.                                                             |
 
 ### Scopes
 
 Scopes define high-level nodes of Leon.
 
-- web app
-- server
+- bridge/python
+- bridge/nodejs
+- docker
 - hotword
-- package/package_name
+- scripts
+- server
+- tcp server
+- web app
+- skill/skill_name
 
 ### Examples
 
 ```sh
 git commit -m "feat(server): awesome new server feature"
-git commit -m "docs(package/leon): fix spelling"
+git commit -m "docs(skill/leon): fix spelling"
 git commit -m "chore: split training script into awesome blocks"
 git commit -m "style(web app): remove chatbot useless parentheses"
 ```
 
-## Donate
+## Sponsor
 
-You can also contribute by [buying me a fruit juice](https://donate.getleon.ai).
+You can also contribute by [sponsoring Leon](http://sponsor.getleon.ai).
+
+Please note that I dedicate most of my free time to Leon.
+
+By sponsoring the project you make the project sustainable and faster to develop features.
+
+The focus is not only limited to the activity you see on GitHub but also a lot of thinking about the direction of the project. Which is naturally related to the overall design, architecture, vision, learning process and so on...
+
+## Contributing to the Python Bridge or TCP HttpServer
+
+Leon makes use of two binaries, the Python bridge and the TCP server. These binaries are compiled from Python sources.
+
+The Python bridge is used to communicate between the core and skills made with Python.
+
+The TCP server is used to communicate between the core and third-party nodes, such as spaCy.
+
+### Set Up the Python Environment
+
+To contribute to these parts, you need to set up a Python environment running with a specific Python version and a specific Pipenv version.
+
+It is recommended to use Pyenv to manage your Python versions.
+
+If you are on GNU/Linux Ubuntu, you can run the following to install Pyenv, otherwise, please refer to the [Pyenv documentation to install it](https://github.com/pyenv/pyenv#installation):
+
+```bash
+# Update registry
+sudo apt-get update
+
+# Install Pyenv deps
+sudo apt-get install make build-essential libssl-dev zlib1g-dev \
+libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
+libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev
+
+# Install Pyenv
+curl https://pyenv.run | bash
+
+# Add output lines to .bashrc
+
+# Restart shell
+exec "$SHELL"
+```
+
+Once Pyenv installed, run:
+
+```bash
+# Install Python
+pyenv install 3.9.10 --force
+pyenv global 3.9.10
+
+# Install Pipenv
+pip install pipenv==2022.7.24
+```
+
+Your Python environment should be ready now. So now you can set up the respective environments according to what you are going to contribute to and build them:
+
+```bash
+# Set up the Python bridge environment
+npm run setup:python-bridge
+
+# Set up the TCP server environment
+npm run setup:tcp-server
+# If you are in China, you can run this to download models faster:
+npm run setup:tcp-server cn
+
+# Once your code changes are done, you can build via:
+
+# Build the Python bridge
+npm run build:python-bridge
+
+# Build the TCP server
+npm run build:tcp-server
+
+# Run the Python bridge
+./bridges/python/dist/{OS-CPU_ARCH}/leon-python-bridge server/src/intent-object.sample.json
+
+# Run the TCP server
+./tcp_server/dist/{OS-CPU_ARCH}/leon-tcp-server en
+```
 
 ## Spread the Word
 
-Use [#LeonAI](https://twitter.com/hashtag/LeonAI) if you tweet about Leon and/or mention [@louistiti_fr](https://twitter.com/louistiti_fr).
+Use [#LeonAI](<https://twitter.com/search?f=live&q=%23LeonAI%20(from%3Agrenlouis%20OR%20from%3Alouistiti_fr)&src=typed_query>) if you tweet about Leon and/or mention [@grenlouis](https://twitter.com/grenlouis).

.github/FUNDING.yml

@@ -0,0 +1,8 @@
+# These are supported funding model platforms
+
+github: [louistiti]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+custom: # http://sponsor.getleon.ai

.github/ISSUE_TEMPLATE.md

@@ -1,7 +0,0 @@
-<!--
-
-Thanks for your interest in Leon! ❤️
-
-Please check if there is no similar issue before creating this one.
-
--->

.github/ISSUE_TEMPLATE/BUG.md

@@ -7,6 +7,7 @@ labels: bug
 <!--
 Thanks for your interest in Leon! ❤️
 Please check if there is no similar issue before creating this one.
+If the bug is related to the setup, please submit the issue at: https://github.com/leon-ai/leon-cli/issues/new/choose
 -->
 
 ### Specs
@@ -14,8 +15,9 @@ Please check if there is no similar issue before creating this one.
 - Leon version:
 - OS (or browser) version:
 - Node.js version:
-- Complete "npm run check" output:
-- (optional) Leon package version:
+- Complete "leon check" (or "npm run check") output:
+- (if using Docker) Complete "npm run docker:check" output:
+- (optional) Leon skill version:
 
 ### Expected Behavior
 

.github/ISSUE_TEMPLATE/DOCS.md

@@ -12,6 +12,7 @@ Please place an x (no spaces - [x]) in all [ ] that apply.
 -->
 
 ### Documentation Is:
+
 - [ ] Missing
 - [ ] Needed
 - [ ] Confusing

.github/PULL_REQUEST_TEMPLATE.md

@@ -14,6 +14,7 @@ Please place an x (no spaces - [x]) in all [ ] that apply.
 -->
 
 ### What type of change does this PR introduce?
+
 - [ ] Bugfix
 - [ ] Feature
 - [ ] Refactor
@@ -21,10 +22,10 @@ Please place an x (no spaces - [x]) in all [ ] that apply.
 - [ ] Not Sure?
 
 ### Does this PR introduce breaking changes?
+
 - [ ] Yes
 - [ ] No
 
 ### List any relevant issue numbers:
 
 ### Description:
-

.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  - package-ecosystem: 'npm'
+    directory: '/'
+    schedule:
+      interval: 'weekly'
+      day: 'friday'
+      time: '22:00'
+    commit-message:
+      prefix: 'chore'
+      include: 'scope'
+    reviewers:
+      - 'louistiti'

.github/workflows/build.yml

@@ -0,0 +1,39 @@
+name: Build
+
+on:
+  push:
+    # branches: [master, develop]
+    branches: [master]
+  pull_request:
+    # branches: [master, develop]
+    branches: [master]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Use Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: 3.x
+
+      - name: Use Node.js
+        uses: actions/setup-node@v2
+        with:
+          node-version: 16.x
+          cache: npm
+
+      - name: Install Pipenv
+        run: pip install --upgrade pip && pip install pipenv
+
+      - name: Install
+        run: npm install
+
+      - name: Check setup
+        run: npm run check
+
+      - name: Build
+        run: npm run build

.github/workflows/lint.yml

@@ -0,0 +1,36 @@
+name: Lint
+
+on:
+  push:
+    # branches: [master, develop]
+    branches: [master]
+  pull_request:
+    # branches: [master, develop]
+    branches: [master]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Use Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: 3.x
+
+      - name: Use Node.js
+        uses: actions/setup-node@v2
+        with:
+          node-version: 16.x
+          cache: npm
+
+      - name: Install Pipenv
+        run: pip install --upgrade pip && pip install pipenv
+
+      - name: Install
+        run: npm install
+
+      - name: Run linter
+        run: npm run lint

.github/workflows/pre-release-nodejs-bridge.yml

@@ -0,0 +1,76 @@
+name: Pre-release Node.js bridge
+
+on: workflow_dispatch
+
+jobs:
+  build:
+    name: Build
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-20.04]
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Clone repository
+        uses: actions/checkout@v3
+
+      - name: Install Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: lts/*
+
+      - name: Set Node.js bridge version
+        working-directory: bridges/nodejs/src
+        run: |
+          echo "NODEJS_BRIDGE_VERSION=$(node --require fs --eval "const fs = require('node:fs'); const [, VERSION] = fs.readFileSync('version.ts', 'utf8').split(\"'\"); console.log(VERSION)")" >> $GITHUB_ENV
+
+      - name: Display Node.js bridge version
+        run: |
+          echo "Node.js bridge version: ${{ env.NODEJS_BRIDGE_VERSION }}"
+
+      - name: Install core
+        run: npm install
+
+      - name: Build Node.js bridge
+        run: npm run build:nodejs-bridge
+
+      - name: Upload Node.js bridge
+        uses: actions/upload-artifact@v3
+        with:
+          path: bridges/nodejs/dist/*.zip
+
+  draft-release:
+    name: Draft-release
+    needs: [build]
+    runs-on: ubuntu-20.04
+
+    steps:
+      - name: Clone repository
+        uses: actions/checkout@v3
+
+      - name: Install Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: lts/*
+
+      - name: Set Node.js bridge version
+        working-directory: bridges/nodejs/src
+        run: |
+          echo "NODEJS_BRIDGE_VERSION=$(node --require fs --eval "const fs = require('node:fs'); const [, VERSION] = fs.readFileSync('version.ts', 'utf8').split(\"'\"); console.log(VERSION)")" >> $GITHUB_ENV
+
+      - name: Download Node.js bridge
+        uses: actions/download-artifact@v3
+        with:
+          path: bridges/nodejs/dist
+
+      - uses: marvinpinto/action-automatic-releases@latest
+        with:
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          automatic_release_tag: nodejs-bridge_v${{ env.NODEJS_BRIDGE_VERSION }}
+          draft: true
+          prerelease: false
+          title: Node.js Bridge ${{ env.NODEJS_BRIDGE_VERSION }}
+          files: bridges/nodejs/dist/artifact/*.zip

.github/workflows/pre-release-python-bridge.yml

@@ -0,0 +1,91 @@
+name: Pre-release Python bridge
+
+on: workflow_dispatch
+
+env:
+  PIPENV_PIPFILE: bridges/python/src
+  PIPENV_VENV_IN_PROJECT: true
+
+jobs:
+  build:
+    name: Build
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-20.04, macos-latest, windows-latest]
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Clone repository
+        uses: actions/checkout@v3
+
+      - name: Install Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.9.10
+
+      - name: Install Pipenv
+        run: pip install --upgrade pip && pip install pipenv==2022.7.24
+
+      - name: Install Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: lts/*
+
+      - name: Set Python bridge version
+        working-directory: bridges/python/src
+        run: |
+          echo "PYTHON_BRIDGE_VERSION=$(python -c "from version import __version__; print(__version__)")" >> $GITHUB_ENV
+
+      - name: Display Python bridge version
+        run: |
+          echo "Python bridge version: ${{ env.PYTHON_BRIDGE_VERSION }}"
+
+      - name: Install core
+        run: npm install
+
+      - name: Set up Python bridge
+        run: npm run setup:python-bridge
+
+      - name: Build Python bridge
+        run: npm run build:python-bridge
+
+      - name: Upload Python bridge
+        uses: actions/upload-artifact@v3
+        with:
+          path: bridges/python/dist/*.zip
+
+  draft-release:
+    name: Draft-release
+    needs: [build]
+    runs-on: ubuntu-20.04
+
+    steps:
+      - name: Clone repository
+        uses: actions/checkout@v3
+
+      - name: Install Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.9.10
+
+      - name: Set Python bridge version
+        working-directory: bridges/python/src
+        run: |
+          echo "PYTHON_BRIDGE_VERSION=$(python -c "from version import __version__; print(__version__)")" >> $GITHUB_ENV
+
+      - name: Download Python bridge
+        uses: actions/download-artifact@v3
+        with:
+          path: bridges/python/dist
+
+      - uses: marvinpinto/action-automatic-releases@latest
+        with:
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          automatic_release_tag: python-bridge_v${{ env.PYTHON_BRIDGE_VERSION }}
+          draft: true
+          prerelease: false
+          title: Python Bridge ${{ env.PYTHON_BRIDGE_VERSION }}
+          files: bridges/python/dist/artifact/*.zip

.github/workflows/pre-release-tcp-server.yml

@@ -0,0 +1,91 @@
+name: Pre-release TCP server
+
+on: workflow_dispatch
+
+env:
+  PIPENV_PIPFILE: tcp_server/src
+  PIPENV_VENV_IN_PROJECT: true
+
+jobs:
+  build:
+    name: Build
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-20.04, macos-latest, windows-latest]
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Clone repository
+        uses: actions/checkout@v3
+
+      - name: Install Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.9.10
+
+      - name: Install Pipenv
+        run: pip install --upgrade pip && pip install pipenv==2022.7.24
+
+      - name: Install Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: lts/*
+
+      - name: Set TCP server version
+        working-directory: tcp_server/src
+        run: |
+          echo "TCP_SERVER_VERSION=$(python -c "from version import __version__; print(__version__)")" >> $GITHUB_ENV
+
+      - name: Display TCP server version
+        run: |
+          echo "TCP server version: ${{ env.TCP_SERVER_VERSION }}"
+
+      - name: Install core
+        run: npm install
+
+      - name: Set up TCP server
+        run: npm run setup:tcp-server
+
+      - name: Build TCP server
+        run: npm run build:tcp-server
+
+      - name: Upload TCP server
+        uses: actions/upload-artifact@v3
+        with:
+          path: tcp_server/dist/*.zip
+
+  draft-release:
+    name: Draft-release
+    needs: [build]
+    runs-on: ubuntu-20.04
+
+    steps:
+      - name: Clone repository
+        uses: actions/checkout@v3
+
+      - name: Install Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.9.10
+
+      - name: Set TCP server version
+        working-directory: tcp_server/src
+        run: |
+          echo "TCP_SERVER_VERSION=$(python -c "from version import __version__; print(__version__)")" >> $GITHUB_ENV
+
+      - name: Download TCP server
+        uses: actions/download-artifact@v3
+        with:
+          path: tcp_server/dist
+
+      - uses: marvinpinto/action-automatic-releases@latest
+        with:
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          automatic_release_tag: tcp-server_v${{ env.TCP_SERVER_VERSION }}
+          draft: true
+          prerelease: false
+          title: TCP Server ${{ env.TCP_SERVER_VERSION }}
+          files: tcp_server/dist/artifact/*.zip

.github/workflows/tests.yml

@@ -0,0 +1,51 @@
+name: Tests
+
+on:
+  push:
+    # branches: [master, develop]
+    branches: [master]
+  pull_request:
+    # branches: [master, develop]
+    branches: [master]
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Use Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: 3.x
+
+      - name: Use Node.js
+        uses: actions/setup-node@v2
+        with:
+          node-version: 16.x
+          cache: npm
+
+      - name: Install Pipenv
+        run: pip install --upgrade pip && pip install pipenv
+
+      - name: Install
+        run: npm install
+
+      - name: Run JSON tests
+        run: npm run test:json
+
+      - name: Run over HTTP tests
+        run: npm run test:over-http
+
+      - name: Run E2E tests
+        run: npm run test:e2e
+
+      - name: Install offline STT
+        run: npm run setup:offline-stt
+
+      - name: Install offline TTS
+        run: npm run setup:offline-tts
+
+      - name: Run unit tests
+        run: npm run test:unit

.gitignore

@@ -1,26 +1,36 @@
 __pycache__/
 .idea/
-**/dist/
+.fleet/
+.vscode/
+**/dist/*
+**/build/
 **/node_modules/
 test/coverage/
 **/tmp/*
-bridges/python/.venv/*
-downloads/*
+**/src/.venv/*
 logs/*
-server/src/config/**/*.json
-bin/deepspeech/*
+core/config/**/*.json
+bin/coqui/*
 bin/flite/*
 
+package-lock.json
 *.pyc
 .DS_Store
+*.sublime-workspace
 npm-debug.log
 debug.log
 .env
-!**/.gitkeep
-!bridges/python/.venv/.gitkeep
+.last-skill-npm-install
+leon.json
+bridges/python/src/Pipfile.lock
+tcp_server/src/Pipfile.lock
+!tcp_server/**/.gitkeep
+!bridges/python/**/.gitkeep
+!bridges/nodejs/**/.gitkeep
 !**/*.sample*
-packages/**/config/config.json
-packages/**/data/db/*.json
-server/src/data/expressions/classifier.json
-app/js/main.js
+skills/**/src/settings.json
+skills/**/memory/*.json
+core/data/models/*.nlp
 package.json.backup
+.python-version
+schemas/**/*.json

.gitpod.yml

@@ -0,0 +1,19 @@
+image: gitpod/workspace-full
+
+tasks:
+  - before: npm install -g @leon-ai/cli
+    init: leon create birth
+    command: leon start
+
+ports:
+  - port: 1337
+    onOpen: notify
+
+github:
+  prebuilds:
+    master: true
+    branches: true
+    pullRequests: true
+    addComment: true
+    addBadge: true
+    addLabel: true

.husky/commit-msg

@@ -0,0 +1,11 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+if ! [ -x "$(command -v npm)" ]; then
+  echo "npm: command not found"
+  echo "If you use a version manager tool such as nvm and a git GUI such as GitKraken, please read: https://typicode.github.io/husky/#/?id=command-not-found" >&2
+  exit 1
+else
+  npx ts-node scripts/commit-msg.js
+fi
+

.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+npx lint-staged

.lintstagedrc

@@ -0,0 +1,3 @@
+{
+  "*": ["npm run lint"]
+}

.npmrc

@@ -0,0 +1,3 @@
+engine-strict=true
+package-lock=false
+save-exact=true

.nvmrc

@@ -0,0 +1 @@
+lts/*

.prettierrc.json

@@ -0,0 +1,5 @@
+{
+  "semi": false,
+  "trailingComma": "none",
+  "singleQuote": true
+}

CHANGELOG.md

@@ -1,3 +1,362 @@
-# [1.0.0-beta.0](https://github.com/leon-ai/leon/compare/https://github.com/leon-ai/leon.git...v1.0.0-beta.0) (2019-02-10)
+# [1.0.0-beta.8](https://github.com/leon-ai/leon/compare/v1.0.0-beta.7...v1.0.0-beta.8) (2023-05-01) / Binaries and TypeScript Rewrite
+
+_Please refer to [our latest blog post](https://blog.getleon.ai/binaries-and-typescript-rewrite-1-0-0-beta-8/) for more information on the new release of our dear Leon._
+
+# [1.0.0-beta.7](https://github.com/leon-ai/leon/compare/v1.0.0-beta.6...v1.0.0-beta.7) (2022-08-24) / A Much Better NLP
+
+_Please [read this blog post](https://blog.getleon.ai/a-much-better-nlp-and-future-1-0-0-beta-7/) to know more about all the new features and the exciting future of Leon._
+
+### BREAKING CHANGES
+
+- remove legacy packages [07743657](https://github.com/leon-ai/leon/commit/07743657cd2954e7f850c08eea7c032c24b28a96)
+
+### Features
+
+- create new NLP skills resolvers model + NLP global resolvers model [602604e4](https://github.com/leon-ai/leon/commit/602604e43788c6b6be8c402d54fe54342d0cd5d6)
+- better isolate skill resolvers from global resolvers + finish up Akinator skill [905d248e](https://github.com/leon-ai/leon/commit/905d248ebf7e84b1ccc74450520228aef9a8804a)
+- transfer language from core to skills + support thematics on Akinator skill [b35a249b](https://github.com/leon-ai/leon/commit/b35a249bf68000d6708aaee4abc4cd97f5b80035)
+- actions on slot level + akinator skill progress [7101b8b4](https://github.com/leon-ai/leon/commit/7101b8b4b828b49e009da2fcdac7c5ed2e48c8f8)
+- add Cartesian sample training on resolvers + enum entities [6ed88a59](https://github.com/leon-ai/leon/commit/6ed88a5946c77b356e49fe8b9cbe890b8dd1f037)
+- map skills resolvers intents [eb5ade76](https://github.com/leon-ai/leon/commit/eb5ade76844dd14f5d5a5c5eeb434eed70fe62f4)
+- train skills resolvers and remap as per changes [82df0a3c](https://github.com/leon-ai/leon/commit/82df0a3c235fbd50ad0cfe12e23a51f777dcd658)
+- achieve Cartesian training [a1e9011d](https://github.com/leon-ai/leon/commit/a1e9011d5db48ed8e9f49cef2d813ee7e2400ec2)
+- introduce suggestions [dcddacca](https://github.com/leon-ai/leon/commit/dcddacca2956529de0aea8ff98e1e6f16104966a)
+- communicate suggestions to the client [4b5a8835](https://github.com/leon-ai/leon/commit/4b5a883510fd4421a491f999cc21d8f7dd369a03)
+- shared skills memory [795acc5b](https://github.com/leon-ai/leon/commit/795acc5bdd29e9a27d1cf3b4407453648d573973)
+- support dynamic variables on skill NLU settings for logic type [10d10a16](https://github.com/leon-ai/leon/commit/10d10a1690cb65970932ee7230e3f324ec67dbce)
+- tmp resolvers mapping [b1a332ba](https://github.com/leon-ai/leon/commit/b1a332bab6af8b74a8c58c07bac3ef3a1cebad89)
+- start to map resolvers between the core and skills [e88495a9](https://github.com/leon-ai/leon/commit/e88495a9a94e86026fd0c7c4c44f3ff06edb2e80)
+- train affirmation and denial resolver [993d52e8](https://github.com/leon-ai/leon/commit/993d52e8686f335039ff3d5e2a82c1a37efb1825)
+- Python TCP server and Node.js TCP client for IPC (wip) [5970ec9e](https://github.com/leon-ai/leon/commit/5970ec9e8e4c2784c50e2ddc76b34b71aa4310e6)
+- introduce spaCy for complete NER (wip) [caa86fc8](https://github.com/leon-ai/leon/commit/caa86fc8a6850b18f67ba7bedb423be693a88d17)
+- slot filling (wip) [76547d94](https://github.com/leon-ai/leon/commit/76547d9411c32e0eb2ccfdac3a4901d2d2fb37f6)
+- share data across domains [f4f9fff9](https://github.com/leon-ai/leon/commit/f4f9fff9783861be183990d7869973c7a30c8104)
+- dynamic variable binding on NLG [0367b44f](https://github.com/leon-ai/leon/commit/0367b44f211c1629fffe6981a730f171707bf0c0)
+- context and slot filling preparation (wip) [975b8ebc](https://github.com/leon-ai/leon/commit/975b8ebcf00db91b44dd067be6dde5c1bf32fff1)
+- annotate entities on the fly + prepare for dialog skill type and cross-domains data [4107932d](https://github.com/leon-ai/leon/commit/4107932d000086188d6f44ef67b73cc322fc58e5)
+- new NLP training [d8023308](https://github.com/leon-ai/leon/commit/d8023308d0ef1f3eede37f21f45daa2f893031b0)
+
+- **server:**
+  - trigger next action suggestions or current ones [244d08c0](https://github.com/leon-ai/leon/commit/244d08c0bd0fea315269f52ab899f9b7fe083f51)
+  - introduce main NLP model and resolvers NLP model [e37526d9](https://github.com/leon-ai/leon/commit/e37526d9056d858ebcf17b81f6714f47b67c77cb)
+  - change log emojis [843bc428](https://github.com/leon-ai/leon/commit/843bc428b8deb397e2d051a8e0bfaf1b82b459a2)
+  - provide nextAction even when no slot is set and clean up NLU object on context switch [8377c63d](https://github.com/leon-ai/leon/commit/8377c63db4e4e42ed929171cd8b9abdb13c44b2a)
+  - report full traceback from skills execution [b69b1fea](https://github.com/leon-ai/leon/commit/b69b1fea16250421bc7d5def1c973dd43e453071)
+  - support on-the-fly entity annotation for built-in entities [567b030c](https://github.com/leon-ai/leon/commit/567b030c4fcf8df266c39cca61a146fb33b9e0fc)
+  - save slots within conversation context [fce47cdb](https://github.com/leon-ai/leon/commit/fce47cdbd570993ac5cca2b4ff5bc97969df4e40)
+  - resolve resolvers tmp [ceea47ff](https://github.com/leon-ai/leon/commit/ceea47ff7dd536bfd3adf3cc355e90e3e94b1cbd)
+  - prepare the next action on non-slot-filled skills [0acb31a9](https://github.com/leon-ai/leon/commit/0acb31a9c61c1c094b29f3d0ff2647d625eab0be)
+  - add more affirmative utterance samples [870ab2e8](https://github.com/leon-ai/leon/commit/870ab2e87eba2c548d38dc90d30553e7fa380c1e)
+  - restart a skill with the original utterance saved in context [f4446ef1](https://github.com/leon-ai/leon/commit/f4446ef17796d38d0f98d5b7e889503622a1a998)
+  - clean up context if the action loop does not meet the expected items [035c9d52](https://github.com/leon-ai/leon/commit/035c9d5240472ac19a84ae8c1a87844fa0d0af5d)
+  - add handsigns custom entity [1529c720](https://github.com/leon-ai/leon/commit/1529c72039092c7b8f37304d6064e04f2dc7b795)
+  - reprocess NLU in case of slot filling interruption [9e242d77](https://github.com/leon-ai/leon/commit/9e242d77d32109e9355eec422790a5a66fd18f9c)
+  - handle action loop when slots have all been filled at once [f8830502](https://github.com/leon-ai/leon/commit/f88305020a5bc79056b7ff9c1a31f8d3c3a7cdce)
+  - break the action loop from the skill [27dc801c](https://github.com/leon-ai/leon/commit/27dc801cf53de5af3d54b95f42d2b9e627090867)
+  - stop action loop from skill to core [99681e25](https://github.com/leon-ai/leon/commit/99681e257795a18361be379b93244088401f640b)
+  - introduce basic concept of action loop [c5b38400](https://github.com/leon-ai/leon/commit/c5b38400821e5bc5edc4402d007f815f24319d44)
+  - prepare action loop feature [19e1aa22](https://github.com/leon-ai/leon/commit/19e1aa22f6e989e90eb745e3a7b7ccb8ff5adbfa)
+  - add current utterance entities to differentiate from the whole context [8b56a185](https://github.com/leon-ai/leon/commit/8b56a1850c9d76e335f1bad1b4395d73ddc5ea19)
+  - when a context is activated, pick up the most probable classification [8e186879](https://github.com/leon-ai/leon/commit/8e1868798c8750c19b1719a44dc6fb8bca68b250)
+  - persist entities into contexts [87575773](https://github.com/leon-ai/leon/commit/875757739f6701f54805eeff2c7c350cff36c4ac)
+  - forward slots to skill + add original utterance [68e40f65](https://github.com/leon-ai/leon/commit/68e40f65df0d1fe29ccad991868a2408c6e1015e)
+  - handle case when all slots have been filled in one utterance [22e9234b](https://github.com/leon-ai/leon/commit/22e9234b3d2c97e83eaafaeeb5aa9d27c351c95a)
+  - trigger next action once all slots have been filled [9b870010](https://github.com/leon-ai/leon/commit/9b870010dd929bc1aed6d87696f1cc4e9f177c0b)
+  - complete slot filling before triggering the next action [9124687e](https://github.com/leon-ai/leon/commit/9124687eb0e17295a30f860752ee622ba44d1440)
+  - from modules to skills with type at the actions level [77ebaf4a](https://github.com/leon-ai/leon/commit/77ebaf4a9c78b2e471d39872e361ea05b163580d)
+  - verify if all slots are filled [e27c1b9c](https://github.com/leon-ai/leon/commit/e27c1b9c8f5c2f668f464f152ad227d65ba5ef6b)
+  - context and slot filling, keep context and await for entities [25adf406](https://github.com/leon-ai/leon/commit/25adf406c810e48b1277105dd6c269a2ed601d28)
+  - unstack oldest context [1ece25a4](https://github.com/leon-ai/leon/commit/1ece25a497acc9f9876fe158ace5da38beec31e6)
+  - context setup with slot for each conversation (wip) [8257eb87](https://github.com/leon-ai/leon/commit/8257eb8792c9f4fc90bcc1b393d3fddf8ff541dc)
+  - resolve slots from slot filling [960a6dc7](https://github.com/leon-ai/leon/commit/960a6dc71c2efb50ad6a8448d447ebd79c559c41)
+  - pickup questions for slot filling [3bbc2f8a](https://github.com/leon-ai/leon/commit/3bbc2f8a254d10f0c37cdb7abf016b3e418f594a)
+  - main slots structure (wip) [1d9b1809](https://github.com/leon-ai/leon/commit/1d9b18093b6e042ae49f557149a7822b4420cdb8)
+  - introduce resolvers for slot filling (wip) [334bf393](https://github.com/leon-ai/leon/commit/334bf393f2c43edd326d9de2e93c037ffeebeab5)
+  - slot filling PoC (tmp wip) [95bfcfe4](https://github.com/leon-ai/leon/commit/95bfcfe422f21a2946e50031a3623675dfe81b9d)
+  - slot filling (wip) [969a83e6](https://github.com/leon-ai/leon/commit/969a83e6081de20ec5e2bdd0329a21a3fe448f13)
+  - trigger unsupported language [1845eed7](https://github.com/leon-ai/leon/commit/1845eed71dadd5f693d76abd7633864014bf8af1)
+  - context (wip) [d1c2a11d](https://github.com/leon-ai/leon/commit/d1c2a11d8284ca4e1d4563b871c50c006e8ef8a0)
+  - context (wip) [a9a43ac4](https://github.com/leon-ai/leon/commit/a9a43ac478c46f3832d2af49c287bb574a70cc14)
+  - differenciate cities from countries for location entities [bf9bf231](https://github.com/leon-ai/leon/commit/bf9bf231f714e1edc1417e43af12fa54c00ba064)
+  - auto restart the TCP server when language is switching [9be7c700](https://github.com/leon-ai/leon/commit/9be7c700767672ac6e0c875d3b5ae7fa6414e4fa)
+  - support multi languages on TCP server [a808742c](https://github.com/leon-ai/leon/commit/a808742c927d45c18df45af133e67c98d4a0415a)
+  - add auto reconnect on TCP client [cbe89ed6](https://github.com/leon-ai/leon/commit/cbe89ed6ccfd727356eb34078a8a4348b2fd696f)
+  - make TCP client global [006e9fb0](https://github.com/leon-ai/leon/commit/006e9fb01148c2107f6acc6a562ace4809da92be)
+  - fully implement low-level networking for IPC [8acb82da](https://github.com/leon-ai/leon/commit/8acb82da9bacdb9b7952c4a4d130d094e07def5e)
+  - more accurate NLG [d5577b1e](https://github.com/leon-ai/leon/commit/d5577b1ef5cf1b8b4a924636ba4425b8b4ae133d)
+  - unknown_answers fallback on dialog type [28efe6e7](https://github.com/leon-ai/leon/commit/28efe6e7d542f19bf12ddede1815f7fa8cf01036)
+  - deep data mapping on enum NER [3ca48265](https://github.com/leon-ai/leon/commit/3ca48265e7115c8e0f02c65ba92d90412325ad76)
+  - NLG and entities mapping [8f2f935b](https://github.com/leon-ai/leon/commit/8f2f935b949ceb965941460d4ff1ed0084b72442)
+  - bootstrap skill structure [fe90c68e](https://github.com/leon-ai/leon/commit/fe90c68ea0e9b0e857b62aa9f3b0a42ba1ffed6b)
+  - on-the-fly language switching [f24513a2](https://github.com/leon-ai/leon/commit/f24513a22395d1903e485883f4813cdceccdbd18)
+  - new NLP containers [34b2aa56](https://github.com/leon-ai/leon/commit/34b2aa5655e55284d59db4569960c49965a0483c)
+  - (WIP) NLU refactoring [ca3f5f42](https://github.com/leon-ai/leon/commit/ca3f5f42da26eb634e10b56e9b84bd45b5543024)
+  - add skills domains [cf2a28aa](https://github.com/leon-ai/leon/commit/cf2a28aac2d936cc15e6aa9aa13747015d952053)
+- **skill/akinator:**
+  - finish up [79e7df02](https://github.com/leon-ai/leon/commit/79e7df022f7daedf43db7f892e049a31924ce985)
+  - finished main business logic [76cae42f](https://github.com/leon-ai/leon/commit/76cae42fdeac0edcd3ebd6aa7718728617687b1b)
+  - backbone [02a2f714](https://github.com/leon-ai/leon/commit/02a2f71470bb4c0c6ca04526e89461d863d17145)
+- **skill/birthday:**
+  remove birthday skill [be0b345d](https://github.com/leon-ai/leon/commit/be0b345d3f7fea562548e3fbed62b65c32eff4c0)
+- **skill/color:**
+  introduce color skill [ce00989b](https://github.com/leon-ai/leon/commit/ce00989b01f65c5cbb5a2e13f454207c1ba7741c)
+- **skill/guess_the_number:**
+  introduce the Guess the Number skill [fba80966](https://github.com/leon-ai/leon/commit/fba80966c937a32182e48670c47358babb539d64)
+- **skill/introduction:**
+  - add one utterance sample [af0fdd1e](https://github.com/leon-ai/leon/commit/af0fdd1e18975bf8b60abb2957ddf79831281817)
+  - ask about owner info if necessary [c5cc9bdd](https://github.com/leon-ai/leon/commit/c5cc9bdd52afaaa710f9476d1e9918f3d168e243)
+- **skill/mbti:**
+  - complete form resolver [aad9f3f1](https://github.com/leon-ai/leon/commit/aad9f3f1ef61499d438ea40c9d2d95764667678d)
+  - finish business logic [99a3f103](https://github.com/leon-ai/leon/commit/99a3f103e00b5a58745ee851d2fa95c61871f75a)
+  - questions mapping [ae4f69f7](https://github.com/leon-ai/leon/commit/ae4f69f7c7189ff75e004f68c9a2a8b6bb37b6bd)
+  - complete questionnaire [7f1f8871](https://github.com/leon-ai/leon/commit/7f1f8871598746c5475b24e086ea6e581f2a988e)
+  - main logic backbone [33109a4c](https://github.com/leon-ai/leon/commit/33109a4c8b5df82e7b98e48e66f8d53f0cc114fb)
+  - main NLU structure [skip ci] [86d5040a](https://github.com/leon-ai/leon/commit/86d5040a7dc2006036c7e67a2cf54a4c992e64aa)
+- **skill/rochambeau:**
+  - add start answers [192dd0a8](https://github.com/leon-ai/leon/commit/192dd0a87ab5dc025bb90b20b187e36a58be54ea)
+  - introduce paper scissors rock [57370470](https://github.com/leon-ai/leon/commit/573704706c843d870f2498146bc3cd659bab4f06)
+  - init [7f5e30ac](https://github.com/leon-ai/leon/commit/7f5e30ac82f2a2d7579e361229a4044348915867)
+- **web app:**
+  - join us on Discord [141c89ec](https://github.com/leon-ai/leon/commit/141c89ecbfd329a8e63d5a603d0ae6b42f9abf38)
+  - wait for TCP client to be connected first [bc228a68](https://github.com/leon-ai/leon/commit/bc228a68600c07871c489d6624bbc837971079a6)
+  ### Bug Fixes
+- check script with new intent-object format [fdf0a389](https://github.com/leon-ai/leon/commit/fdf0a389b76caba5dd47996a43a34c0c7821c70a)
+- check new resolvers paths [cfd8f7cb](https://github.com/leon-ai/leon/commit/cfd8f7cbe5e8fd9ce3d1659c725d7af261db8d71)
+- use ports.ubuntu.com mirror for the offline TTS [skip ci] [3dd90396](https://github.com/leon-ai/leon/commit/3dd9039678820fceb7ccbb1c96358c8d2f188ede)
+- set skill config only when a bridge is set [7513aa7d](https://github.com/leon-ai/leon/commit/7513aa7d20fee1fe9ca5442a7909d22fd1c3b39e)
+- only set skill config when it is a logic type [9ce9a8bc](https://github.com/leon-ai/leon/commit/9ce9a8bc4fe0864730a08d8e9a436982f1365aa5)
+- **docker:**
+  - usage of Ubuntu base image with pyenv and nvm (#408) [f507f6f7](https://github.com/leon-ai/leon/commit/f507f6f7e499f56768b3e624164cbcd58193b153)
+  - check should not allocate a pseudo-TTY (#359) [4372b45f](https://github.com/leon-ai/leon/commit/4372b45fc605893d4130cf7110dd87519b934345)
+- **server:**
+  - make leon handle multiple socket.io-client instances [6e7c0aac](https://github.com/leon-ai/leon/commit/6e7c0aac57008b152b45f1b0f3886ae38777467b)
+  - fallback on global resolver during resolver classification [ec77dd0f](https://github.com/leon-ai/leon/commit/ec77dd0f02a8ae94fb3f02c7b7847b5509d71406)
+  - make use of current entities to match global entities [a8d82050](https://github.com/leon-ai/leon/commit/a8d82050c86b5c24c4c898c06e5ffc3882524c0b)
+  - multiple slots filling [2ac1bc63](https://github.com/leon-ai/leon/commit/2ac1bc63ccd11757d586adfb2e75ce04e3ffbcb5)
+  - context switching on action loop [6712ae55](https://github.com/leon-ai/leon/commit/6712ae5539ef44ed33e360cfcad71c760c4b13b1)
+  - check one-shot slot filling case causing infinite loop [782a3aaa](https://github.com/leon-ai/leon/commit/782a3aaa0a07dda667557bc84db906b3fa9b237c)
+  - clean up active context after all slots have been filled [faabc2c7](https://github.com/leon-ai/leon/commit/faabc2c7b0992fcea035eedf66103d84b101e1a7)
+  - correctly extract all spaCy entities [6aa60bfb](https://github.com/leon-ai/leon/commit/6aa60bfbd8c72e678fe3faf5e7f9dbd37dfd209f)
+  - intent not found [8280c658](https://github.com/leon-ai/leon/commit/8280c65897dba0fe470a3589d151b391c51e344e)
+  - fallback due to modules to skills refactoring [ef0c54b2](https://github.com/leon-ai/leon/commit/ef0c54b22667ef2bd1d2c07003f6b4beb5fa25c0)
+  - NER due to modules to skills refactoring [e4d3904c](https://github.com/leon-ai/leon/commit/e4d3904ceeb2a3ee2c0187a1817331fac916e1a7)
+  - **skill/akinator:**
+    remove direct end on guess action [f6461f73](https://github.com/leon-ai/leon/commit/f6461f733b4a5d944dfa4a987dd1109628c6cbca)
+  - **skill/color:**
+    more appropriate answer [cb18ed63](https://github.com/leon-ai/leon/commit/cb18ed6397cb0e0ad8fbea30c57d7d40137441ee)
+  - **skill/rochambeau:**
+    final logic [0ebc0518](https://github.com/leon-ai/leon/commit/0ebc0518e61b899c35dd13df65a43f69399e784d)
+  ### Performance Improvements
+- check Pipfile instead of Pipfile.lock to judge whether Python packages must be installed [afdb71f7](https://github.com/leon-ai/leon/commit/afdb71f766f2956c5cb4a5e0be9025340d1a89db)
+
+### Documentation Changes
+
+- change newsletter link [4bf2a9af](https://github.com/leon-ai/leon/commit/4bf2a9af963f75aeff96f4a43da8ec1024ac583a)
+- README - Edited sentence for clarity (#389) [e83a1c42](https://github.com/leon-ai/leon/commit/e83a1c4230897e8b63251ef86225cf773148c38e)
+- edit newsletter link [fa558a44](https://github.com/leon-ai/leon/commit/fa558a447ade4071f352d56f14602690ed90f521)
+- update sponsor [skip ci] [f30ddb6b](https://github.com/leon-ai/leon/commit/f30ddb6be5f531df2b0042be0ed5ffbe79f73b07)
+- remove sponsor [skip ci] [5dbc010f](https://github.com/leon-ai/leon/commit/5dbc010fa643279a24081f3148022e2211af63f4)
+- remove sponsor [skip ci] [f36dd20f](https://github.com/leon-ai/leon/commit/f36dd20f822cd33c9e8a03efc2849c8d8d1fc75e)
+- remove sponsor [skip ci] [5ee57ddf](https://github.com/leon-ai/leon/commit/5ee57ddf2a9f7817ec35b2e70d49e5bb422d8f78)
+- add @ant-media sponsor [skip ci] [b47cbc3a](https://github.com/leon-ai/leon/commit/b47cbc3a5ecb6591f7abb4f62feae8102b9a6468)
+- add long dev notice to README [skip ci] [499be77d](https://github.com/leon-ai/leon/commit/499be77d509231b853f591e27f726381da5a50d8)
+- move sponsor to new section [skip ci] [8825d687](https://github.com/leon-ai/leon/commit/8825d6877c19d86495e89a858b859b7ab1f9ae37)
+- change Twitter handle [skip ci] [c1afc11c](https://github.com/leon-ai/leon/commit/c1afc11cdb283526540d0fecdf83efddf3f3a9f7)
+- remove sponsor [skip ci] [99b401a6](https://github.com/leon-ai/leon/commit/99b401a668a6fb248e33c22782940402be7c9b17)
+- add new sponsor self-hosted img [skip ci] [238d928c](https://github.com/leon-ai/leon/commit/238d928cace13d4ecd174ca14b136967d8845e0f)
+- remove new sponsor link (broken) [skip ci] [254f2848](https://github.com/leon-ai/leon/commit/254f2848aab622b79cce16d10c58d53ff6db9a8f)
+- in GitHub BUG.md from modules to skills [4a5480a3](https://github.com/leon-ai/leon/commit/4a5480a3ccc54ee34d42f6edcec2a40224dee7ed)
+- change @FluxIndustries sponsorship [skip ci] [1a118b71](https://github.com/leon-ai/leon/commit/1a118b718e5d4ade123756ac94758a01c50b12ae)
+- add @FluxIndustries sponsor [skip ci] [9a604d7c](https://github.com/leon-ai/leon/commit/9a604d7ccc0c6aaec257299078141dd0c3077933)
+- new #LeonAI link [skip ci] [a0107d62](https://github.com/leon-ai/leon/commit/a0107d629473f7fd057d367926e83822d46f1227)
+- changelog new version diff link fix [skip ci] [e14c2498](https://github.com/leon-ai/leon/commit/e14c249826db92af7b85422e566be6aa834a7fb7)
+
+# [1.0.0-beta.6](https://github.com/leon-ai/leon/compare/v1.0.0-beta.5...v1.0.0-beta.6) (2022-02-07) / Leon Over HTTP + Making Friends with Coqui STT
+
+### Features
+
+- simple coqui-ai stt integration [86a4816b](https://github.com/leon-ai/leon/commit/86a4816b777fee8ec9c89648c5866a75de56c017)
+- HTTP API key generator [d10a7fa7](https://github.com/leon-ai/leon/commit/d10a7fa7880a0bf2fb1cae7904d1ef4257f05257)
+- avoid unnecessary routes generation
+
+- **server:**
+  - make Coqui STT the default STT solution [70399187](https://github.com/leon-ai/leon/commit/7039918760c0ef7ba93bf45820e3cae774c42d8c)
+    - add HTTP API key middleware [cdf41499](https://github.com/leon-ai/leon/commit/cdf4149939cbe3f3ae81039957dba3377a78f5a6)
+    - expose queries over HTTP [b6428d03](https://github.com/leon-ai/leon/commit/b6428d038452619f1682c863892cd8f376efca84)
+    - add timeout action over HTTP [115f9c16](https://github.com/leon-ai/leon/commit/115f9c164559d761625cc6f362749f7d2417d300)
+    - handle built-in and trim entities over HTTP + add "disabled" HTTP API action option [82fb967a](https://github.com/leon-ai/leon/commit/82fb967af8f49421e3b2474184da3d34fb17294f)
+    - execute modules over HTTP [2e5b2c59](https://github.com/leon-ai/leon/commit/2e5b2c59da0bafe3acd966773c6fac3611b3bd0c)
+    - generate Fastify routes on the file to expose packages over HTTP [5b41713a](https://github.com/leon-ai/leon/commit/5b41713a68ee628e695212dbebc88f6b9a94b461)
+
+### Bug Fixes
+
+- do not ask to regenerate the HTTP API key if this one isn't available yet [d265377a](https://github.com/leon-ai/leon/commit/d265377a43fd4506cf12db46f261b891f2054ed2)
+- Python deps tree check [c6c01291](https://github.com/leon-ai/leon/commit/c6c012915824227efdf0c50df6a8f1cd8d70ed42)
+- hotword offline (#342) [f563d01d](https://github.com/leon-ai/leon/commit/f563d01d077499c836e94c86f85cedc2ad4d56e6)
+- addressed comments by @JRMeyer [b1c6f5c8](https://github.com/leon-ai/leon/commit/b1c6f5c883103d57d4fe566af640fc3ac5ce713d)
+- allow to detect STT offline capabilities [04d62288](https://github.com/leon-ai/leon/commit/04d622884165e0bde65785569a659f59cf9e8582)
+- Amazon Polly is always configured on check script due to new structure [e6246d1f](https://github.com/leon-ai/leon/commit/e6246d1f8f9ec15a4ebe9600764afffbaa7e62d9)
+
+### Performance Improvements
+
+- check if Python deps tree has been updated before going through deps install [2d0b0f13](https://github.com/leon-ai/leon/commit/2d0b0f1365d8e4d6eadf9f7cc0a16b7b4b4306f4)
+
+# [1.0.0-beta.5](https://github.com/leon-ai/leon/compare/v1.0.0-beta.4...v1.0.0-beta.5) (2021-12-28) / Refocus
+
+_This release marks a major turn in the future versions of the Leon core. Please [read this blog post](https://blog.getleon.ai/i-ran-away-from-open-source/) to know more._
+
+### BREAKING CHANGES
+
+- Node.js 16+ and npm 8+ minimum requirements [2f66f1c1](https://github.com/leon-ai/leon/commit/2f66f1c17bb2e4a1c18b4251d49de252b8d87344)
+
+### Features
+
+- **server:** support arrays on NER between conditions [7cf7f979](https://github.com/leon-ai/leon/commit/7cf7f9791254e1950fe9128ce1b3a58079cc2ada)
+
+### Bug Fixes
+
+- jest-extended new setup due to latest update [02f766d6](https://github.com/leon-ai/leon/commit/02f766d6a8453609ebaec78356aa6e6d4df0967b)
+
+### Performance Improvements
+
+- Windows setup on DeepSpeech dep removal [13f5a49f](https://github.com/leon-ai/leon/commit/13f5a49f678f8f67a93b67d4f558cddcf237e204)
+
+### Documentation Changes
+
+- URL redirect managed by registrar [c16d5b28](https://github.com/leon-ai/leon/commit/c16d5b280b758f7e18305e30678adec79f0a0716)
+
+# [1.0.0-beta.4](https://github.com/leon-ai/leon/compare/1.0.0-beta.2...v1.0.0-beta.4) (2021-05-01) / Getting Rid of Dust
+
+_This release includes a lot of changes that are made under the hood and are not displayed here, please **[read the blog post](https://blog.getleon.ai/getting-rid-of-dust-1-0-0-beta-4/)** to know more._
+
+### BREAKING CHANGES
+
+- **package/checker:** introduce Have I Been Pwned v3 API with API key ([0ca89fe3](https://github.com/leon-ai/leon/commit/0ca89fe32d51c80cec5f9446acf14990390a5917))
+- **server:**
+  - AWS SDK new structure due to v3 and adapt Amazon Polly changes ([f15f2db7](https://github.com/leon-ai/leon/commit/f15f2db78e5781d05e5e2bcb186645966d17debf))
+  - IBM Watson TTS and STT new structure ([f41ea0e9](https://github.com/leon-ai/leon/commit/f41ea0e9a1479bfd6a1cb2e8d1f70aec744c685b) | [2668c295](https://github.com/leon-ai/leon/commit/2668c295880ee753ef7ca26a91dbc7e0901febff))
+
+### Features
+
+- **package/calendar:** introduce To-Do list module ([0cdd73d6](https://github.com/leon-ai/leon/commit/0cdd73d6c24a287915f691e3b12edacd75fd383a) | [857be947](https://github.com/leon-ai/leon/commit/857be947792c650ac35847e14fc41064008cef24) | [2041be14](https://github.com/leon-ai/leon/commit/2041be14dbc01640a61de96d1982cc20cd05a8b3) | [12e8f5c3](https://github.com/leon-ai/leon/commit/12e8f5c3bfb436aa212557cd99d9926aa431ab4f) | [8575e9e3](https://github.com/leon-ai/leon/commit/8575e9e3ef01499d9f7be6d313a85d48549e9107) | [5e128df0](https://github.com/leon-ai/leon/commit/5e128df023977525de3e66ce2826aace87569308) | [602aa694](https://github.com/leon-ai/leon/commit/602aa694ac49333f48c119cf2ca2aa7f54b8ae44) | [b9693df9](https://github.com/leon-ai/leon/commit/b9693df90cbc01067e18e64db4d377e41b3fd1d4) | [581da8cd](https://github.com/leon-ai/leon/commit/581da8cd9806323aabb0e85778d645df3c0948b9) | [53f7db55](https://github.com/leon-ai/leon/commit/53f7db55c6e916751f1d59c239628d5ea8914009) | [ae073971](https://github.com/leon-ai/leon/commit/ae0739717b6a17373d8f9bc69571c67c1c571b4a))
+- **package/checker:** introduce Have I Been Pwned module ([61c1b55a](https://github.com/leon-ai/leon/commit/61c1b55af5691c03f6a6dae0cf3f236a374f1fe7) | [5a999bc6](https://github.com/leon-ai/leon/commit/5a999bc63aa0c667c4e3092daac6a05a6c4b4499) | [36368664](https://github.com/leon-ai/leon/commit/36368664fce8bcf0c17c4c83818aeb418f1e2f23) | [a7a6d885](https://github.com/leon-ai/leon/commit/a7a6d885a83455163eeca74a355177d65db156b8) | [c73ba52b](https://github.com/leon-ai/leon/commit/c73ba52ba8575a64b3329e59a50050d15281d0ec) | [8374e548](https://github.com/leon-ai/leon/commit/8374e5481022de9b134f49180a8dfe28db136261) | [a476fd0f](https://github.com/leon-ai/leon/commit/a476fd0f38f18bf8035db213be2c55f83871038d))
+- **package/network:** add speedtest module ([09ad4340](https://github.com/leon-ai/leon/commit/09ad43406d3df8ca65f385a91c159def51f91811))
+- **server:**
+  - add regex entity type [3fda3526](https://github.com/leon-ai/leon/commit/3fda3526c7425bdea4b669474fa77efd61c06a8e)
+  - catch unsupported action entity type [5bc6c3f1](https://github.com/leon-ai/leon/commit/5bc6c3f116d6b9ece2cc3bebdbdb08f019ee90b9)
+  - NER backbone [24cf3c9a](https://github.com/leon-ai/leon/commit/24cf3c9a4facd05a4c626ff9d2e7c83a5ae15298)
+  - introduce actions module [b449376f](https://github.com/leon-ai/leon/commit/b449376f61dc995e2e264c6a14ba123926f5cc58)
+
+### Bug Fixes
+
+- set correct status code for GET /downloads [690f1841](https://github.com/leon-ai/leon/commit/690f1841d681a1e48e1837e3e166228d6c2ddaf6)
+- take `.env` in consideration when using Docker [d38e6095](https://github.com/leon-ai/leon/commit/d38e6095f9b71467b8486430fba4bb7007ec4c5a)
+- spinner test [9071c927](https://github.com/leon-ai/leon/commit/9071c92790be674687590e4a896bbf44bc26fb43)
+- e2e tests by adding modules actions level [5cf77d90](https://github.com/leon-ai/leon/commit/5cf77d9011a80b326f229b2309a6910ac0f1cfa2)
+
+- **package/leon:** fix english translations [90225707](https://github.com/leon-ai/leon/commit/90225707f94154021cadeb9c61bdc48c3de5aa29)
+- **package/network:** make use of new compatible speedtest lib [0c925626](https://github.com/leon-ai/leon/commit/0c925626df65858fa039972b3f3d5f38fde93eb6)
+- **package/trend:**
+  - GitHub module new scraping [68414937](https://github.com/leon-ai/leon/commit/6841493740ca859000c1fd8d692b73fc79fcf500)
+  - when there is no star provided on the GitHub module [563fb409](https://github.com/leon-ai/leon/commit/563fb40955e2deb5c6d0bd064fc9cc8766a6fcaf)
+- **server:**
+  - make use of Basic plugin from the main NLP container [e1d5bed3](https://github.com/leon-ai/leon/commit/e1d5bed3e688db566a0cb803dda5c2d57c599d8c)
+  - NER trim entity on after conditions [fa6a5a43](https://github.com/leon-ai/leon/commit/fa6a5a43a60b493aa403a44957082382494c129b)
+
+### Documentation Changes
+
+- add minimum Pipenv version requirement to README [72e46bd6](https://github.com/leon-ai/leon/commit/72e46bd6c175a4a149fb6b14522823b224d7c152)
+- hunt broken links [b2a22792](https://github.com/leon-ai/leon/commit/b2a2279243e7566b57fb7f696024bdf08294e853)
+- add "ci" commit type in CONTRIBUTING.md [09e2672b](https://github.com/leon-ai/leon/commit/09e2672b0b399f5ce9dd7cd446d04f4d6fd7c13a)
+- use emojies in README [0ea7a78b](https://github.com/leon-ai/leon/commit/0ea7a78b7c94dc44c992913ae1c90fb1cf8a7692)
+- add social badges to README [c55c7532](https://github.com/leon-ai/leon/commit/c55c7532b25bf420c4819be71b0f9c21ccc58711)
+- Node.js 14 requirement [d1034bd1](https://github.com/leon-ai/leon/commit/d1034bd135fd5a6314a1571d4088fd85a8e6a1da)
+
+# [1.0.0-beta.2](https://github.com/leon-ai/leon/compare/1.0.0-beta.1...1.0.0-beta.2) (2019-04-24)
+
+### Features
+
+- can send custom HTTP headers
+  ([2685cdab](https://github.com/leon-ai/leon/commit/2685cdab07cc1a9ea418eab812e5163d2dd0da90))
+- allow HTML output
+  ([ec3f02df](https://github.com/leon-ai/leon/commit/ec3f02dfaf2f4b7623ce350350ebee28cf18740e))
+- NLU improvement with node-nlp
+  ([6585db71](https://github.com/leon-ai/leon/commit/6585db718ccae1d750a35783075cf61cc8fe84f1))
+
+- **package/trend:**
+  - add answer when the Product Hunt developer token is not provided
+    ([f40b479b](https://github.com/leon-ai/leon/commit/f40b479b295247c5a8a0e6ed81afe56fadfd2730))
+  - Product Hunt module done
+    ([37794306](https://github.com/leon-ai/leon/commit/3779430621bef970be0e8d048eb0b4bf160ae8a4))
+  - basics done on the Product Hunt module
+    ([32cc7dbe](https://github.com/leon-ai/leon/commit/32cc7dbe36592fb9618d9c10da5f05a4be7e41b6))
+  - complete dedicated answers according to the technology and given time
+    ([8997d691](https://github.com/leon-ai/leon/commit/8997d6917445f837c9647a5a9b4d6998d2df4952))
+  - GitHub module done
+    ([7c6f3922](https://github.com/leon-ai/leon/commit/7c6f3922f299193ee0fb54d0fc97f8b436fc706b))
+  - be able to choose a limit and a date range for the GitHub module
+    ([3c088371](https://github.com/leon-ai/leon/commit/3c0883716e1c10371c399843a578095a1e16781d))
+  - format GitHub results in one message
+    ([9d026b94](https://github.com/leon-ai/leon/commit/9d026b94efa8871d421ae2b593b96622a98537ac))
+  - simple GitHub module results
+    ([5baec074](https://github.com/leon-ai/leon/commit/5baec07455f453d4ad003f1da360b2663b7e15e0))
+  - list GitHub trends in HTML raw
+    ([3441629e](https://github.com/leon-ai/leon/commit/3441629e3cde933b322cb114d9f1bc3ef0eb3944) | [6b932e94](https://github.com/leon-ai/leon/commit/6b932e947fc365ea6435fda798b7cca32708b443))
+  - expressions dataset and structure
+    ([f406a5a0](https://github.com/leon-ai/leon/commit/f406a5a09894e12c56a1e76dda609adada00b0d7) | [f54c2272](https://github.com/leon-ai/leon/commit/f54c2272b4b4dc5c56b512b0ccc1519d77ef15a3))
+
+### Bug Fixes
+
+- Leon was not fully installed with Docker if a `.env` file was existing
+  ([c8a68ab0](https://github.com/leon-ai/leon/commit/c8a68ab02eec9ddaf803b6e36cd7e91a4989cdea))
+
+- **package/trend:**
+  when there is no contributor on GitHub module
+  ([d845e49b](https://github.com/leon-ai/leon/commit/d845e49b0f18caeb306e2d399c50a03883b2f55d))
+- **server:**
+  - skip Pipenv locking until they fix it
+    ([029381e3](https://github.com/leon-ai/leon/commit/029381e3256933f37f5c2950c4eb1f0192f55ec6) | [ecfdc73f](https://github.com/leon-ai/leon/commit/ecfdc73f8290dd9e1910df9519095516a1227763))
+
+### Documentation Changes
+
+- add `What is Leon able to do?` section in the readme
+  ([87f53c91](https://github.com/leon-ai/leon/commit/87f53c91368141966959f3ad7299bb7b643828a5) | [d558fc8b](https://github.com/leon-ai/leon/commit/d558fc8b7c6494babf5dec799802227f77c33d8a))
+- open-source != open source
+  ([16a9372e](https://github.com/leon-ai/leon/commit/16a9372e05d4d31a7a39a65a52d4708b72499d4c) | [2155cd88](https://github.com/leon-ai/leon/commit/2155cd88decbbd671bd58840291d9330ce06ebba))
+
+# [1.0.0-beta.1](https://github.com/leon-ai/leon/compare/1.0.0-beta.0...1.0.0-beta.1) (2019-02-24)
+
+### Features
+
+- add Docker support
+  ([209760db](https://github.com/leon-ai/leon/commit/209760dba747001300692fb6a6af97543de584d6))
+
+### Bug Fixes
+
+- **package/checker:**
+  isitdown module fails with capital letters in URL
+  ([ada6aaef](https://github.com/leon-ai/leon/commit/ada6aaef4bada47e87d28f9f6eaa05b9e23f58d2))
+- **web app:**
+  enable environment variables
+  ([a438d6f9](https://github.com/leon-ai/leon/commit/a438d6f942812f74e3dda75a9875609f8bea21cd))
+
+### Performance Improvements
+
+- **web app:**
+  favicon compression
+  ([33dbcb42](https://github.com/leon-ai/leon/commit/33dbcb425eaafba90176ff64e5f689eb36bc6ce1))
+
+### Documentation Changes
+
+- update README to make the reader genderless
+  ([58662658](https://github.com/leon-ai/leon/commit/586626586b7a2f84cb2cd84028111976bc5172f0))
+- use "to rule them all" in README
+  ([c74dda4c](https://github.com/leon-ai/leon/commit/c74dda4cb9acc78de143ae01fdc6b4ef0a5ec3ef))
+
+- **readme:**
+  add story write-up
+  ([08a68e37](https://github.com/leon-ai/leon/commit/08a68e376b6a9367425947380564120943376500))
+
+# [1.0.0-beta.0](https://github.com/leon-ai/leon/compare/https://github.com/leon-ai/leon.git...1.0.0-beta.0) (2019-02-10)
 
 Initial release.

Dockerfile

@@ -0,0 +1,60 @@
+FROM ubuntu:20.04
+ENV IS_DOCKER true
+
+# Replace shell with bash so we can source files
+RUN rm /bin/sh && ln -s /bin/bash /bin/sh
+
+# Set debconf to run non-interactively
+RUN echo 'debconf debconf/frontend select Noninteractive' | debconf-set-selections
+
+# Install base dependencies
+RUN apt-get update && apt-get install --yes -q --no-install-recommends \
+  apt-transport-https \
+  build-essential \
+  ca-certificates \
+  curl \
+  git \
+  wget \
+  libssl-dev \
+  openssl \
+  libz-dev \
+  zlib1g-dev \
+  libbz2-dev \
+  libreadline-dev \
+  libsqlite3-dev \
+  llvm \
+  libncurses5-dev \
+  xz-utils \
+  tk-dev libxml2-dev \
+  libxmlsec1-dev \
+  libffi-dev \
+  liblzma-dev \
+  libgdbm-dev \
+  libnss3-dev \
+  libc6-dev
+
+# Run the container as an unprivileged user
+RUN groupadd docker && useradd -g docker -s /bin/bash -m docker
+USER docker
+WORKDIR /home/docker
+
+# Install Node.js with nvm
+ENV NVM_DIR /home/docker/.nvm
+ENV NODE_VERSION v16.18.0
+
+RUN curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.2/install.sh | bash
+RUN /bin/bash -c "source $NVM_DIR/nvm.sh && nvm install $NODE_VERSION && nvm use --delete-prefix $NODE_VERSION"
+
+ENV NODE_PATH $NVM_DIR/versions/node/$NODE_VERSION/lib/node_modules
+ENV PATH $NVM_DIR/versions/node/$NODE_VERSION/bin:$PATH
+
+# Install Leon
+WORKDIR /home/docker/leon
+USER root
+RUN chown -R docker /home/docker/leon
+USER docker
+COPY --chown=docker ./ ./
+RUN npm install
+RUN npm run build
+
+CMD ["npm", "start"]

LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2019-present, Louis Grenard <louis.grenard@gmail.com>
+Copyright (c) 2019-present, Louis Grenard <louis@getleon.ai>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,64 +1,129 @@
 <p align="center">
-  <a href="https://getleon.ai"><img width="96" src="https://getleon.ai/img/logo.svg"></a><br><br>
-  <a href="https://www.youtube.com/watch?v=p7GRGiicO1c"><img width="512" src="https://getleon.ai/img/1.0.0-beta.0_preview_en.png"></a><br>
+  <a href="https://getleon.ai"><img width="800" src="https://getleon.ai/img/hero-animation.gif" /></a>
 </p>
 
-<h1 align="center">Leon</h1>
+<h1 align="center">
+  <a href="https://getleon.ai"><img width="96" src="https://getleon.ai/img/logo.svg" alt="Leon"></a><br>
+  Leon
+</h1>
 
-*<p align="center">Your open-source personal assistant.</p>*
+_<p align="center">Your open-source personal assistant.</p>_
 
 <p align="center">
-  <a href="https://github.com/leon-ai/leon/blob/develop/LICENSE.md"><img src="https://img.shields.io/badge/license-MIT-blue.svg?style=flat"/></a>
-  <a href="https://circleci.com/gh/leon-ai/leon/tree/develop"><img src="https://img.shields.io/circleci/project/github/leon-ai/leon.svg?style=flat"/></a>
-  <a href="https://github.com/leon-ai/leon/blob/develop/.github/CONTRIBUTING.md"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat"/></a>
+  <a href="https://github.com/leon-ai/leon/blob/develop/LICENSE.md"><img src="https://img.shields.io/badge/license-MIT-blue.svg?label=License&style=flat" /></a>
+  <a href="https://github.com/leon-ai/leon/blob/develop/.github/CONTRIBUTING.md"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat" /></a>
+  <br>
+  <a href="https://github.com/leon-ai/leon/actions/workflows/build.yml"><img src="https://github.com/leon-ai/leon/actions/workflows/build.yml/badge.svg?branch=develop" /></a>
+  <a href="https://github.com/leon-ai/leon/actions/workflows/tests.yml"><img src="https://github.com/leon-ai/leon/actions/workflows/tests.yml/badge.svg?branch=develop" /></a>
+  <a href="https://github.com/leon-ai/leon/actions/workflows/lint.yml"><img src="https://github.com/leon-ai/leon/actions/workflows/lint.yml/badge.svg?branch=develop" /></a>
+  <br>
+  <a href="https://discord.gg/MNQqqKg"><img src="https://svgshare.com/i/V09.svg"/></a>
 </p>
 
 <p align="center">
   <a href="https://getleon.ai">Website</a> ::
   <a href="https://docs.getleon.ai">Documentation</a> ::
-  <a href="https://roadmap.getleon.ai">Roadmap</a> ::
-  <a href="https://github.com/leon-ai/leon/blob/develop/.github/CONTRIBUTING.md">Contributing</a>
+  <a href="http://roadmap.getleon.ai">Roadmap</a> ::
+  <a href="https://github.com/leon-ai/leon/blob/develop/.github/CONTRIBUTING.md">Contributing</a> ::
+  <a href="https://blog.getleon.ai/the-story-behind-leon/">Story</a>
 </p>
 
 ---
 
-## Introduction
+## Current State
 
-Leon is an **open-source personal assistant** who can live **on your server**.
+### Why is there a small amount of contributors?
 
-He **does stuff** when you **ask for it**.
+I'm taking a lot of time to work on the new core of Leon due to personal reasons. I can only work on it after work and on weekends. Hence, **I'm blocking any potential contribution as the whole core of Leon is coming with many breaking changes**. Many of you are willing to contribute in Leon (create new skills, help to improve the core, translations and so on...), a big thanks to every one of you!
+
+While I would love to devote more time to Leon, I'm currently unable to do so because I have bills to pay. I have some ideas about how to monetize Leon in the future (Leon's core will always remain open source), but before to get there there is still a long way to go.
+
+Until then, any financial support by [sponsoring Leon](http://sponsor.getleon.ai) is much appreciated 🙂
+
+### How about large language models and Leon?
+
+Since AI gained in popularity and large language models are getting more and more traction, many of you joined our community. A huge welcome to all of you! 🤗
+
+At the moment, Leon's NLU will remain intents first with his own model without relying on an LLM. It is important that Leon can run 100% offline and I'm confident that with the downsizing techniques such as quantization Leon will sooner or later work with LLMs at his core and still be able to run on edge.
+
+Here is how LLMs may help Leon in the future:
+
+- Intent fallback: when an utterance cannot match an intent, then rely on an LLM to provide results.
+- New named entity recognition engine: provide a better solution to extract entities from utterances such as fruits, numbers, cities, durations, persons, etc.
+- Skill features: let skills leverage LLMs to provide out-of-the-box NLP features such as summarization, knowledge base, translation, sentiment analysis and so on...
+- Skill building: LLMs can help to develop skills such as paraphrasing utterance samples, translate answers, convert code from our Python bridge to the upcoming JavaScript bridge and vice versa, etc.
+- More...
+
+### What's Next?
+
+Once the new core released, we'll work on the community aspect of Leon. For example, better organize [our Discord](https://discord.gg/MNQqqKg), planify regular calls, work on skills together, etc. It is very important for Leon to have a real community. At that moment, the skills platform will already be online, so it'll be easier to sync our progress and publish new skills.
+
+- Feel free to check out the Git development branches and our [next major milestones](https://blog.getleon.ai/a-much-better-nlp-and-future-1-0-0-beta-7/#whats-next).
+- And the [detailed roadmap](http://roadmap.getleon.ai).
+- Many exciting things are coming up, hence no new documentation and test are going to be written until the official release of Leon.
+
+---
+
+## Latest Release
+
+Check out the [latest release blog post](https://blog.getleon.ai/binaries-and-typescript-rewrite-1-0-0-beta-8/).
+
+<a href="https://blog.getleon.ai/binaries-and-typescript-rewrite-1-0-0-beta-8/"><img width="400" src="https://blog.getleon.ai/static/a0d1cbafd1968e7531dc17e229f8cc61/aa440/beta-8.png" /></a>
+
+---
+
+## 👋 Introduction
+
+**Leon** is an **open-source personal assistant** who can live **on your server**.
+
+He **does stuff** when you **ask him to**.
 
 You can **talk to him** and he can **talk to you**.
 You can also **text him** and he can also **text you**.
 If you want to, Leon can communicate with you by being **offline to protect your privacy**.
 
 ### Why?
+
 > 1. If you are a developer (or not), you may want to build many things that could help in your daily life.
-> Instead of building a dedicated project for each of those ideas, Leon can help you with his
-> packages/modules (skills) structure.
-> 2. With this generic structure, everyone can create his own modules and share them with others.
-> Therefore there is only one core (to govern all of them).
+>    Instead of building a dedicated project for each of those ideas, Leon can help you with his
+>    Skills structure.
+> 2. With this generic structure, everyone can create their own skills and share them with others.
+>    Therefore there is only one core (to rule them all).
 > 3. Leon uses AI concepts, which is cool.
 > 4. Privacy matters, you can configure Leon to talk with him offline. You can already text with him without any third party services.
-> 5. Open-source is great.
+> 5. Open source is great.
 
 ### What is this repository for?
+
 > This repository contains the following nodes of Leon:
+>
 > - The server
-> - The packages/modules
+> - Skills
 > - The web app
 > - The hotword node
+> - The TCP server (for inter-process communication between Leon and third-party nodes such as spaCy)
+> - The Python bridge (the connector between the core and skills made with Python)
 
-Sounds good for you? Then let's get started!
+### What is Leon able to do?
 
-## Getting Started
+> Today, the most interesting part is about his core and the way he can scale up. He is pretty young but can easily scale to have new features (skills).
+> You can find what he is able to do by browsing the [skills list](https://github.com/leon-ai/leon/tree/develop/skills).<br>
+> Please do know that after the official release, we will build many skills along with the community. Feel free to [join us on Discord](https://discord.gg/MNQqqKg) to be part of the journey.
+
+Sounds good to you? Then let's get started!
+
+## ☁️ Try with a Single-Click
+
+Gitpod will automatically set up an environment and run an instance for you.
+
+[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/leon-ai/leon)
+
+## 🚀 Getting Started
 
 ### Prerequisites
 
-- [Node.js](https://nodejs.org/) >= 10
-- npm >= 5
-- [Python](https://www.python.org/downloads/) 3.6.x
-- [Pipenv](https://docs.pipenv.org)
+- [Node.js](https://nodejs.org/) >= 16
+- [npm](https://npmjs.com/) >= 8
 - Supported OSes: Linux, macOS and Windows
 
 To install these prerequisites, you can follow the [How To section](https://docs.getleon.ai/how-to/) of the documentation.
@@ -66,65 +131,137 @@ To install these prerequisites, you can follow the [How To section](https://docs
 ### Installation
 
 ```sh
-# Clone the repository (stable branch)
-git clone -b master https://github.com/leon-ai/leon.git leon
-# OR download the latest release at: https://github.com/leon-ai/leon/releases/latest
+# Install the Leon CLI
+npm install --global @leon-ai/cli
 
-# Go to the project root
-cd leon
-
-# Install
-npm install
+# Install Leon (stable branch)
+leon create birth
+# OR install from the develop branch: leon create birth --develop
 ```
 
 ### Usage
 
 ```sh
 # Check the setup went well
-npm run check
-
-# Build
-npm run build
+leon check
 
 # Run
-npm start
+leon start
 
 # Go to http://localhost:1337
 # Hooray! Leon is running
 ```
 
-## Documentation
+### Docker Installation
+
+```sh
+# Install Leon
+leon create birth --docker
+
+# Run
+leon start
+
+# Go to http://localhost:1337
+# Hooray! Leon is running
+```
+
+## 📚 Documentation
 
 For full documentation, visit [docs.getleon.ai](https://docs.getleon.ai).
 
-## Roadmap
+## 📺 Video
 
-To know what is going on, follow [roadmap.getleon.ai](https://roadmap.getleon.ai).
+[Watch a demo](https://www.youtube.com/watch?v=p7GRGiicO1c).
 
-## Contributing
+## 🧭 Roadmap
 
-If you have an idea about improving Leon, do not hesitate.
+To know what is going on, follow [roadmap.getleon.ai](http://roadmap.getleon.ai).
 
-**Leon needs open-source to live**, the more modules he has, the more skillful he becomes.
+## ❤️ Contributing
 
-## Stay Tuned
-- [Newsletter](https://getleon.ai)
+If you have an idea for improving Leon, do not hesitate.
+
+**Leon needs open source to live**, the more skills he has, the more skillful he becomes.
+
+## 📖 The Story Behind Leon
+
+You'll find a write-up on this [blog post](https://blog.getleon.ai/the-story-behind-leon/).
+
+## 🔔 Stay Tuned
+
+- [Twitter](https://twitter.com/grenlouis)
+- [Newsletter](https://newsletter.getleon.ai/subscription/form)
 - [Blog](https://blog.getleon.ai)
 - [GitHub issues](https://github.com/leon-ai/leon/issues)
-- [Twitter](https://twitter.com/louistiti_fr)
-- [#LeonAI](https://twitter.com/hashtag/LeonAI)
+- [YouTube](https://www.youtube.com/channel/UCW6mk6j6nQUzFYY97r47emQ)
+- [#LeonAI](<https://twitter.com/search?f=live&q=%23LeonAI%20(from%3Agrenlouis%20OR%20from%3Alouistiti_fr)&src=typed_query>)
 
-## Author
-**Louis Grenard** ([@louistiti_fr](https://twitter.com/louistiti_fr))
+## 👨 Author
 
-## Donate
+**Louis Grenard** ([@grenlouis](https://twitter.com/grenlouis))
 
-You can also contribute by [buying me a fruit juice](https://donate.getleon.ai).
+## 👍 Sponsors
+
+<table>
+  <tbody>
+    <tr>
+      <td align="center" valign="middle" width="128">
+        <a href="https://github.com/Appwrite">
+          <img src="https://github.com/Appwrite.png?size=128" />
+          Appwrite
+        </a><br>
+        <sub><sup>250 USD / month</sup></sub>
+      </td>
+      <td align="center" valign="middle" width="128">
+        <img src="https://getleon.ai/img/anonymous.svg" width="128" />
+        Anonymous
+        <br>
+        <sub><sup>100 USD / month</sup></sub>
+      </td>
+      <td align="center" valign="middle" width="128">
+        <a href="https://github.com/herbundkraut">
+          <img src="https://github.com/herbundkraut.png?size=128" />
+          herbundkraut
+        </a><br>
+        <sub><sup>10 USD / month</sup></sub>
+      </td>
+      <td align="center" valign="middle" width="128">
+        <a href="http://sponsor.getleon.ai/">
+          You?
+        </a>
+      </td>
+    </tr>
+  </tbody>
+</table>
+
+You can also contribute by [sponsoring Leon](http://sponsor.getleon.ai).
+
+Please note that I dedicate most of my free time to Leon.
+
+By sponsoring the project you make the project sustainable and faster to develop features.
+
+The focus is not only limited to the activity you see on GitHub but also a lot of thinking about the direction of the project. Which is naturally related to the overall design, architecture, vision, learning process and so on...
+
+### Special Thanks
+
+<a href="https://vercel.com/?utm_source=leon-ai&utm_campaign=oss">
+  <img src="https://i.imgur.com/S5olXWh.png" alt="Vercel" width="128" />
+</a>
+&nbsp; &nbsp; &nbsp;
+<a href="https://www.macstadium.com/">
+  <img src="https://getleon.ai/img/thanks/mac-stadium.svg" alt="MacStadium" width="128" />
+</a>
+&nbsp; &nbsp; &nbsp;
+<a href="https://www.aoz.studio">
+  <img src="https://getleon.ai/_next/image?url=%2Fimg%2Fthanks%2Faoz-studio.png&w=384&q=75" alt="AOZ Studio" width="128" />
+</a>
+
+## 📝 License
 
-## License
 [MIT License](https://github.com/leon-ai/leon/blob/develop/LICENSE.md)
 
-Copyright (c) 2019-present, Louis Grenard <louis.grenard@gmail.com>
+Copyright (c) 2019-present, Louis Grenard <louis@getleon.ai>
 
 ## Cheers!
-![Cheers!](https://assets-cdn.github.com/images/icons/emoji/unicode/1f37b.png?v6 "Cheers!")
+
+![Cheers!](https://github.githubassets.com/images/icons/emoji/unicode/1f379.png 'Cheers!')

app/index.html

@@ -1,49 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-	<meta charset="utf-8">
-	<link rel="stylesheet" href="css/style.css">
-  <link rel="icon" type="image/png" href="img/favicon.png">
-  <title>Leon</title>
-</head>
-<body class="settingup">
-	<main>
-    <div id="feed">
-      <p id="no-bubble" class="hide">
-        You can start to interact with Leon, don't be shy.
-      </p>
-    </div>
-    <div id="is-typing">
-      <div class="circle"></div>
-      <div class="circle"></div>
-      <div class="circle"></div>
-    </div>
-    <div id="input-container">
-      <div id="mic-container">
-        <button></button>
-        <div id="sonar"></div>
-      </div>
-      <label for="query"></label>
-      <input type="text" id="query" autocomplete="off" autofocus>
-      <small>
-        Use <kbd>↑</kbd> <kbd>↓</kbd> to browse history;
-        <kbd>↵</kbd> to submit;
-        <kbd>alt + t to listen.</kbd>
-      </small>
-    </div>
-	</main>
-	<footer>
-		<div id="logo"></div>
-		<div id="version">
-			<small>v</small>
-		</div>
-    <div id="logger">
-      <small class="italic">
-        <a href="https://docs.getleon.ai/collaborative-logger.html" target="_blank">Collaborative logger</a>
-      </small>
-    </div>
-	</footer>
-	<script src="vendor/socket.io/2.0.3/socket.io.js"></script>
-	<script src="js/main.js"></script>
-</body>
-</html>

app/js/client.es6.js

@@ -1,103 +0,0 @@
-'use strict'
-
-import Chatbot from './chatbot.es6'
-
-export default class Client {
-  constructor (client, host, port, input, res) {
-    this.client = client
-    this.host = host
-    this.port = port
-    this._input = input
-    this.socket = io.connect(`http://${this.host}:${this.port}`)
-    this.history = localStorage.getItem('history')
-    this.parsedHistory = []
-    this.info = res
-    this.chatbot = new Chatbot()
-  }
-
-  set input (newInput) {
-    if (typeof newInput !== 'undefined') {
-      this._input.value = newInput
-    }
-  }
-
-  init (config) {
-    this.chatbot.init()
-
-    this.socket.on('connect', () => {
-      this.socket.emit('init', this.client)
-    })
-
-    this.socket.on('answer', (data) => {
-      this.chatbot.receivedFrom('leon', data)
-    })
-
-    this.socket.on('is-typing', (data) => {
-      this.chatbot.isTyping('leon', data)
-    })
-
-    this.socket.on('recognized', (data, cb) => {
-      this._input.value = data
-      this.send('query')
-
-      cb('string-received')
-    })
-
-    this.socket.on('audio-forwarded', (data, cb) => {
-      const ctx = new AudioContext()
-      const source = ctx.createBufferSource()
-
-      ctx.decodeAudioData(data, (buffer) => {
-        source.buffer = buffer
-
-        source.connect(ctx.destination)
-        source.start(0)
-      })
-
-      cb('audio-received')
-    })
-
-    this.socket.on('download', (data) => {
-      window.location = `http://${config.server_host}:${config.server_port}/v1/downloads?package=${data.package}&module=${data.module}`
-    })
-
-    if (this.history !== null) {
-      this.parsedHistory = JSON.parse(this.history)
-    }
-  }
-
-  send (keyword) {
-    if (this._input.value !== '') {
-      this.socket.emit(keyword, { client: this.client, value: this._input.value.trim() })
-      this.chatbot.sendTo('leon', this._input.value)
-
-      this.save()
-
-      return true
-    }
-
-    return false
-  }
-
-  save () {
-    let val = this._input.value
-
-    if (localStorage.getItem('history') === null) {
-      localStorage.setItem('history', JSON.stringify([]))
-      this.parsedHistory = JSON.parse(localStorage.getItem('history'))
-    } else if (this.parsedHistory.length >= 32) {
-      this.parsedHistory.shift()
-    }
-
-    if (val[0] === ' ') {
-      val = val.substr(1, val.length - 1)
-    }
-
-    if (this.parsedHistory[this.parsedHistory.length - 1] !== val) {
-      this.parsedHistory.push(val)
-      localStorage.setItem('history', JSON.stringify(this.parsedHistory))
-    }
-
-    this._input.value = ''
-  }
-}

app/js/loader.es6.js

@@ -1,26 +0,0 @@
-'use strict'
-
-import EventEmitter from 'events'
-
-export default class Loader {
-  constructor () {
-    this.load = new EventEmitter()
-    this.body = document.querySelector('body')
-
-    this.load.on('settingup', (state) => {
-      if (state === true) {
-        this.body.classList.add('settingup')
-      } else {
-        this.body.classList.remove('settingup')
-      }
-    })
-  }
-
-  start () {
-    this.load.emit('settingup', true)
-  }
-
-  stop () {
-    this.load.emit('settingup', false)
-  }
-}

app/js/main.es6.js

@@ -1,163 +0,0 @@
-'use strict'
-
-import request from 'superagent'
-
-import Loader from './loader.es6'
-import Client from './client.es6'
-import Recorder from './recorder.es6'
-import listener from './listener.es6'
-import { onkeydowndocument, onkeydowninput } from './onkeydown.es6'
-
-const config = {
-  app: 'webapp',
-  server_host: 'localhost',
-  server_port: 1337,
-  min_decibels: -40, // Noise detection sensitivity
-  max_blank_time: 1000 // Maximum time to consider a blank (ms)
-}
-
-document.addEventListener('DOMContentLoaded', () => {
-  const loader = new Loader()
-
-  loader.start()
-
-  request.get(`http://${config.server_host}:${config.server_port}/v1/info`)
-    .end((err, res) => {
-      if (err || !res.ok) {
-        console.error(err.response.error.message)
-      } else {
-        const input = document.querySelector('#query')
-        const mic = document.querySelector('button')
-        const v = document.querySelector('#version small')
-        const logger = document.querySelector('#logger small')
-        const client = new Client(config.app, config.server_host,
-          config.server_port, input, res.body)
-        let rec = { }
-        let chunks = []
-        let enabled = false
-        let hotwordTriggered = false
-        let autoStartedAfterTalk = false
-        let noiseDetected = false
-        let countSilenceAfterTalk = 0
-        let sLogger = ' enabled, thank you.'
-
-        v.innerHTML += client.info.version
-        if (client.info.logger === false) {
-          sLogger = ' disabled.'
-        }
-        logger.innerHTML += sLogger
-
-        client.init(config)
-
-        if (navigator.mediaDevices && navigator.mediaDevices.getUserMedia) {
-          navigator.mediaDevices.getUserMedia({ audio: true }).then((stream) => {
-            if (MediaRecorder) {
-              rec = new Recorder(stream, mic, client.info)
-
-              rec.ondataavailable((e) => {
-                chunks.push(e.data)
-              })
-
-              rec.onstart(() => { /* */ })
-
-              rec.onstop(() => {
-                const blob = new Blob(chunks)
-                chunks = []
-                enabled = false
-
-                // Ensure there are some data
-                if (blob.size >= 1000) {
-                  client.socket.emit('recognize', blob)
-                }
-              })
-
-              listener.listening(stream, config.min_decibels, config.max_blank_time, () => {
-                // Noise detected
-                noiseDetected = true
-              }, () => {
-                // Noise ended
-
-                noiseDetected = false
-                if (enabled === true && hotwordTriggered === false) {
-                  rec.stop()
-                  enabled = false
-                  hotwordTriggered = false
-                  countSilenceAfterTalk = 0
-
-                  if (client.info.after_speech === true) {
-                    // Auto enable recording after talk
-                    setTimeout(() => {
-                      rec.start(false)
-                      enabled = true
-                      autoStartedAfterTalk = true
-                    }, 500)
-                  }
-                }
-              })
-
-              if (client.info.after_speech === true) {
-                setInterval(() => {
-                  // If record after talk has started
-                  if (autoStartedAfterTalk === true && countSilenceAfterTalk <= 3) {
-                    // Stop recording if there was no noise for 3 seconds
-                    if (countSilenceAfterTalk === 3) {
-                      rec.stop(false)
-                      enabled = false
-                      autoStartedAfterTalk = false
-                      countSilenceAfterTalk = 0
-                    } else if (noiseDetected === false) {
-                      countSilenceAfterTalk += 1
-                    }
-                  }
-                }, 1000)
-              }
-
-              client.socket.on('enable-record', () => {
-                hotwordTriggered = true
-                rec.start()
-                setTimeout(() => { hotwordTriggered = false }, config.max_blank_time)
-                enabled = true
-              })
-            } else {
-              console.error('MediaRecorder is not supported on your browser.')
-            }
-          }).catch((err) => {
-            console.error('MediaDevices.getUserMedia() threw the following error:', err)
-          })
-        } else {
-          console.error('MediaDevices.getUserMedia() is not supported on your browser.')
-        }
-
-        loader.stop()
-
-        document.addEventListener('keydown', (e) => {
-          onkeydowndocument(e, () => {
-            if (enabled === false) {
-              input.value = ''
-              rec.start()
-              enabled = true
-            } else {
-              rec.stop()
-              enabled = false
-            }
-          })
-        })
-
-        input.addEventListener('keydown', (e) => {
-          onkeydowninput(e, client)
-        })
-
-        mic.addEventListener('click', (e) => {
-          e.preventDefault()
-
-          if (enabled === false) {
-            rec.start()
-            enabled = true
-          } else {
-            rec.stop()
-            enabled = false
-          }
-        })
-      }
-    })
-})

app/src/css/style.css

@@ -1,18 +1,84 @@
 @import url(https://fonts.googleapis.com/css?family=Open+Sans:400,600,700,800);
 
-html, body, div, span, applet, object, iframes,
-h1, h2, h3, h4, h5, h6, p, blockquote, pre,
-a, abbr, acronym, address, big, cite, code,
-del, dfn, em, img, ins, kbd, q, s, samp,
-small, strike, sub, sup, tt, var,
-u, i, center,
-dl, dt, dd, ol, ul, li,
-fieldset, form, label, legend,
-table, caption, tbody, tfoot, thead, tr, th, td,
-article, aside, canvas, details, embed,
-figure, figcaption, footer, header, hgroup,
-menu, nav, output, ruby, section, summary,
-time, mark, audio, video {
+html,
+body,
+div,
+span,
+applet,
+object,
+iframes,
+h1,
+h2,
+h3,
+h4,
+h5,
+h6,
+p,
+blockquote,
+pre,
+a,
+abbr,
+acronym,
+address,
+big,
+cite,
+code,
+del,
+dfn,
+em,
+img,
+ins,
+kbd,
+q,
+s,
+samp,
+small,
+strike,
+sub,
+sup,
+tt,
+var,
+u,
+i,
+center,
+dl,
+dt,
+dd,
+ol,
+ul,
+li,
+fieldset,
+form,
+label,
+legend,
+table,
+caption,
+tbody,
+tfoot,
+thead,
+tr,
+th,
+td,
+article,
+aside,
+canvas,
+details,
+embed,
+figure,
+figcaption,
+footer,
+header,
+hgroup,
+menu,
+nav,
+output,
+ruby,
+section,
+summary,
+time,
+mark,
+audio,
+video {
   margin: 0;
   padding: 0;
   border: 0;
@@ -21,17 +87,29 @@ time, mark, audio, video {
   vertical-align: baseline;
 }
 
-article, aside, details, figcaption, figure,
-footer, header, hgroup, menu, nav, section {
+article,
+aside,
+details,
+figcaption,
+figure,
+footer,
+header,
+hgroup,
+menu,
+nav,
+section {
   display: block;
 }
 
-blockquote, q {
+blockquote,
+q {
   quotes: none;
 }
 
-blockquote:before, blockquote:after,
-q:before, q:after {
+blockquote:before,
+blockquote:after,
+q:before,
+q:after {
   content: '';
   content: none;
 }
@@ -46,18 +124,29 @@ table {
   outline: none;
 }
 
+:root {
+  --black-color: #000;
+  --light-black-color: #222426;
+  --white-color: #fff;
+  --grey-color: #323739;
+}
+
 a {
   color: inherit;
 }
 
+ul li {
+  margin-left: 20px;
+}
+
 body {
-  color: #FFF;
-  background-color: #151718;
+  color: var(--white-color);
+  background-color: var(--black-color);
   font-family: 'Open Sans', sans-serif;
   font-weight: 400;
 }
 body > * {
-  transition: opacity .5s;
+  transition: opacity 0.5s;
 }
 body.settingup > * {
   opacity: 0;
@@ -72,14 +161,14 @@ body.settingup::after {
   left: 50%;
   transform: translate(-50%, -50%);
   border-radius: 50%;
-  animation: scaleout .6s infinite ease-in-out;
+  animation: scaleout 0.6s infinite ease-in-out;
 }
 @keyframes scaleout {
   0% {
     transform: scale(0);
   }
   100% {
-    transform: scale(1.0);
+    transform: scale(1);
     opacity: 0;
   }
 }
@@ -103,10 +192,10 @@ footer {
 
 input {
   text-align: center;
-  color: #FFF;
+  color: var(--white-color);
   width: 100%;
   border: none;
-  border-bottom: 2px solid #FFF;
+  border-bottom: 2px solid var(--grey-color);
   background: none;
   font-weight: 400;
   font-size: 4em;
@@ -114,8 +203,8 @@ input {
 }
 
 small {
-  color: #FFF;
-  font-size: .7em;
+  color: var(--white-color);
+  font-size: 0.7em;
 }
 
 .hide {
@@ -135,14 +224,14 @@ small {
   top: 10%;
   height: 50%;
   overflow-y: auto;
-  border: 2px solid #FFF;
+  border: 2px solid var(--grey-color);
   border-radius: 12px;
 }
 #feed::-webkit-scrollbar {
   width: 6px;
 }
 #feed::-webkit-scrollbar-thumb {
-  background-color: rgba(255, 255, 255, .2);
+  background-color: rgba(255, 255, 255, 0.2);
   border-radius: 12px;
 }
 
@@ -157,7 +246,7 @@ small {
   padding: 0 8px;
   opacity: 0;
   margin-top: 20px;
-  transition: opacity .3s;
+  transition: opacity 0.3s;
 }
 #is-typing.on {
   opacity: 1;
@@ -168,20 +257,20 @@ small {
   border-radius: 50%;
   width: 10px;
   height: 10px;
-  background-color: #FFF;
+  background-color: var(--white-color);
   transform: scale(1);
 }
 #is-typing .circle:nth-child(1) {
-  animation: typing .2s linear infinite alternate;
-  background-color: #0071F0;
+  animation: typing 0.2s linear infinite alternate;
+  background-color: #0071f0;
 }
 #is-typing .circle:nth-child(2) {
-  animation: typing .2s .2s linear infinite alternate;
-  background-color: #FFF;
+  animation: typing 0.2s 0.2s linear infinite alternate;
+  background-color: var(--white-color);
 }
 #is-typing .circle:nth-child(3) {
-  animation: typing .2s linear infinite alternate;
-  background-color: #EC297A;
+  animation: typing 0.2s linear infinite alternate;
+  background-color: #ec297a;
 }
 @keyframes typing {
   100% {
@@ -198,6 +287,17 @@ small {
 .bubble-container.leon {
   text-align: left;
 }
+.show-more {
+  margin: 3px;
+  text-decoration: underline;
+}
+.show-more:hover {
+  cursor: pointer;
+  text-decoration: none;
+}
+.show-all {
+  max-height: 100% !important;
+}
 
 .bubble {
   padding: 6px 12px;
@@ -207,16 +307,17 @@ small {
   word-break: break-word;
   text-align: left;
   opacity: 0;
-  animation: fadeIn .2s ease-in forwards;
+  animation: fadeIn 0.2s ease-in forwards;
+  overflow: hidden;
 }
 #feed .me .bubble {
-  background-color: #1C75DB;
-  color: #FFF;
+  background-color: #1c75db;
+  color: var(--white-color);
   right: 0;
 }
 #feed .leon .bubble {
-  background-color: #EEE;
-  color: #151718;
+  background-color: var(--light-black-color);
+  color: var(--white-color);
 }
 @keyframes fadeIn {
   100% {
@@ -224,10 +325,35 @@ small {
   }
 }
 
+#suggestions-container {
+  position: absolute;
+  z-index: 10;
+  width: 100%;
+  bottom: 36%;
+  display: flex;
+  justify-content: flex-end;
+  column-gap: 8px;
+  overflow-x: auto;
+}
+.suggestion {
+  border: 1px solid var(--white-color);
+  background-color: transparent;
+  color: var(--white-color);
+  border-radius: 8px;
+  padding: 2px 8px;
+  font-size: inherit;
+  cursor: pointer;
+  transition: background-color 0.2s, color 0.2s;
+}
+.suggestion:hover {
+  color: var(--black-color);
+  background-color: var(--white-color);
+}
+
 #input-container {
   position: absolute;
   width: 100%;
-  bottom: 25%;
+  bottom: 22%;
 }
 
 #mic-container {
@@ -240,7 +366,7 @@ small {
   font-style: italic;
 }
 
-button {
+#mic-button {
   position: absolute;
   border: none;
   cursor: pointer;
@@ -250,22 +376,22 @@ button {
   background-color: #888;
   -webkit-mask-image: url(../img/mic.svg);
   mask-image: url(../img/mic.svg);
-  transition: background-color .2s;
+  transition: background-color 0.2s;
 }
-button:not(.enabled) {
+#mic-button:not(.enabled) {
   margin-left: -26px;
 }
-button:hover {
-  background-color: #FFF;
+#mic-button:hover {
+  background-color: var(--white-color);
 }
-button.enabled {
-  background-color: #00E676;
+#mic-button.enabled {
+  background-color: #00e676;
 }
-button.enabled + #sonar {
+#mic-button.enabled + #sonar {
   width: 26px;
   height: 26px;
   border-radius: 50%;
-  opacity: .3;
+  opacity: 0.3;
   background-color: #575757;
   pointer-events: none;
   animation: sonar 1.3s linear infinite;

app/src/index.html

@@ -0,0 +1,53 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <link rel="stylesheet" href="/css/style.css" />
+    <link rel="icon" type="image/png" href="/img/favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Leon</title>
+  </head>
+  <body class="settingup">
+    <main>
+      <div id="root"></div>
+      <div id="feed">
+        <p id="no-bubble" class="hide">
+          You can start to interact with Leon, don't be shy.
+        </p>
+      </div>
+      <div id="suggestions-container"></div>
+      <div id="is-typing">
+        <div class="circle"></div>
+        <div class="circle"></div>
+        <div class="circle"></div>
+      </div>
+      <div id="input-container">
+        <div id="mic-container">
+          <button id="mic-button"></button>
+          <div id="sonar"></div>
+        </div>
+        <label for="utterance"></label>
+        <input type="text" id="utterance" autocomplete="off" autofocus />
+        <small>
+          Use <kbd>↑</kbd> <kbd>↓</kbd> to browse history; <kbd>↵</kbd> to
+          submit;
+          <kbd>alt + c to listen.</kbd>
+        </small>
+      </div>
+    </main>
+    <footer>
+      <div id="logo"></div>
+      <div id="version">
+        <small>v</small>
+      </div>
+      <div id="discord">
+        <small class="italic">
+          <a href="https://discord.gg/MNQqqKg" target="_blank"
+            >Join us on Discord</a
+          >
+        </small>
+      </div>
+    </footer>
+    <script type="module" src="/js/main.js"></script>
+  </body>
+</html>

app/src/js/app.tsx

@@ -0,0 +1,9 @@
+function App() {
+  return (
+    <>
+      <p>Hello from React</p>
+    </>
+  )
+}
+
+export default App

app/src/js/aurora/button.tsx

@@ -0,0 +1,9 @@
+import type React from 'react'
+
+interface Props {
+  children: React.ReactNode
+}
+
+export function Button({ children }: Props) {
+  return <button>{children}</button>
+}

app/src/js/chatbot.js

@@ -1,10 +1,8 @@
-'use strict'
-
-import EventEmitter from 'events'
+const MAXIMUM_HEIGHT_TO_SHOW_SEE_MORE = 340
 
 export default class Chatbot {
-  constructor () {
-    this.em = new EventEmitter()
+  constructor() {
+    this.et = new EventTarget()
     this.feed = document.querySelector('#feed')
     this.typing = document.querySelector('#is-typing')
     this.noBubbleMessage = document.querySelector('#no-bubble')
@@ -12,34 +10,34 @@ export default class Chatbot {
     this.parsedBubbles = JSON.parse(this.bubbles)
   }
 
-  async init () {
+  async init() {
     await this.loadFeed()
     this.scrollDown()
 
-    this.em.on('to-leon', (string) => {
-      this.createBubble('me', string)
+    this.et.addEventListener('to-leon', (event) => {
+      this.createBubble('me', event.detail)
     })
 
-    this.em.on('me-received', (string) => {
-      this.createBubble('leon', string)
+    this.et.addEventListener('me-received', (event) => {
+      this.createBubble('leon', event.detail)
     })
   }
 
-  sendTo (who, string) {
+  sendTo(who, string) {
     if (who === 'leon') {
-      this.em.emit('to-leon', string)
+      this.et.dispatchEvent(new CustomEvent('to-leon', { detail: string }))
     }
   }
 
-  receivedFrom (who, string) {
+  receivedFrom(who, string) {
     if (who === 'leon') {
-      this.em.emit('me-received', string)
+      this.et.dispatchEvent(new CustomEvent('me-received', { detail: string }))
     }
   }
 
-  isTyping (who, value) {
+  isTyping(who, value) {
     if (who === 'leon') {
-      if (value === true) {
+      if (value) {
         this.enableTyping()
       } else if (value === false) {
         this.disableTyping()
@@ -47,23 +45,26 @@ export default class Chatbot {
     }
   }
 
-  enableTyping () {
+  enableTyping() {
     if (!this.typing.classList.contains('on')) {
       this.typing.classList.add('on')
     }
   }
 
-  disableTyping () {
+  disableTyping() {
     if (this.typing.classList.contains('on')) {
       this.typing.classList.remove('on')
     }
   }
 
-  scrollDown () {
+  scrollDown() {
     this.feed.scrollTo(0, this.feed.scrollHeight)
   }
 
-  loadFeed () {
+  loadFeed() {
+    /**
+     * TODO: widget: load widget from local storage
+     */
     return new Promise((resolve) => {
       if (this.parsedBubbles === null || this.parsedBubbles.length === 0) {
         this.noBubbleMessage.classList.remove('hide')
@@ -76,7 +77,7 @@ export default class Chatbot {
 
           this.createBubble(bubble.who, bubble.string, false)
 
-          if ((i + 1) === this.parsedBubbles.length) {
+          if (i + 1 === this.parsedBubbles.length) {
             setTimeout(() => {
               resolve()
             }, 100)
@@ -86,22 +87,39 @@ export default class Chatbot {
     })
   }
 
-  createBubble (who, string, save = true) {
+  createBubble(who, string, save = true) {
     const container = document.createElement('div')
     const bubble = document.createElement('p')
 
     container.className = `bubble-container ${who}`
     bubble.className = 'bubble'
-    bubble.textContent = string
+    bubble.innerHTML = string
 
     this.feed.appendChild(container).appendChild(bubble)
 
-    if (save === true) {
+    if (container.clientHeight > MAXIMUM_HEIGHT_TO_SHOW_SEE_MORE) {
+      bubble.style.maxHeight = `${MAXIMUM_HEIGHT_TO_SHOW_SEE_MORE}px`
+      const showMore = document.createElement('p')
+      const showMoreText = 'Show more'
+
+      showMore.className = 'show-more'
+      showMore.innerHTML = showMoreText
+
+      container.appendChild(showMore)
+
+      showMore.addEventListener('click', () => {
+        bubble.classList.toggle('show-all')
+        showMore.innerHTML =
+          showMore.innerHTML === showMoreText ? 'Show less' : showMoreText
+      })
+    }
+
+    if (save) {
       this.saveBubble(who, string)
     }
   }
 
-  saveBubble (who, string) {
+  saveBubble(who, string) {
     if (!this.noBubbleMessage.classList.contains('hide')) {
       this.noBubbleMessage.classList.add('hide')
     }

app/src/js/client.js

@@ -0,0 +1,225 @@
+import { io } from 'socket.io-client'
+import React from 'react'
+import { createRoot } from 'react-dom/client'
+
+import { Button } from './aurora/button'
+import Chatbot from './chatbot'
+import { INIT_MESSAGES } from './constants'
+
+export default class Client {
+  constructor(client, serverUrl, input, res) {
+    this.client = client
+    this._input = input
+    this._suggestionContainer = document.querySelector('#suggestions-container')
+    this.serverUrl = serverUrl
+    this.socket = io(this.serverUrl)
+    this.history = localStorage.getItem('history')
+    this.parsedHistory = []
+    this.info = res
+    this.chatbot = new Chatbot()
+    this._recorder = {}
+    this._suggestions = []
+  }
+
+  set input(newInput) {
+    if (typeof newInput !== 'undefined') {
+      this._input.value = newInput
+    }
+  }
+
+  set recorder(recorder) {
+    this._recorder = recorder
+  }
+
+  get recorder() {
+    return this._recorder
+  }
+
+  async sendInitMessages() {
+    for (let i = 0; i < INIT_MESSAGES.length; i++) {
+      const messages = INIT_MESSAGES[i]
+      const message = messages[Math.floor(Math.random() * messages.length)]
+      const sendingDelay = Math.floor(Math.random() * 2000) + 1000
+      const typingFactorDelay = Math.floor(Math.random() * 4) + 2
+
+      setTimeout(() => {
+        this.chatbot.isTyping('leon', true)
+      }, sendingDelay / typingFactorDelay)
+
+      await new Promise((resolve) => setTimeout(resolve, sendingDelay))
+
+      this.chatbot.receivedFrom('leon', message)
+      this.chatbot.isTyping('leon', false)
+    }
+  }
+
+  init(loader) {
+    this.chatbot.init()
+
+    this.socket.on('connect', () => {
+      this.socket.emit('init', this.client)
+    })
+
+    this.socket.on('ready', () => {
+      loader.stop()
+
+      if (this.chatbot.parsedBubbles?.length === 0) {
+        this.sendInitMessages()
+      }
+    })
+
+    this.socket.on('answer', (data) => {
+      this.chatbot.receivedFrom('leon', data)
+    })
+
+    this.socket.on('suggest', (data) => {
+      data?.forEach((suggestionText) => {
+        this.addSuggestion(suggestionText)
+      })
+    })
+
+    this.socket.on('is-typing', (data) => {
+      this.chatbot.isTyping('leon', data)
+    })
+
+    this.socket.on('recognized', (data, cb) => {
+      this._input.value = data
+      this.send('utterance')
+
+      cb('string-received')
+    })
+
+    this.socket.on('widget', (data) => {
+      /**
+       * TODO: widget: widget handler to core/skill; dynamic component rendering
+       */
+      console.log('data', data)
+
+      const container = document.createElement('div')
+      container.className = 'widget'
+      this.chatbot.feed.appendChild(container)
+
+      const root = createRoot(container)
+
+      // TODO: widget: pass props and dynamic component loading according to type
+      const widgets = {
+        Button: (options) => {
+          return Button({
+            children: options.text
+          })
+        }
+      }
+
+      root.render(widgets[data.type](data.options))
+    })
+
+    this.socket.on('audio-forwarded', (data, cb) => {
+      const ctx = new AudioContext()
+      const source = ctx.createBufferSource()
+
+      ctx.decodeAudioData(data.buffer, (buffer) => {
+        source.buffer = buffer
+
+        source.connect(ctx.destination)
+        source.start(0)
+
+        /**
+         * When the after speech option is enabled and
+         * the answer is a final one
+         */
+        if (this.info.after_speech && data.is_final_answer) {
+          // Enable recording after the speech + 500ms
+          setTimeout(() => {
+            this._recorder.start()
+            this._recorder.enabled = true
+
+            // Check every second if the recorder is enabled to stop it
+            const id = setInterval(() => {
+              if (this._recorder.enabled) {
+                if (this._recorder.countSilenceAfterTalk <= 8) {
+                  // Stop recording if there was no noise for 8 seconds
+                  if (this._recorder.countSilenceAfterTalk === 8) {
+                    this._recorder.stop()
+                    this._recorder.enabled = false
+                    this._recorder.countSilenceAfterTalk = 0
+                    clearInterval(id)
+                  } else if (!this._recorder.noiseDetected) {
+                    this._recorder.countSilenceAfterTalk += 1
+                  } else {
+                    clearInterval(id)
+                  }
+                }
+              }
+            }, 1_000)
+          }, data.duration + 500)
+        }
+      })
+
+      cb('audio-received')
+    })
+
+    if (this.history !== null) {
+      this.parsedHistory = JSON.parse(this.history)
+    }
+  }
+
+  send(keyword) {
+    if (this._input.value !== '') {
+      this.socket.emit(keyword, {
+        client: this.client,
+        value: this._input.value.trim()
+      })
+      this.chatbot.sendTo('leon', this._input.value)
+
+      this._suggestions.forEach((suggestion) => {
+        // Remove all event listeners of the suggestion
+        suggestion.replaceWith(suggestion.cloneNode(true))
+        this._suggestionContainer.replaceChildren()
+      })
+
+      this.save()
+
+      return true
+    }
+
+    return false
+  }
+
+  save() {
+    let val = this._input.value
+
+    if (localStorage.getItem('history') === null) {
+      localStorage.setItem('history', JSON.stringify([]))
+      this.parsedHistory = JSON.parse(localStorage.getItem('history'))
+    } else if (this.parsedHistory.length >= 32) {
+      this.parsedHistory.shift()
+    }
+
+    if (val[0] === ' ') {
+      val = val.substr(1, val.length - 1)
+    }
+
+    if (this.parsedHistory[this.parsedHistory.length - 1] !== val) {
+      this.parsedHistory.push(val)
+      localStorage.setItem('history', JSON.stringify(this.parsedHistory))
+    }
+
+    this._input.value = ''
+  }
+
+  addSuggestion(text) {
+    const newSuggestion = document.createElement('button')
+    newSuggestion.classList.add('suggestion')
+    newSuggestion.textContent = text
+
+    this._suggestionContainer.appendChild(newSuggestion)
+
+    newSuggestion.addEventListener('click', (e) => {
+      e.preventDefault()
+      this.input = e.target.textContent
+      this.send('utterance')
+    })
+
+    this._suggestions.push(newSuggestion)
+  }
+}

app/src/js/constants.js

@@ -0,0 +1,21 @@
+export const INIT_MESSAGES = [
+  [
+    `Hello there! Glad to e-meet meet you, I'm Leon, your open-source personal assistant. While I'm still learning and improving, I promise to do my best to be helpful.`
+  ],
+  [
+    `<ul>
+<li>We've got lots in the works. Check out <a href="http://roadmap.getleon.ai/" target="_blank">our roadmap</a>.</li>
+<li>Stay updated on our progress by checking out our <a href="https://blog.getleon.ai/" target="_blank">blog</a>.</li>
+<li>You can also get updates straight to your inbox <a href="https://newsletter.getleon.ai/subscription/form" target="_blank">here</a>.</li>
+`
+  ],
+  [
+    `Come hang out with us <a href="https://discord.gg/MNQqqKg" target="_blank">on Discord</a>! Once we release our official version, our community will be working together to build new skills for me. You won't want to miss out on the fun!`
+  ],
+  [
+    `At the moment, I'm not using a large language model, but we're planning to incorporate some in the future to improve my abilities. You can <a href="https://github.com/leon-ai/leon#how-about-large-language-models-and-leon" target="_blank">learn more about our plans here</a>.`
+  ],
+  [
+    `Just so you know, my creator is working tirelessly to improve my skills and features, dedicating 75% of his free time to the project on top of his full-time job. If you'd like to help speed up my development, you can sponsor his work by clicking on this link: <strong><a href='http://sponsor.getleon.ai/' target='_blank'>sponsor.getleon.ai</a></strong>. Your support would mean a lot to us. Thank you for choosing me as your assistant!`
+  ]
+]

app/src/js/listener.js

@@ -1,9 +1,12 @@
-'use strict'
+const listener = {}
 
-const listener = { }
-
-listener.listening = (stream, minDecibels, maxBlankTime,
-                      cbOnStart, cbOnEnd) => {
+listener.listening = (
+  stream,
+  minDecibels,
+  maxBlankTime,
+  cbOnStart,
+  cbOnEnd
+) => {
   const ctx = new AudioContext()
   const analyser = ctx.createAnalyser()
   const streamNode = ctx.createMediaStreamSource(stream)
@@ -19,7 +22,7 @@ listener.listening = (stream, minDecibels, maxBlankTime,
 
     analyser.getByteFrequencyData(data)
 
-    if (data.some(v => v)) {
+    if (data.some((v) => v)) {
       if (triggered) {
         triggered = false
 
@@ -28,7 +31,7 @@ listener.listening = (stream, minDecibels, maxBlankTime,
       silenceStart = time
     }
 
-    if (!triggered && (time - silenceStart) > maxBlankTime) {
+    if (!triggered && time - silenceStart > maxBlankTime) {
       cbOnEnd()
 
       triggered = true

app/src/js/loader.js

@@ -0,0 +1,22 @@
+export default class Loader {
+  constructor() {
+    this.et = new EventTarget()
+    this.body = document.querySelector('body')
+
+    this.et.addEventListener('settingup', (event) => {
+      if (event.detail) {
+        this.body.classList.add('settingup')
+      } else {
+        this.body.classList.remove('settingup')
+      }
+    })
+  }
+
+  start() {
+    this.et.dispatchEvent(new CustomEvent('settingup', { detail: true }))
+  }
+
+  stop() {
+    this.et.dispatchEvent(new CustomEvent('settingup', { detail: false }))
+  }
+}

app/src/js/main.js

@@ -0,0 +1,143 @@
+import axios from 'axios'
+
+import Loader from './loader'
+import Client from './client'
+import Recorder from './recorder'
+import listener from './listener'
+import { onkeydowndocument, onkeydowninput } from './onkeydown'
+
+const config = {
+  app: 'webapp',
+  server_host: import.meta.env.VITE_LEON_HOST,
+  server_port: import.meta.env.VITE_LEON_PORT,
+  min_decibels: -40, // Noise detection sensitivity
+  max_blank_time: 1_000 // Maximum time to consider a blank (ms)
+}
+const serverUrl =
+  import.meta.env.VITE_LEON_NODE_ENV === 'production'
+    ? ''
+    : `${config.server_host}:${config.server_port}`
+
+document.addEventListener('DOMContentLoaded', async () => {
+  const loader = new Loader()
+
+  loader.start()
+
+  try {
+    const response = await axios.get(`${serverUrl}/api/v1/info`)
+    const input = document.querySelector('#utterance')
+    const mic = document.querySelector('#mic-button')
+    const v = document.querySelector('#version small')
+    const client = new Client(config.app, serverUrl, input, response.data)
+    let rec = {}
+    let chunks = []
+
+    v.innerHTML += client.info.version
+
+    client.init(loader)
+
+    if (navigator.mediaDevices && navigator.mediaDevices.getUserMedia) {
+      navigator.mediaDevices
+        .getUserMedia({ audio: true })
+        .then((stream) => {
+          if (MediaRecorder) {
+            rec = new Recorder(stream, mic, client.info)
+            client.recorder = rec
+
+            rec.ondataavailable((e) => {
+              chunks.push(e.data)
+            })
+
+            rec.onstart(() => {
+              /* */
+            })
+
+            rec.onstop(() => {
+              const blob = new Blob(chunks)
+              chunks = []
+              rec.enabled = false
+
+              // Ensure there are some data
+              if (blob.size >= 1_000) {
+                client.socket.emit('recognize', blob)
+              }
+            })
+
+            listener.listening(
+              stream,
+              config.min_decibels,
+              config.max_blank_time,
+              () => {
+                // Noise detected
+                rec.noiseDetected = true
+              },
+              () => {
+                // Noise ended
+
+                rec.noiseDetected = false
+                if (rec.enabled && !rec.hotwordTriggered) {
+                  rec.stop()
+                  rec.enabled = false
+                  rec.hotwordTriggered = false
+                  rec.countSilenceAfterTalk = 0
+                }
+              }
+            )
+
+            client.socket.on('enable-record', () => {
+              rec.hotwordTriggered = true
+              rec.start()
+              setTimeout(() => {
+                rec.hotwordTriggered = false
+              }, config.max_blank_time)
+              rec.enabled = true
+            })
+          } else {
+            console.error('MediaRecorder is not supported on your browser.')
+          }
+        })
+        .catch((err) => {
+          console.error(
+            'MediaDevices.getUserMedia() threw the following error:',
+            err
+          )
+        })
+    } else {
+      console.error(
+        'MediaDevices.getUserMedia() is not supported on your browser.'
+      )
+    }
+
+    document.addEventListener('keydown', (e) => {
+      onkeydowndocument(e, () => {
+        if (rec.enabled === false) {
+          input.value = ''
+          rec.start()
+          rec.enabled = true
+        } else {
+          rec.stop()
+          rec.enabled = false
+        }
+      })
+    })
+
+    input.addEventListener('keydown', (e) => {
+      onkeydowninput(e, client)
+    })
+
+    mic.addEventListener('click', (e) => {
+      e.preventDefault()
+
+      if (rec.enabled === false) {
+        rec.start()
+        rec.enabled = true
+      } else {
+        rec.stop()
+        rec.enabled = false
+      }
+    })
+  } catch (e) {
+    alert(`Error: ${e.message}; ${JSON.stringify(e.response?.data)}`)
+    console.error(e)
+  }
+})

app/src/js/onkeydown.js

@@ -1,5 +1,3 @@
-'use strict'
-
 let index = -1
 let parsedHistory = null
 
@@ -11,18 +9,18 @@ const onkeydowninput = (e, client) => {
   }
 
   if (key === 13) {
-    if (client.send('query')) {
+    if (client.send('utterance')) {
       parsedHistory = JSON.parse(localStorage.getItem('history')).reverse()
       index = -1
     }
   } else if (localStorage.getItem('history') !== null) {
-    if (key === 38 && index < (parsedHistory.length - 1)) {
+    if (key === 38 && index < parsedHistory.length - 1) {
       index += 1
       client.input = parsedHistory[index]
-    } else if (key === 40 && (index - 1) >= 0) {
+    } else if (key === 40 && index - 1 >= 0) {
       index -= 1
       client.input = parsedHistory[index]
-    } else if (key === 40 && (index - 1) < 0) {
+    } else if (key === 40 && index - 1 < 0) {
       client.input = ''
       index = -1
     }
@@ -30,12 +28,9 @@ const onkeydowninput = (e, client) => {
 }
 
 const onkeydowndocument = (e, cb) => {
-  if (e.altKey === true && e.key === 't') {
+  if (e.altKey && e.key === 'c') {
     cb()
   }
 }
 
-export {
-  onkeydowninput,
-  onkeydowndocument
-}
+export { onkeydowninput, onkeydowndocument }

app/src/js/recorder.js

@@ -1,16 +1,21 @@
-'use strict'
+import on from '../sounds/on.mp3'
+import off from '../sounds/off.mp3'
 
 export default class Recorder {
-  constructor (stream, el, info) {
+  constructor(stream, el, info) {
     this.recorder = new MediaRecorder(stream, { audioBitsPerSecond: 16000 })
     this.el = el
-    this.audioOn = new Audio('../sounds/on.mp3')
-    this.audioOff = new Audio('../sounds/off.mp3')
+    this.audioOn = new Audio(on)
+    this.audioOff = new Audio(off)
     this.playSound = true
     this.info = info
+    this.enabled = false
+    this.hotwordTriggered = false
+    this.noiseDetected = false
+    this.countSilenceAfterTalk = 0
   }
 
-  start (playSound = true) {
+  start(playSound = true) {
     if (this.info.stt.enabled === false) {
       console.warn('Speech-to-text disabled')
     } else {
@@ -19,7 +24,7 @@ export default class Recorder {
     }
   }
 
-  stop (playSound = true) {
+  stop(playSound = true) {
     if (this.info.stt.enabled === false) {
       console.warn('Speech-to-text disabled')
     } else {
@@ -28,9 +33,9 @@ export default class Recorder {
     }
   }
 
-  onstart (cb) {
+  onstart(cb) {
     this.recorder.onstart = (e) => {
-      if (this.playSound === true) {
+      if (this.playSound) {
         this.audioOn.play()
       }
       this.el.classList.add('enabled')
@@ -39,9 +44,9 @@ export default class Recorder {
     }
   }
 
-  onstop (cb) {
+  onstop(cb) {
     this.recorder.onstop = (e) => {
-      if (this.playSound === true) {
+      if (this.playSound) {
         this.audioOff.play()
       }
       this.el.classList.remove('enabled')
@@ -50,7 +55,7 @@ export default class Recorder {
     }
   }
 
-  ondataavailable (cb) {
+  ondataavailable(cb) {
     this.recorder.ondataavailable = (e) => {
       cb(e)
     }

app/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "useDefineForClassFields": true,
+    "skipLibCheck": true,
+    "module": "ESNext",
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx",
+
+    /* Linting */
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
+  }
+}

app/vite.config.js

@@ -0,0 +1,26 @@
+import dns from 'node:dns'
+
+import dotenv from 'dotenv'
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+dotenv.config()
+
+dns.setDefaultResultOrder('verbatim')
+
+// Map necessary Leon's env vars as Vite only expose VITE_*
+process.env.VITE_LEON_NODE_ENV = process.env.LEON_NODE_ENV
+process.env.VITE_LEON_HOST = process.env.LEON_HOST
+process.env.VITE_LEON_PORT = process.env.LEON_PORT
+
+export default defineConfig({
+  root: 'app/src',
+  build: {
+    outDir: '../dist',
+    emptyOutDir: true
+  },
+  server: {
+    port: 3000
+  },
+  plugins: [react()]
+})

bridges/nodejs/.npmrc

@@ -0,0 +1,2 @@
+package-lock=false
+save-exact=true

bridges/nodejs/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "leon-nodejs-bridge",
+  "description": "Leon's Node.js bridge to communicate between the core and skills made with JavaScript",
+  "main": "dist/bin/leon-nodejs-bridge.js",
+  "author": {
+    "name": "Louis Grenard",
+    "email": "louis@getleon.ai",
+    "url": "https://twitter.com/grenlouis"
+  },
+  "license": "MIT",
+  "homepage": "https://getleon.ai",
+  "bugs": {
+    "url": "https://github.com/leon-ai/leon/issues"
+  },
+  "dependencies": {
+    "axios": "1.4.0",
+    "lodash": "4.17.21"
+  },
+  "devDependencies": {
+    "@types/lodash": "4.14.194"
+  }
+}

bridges/nodejs/src/constants.ts

@@ -0,0 +1,32 @@
+import fs from 'node:fs'
+import path from 'node:path'
+
+import { SKILLS_PATH as SKILLS_ROOT_PATH } from '@/constants'
+import type { SkillConfigSchema } from '@server/schemas/skill-schemas'
+
+import type { IntentObject } from '@sdk/types'
+
+const {
+  argv: [, , INTENT_OBJ_FILE_PATH]
+} = process
+
+export const INTENT_OBJECT: IntentObject = JSON.parse(
+  fs.readFileSync(INTENT_OBJ_FILE_PATH as string, 'utf8')
+)
+export const SKILL_PATH = path.join(
+  SKILLS_ROOT_PATH,
+  INTENT_OBJECT.domain,
+  INTENT_OBJECT.skill
+)
+export const SKILLS_PATH = SKILLS_ROOT_PATH
+export const SKILL_CONFIG: SkillConfigSchema = JSON.parse(
+  fs.readFileSync(
+    path.join(
+      SKILL_PATH,
+      'config',
+      INTENT_OBJECT.extra_context_data.lang + '.json'
+    ),
+    'utf8'
+  )
+)
+export { LEON_VERSION, NODEJS_BRIDGE_VERSION } from '@/constants'

bridges/nodejs/src/main.ts

@@ -0,0 +1,49 @@
+import path from 'node:path'
+
+import type { ActionFunction, ActionParams } from '@sdk/types'
+import { INTENT_OBJECT } from '@bridge/constants'
+;(async (): Promise<void> => {
+  const {
+    domain,
+    skill,
+    action,
+    lang,
+    utterance,
+    current_entities,
+    entities,
+    current_resolvers,
+    resolvers,
+    slots,
+    extra_context_data
+  } = INTENT_OBJECT
+
+  const params: ActionParams = {
+    lang,
+    utterance,
+    current_entities,
+    entities,
+    current_resolvers,
+    resolvers,
+    slots,
+    extra_context_data
+  }
+
+  try {
+    const actionModule = await import(
+      path.join(
+        process.cwd(),
+        'skills',
+        domain,
+        skill,
+        'src',
+        'actions',
+        `${action}.ts`
+      )
+    )
+    const actionFunction: ActionFunction = actionModule.run
+
+    await actionFunction(params)
+  } catch (e) {
+    console.error(`Error while running "${skill}" skill "${action}" action:`, e)
+  }
+})()

bridges/nodejs/src/sdk/aurora/button.ts

@@ -0,0 +1,12 @@
+import { Widget } from '../widget'
+
+// TODO: contains the button API. rendering engine <-> SDK
+interface ButtonOptions {
+  text: string
+}
+
+export class Button extends Widget<ButtonOptions> {
+  public constructor(options: ButtonOptions) {
+    super(options)
+  }
+}

bridges/nodejs/src/sdk/leon.ts

@@ -0,0 +1,130 @@
+import type {
+  AnswerData,
+  AnswerInput,
+  AnswerOutput,
+  AnswerConfig
+} from '@sdk/types'
+import { INTENT_OBJECT, SKILL_CONFIG } from '@bridge/constants'
+
+class Leon {
+  private static instance: Leon
+
+  constructor() {
+    if (!Leon.instance) {
+      Leon.instance = this
+    }
+  }
+
+  /**
+   * Apply data to the answer
+   * @param answerKey The answer key
+   * @param data The data to apply
+   * @example setAnswerData('key', { name: 'Leon' })
+   */
+  public setAnswerData(
+    answerKey: string,
+    data: AnswerData = null
+  ): AnswerConfig {
+    try {
+      // In case the answer key is a raw answer
+      if (SKILL_CONFIG.answers == null || !SKILL_CONFIG.answers[answerKey]) {
+        return answerKey
+      }
+
+      const answers = SKILL_CONFIG.answers[answerKey] ?? ''
+      let answer: AnswerConfig
+
+      if (Array.isArray(answers)) {
+        answer = answers[Math.floor(Math.random() * answers.length)] ?? ''
+      } else {
+        answer = answers
+      }
+
+      if (data != null) {
+        for (const key in data) {
+          // In case the answer needs speech and text differentiation
+          if (typeof answer !== 'string' && answer.text) {
+            answer.text = answer.text.replaceAll(`%${key}%`, String(data[key]))
+            answer.speech = answer.speech.replaceAll(
+              `%${key}%`,
+              String(data[key])
+            )
+          } else {
+            answer = (answer as string).replaceAll(
+              `%${key}%`,
+              String(data[key])
+            )
+          }
+        }
+      }
+
+      if (SKILL_CONFIG.variables) {
+        const { variables } = SKILL_CONFIG
+
+        for (const key in variables) {
+          // In case the answer needs speech and text differentiation
+          if (typeof answer !== 'string' && answer.text) {
+            answer.text = answer.text.replaceAll(
+              `%${key}%`,
+              String(variables[key])
+            )
+            answer.speech = answer.speech.replaceAll(
+              `%${key}%`,
+              String(variables[key])
+            )
+          } else {
+            answer = (answer as string).replaceAll(
+              `%${key}%`,
+              String(variables[key])
+            )
+          }
+        }
+      }
+
+      return answer
+    } catch (e) {
+      console.error('Error while setting answer data:', e)
+
+      throw e
+    }
+  }
+
+  /**
+   * Send an answer to the core
+   * @param answerInput The answer input
+   * @example answer({ key: 'greet' }) // 'Hello world'
+   * @example answer({ key: 'welcome', data: { name: 'Louis' } }) // 'Welcome Louis'
+   * @example answer({ key: 'confirm', core: { restart: true } }) // 'Would you like to retry?'
+   */
+  public async answer(answerInput: AnswerInput): Promise<void> {
+    try {
+      const answerObject: AnswerOutput = {
+        ...INTENT_OBJECT,
+        output: {
+          codes:
+            answerInput.widget && !answerInput.key
+              ? 'widget'
+              : (answerInput.key as string),
+          answer:
+            answerInput.key != null
+              ? this.setAnswerData(answerInput.key, answerInput.data)
+              : '',
+          core: answerInput.core
+        }
+      }
+
+      if (answerInput.widget) {
+        answerObject.output.widget = answerInput.widget
+      }
+
+      // "Temporize" for the data buffer output on the core
+      await new Promise((r) => setTimeout(r, 100))
+
+      process.stdout.write(JSON.stringify(answerObject))
+    } catch (e) {
+      console.error('Error while creating answer:', e)
+    }
+  }
+}
+
+export const leon = new Leon()

bridges/nodejs/src/sdk/memory.ts

@@ -0,0 +1,99 @@
+import path from 'node:path'
+import fs from 'node:fs'
+
+import { SKILL_PATH, SKILLS_PATH } from '@bridge/constants'
+
+interface MemoryOptions<T> {
+  name: string
+  defaultMemory?: T
+}
+
+export class Memory<T = unknown> {
+  private readonly memoryPath: string
+  private readonly name: string
+  private readonly defaultMemory: T | undefined
+  private isFromAnotherSkill: boolean
+
+  constructor(options: MemoryOptions<T>) {
+    const { name, defaultMemory } = options
+
+    this.name = name
+    this.defaultMemory = defaultMemory
+    this.memoryPath = path.join(SKILL_PATH, 'memory', `${this.name}.json`)
+    this.isFromAnotherSkill = false
+
+    if (this.name.includes(':') && this.name.split(':').length === 3) {
+      this.isFromAnotherSkill = true
+      const [domainName, skillName, memoryName] = this.name.split(':')
+      this.memoryPath = path.join(
+        SKILLS_PATH,
+        domainName as string,
+        skillName as string,
+        'memory',
+        `${memoryName}.json`
+      )
+    }
+  }
+
+  /**
+   * Clear the memory and set it to the default memory value
+   * @example clear()
+   */
+  public async clear(): Promise<void> {
+    if (!this.isFromAnotherSkill) {
+      await this.write(this.defaultMemory as T)
+    } else {
+      throw new Error(
+        `You cannot clear the memory "${this.name}" as it belongs to another skill`
+      )
+    }
+  }
+
+  /**
+   * Read the memory
+   * @example read()
+   */
+  public async read(): Promise<T> {
+    if (this.isFromAnotherSkill && !fs.existsSync(this.memoryPath)) {
+      throw new Error(
+        `You cannot read the memory "${this.name}" as it belongs to another skill which haven't written to this memory yet`
+      )
+    }
+
+    try {
+      if (!fs.existsSync(this.memoryPath)) {
+        await this.clear()
+      }
+
+      return JSON.parse(await fs.promises.readFile(this.memoryPath, 'utf-8'))
+    } catch (e) {
+      console.error(`Error while reading memory for "${this.name}":`, e)
+      throw e
+    }
+  }
+
+  /**
+   * Write the memory
+   * @param memory The memory to write
+   * @example write({ foo: 'bar' }) // { foo: 'bar' }
+   */
+  public async write(memory: T): Promise<T> {
+    if (!this.isFromAnotherSkill) {
+      try {
+        await fs.promises.writeFile(
+          this.memoryPath,
+          JSON.stringify(memory, null, 2)
+        )
+
+        return memory
+      } catch (e) {
+        console.error(`Error while writing memory for "${this.name}":`, e)
+        throw e
+      }
+    } else {
+      throw new Error(
+        `You cannot write into the memory "${this.name}" as it belongs to another skill`
+      )
+    }
+  }
+}

bridges/nodejs/src/sdk/network.ts

@@ -0,0 +1,147 @@
+import dns from 'node:dns'
+
+import type { AxiosInstance } from 'axios'
+import axios from 'axios'
+
+import { LEON_VERSION, NODEJS_BRIDGE_VERSION } from '@bridge/constants'
+
+interface NetworkOptions {
+  /** `baseURL` will be prepended to `url`. It can be convenient to set `baseURL` for an instance of `Network` to pass relative URLs. */
+  baseURL?: string
+}
+
+interface NetworkRequestOptions {
+  /** Server URL that will be used for the request. */
+  url: string
+
+  /** Request method to be used when making the request. */
+  method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
+
+  /** Data to be sent as the request body. */
+  data?: Record<string, unknown>
+
+  /** Custom headers to be sent. */
+  headers?: Record<string, string>
+}
+
+interface NetworkResponse<ResponseData> {
+  /** Data provided by the server. */
+  data: ResponseData
+
+  /** HTTP status code from the server response. */
+  statusCode: number
+
+  /** Options that was provided for the request. */
+  options: NetworkRequestOptions & NetworkOptions
+}
+
+export class NetworkError<ResponseErrorData = unknown> extends Error {
+  public readonly response: NetworkResponse<ResponseErrorData>
+
+  public constructor(response: NetworkResponse<ResponseErrorData>) {
+    super(`[NetworkError]: ${response.statusCode} ${response.data}`)
+    this.response = response
+    Object.setPrototypeOf(this, NetworkError.prototype)
+  }
+}
+
+export class Network {
+  private readonly options: NetworkOptions
+  private axios: AxiosInstance
+
+  public constructor(options: NetworkOptions = {}) {
+    this.options = options
+    this.axios = axios.create({
+      baseURL: this.options.baseURL
+    })
+  }
+
+  /**
+   * Send HTTP request
+   * @param options Request options
+   * @example request({ url: '/send', method: 'POST', data: { message: 'Hi' } })
+   */
+  public async request<ResponseData = unknown, ResponseErrorData = unknown>(
+    options: NetworkRequestOptions
+  ): Promise<NetworkResponse<ResponseData>> {
+    try {
+      const response = await this.axios.request<string>({
+        url: options.url,
+        method: options.method.toLowerCase(),
+        data: options.data,
+        transformResponse: (data) => {
+          return data
+        },
+        headers: {
+          'User-Agent': `Leon Personal Assistant ${LEON_VERSION} - Node.js Bridge ${NODEJS_BRIDGE_VERSION}`,
+          ...options.headers
+        }
+      })
+
+      let data = {} as ResponseData
+      try {
+        data = JSON.parse(response.data)
+      } catch {
+        data = response.data as ResponseData
+      }
+
+      return {
+        data,
+        statusCode: response.status,
+        options: {
+          ...this.options,
+          ...options
+        }
+      }
+    } catch (error) {
+      let statusCode = 500
+      let dataRawText = ''
+
+      if (axios.isAxiosError(error)) {
+        dataRawText = error?.response?.data ?? ''
+        statusCode = error?.response?.status ?? 500
+      }
+
+      let data: ResponseErrorData
+      try {
+        data = JSON.parse(dataRawText)
+      } catch {
+        data = dataRawText as ResponseErrorData
+      }
+
+      throw new NetworkError<ResponseErrorData>({
+        data,
+        statusCode,
+        options: {
+          ...this.options,
+          ...options
+        }
+      })
+    }
+  }
+
+  /**
+   * Check if error is a network error
+   * @param error Error to check
+   * @example isNetworkError(error) // false
+   */
+  public isNetworkError<ResponseErrorData = unknown>(
+    error: unknown
+  ): error is NetworkError<ResponseErrorData> {
+    return error instanceof NetworkError
+  }
+
+  /**
+   * Verify whether there is an Internet connectivity
+   * @example isNetworkAvailable() // true
+   */
+  public async isNetworkAvailable(): Promise<boolean> {
+    try {
+      await dns.promises.resolve('getleon.ai')
+
+      return true
+    } catch {
+      return false
+    }
+  }
+}

bridges/nodejs/src/sdk/packages/lodash.ts

@@ -0,0 +1 @@
+export { default } from 'lodash'

bridges/nodejs/src/sdk/settings.ts

@@ -0,0 +1,125 @@
+import path from 'node:path'
+import fs from 'node:fs'
+
+import { SKILL_PATH } from '@bridge/constants'
+
+export class Settings<T extends Record<string, unknown>> {
+  private readonly settingsPath: string
+  private readonly settingsSamplePath: string
+
+  public constructor() {
+    this.settingsPath = path.join(SKILL_PATH, 'src', 'settings.json')
+    this.settingsSamplePath = path.join(
+      SKILL_PATH,
+      'src',
+      'settings.sample.json'
+    )
+  }
+
+  /**
+   * Check if a setting is already set
+   * @param key The key to verify whether its value is set
+   * @returns isSettingSet('apiKey') // true
+   */
+  public async isSettingSet(key: string): Promise<boolean> {
+    const settingsSample = await this.getSettingsSample()
+    const settings = await this.get()
+
+    return (
+      !!settings[key] &&
+      JSON.stringify(settings[key]) !== JSON.stringify(settingsSample[key])
+    )
+  }
+
+  /**
+   * Clear the settings and set it to the default settings.sample.json file
+   * @example clear()
+   */
+  public async clear(): Promise<void> {
+    const settingsSample = await this.getSettingsSample()
+
+    await this.set(settingsSample)
+  }
+
+  private async getSettingsSample(): Promise<T> {
+    try {
+      return JSON.parse(
+        await fs.promises.readFile(this.settingsSamplePath, 'utf8')
+      )
+    } catch (e) {
+      console.error(
+        `Error while reading settings sample at "${this.settingsSamplePath}":`,
+        e
+      )
+
+      throw e
+    }
+  }
+
+  /**
+   * Get the settings
+   * @param key The key of the setting to get
+   * @example get('API_KEY') // 'value'
+   * @example get() // { API_KEY: 'value' }
+   */
+  public async get<Key extends keyof T>(key: Key): Promise<T[Key]>
+  public async get(): Promise<T>
+  public async get<Key extends keyof T>(key?: Key): Promise<T | T[Key]> {
+    try {
+      if (!fs.existsSync(this.settingsPath)) {
+        await this.clear()
+      }
+
+      const settings = JSON.parse(
+        await fs.promises.readFile(this.settingsPath, 'utf8')
+      )
+
+      if (key != null) {
+        return settings[key]
+      }
+
+      return settings
+    } catch (e) {
+      console.error(
+        `Error while reading settings at "${this.settingsPath}":`,
+        e
+      )
+      throw e
+    }
+  }
+
+  /**
+   * Set the settings
+   * @param key The key of the setting to set
+   * @param value The value of the setting to set
+   * @example set({ API_KEY: 'value' }) // { API_KEY: 'value' }
+   */
+  public async set<Key extends keyof T>(key: Key, value: T[Key]): Promise<T>
+  public async set(settings: T): Promise<T>
+  public async set<Key extends keyof T>(
+    keyOrSettings: Key | T,
+    value?: T[Key]
+  ): Promise<T> {
+    try {
+      const settings = await this.get()
+      const newSettings =
+        typeof keyOrSettings === 'object'
+          ? keyOrSettings
+          : { ...settings, [keyOrSettings]: value }
+
+      await fs.promises.writeFile(
+        this.settingsPath,
+        JSON.stringify(newSettings, null, 2)
+      )
+
+      return newSettings
+    } catch (e) {
+      console.error(
+        `Error while writing settings at "${this.settingsPath}":`,
+        e
+      )
+
+      throw e
+    }
+  }
+}

bridges/nodejs/src/sdk/types.ts

@@ -0,0 +1,37 @@
+/**
+ * Action types
+ */
+import type {
+  ActionParams,
+  IntentObject,
+  SkillAnswerCoreData,
+  SkillAnswerOutput
+} from '@/core/brain/types'
+import type { SkillAnswerConfigSchema } from '@/schemas/skill-schemas'
+
+export type { ActionParams, IntentObject }
+
+export * from '@/core/nlp/types'
+
+export type ActionFunction = (params: ActionParams) => Promise<void>
+
+/**
+ * Answer types
+ */
+export interface Answer {
+  key?: string
+  widget?: unknown // TODO
+  data?: AnswerData
+  core?: SkillAnswerCoreData
+}
+export interface TextAnswer extends Answer {
+  key: string
+}
+export interface WidgetAnswer extends Answer {
+  widget: unknown
+  key?: string
+}
+export type AnswerData = Record<string, string | number> | null
+export type AnswerInput = TextAnswer | WidgetAnswer
+export type AnswerOutput = SkillAnswerOutput
+export type AnswerConfig = SkillAnswerConfigSchema

bridges/nodejs/src/sdk/widget.ts

@@ -0,0 +1,9 @@
+export abstract class Widget<T> {
+  public readonly type: string
+  public readonly options: T
+
+  protected constructor(options: T) {
+    this.type = this.constructor.name
+    this.options = options
+  }
+}

bridges/nodejs/src/version.ts

@@ -0,0 +1 @@
+export const VERSION = '1.1.0'

bridges/nodejs/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist/bin",
+    "rootDir": "../../",
+    "baseUrl": ".",
+    "paths": {
+      "@@/*": ["../../*"],
+      "@/*": ["../../server/src/*"],
+      "@server/*": ["../../server/src/*"],
+      "@bridge/*": ["./src/*"],
+      "@sdk/*": ["./src/sdk/*"]
+    },
+    "exactOptionalPropertyTypes": false,
+    "declaration": true
+  },
+  "ts-node": {
+    "swc": true,
+    "require": ["tsconfig-paths/register"],
+    "files": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

bridges/python/Pipfile

@@ -1,14 +0,0 @@
-[[source]]
-url = "https://pypi.org/simple"
-verify_ssl = true
-name = "pypi"
-
-[packages]
-requests = "==2.21.0"
-pytube = "==9.2.2"
-tinydb = "==3.9.0"
-
-[dev-packages]
-
-[requires]
-python_version = "3.6"

bridges/python/Pipfile.lock

@@ -1,73 +0,0 @@
-{
-    "_meta": {
-        "hash": {
-            "sha256": "ef69fb486898e1db2c2908e9b67e156c99e6a7ddaccad88881a5e8f36edd162e"
-        },
-        "pipfile-spec": 6,
-        "requires": {
-            "python_version": "3.6"
-        },
-        "sources": [
-            {
-                "name": "pypi",
-                "url": "https://pypi.org/simple",
-                "verify_ssl": true
-            }
-        ]
-    },
-    "default": {
-        "certifi": {
-            "hashes": [
-                "sha256:47f9c83ef4c0c621eaef743f133f09fa8a74a9b75f037e8624f83bd1b6626cb7",
-                "sha256:993f830721089fef441cdfeb4b2c8c9df86f0c63239f06bd025a76a7daddb033"
-            ],
-            "version": "==2018.11.29"
-        },
-        "chardet": {
-            "hashes": [
-                "sha256:84ab92ed1c4d4f16916e05906b6b75a6c0fb5db821cc65e70cbd64a3e2a5eaae",
-                "sha256:fc323ffcaeaed0e0a02bf4d117757b98aed530d9ed4531e3e15460124c106691"
-            ],
-            "version": "==3.0.4"
-        },
-        "idna": {
-            "hashes": [
-                "sha256:c357b3f628cf53ae2c4c05627ecc484553142ca23264e593d327bcde5e9c3407",
-                "sha256:ea8b7f6188e6fa117537c3df7da9fc686d485087abf6ac197f9c46432f7e4a3c"
-            ],
-            "version": "==2.8"
-        },
-        "pytube": {
-            "hashes": [
-                "sha256:29e91b4809d55a89e68a29f894297c13d3199be05e848713bb1eaa72771f00be",
-                "sha256:bb0b1d62a8181cb0adb14c42f81f2f6bca733ba3759745e1b223ea01b4fac3b0"
-            ],
-            "index": "pypi",
-            "version": "==9.2.2"
-        },
-        "requests": {
-            "hashes": [
-                "sha256:502a824f31acdacb3a35b6690b5fbf0bc41d63a24a45c4004352b0242707598e",
-                "sha256:7bf2a778576d825600030a110f3c0e3e8edc51dfaafe1c146e39a2027784957b"
-            ],
-            "index": "pypi",
-            "version": "==2.21.0"
-        },
-        "tinydb": {
-            "hashes": [
-                "sha256:67b3b302fc86e0139db545d5abd65bf0e1dadaecee63bd1ff3fe2169810d5387",
-                "sha256:e7d939c52710ee4354bb619b9bed05ae6192645f1520f13d8fcf4f06b5590e02"
-            ],
-            "index": "pypi",
-            "version": "==3.9.0"
-        },
-        "urllib3": {
-            "hashes": [
-                "sha256:61bf29cada3fc2fbefad4fdf059ea4bd1b4a86d2b6d15e1c7c0b582b9752fe39",
-                "sha256:de9529817c93f27c8ccbfead6985011db27bd0ddfcdb2d86f3f663385c6a9c22"
-            ],
-            "version": "==1.24.1"
-        }
-    },
-    "develop": {}
-}

bridges/python/main.py

@@ -1,23 +0,0 @@
-#!/usr/bin/env python
-# -*- coding:utf-8 -*-
-
-import utils
-from sys import argv, path
-from json import dumps
-from importlib import import_module
-
-def main():
-	"""Dynamically import modules related to the args and print the ouput"""
-
-	path.append('.')
-
-	lang = argv[1]
-	package = argv[2]
-	module = argv[3]
-	string = argv[4]
-	m = import_module('packages.' + package + '.' + module)
-
-	return getattr(m, module)(string)
-
-if __name__ == '__main__':
-	main()

bridges/python/src/Pipfile

@@ -0,0 +1,14 @@
+[[source]]
+url = "https://pypi.org/simple"
+verify_ssl = true
+name = "pypi"
+
+[requires]
+python_version = "3.9.10"
+
+[packages]
+setuptools = "*"
+wheel = "*"
+cx-freeze = "==6.11.1"
+requests = "==2.28.1"
+beautifulsoup4 = "==4.7.1"

bridges/python/src/constants.py

@@ -0,0 +1,30 @@
+import sys
+import json
+import os
+
+import version
+
+INTENT_OBJ_FILE_PATH = sys.argv[1]
+
+with open(INTENT_OBJ_FILE_PATH, 'r') as f:
+    INTENT_OBJECT = json.load(f)
+
+SKILLS_ROOT_PATH = os.path.join(
+    os.getcwd(),
+    'skills'
+)
+
+SKILL_PATH = os.path.join(
+    SKILLS_ROOT_PATH,
+    INTENT_OBJECT['domain'],
+    INTENT_OBJECT['skill']
+)
+
+SKILLS_PATH = SKILLS_ROOT_PATH
+
+with open(os.path.join(SKILL_PATH, 'config', INTENT_OBJECT['extra_context_data']['lang'] + '.json'), 'r') as f:
+    SKILL_CONFIG = json.load(f)
+
+LEON_VERSION = os.getenv('npm_package_version')
+
+PYTHON_BRIDGE_VERSION = version.__version__

bridges/python/src/main.py

@@ -0,0 +1,44 @@
+import sys
+from traceback import print_exc
+from importlib import import_module
+
+from constants import INTENT_OBJECT
+
+
+def main():
+    params = {
+        'lang': INTENT_OBJECT['lang'],
+        'utterance': INTENT_OBJECT['utterance'],
+        'current_entities': INTENT_OBJECT['current_entities'],
+        'entities': INTENT_OBJECT['entities'],
+        'current_resolvers': INTENT_OBJECT['current_resolvers'],
+        'resolvers': INTENT_OBJECT['resolvers'],
+        'slots': INTENT_OBJECT['slots'],
+        'extra_context_data': INTENT_OBJECT['extra_context_data']
+    }
+
+    try:
+        sys.path.append('.')
+
+        skill_action_module = import_module(
+            'skills.'
+            + INTENT_OBJECT['domain']
+            + '.'
+            + INTENT_OBJECT['skill']
+            + '.src.actions.'
+            + INTENT_OBJECT['action']
+        )
+
+        getattr(skill_action_module, 'run')(params)
+    except Exception as e:
+        print(f"Error while running {INTENT_OBJECT['skill']} skill {INTENT_OBJECT['action']} action: {e}")
+        print_exc()
+
+
+if __name__ == '__main__':
+    try:
+        raise main()
+    except Exception as e:
+        # Print full traceback error report if skills triggers an error from the call stack
+        if 'exceptions must derive from BaseException' not in str(e):
+            print_exc()

bridges/python/src/sdk/aurora/button.py

@@ -0,0 +1,9 @@
+from ..widget import Widget
+
+
+# TODO: contains the button API. rendering engine <-> SDK
+
+
+class Button(Widget):
+    def __init__(self, options):
+        super().__init__(options)

bridges/python/src/sdk/leon.py

@@ -0,0 +1,92 @@
+import random
+import sys
+from typing import Union
+from time import sleep
+import json
+
+from .types import AnswerInput, AnswerData, AnswerConfig
+from ..constants import SKILL_CONFIG, INTENT_OBJECT
+
+
+class Leon:
+    instance: 'Leon' = None
+
+    def __init__(self) -> None:
+        if not Leon.instance:
+            Leon.instance = self
+
+    @staticmethod
+    def set_answer_data(answer_key: str, data: Union[AnswerData, None] = None) -> Union[str, AnswerConfig]:
+        """
+        Apply data to the answer
+        :param answer_key: The answer key
+        :param data: The data to apply
+        """
+        try:
+            # In case the answer key is a raw answer
+            if SKILL_CONFIG.get('answers') is None or SKILL_CONFIG['answers'].get(answer_key) is None:
+                return answer_key
+
+            answers = SKILL_CONFIG['answers'].get(answer_key, '')
+            if isinstance(answers, list):
+                answer = answers[random.randrange(len(answers))]
+            else:
+                answer = answers
+
+            if data:
+                for key, value in data.items():
+                    # In case the answer needs speech and text differentiation
+                    if not isinstance(answer, str) and answer.get('text'):
+                        answer['text'] = answer['text'].replace('%{}%'.format(key), str(value))
+                        answer['speech'] = answer['speech'].replace('%{}%'.format(key), str(value))
+                    else:
+                        answer = answer.replace('%{}%'.format(key), str(value))
+
+            if SKILL_CONFIG.get('variables'):
+                for key, value in SKILL_CONFIG['variables'].items():
+                    # In case the answer needs speech and text differentiation
+                    if not isinstance(answer, str) and answer.get('text'):
+                        answer['text'] = answer['text'].replace('%{}%'.format(key), str(value))
+                        answer['speech'] = answer['speech'].replace('%{}%'.format(key), str(value))
+                    else:
+                        answer = answer.replace('%{}%'.format(key), str(value))
+
+            return answer
+        except Exception as e:
+            print('Error while setting answer data:', e)
+            raise e
+
+    def answer(self, answer_input: AnswerInput) -> None:
+        """
+        Send an answer to the core
+        :param answer_input: The answer input
+        """
+        try:
+            key = answer_input.get('key')
+            output = {
+                'output': {
+                    'codes': 'widget' if answer_input.get('widget') and not answer_input.get('key') else answer_input.get('key'),
+                    'answer': self.set_answer_data(key, answer_input.get('data')) if key is not None else '',
+                    'core': answer_input.get('core')
+                }
+            }
+
+            if answer_input.get('widget'):
+                output['output']['widget'] = answer_input['widget'].__dict__
+
+            answer_object = {
+                **INTENT_OBJECT,
+                **output
+            }
+
+            # "Temporize" for the data buffer output on the core
+            sleep(0.1)
+
+            sys.stdout.write(json.dumps(answer_object))
+            sys.stdout.flush()
+
+        except Exception as e:
+            print('Error while creating answer:', e)
+
+
+leon = Leon()

bridges/python/src/sdk/memory.py

@@ -0,0 +1,76 @@
+import json
+import os
+from typing import TypedDict, Any
+
+from ..constants import SKILL_PATH, SKILLS_PATH
+
+
+class MemoryOptions(TypedDict, total=False):
+    name: str
+    default_memory: Any
+
+
+class Memory:
+    def __init__(self, options: MemoryOptions):
+        self.name = options['name']
+        self.default_memory = options['default_memory'] if 'default_memory' in options else None
+        self.memory_path = self.memory_path = os.path.join(
+            SKILL_PATH,
+            'memory',
+            f'{self.name}.json'
+        )
+        self.__is_from_another_skill = False
+
+        if ':' in self.name and self.name.count(':') == 2:
+            self.__is_from_another_skill = True
+            domain_name, skill_name, memory_name = self.name.split(':')
+            self.memory_path = os.path.join(
+                SKILLS_PATH,
+                domain_name,
+                skill_name,
+                'memory',
+                memory_name + '.json'
+            )
+
+    def clear(self) -> None:
+        """
+        Clear the memory and set it to the default memory value
+        """
+        if not self.__is_from_another_skill:
+            self.write(self.default_memory)
+        else:
+            raise ValueError(f'You cannot clear the memory "{self.name}" as it belongs to another skill')
+
+    def read(self):
+        """
+        Read the memory
+        """
+        if self.__is_from_another_skill and not os.path.exists(self.memory_path):
+            raise ValueError(f'You cannot read the memory "{self.name}" as it belongs to another skill which hasn\'t written to this memory yet')
+
+        try:
+            if not os.path.exists(self.memory_path):
+                self.clear()
+
+            with open(self.memory_path, 'r') as f:
+                return json.load(f)
+        except Exception as e:
+            print(f'Error while reading memory for "{self.name}": {e}')
+            raise e
+
+    def write(self, memory):
+        """
+        Write the memory
+        :param memory: The memory to write
+        """
+        if not self.__is_from_another_skill:
+            try:
+                with open(self.memory_path, 'w') as f:
+                    json.dump(memory, f, indent=2)
+
+                return memory
+            except Exception as e:
+                print(f'Error while writing memory for "{self.name}": {e}')
+                raise e
+        else:
+            raise ValueError(f'You cannot write into the memory "{self.name}" as it belongs to another skill')

bridges/python/src/sdk/network.py

@@ -0,0 +1,92 @@
+import requests
+import socket
+from typing import Any, Dict, TypedDict, Union, Literal, Optional
+
+from ..constants import LEON_VERSION, PYTHON_BRIDGE_VERSION
+
+
+class NetworkOptions(TypedDict, total=False):
+    base_url: Optional[str]
+
+
+class NetworkResponse(TypedDict):
+    data: Any
+    status_code: int
+    options: Dict[str, Any]
+
+
+class NetworkError(Exception):
+    def __init__(self, response: NetworkResponse) -> None:
+        self.response = response
+        super().__init__(f"[NetworkError]: {response['status_code']} {response['data']}")
+
+
+class NetworkRequestOptions(TypedDict, total=False):
+    url: str
+    method: Union[Literal['GET'], Literal['POST'], Literal['PUT'], Literal['PATCH'], Literal['DELETE']]
+    data: Dict[str, Any]
+    headers: Dict[str, str]
+
+
+class Network:
+    def __init__(self, options: NetworkOptions = {'base_url': None}) -> None:
+        self.options = options
+
+    def request(self, options: NetworkRequestOptions) -> NetworkResponse:
+        try:
+            url = options['url']
+
+            if self.options['base_url'] is not None:
+                url = self.options['base_url'] + url
+            method = options['method']
+            data = options.get('data', {})
+            headers = options.get('headers', {})
+            response = requests.request(
+                method,
+                url,
+                json=data,
+                headers={
+                    'User-Agent': f"Leon Personal Assistant {LEON_VERSION} - Python Bridge {PYTHON_BRIDGE_VERSION}",
+                    **headers
+                }
+            )
+
+            data = {}
+            try:
+                data = response.json()
+            except Exception:
+                data = response.text
+
+            network_response: NetworkResponse = {
+                'data': data,
+                'status_code': response.status_code,
+                'options': {**self.options, **options}
+            }
+
+            if response.ok:
+                return network_response
+            else:
+                raise NetworkError(network_response)
+        except requests.exceptions.RequestException as error:
+            data = {}
+            try:
+                data = error.response.json()
+            except Exception:
+                data = error.response.text
+
+            raise NetworkError({
+                'data': data,
+                'status_code': error.response.status_code,
+                'options': {**self.options, **options}
+            }) from error
+
+    def is_network_error(self, error: Exception) -> bool:
+        return isinstance(error, NetworkError)
+
+    def is_network_available(self) -> bool:
+        try:
+            socket.gethostbyname('getleon.ai')
+
+            return True
+        except socket.error:
+            return False

bridges/python/src/sdk/settings.py

@@ -0,0 +1,91 @@
+import json
+import os
+from os import path
+from typing import Union, Any, overload
+
+from ..constants import SKILL_PATH
+
+
+class Settings:
+    def __init__(self):
+        self.settings_path = path.join(SKILL_PATH, 'src', 'settings.json')
+        self.settings_sample_path = path.join(SKILL_PATH, 'src', 'settings.sample.json')
+
+    def is_setting_set(self, key: str) -> bool:
+        """
+        Check if a setting is already set
+        :param key: The key to verify whether its value is set
+        """
+        settings_sample = self.get_settings_sample()
+        settings = self.get()
+
+        return key in settings and json.dumps(settings[key]) != json.dumps(settings_sample[key])
+
+    def clear(self) -> None:
+        """
+        Clear the settings and set it to the default settings.sample.json file
+        """
+        settings_sample = self.get_settings_sample()
+        self.set(settings_sample)
+
+    def get_settings_sample(self) -> dict[str, Any]:
+        try:
+            with open(self.settings_sample_path, 'r') as file:
+                return json.load(file)
+        except Exception as e:
+            print(f"Error while reading settings sample at '{self.settings_sample_path}': {e}")
+            raise e
+
+    @overload
+    def get(self, key: str) -> Any: ...
+
+    @overload
+    def get(self, key: None = None) -> dict[str, Any]: ...
+
+    def get(self, key: Union[str, None] = None) -> Union[dict[str, Any], Any]:
+        """
+        Get the settings
+        :param key: The key to get from the settings
+        """
+        try:
+            if not os.path.exists(self.settings_path):
+                self.clear()
+
+            with open(self.settings_path, 'r') as file:
+                settings = json.load(file)
+
+                if key is not None:
+                    return settings[key]
+
+                return settings
+        except Exception as e:
+            print(f"Error while reading settings at '{self.settings_path}': {e}")
+            raise e
+
+    @overload
+    def set(self, key_or_settings: dict[str, Any]) -> dict[str, Any]: ...
+
+    @overload
+    def set(self, key_or_settings: str, value: Any) -> dict[str, Any]: ...
+
+    def set(self, key_or_settings: Union[str, dict[str, Any]], value: Any = None) -> dict[str, Any]:
+        """
+        Set the settings
+        :param key_or_settings: The key to set or the settings to set
+        :param value: The value to set
+        """
+        try:
+            settings = self.get()
+
+            if isinstance(key_or_settings, dict):
+                new_settings = key_or_settings
+            else:
+                new_settings = {**settings, key_or_settings: value}
+
+            with open(self.settings_path, 'w') as file:
+                json.dump(new_settings, file, indent=2)
+
+            return new_settings
+        except Exception as e:
+            print(f"Error while writing settings at '{self.settings_path}': {e}")
+            raise e

bridges/python/src/sdk/types.py

@@ -0,0 +1,49 @@
+from typing import Dict, Any, Optional, Union, Literal, TypedDict
+
+
+class NLUResultSentiment(TypedDict):
+    vote: Optional[Union[Literal['positive'], Literal['neutral'], Literal['negative']]]
+    score: Optional[float]
+
+
+class ExtraContextData(TypedDict):
+    lang: str
+    sentiment: str
+    date: str
+    time: str
+    timestamp: int
+    date_time: str
+    week_day: str
+
+
+class ActionParams(TypedDict):
+    lang: str
+    utterance: str
+    current_entities: list[Any]
+    entities: list[Any]
+    current_resolvers: list[Any]
+    resolvers: list[Any]
+    slots: Dict[str, Any]
+    extra_context_data: ExtraContextData
+
+
+AnswerData = Optional[Union[Dict[str, Union[str, int]], None]]
+
+
+class Answer(TypedDict):
+    key: Optional[str]
+    widget: Optional[Any]
+    data: Optional[AnswerData]
+    core: Optional[Dict[str, Any]]
+
+
+class AnswerInput(TypedDict, total=False):
+    key: Optional[str]
+    widget: Any
+    data: Optional[AnswerData]
+    core: Dict[str, Any]
+
+
+class AnswerConfig(TypedDict):
+    text: str
+    speech: str

bridges/python/src/sdk/widget.py

@@ -0,0 +1,4 @@
+class Widget:
+    def __init__(self, options):
+        self.type = type(self).__name__
+        self.options = options

bridges/python/src/setup.py

@@ -0,0 +1,30 @@
+from cx_Freeze import setup, Executable
+import requests.certs
+
+from version import __version__
+
+options = {
+    'build_exe': {
+        # Add common dependencies for skills
+        'includes': [
+            'bs4',
+            'requests',
+            'timeit'
+        ],
+        'include_files': [(requests.certs.where(), 'cacert.pem')]
+    }
+}
+
+executables = [
+    Executable(
+        script='bridges/python/src/main.py',
+        target_name='leon-python-bridge'
+    )
+]
+
+setup(
+    name='leon-python-bridge',
+    version=__version__,
+    executables=executables,
+    options=options
+)

bridges/python/src/version.py

@@ -0,0 +1 @@
+__version__ = '1.2.0'

bridges/python/utils.py

@@ -1,110 +0,0 @@
-#!/usr/bin/env python
-# -*- coding:utf-8 -*-
-
-from json import loads, dumps
-from os import path
-from pathlib import Path
-from random import choice
-from sys import argv, stdout
-from re import findall
-from vars import useragent
-from tinydb import TinyDB, Query, operations
-from time import sleep
-import sqlite3
-import requests
-
-dirname = path.dirname(path.realpath(__file__))
-lang = argv[1]
-package = argv[2]
-module = argv[3]
-istring = argv[4]
-
-def translate(key, d = { }):
-	"""Pickup the language file according to the cmd arg
-	and return the value regarding to the params"""
-
-	output = ''
-
-	file = open(dirname + '/../../packages/' + package + '/' + 'data/answers/' + lang + '.json', 'r', encoding = 'utf8')
-	obj = loads(file.read())
-	file.close()
-
-	prop = obj[module][key]
-	if isinstance(prop, list):
-		output = choice(prop)
-	else:
-		output = prop
-
-	if d:
-		for k in d:
-			output = output.replace('%' + k + '%', str(d[k]))
-
-	# "Temporize" for the data buffer ouput on the core
-	sleep(0.1)
-				
-	return output
-
-def output(type, code, speech = ''):
-	"""Communicate with the Core"""
-
-	print(dumps({
-		'package': package,
-		'module': module,
-		'lang': lang,
-		'input': istring,
-		'output': {
-			'type': type,
-			'code': code,
-			'speech': speech,
-			'options': config('options')
-		}
-	}))
-
-	if (type == 'inter'):
-		stdout.flush()
-
-def finddomains(string):
-	"""Find a domain name substring from a string"""
-
-	return findall('[a-z0-9\-]{,63}\.[a-z0-9\-\.]{2,191}', string)
-
-def http(method, url):
-	"""Send HTTP request with the Leon user agent"""
-
-	session = requests.Session()
-	session.headers.update({ 'User-Agent': useragent, 'Cache-Control': 'no-cache' })
-
-	return session.request(method, url)
-
-def config(key):
-	"""Get a package configuration value"""
-
-	file = open(dirname + '/../../packages/' + package + '/config/config.json', 'r', encoding = 'utf8')
-	obj = loads(file.read())
-	file.close()
-
-	return obj[module][key]
-
-def info():
-	"""Get information from the current query"""
-
-	return { 'lang': lang, 'package': package, 'module': module }
-
-def createdldir():
-	"""Create the downloads folder of a current module"""
-
-	dldir = path.dirname(path.realpath(__file__)) + '/../../downloads/'
-	moduledldir = dldir + package + '/' + module
-
-	Path(moduledldir).mkdir(parents = True, exist_ok = True)
-
-	return moduledldir
-
-def db(dbtype = 'tinydb'):
-	"""Create a new dedicated database
-	for a specific package"""
-
-	if dbtype == 'tinydb':
-		db = TinyDB(dirname + '/../../packages/' + package + '/data/db/' + package + '.json')
-		return { 'db': db, 'query': Query, 'operations': operations }
-

bridges/python/vars.py

@@ -1,11 +0,0 @@
-#!/usr/bin/env python
-# -*- coding:utf-8 -*-
-
-from os import path
-from json import loads
-
-packagejsonfile = open(path.dirname(path.realpath(__file__)) + '/../../package.json', 'r', encoding = 'utf8')
-packagejson = loads(packagejsonfile.read())
-packagejsonfile.close()
-
-useragent = 'Leon/' + packagejson['version']

core/config/voice/amazon.sample.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "../../../schemas/voice-config-schemas/amazon.json",
+  "credentials": {
+    "accessKeyId": "",
+    "secretAccessKey": ""
+  },
+  "region": "us-east-2"
+}

core/config/voice/google-cloud.sample.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "../../../schemas/voice-config-schemas/google-cloud.json",
+  "type": "service_account",
+  "project_id": "",
+  "private_key_id": "",
+  "private_key": "",
+  "client_email": "example@iam.gserviceaccount.com",
+  "client_id": "",
+  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
+  "token_uri": "https://accounts.google.com/o/oauth2/token",
+  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
+  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/"
+}

core/config/voice/watson-stt.sample.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "../../../schemas/voice-config-schemas/watson-stt.json",
+  "apikey": "",
+  "url": "https://stream.watsonplatform.net/speech-to-text/api"
+}

core/config/voice/watson-tts.sample.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "../../../schemas/voice-config-schemas/watson-tts.json",
+  "apikey": "",
+  "url": "https://stream.watsonplatform.net/text-to-speech/api"
+}

core/data/en/answers.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "../../../schemas/global-data/global-answers.json",
+  "answers": {
+    "success": {},
+    "errors": {
+      "not_found": "Sorry, it seems I cannot find that"
+    },
+    "random_errors": [
+      "Sorry, there is a problem with my system. Please check my logs for further details",
+      "Sorry, I don't work correctly. Please look at my logs for more information",
+      "Sorry, you need to fix me. Please take a look at my logs for further information",
+      "Sorry, I cannot do that because I'm broken. Please check my logs for further details"
+    ],
+    "random_skill_errors": [
+      "Sorry, it seems I have a problem with the \"%skill_name%\" skill from the \"%domain_name%\" domain",
+      "Sorry, I have an issue with the \"%skill_name%\" skill from the \"%domain_name%\" domain",
+      "Sorry, I've got an error with the \"%skill_name%\" skill from the \"%domain_name%\" domain",
+      "Sorry, the \"%skill_name%\" skill from the \"%domain_name%\" domain is broken"
+    ],
+    "random_unknown_intents": [
+      "Sorry, I still don't know this, but you can help me to understand by <a href=\"https://github.com/leon-ai/leon/blob/develop/.github/CONTRIBUTING.md\" target=\"_blank\">creating a pull request</a>",
+      "Sorry, you should teach me this request. You can teach me by <a href=\"https://github.com/leon-ai/leon/blob/develop/.github/CONTRIBUTING.md\" target=\"_blank\">creating a pull request</a>",
+      "Sorry, I cannot answer that. Let me answer you in the future by <a href=\"https://github.com/leon-ai/leon/blob/develop/.github/CONTRIBUTING.md\" target=\"_blank\">creating a pull request</a>",
+      "Sorry, you have to educate me more. You can help me with that by <a href=\"https://github.com/leon-ai/leon/blob/develop/.github/CONTRIBUTING.md\" target=\"_blank\">contributing to my code</a>",
+      "Sorry, I don't understand your query",
+      "Sorry, I'm still very young, I didn't get your point"
+    ],
+    "random_not_sure": [
+      "Sorry, you may repeat in an another way",
+      "Sorry, I'm not sure I understood correctly",
+      "Sorry, I'm not sure for what you asked, please repeat with a different way",
+      "Sorry, please repeat again by formulating differently",
+      "Sorry, I didn't correctly clean my ears today! Oh wait, I'm your personal assistant then please try again with a new way"
+    ],
+    "random_not_able": [
+      "Sorry, I'm not able to answer. I understand what you said, but please repeat in another way",
+      "Sorry, I have a blackout, I cannot answer that. I understand what you said, but try to repeat in another way"
+    ],
+    "random_ner_type_not_supported": [
+      "Sorry, the \"%entity_type%\" action entity type is not supported by my NER. Please <a href=\"https://github.com/leon-ai/leon/issues\" target=\"_blank\">open an issue</a> to report, that will be much appreciated",
+      "Sorry, my NER does not recognize the \"%entity_type%\" action entity type. Please <a href=\"https://github.com/leon-ai/leon/issues\" target=\"_blank\">open an issue</a> to report, it'll be highly appreciated"
+    ],
+    "random_language_switch": [
+      "Hey, it looks like a new language, give me a sec so I make the switch",
+      "You are speaking another language, let me do the switch please",
+      "Wow, you can speak several languages, so do I! One moment please"
+    ],
+    "random_language_not_supported": [
+      "Sorry, I don't speak this language yet",
+      "You are awesome, but I can't speak this language yet",
+      "It looks like a language I can't understand at the moment"
+    ],
+    "random_context_out_of_topic": [
+      "Sure, let's change the topic",
+      "Aah, you want to change the subject, sure",
+      "Mmmh, as you wish, let's switch conversation"
+    ]
+  }
+}

core/data/en/global-entities/color.json

@@ -0,0 +1,245 @@
+{
+  "$schema": "../../../../schemas/global-data/global-entity.json",
+  "options": {
+    "red": {
+      "synonyms": ["red"],
+      "data": {
+        "hexa": ["#FF0000"]
+      }
+    },
+    "blue": {
+      "synonyms": ["blue"],
+      "data": {
+        "hexa": ["#0000FF"]
+      }
+    },
+    "green": {
+      "synonyms": ["green"],
+      "data": {
+        "hexa": ["#006400"]
+      }
+    },
+    "orange": {
+      "synonyms": ["orange"],
+      "data": {
+        "hexa": ["#FF6600"]
+      }
+    },
+    "white": {
+      "synonyms": ["white"],
+      "data": {
+        "hexa": ["#FFFFFF"]
+      }
+    },
+    "black": {
+      "synonyms": ["black"],
+      "data": {
+        "hexa": ["#000000"]
+      }
+    },
+    "yellow": {
+      "synonyms": ["yellow"],
+      "data": {
+        "hexa": ["#FFFF00"]
+      }
+    },
+    "purple": {
+      "synonyms": ["purple"],
+      "data": {
+        "hexa": ["#A020F0"]
+      }
+    },
+    "silver": {
+      "synonyms": ["silver"],
+      "data": {
+        "hexa": ["#C0C0C0"]
+      }
+    },
+    "brown": {
+      "synonyms": ["brown"],
+      "data": {
+        "hexa": ["#964B00"]
+      }
+    },
+    "gray": {
+      "synonyms": ["gray", "grey"],
+      "data": {
+        "hexa": ["#808080"]
+      }
+    },
+    "pink": {
+      "synonyms": ["pink"],
+      "data": {
+        "hexa": ["#FFC0CB"]
+      }
+    },
+    "olive": {
+      "synonyms": ["olive"],
+      "data": {
+        "hexa": ["#808000"]
+      }
+    },
+    "maroon": {
+      "synonyms": ["maroon"],
+      "data": {
+        "hexa": ["#800000"]
+      }
+    },
+    "violet": {
+      "synonyms": ["violet"],
+      "data": {
+        "hexa": ["#8F00FF"]
+      }
+    },
+    "charcoal": {
+      "synonyms": ["charcoal"],
+      "data": {
+        "hexa": ["#36454F"]
+      }
+    },
+    "magenta": {
+      "synonyms": ["magenta"],
+      "data": {
+        "hexa": ["#FF00FF"]
+      }
+    },
+    "bronze": {
+      "synonyms": ["bronze"],
+      "data": {
+        "hexa": ["#CD7F32"]
+      }
+    },
+    "cream": {
+      "synonyms": ["cream"],
+      "data": {
+        "hexa": ["#FFFDD0"]
+      }
+    },
+    "gold": {
+      "synonyms": ["gold"],
+      "data": {
+        "hexa": ["#FFD700"]
+      }
+    },
+    "tan": {
+      "synonyms": ["tan"],
+      "data": {
+        "hexa": ["#D2B48C"]
+      }
+    },
+    "teal": {
+      "synonyms": ["teal"],
+      "data": {
+        "hexa": ["#008080"]
+      }
+    },
+    "mustard": {
+      "synonyms": ["mustard"],
+      "data": {
+        "hexa": ["#FFDB58"]
+      }
+    },
+    "navy blue": {
+      "synonyms": ["navy blue"],
+      "data": {
+        "hexa": ["#000080"]
+      }
+    },
+    "coral": {
+      "synonyms": ["coral"],
+      "data": {
+        "hexa": ["#FF7F50"]
+      }
+    },
+    "burgundy": {
+      "synonyms": ["burgundy"],
+      "data": {
+        "hexa": ["#800020"]
+      }
+    },
+    "lavender": {
+      "synonyms": ["lavender"],
+      "data": {
+        "hexa": ["#E6E6FA"]
+      }
+    },
+    "mauve": {
+      "synonyms": ["mauve"],
+      "data": {
+        "hexa": ["#E0b0FF"]
+      }
+    },
+    "peach": {
+      "synonyms": ["peach"],
+      "data": {
+        "hexa": ["#FFE5B4"]
+      }
+    },
+    "rust": {
+      "synonyms": ["rust"],
+      "data": {
+        "hexa": ["#B7410E"]
+      }
+    },
+    "indigo": {
+      "synonyms": ["indigo"],
+      "data": {
+        "hexa": ["#4B0082"]
+      }
+    },
+    "ruby": {
+      "synonyms": ["ruby"],
+      "data": {
+        "hexa": ["#E0115F"]
+      }
+    },
+    "clay": {
+      "synonyms": ["clay"],
+      "data": {
+        "hexa": ["#CC7357"]
+      }
+    },
+    "cyan": {
+      "synonyms": ["cyan"],
+      "data": {
+        "hexa": ["#00FFFF"]
+      }
+    },
+    "azure": {
+      "synonyms": ["azure"],
+      "data": {
+        "hexa": ["#007FFF"]
+      }
+    },
+    "beige": {
+      "synonyms": ["beige"],
+      "data": {
+        "hexa": ["#F5F5DC"]
+      }
+    },
+    "off white": {
+      "synonyms": ["off white"],
+      "data": {
+        "hexa": ["#FAF9F6"]
+      }
+    },
+    "turquoise": {
+      "synonyms": ["turquoise"],
+      "data": {
+        "hexa": ["#30D5C8"]
+      }
+    },
+    "amber": {
+      "synonyms": ["amber"],
+      "data": {
+        "hexa": ["#FFBF00"]
+      }
+    },
+    "mint": {
+      "synonyms": ["mint"],
+      "data": {
+        "hexa": ["#3EB489"]
+      }
+    }
+  }
+}

core/data/en/global-entities/level.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "../../../../schemas/global-data/global-entity.json",
+  "options": {
+    "LOW": {
+      "synonyms": ["low"]
+    },
+    "MEDIUM": {
+      "synonyms": ["medium"]
+    },
+    "HIGH": {
+      "synonyms": ["high"]
+    }
+  }
+}