botium-core 1.11.16 → 1.12.3

package/dist/botium-cjs.js

@@ -27,7 +27,7 @@ var isJson$1 = require('is-json');
 var esprima = require('esprima');
 var markdownIt = require('markdown-it');
 var xlsx = require('xlsx');
-var sync = require('csv-parse/lib/sync');
+var sync = require('csv-parse/sync');
 var yaml = require('yaml');
 var child_process = require('child_process');
 var socket = require('socket.io-client');
@@ -79,12 +79,12 @@ var express__default = /*#__PURE__*/_interopDefaultLegacy(express);
 var bodyParser__default = /*#__PURE__*/_interopDefaultLegacy(bodyParser);
 
 var name = "botium-core";
-var version$1 = "1.11.16";
+var version$1 = "1.12.3";
 var description = "The Selenium for Chatbots";
 var main = "index.js";
 var module$1 = "dist/botium-es.js";
 var engines = {
-	node: ">=10.0.0"
+	node: ">=14.0.0"
 };
 var scripts = {
 	postinstall: "node ./report.js",
@@ -111,23 +111,23 @@ var bugs = {
 };
 var homepage = "https://www.botium.ai";
 var dependencies = {
-	"@babel/runtime": "^7.16.0",
-	async: "^3.2.2",
-	"body-parser": "^1.19.0",
+	"@babel/runtime": "^7.17.2",
+	async: "^3.2.3",
+	"body-parser": "^1.19.1",
 	boolean: "^3.1.4",
 	bottleneck: "^2.19.5",
-	"csv-parse": "^4.16.3",
-	debug: "^4.3.2",
+	"csv-parse": "^5.0.4",
+	debug: "^4.3.3",
 	esprima: "^4.0.1",
-	express: "^4.17.1",
+	express: "^4.17.2",
 	globby: "11.0.4",
-	ioredis: "^4.28.0",
+	ioredis: "^4.28.5",
 	"is-class": "^0.0.9",
 	"is-json": "^2.0.1",
 	jsonpath: "^1.1.1",
 	lodash: "^4.17.21",
-	"markdown-it": "^12.2.0",
-	"mime-types": "^2.1.33",
+	"markdown-it": "^12.3.2",
+	"mime-types": "^2.1.34",
 	mkdirp: "^1.0.4",
 	moment: "^2.29.1",
 	mustache: "^4.2.0",
@@ -137,40 +137,40 @@ var dependencies = {
 	request: "^2.88.2",
 	rimraf: "^3.0.2",
 	"sanitize-filename": "^1.6.3",
-	slugify: "^1.6.1",
-	"socket.io": "^4.3.1",
-	"socket.io-client": "^4.3.2",
+	slugify: "^1.6.5",
+	"socket.io": "^4.4.1",
+	"socket.io-client": "^4.4.1",
 	"socketio-auth": "^0.1.1",
 	"swagger-jsdoc": "^6.1.0",
-	"swagger-ui-express": "^4.1.6",
+	"swagger-ui-express": "^4.3.0",
 	uuid: "^8.3.2",
-	vm2: "^3.9.5",
+	vm2: "^3.9.7",
 	"write-yaml": "^1.0.0",
-	xlsx: "^0.17.3",
+	xlsx: "^0.18.2",
 	xregexp: "^5.1.0",
 	yaml: "^1.10.2"
 };
 var devDependencies = {
-	"@babel/core": "^7.16.0",
-	"@babel/node": "^7.16.0",
-	"@babel/plugin-transform-runtime": "^7.16.0",
-	"@babel/preset-env": "^7.16.0",
-	chai: "^4.3.4",
+	"@babel/core": "^7.17.2",
+	"@babel/node": "^7.16.8",
+	"@babel/plugin-transform-runtime": "^7.17.0",
+	"@babel/preset-env": "^7.16.11",
+	chai: "^4.3.6",
 	"chai-as-promised": "^7.1.1",
 	"cross-env": "^7.0.3",
-	eslint: "^8.1.0",
+	eslint: "^8.9.0",
 	"eslint-config-standard": "^16.0.3",
-	"eslint-plugin-import": "^2.25.2",
+	"eslint-plugin-import": "^2.25.4",
 	"eslint-plugin-node": "^11.1.0",
-	"eslint-plugin-promise": "^5.1.1",
+	"eslint-plugin-promise": "^6.0.0",
 	"eslint-plugin-standard": "^4.1.0",
 	"license-checker": "^25.0.1",
 	"license-compatibility-checker": "^0.3.5",
-	mocha: "^9.1.3",
-	nock: "^13.1.4",
-	"npm-check-updates": "^12.0.0",
+	mocha: "^9.2.0",
+	nock: "^13.2.4",
+	"npm-check-updates": "^12.3.0",
 	nyc: "^15.1.0",
-	rollup: "^2.59.0",
+	rollup: "^2.67.2",
 	"rollup-plugin-babel": "^4.4.0",
 	"rollup-plugin-commonjs": "^10.1.0",
 	"rollup-plugin-json": "^4.0.0",
@@ -287,6 +287,11 @@ var Capabilities = {
   SIMPLEREST_RESPONSE_HOOK: 'SIMPLEREST_RESPONSE_HOOK',
   SIMPLEREST_MEDIA_JSONPATH: 'SIMPLEREST_MEDIA_JSONPATH',
   SIMPLEREST_BUTTONS_JSONPATH: 'SIMPLEREST_BUTTONS_JSONPATH',
+  SIMPLEREST_CARDS_JSONPATH: 'SIMPLEREST_CARDS_JSONPATH',
+  SIMPLEREST_CARD_TEXT_JSONPATH: 'SIMPLEREST_CARD_TEXT_JSONPATH',
+  SIMPLEREST_CARD_SUBTEXT_JSONPATH: 'SIMPLEREST_CARD_SUBTEXT_JSONPATH',
+  SIMPLEREST_CARD_BUTTONS_JSONPATH: 'SIMPLEREST_CARD_BUTTONS_JSONPATH',
+  SIMPLEREST_CARD_ATTACHMENTS_JSONPATH: 'SIMPLEREST_CARD_ATTACHMENTS_JSONPATH',
   SIMPLEREST_CONTEXT_JSONPATH: 'SIMPLEREST_CONTEXT_JSONPATH',
   SIMPLEREST_CONTEXT_MERGE_OR_REPLACE: 'SIMPLEREST_CONTEXT_MERGE_OR_REPLACE',
   SIMPLEREST_CONVERSATION_ID_TEMPLATE: 'SIMPLEREST_CONVERSATION_ID_TEMPLATE',
@@ -325,6 +330,7 @@ var Capabilities = {
   SCRIPTING_NORMALIZE_TEXT: 'SCRIPTING_NORMALIZE_TEXT',
   SCRIPTING_ENABLE_MEMORY: 'SCRIPTING_ENABLE_MEMORY',
   SCRIPTING_ENABLE_MULTIPLE_ASSERT_ERRORS: 'SCRIPTING_ENABLE_MULTIPLE_ASSERT_ERRORS',
+  SCRIPTING_ENABLE_SKIP_ASSERT_ERRORS: 'SCRIPTING_ENABLE_SKIP_ASSERT_ERRORS',
   SCRIPTING_FORCE_BOT_CONSUMED: 'SCRIPTING_FORCE_BOT_CONSUMED',
   // regexp, regexpIgnoreCase, wildcard, wildcardIgnoreCase, wildcardExact, wildcardExactIgnoreCase, include, includeIgnoreCase, equals, equalsIgnoreCase
   SCRIPTING_MATCHING_MODE: 'SCRIPTING_MATCHING_MODE',
@@ -340,6 +346,8 @@ var Capabilities = {
   SCRIPTING_MEMORYEXPANSION_KEEP_ORIG: 'SCRIPTING_MEMORYEXPANSION_KEEP_ORIG',
   // word, non_whitespace, joker
   SCRIPTING_MEMORY_MATCHING_MODE: 'SCRIPTING_MEMORY_MATCHING_MODE',
+  // varnames, testcasenames
+  SCRIPTING_MEMORY_COLUMN_MODE: 'SCRIPTING_MEMORY_COLUMN_MODE',
   // Botium Lifecycle Hooks
   CUSTOMHOOK_ONBUILD: 'CUSTOMHOOK_ONBUILD',
   CUSTOMHOOK_ONSTART: 'CUSTOMHOOK_ONSTART',
@@ -354,6 +362,7 @@ var Capabilities = {
   // API Calls Rate Limiting
   RATELIMIT_USERSAYS_MAXCONCURRENT: 'RATELIMIT_USERSAYS_MAXCONCURRENT',
   RATELIMIT_USERSAYS_MINTIME: 'RATELIMIT_USERSAYS_MINTIME',
+  RATELIMIT_BOTTLENECK_FN: 'RATELIMIT_BOTTLENECK_FN',
   SECURITY_ALLOW_UNSAFE: 'SECURITY_ALLOW_UNSAFE',
   PRECOMPILERS: 'PRECOMPILERS'
 };
@@ -429,6 +438,11 @@ Capabilities.SIMPLEREST_RESPONSE_JSONPATH;
 Capabilities.SIMPLEREST_RESPONSE_HOOK;
 Capabilities.SIMPLEREST_MEDIA_JSONPATH;
 Capabilities.SIMPLEREST_BUTTONS_JSONPATH;
+Capabilities.SIMPLEREST_CARDS_JSONPATH;
+Capabilities.SIMPLEREST_CARD_TEXT_JSONPATH;
+Capabilities.SIMPLEREST_CARD_SUBTEXT_JSONPATH;
+Capabilities.SIMPLEREST_CARD_BUTTONS_JSONPATH;
+Capabilities.SIMPLEREST_CARD_ATTACHMENTS_JSONPATH;
 Capabilities.SIMPLEREST_CONTEXT_JSONPATH;
 Capabilities.SIMPLEREST_CONTEXT_MERGE_OR_REPLACE;
 Capabilities.SIMPLEREST_CONVERSATION_ID_TEMPLATE;
@@ -465,6 +479,7 @@ Capabilities.SCRIPTING_CSV_QA_COLUMN_ANSWER;
 Capabilities.SCRIPTING_NORMALIZE_TEXT;
 Capabilities.SCRIPTING_ENABLE_MEMORY;
 Capabilities.SCRIPTING_ENABLE_MULTIPLE_ASSERT_ERRORS;
+Capabilities.SCRIPTING_ENABLE_SKIP_ASSERT_ERRORS;
 Capabilities.SCRIPTING_FORCE_BOT_CONSUMED;
 Capabilities.SCRIPTING_MATCHING_MODE;
 Capabilities.SCRIPTING_UTTEXPANSION_MODE;
@@ -475,6 +490,7 @@ Capabilities.SCRIPTING_UTTEXPANSION_NAMING_MODE;
 Capabilities.SCRIPTING_UTTEXPANSION_NAMING_UTTERANCE_MAX;
 Capabilities.SCRIPTING_MEMORYEXPANSION_KEEP_ORIG;
 Capabilities.SCRIPTING_MEMORY_MATCHING_MODE;
+Capabilities.SCRIPTING_MEMORY_COLUMN_MODE;
 Capabilities.CUSTOMHOOK_ONBUILD;
 Capabilities.CUSTOMHOOK_ONSTART;
 Capabilities.CUSTOMHOOK_ONUSERSAYS;
@@ -486,6 +502,7 @@ Capabilities.LOGIC_HOOKS;
 Capabilities.USER_INPUTS;
 Capabilities.RATELIMIT_USERSAYS_MAXCONCURRENT;
 Capabilities.RATELIMIT_USERSAYS_MINTIME;
+Capabilities.RATELIMIT_BOTTLENECK_FN;
 Capabilities.SECURITY_ALLOW_UNSAFE;
 Capabilities.PRECOMPILERS;
 
@@ -534,7 +551,6 @@ var Defaults$1 = {
     [Capabilities.SIMPLEREST_METHOD]: 'GET',
     [Capabilities.SIMPLEREST_IGNORE_EMPTY]: true,
     [Capabilities.SIMPLEREST_TIMEOUT]: 10000,
-    [Capabilities.SIMPLEREST_EXTRA_OPTIONS]: {},
     [Capabilities.SIMPLEREST_STRICT_SSL]: true,
     [Capabilities.SIMPLEREST_INBOUND_UPDATE_CONTEXT]: true,
     [Capabilities.SIMPLEREST_CONTEXT_MERGE_OR_REPLACE]: 'MERGE',
@@ -553,6 +569,7 @@ var Defaults$1 = {
     [Capabilities.SCRIPTING_UTTEXPANSION_NAMING_MODE]: 'justLineTag',
     [Capabilities.SCRIPTING_UTTEXPANSION_NAMING_UTTERANCE_MAX]: '16',
     [Capabilities.SCRIPTING_MEMORYEXPANSION_KEEP_ORIG]: false,
+    [Capabilities.SCRIPTING_ENABLE_SKIP_ASSERT_ERRORS]: false,
     [Capabilities.SCRIPTING_FORCE_BOT_CONSUMED]: false,
     [Capabilities.ASSERTERS]: [],
     [Capabilities.LOGIC_HOOKS]: [],
@@ -874,7 +891,7 @@ function getCjsExportFromNamespace (n) {
 	return n && n['default'] || n;
 }
 
-const BotiumError$6 = class BotiumError extends Error {
+const BotiumError$7 = class BotiumError extends Error {
   /**
    *
    * @param message
@@ -899,6 +916,27 @@ const BotiumError$6 = class BotiumError extends Error {
     this.context.message = message.message || message;
   }
 
+  isAsserterError() {
+    if (this.context) {
+      const errArr = lodash__default["default"].isArray(this.context) ? this.context : [this.context];
+      const hasNotAsserterError = errArr.findIndex(errDetail => {
+        if (errDetail.type === 'list') {
+          if (errDetail.errors) {
+            return errDetail.errors.findIndex(e => e.type !== 'asserter') >= 0;
+          } else {
+            return true;
+          }
+        } else {
+          return errDetail.type !== 'asserter';
+        }
+      }) >= 0;
+      if (hasNotAsserterError) return false;
+      return true;
+    } else {
+      return false;
+    }
+  }
+
   prettify(includeJson) {
     const lines = [];
 
@@ -960,10 +998,10 @@ const _getChildErrorsFromContext = context => {
 };
 
 const botiumErrorFromErr$2 = (message, err) => {
-  if (err instanceof BotiumError$6) {
-    return new BotiumError$6(message, err.context, true);
+  if (err instanceof BotiumError$7) {
+    return new BotiumError$7(message, err.context, true);
   } else {
-    return new BotiumError$6(message, {
+    return new BotiumError$7(message, {
       err
     }, true);
   }
@@ -978,7 +1016,7 @@ const botiumErrorFromList$2 = (errors, {
   let children = [];
 
   for (const error of errors) {
-    if (error instanceof BotiumError$6) {
+    if (error instanceof BotiumError$7) {
       const childErrors = flat && _getChildErrorsFromContext(error.context);
 
       if (childErrors && childErrors.length) {
@@ -991,7 +1029,7 @@ const botiumErrorFromList$2 = (errors, {
     }
   }
 
-  const result = new BotiumError$6(message, {
+  const result = new BotiumError$7(message, {
     errors: children,
     type,
     source
@@ -1000,7 +1038,7 @@ const botiumErrorFromList$2 = (errors, {
 };
 
 var BotiumError_1 = {
-  BotiumError: BotiumError$6,
+  BotiumError: BotiumError$7,
   botiumErrorFromErr: botiumErrorFromErr$2,
   botiumErrorFromList: botiumErrorFromList$2
 };
@@ -1181,7 +1219,7 @@ const {
 } = vm2__default["default"];
 const debug$k = debug__default["default"]('botium-core-asserterUtils');
 const {
-  BotiumError: BotiumError$5
+  BotiumError: BotiumError$6
 } = BotiumError_1;
 const {
   DEFAULT_ASSERTERS,
@@ -1332,7 +1370,7 @@ var LogicHookUtils_1 = class LogicHookUtils {
 
     const _checkUnsafe = () => {
       if (!this.caps[Capabilities.SECURITY_ALLOW_UNSAFE]) {
-        throw new BotiumError$5('Security Error. Using unsafe component is not allowed', {
+        throw new BotiumError$6('Security Error. Using unsafe component is not allowed', {
           type: 'security',
           subtype: 'allow unsafe',
           source: path__default["default"].basename(__filename),
@@ -1476,6 +1514,11 @@ var LogicHookUtils_1 = class LogicHookUtils {
             ref,
             ...this.buildScriptContext
           }, this.caps, args);
+        } else if (lodash__default["default"].isFunction(CheckClass.PluginClass)) {
+          return CheckClass.PluginClass({
+            ref,
+            ...this.buildScriptContext
+          }, this.caps, args);
         } else {
           throw new Error(`${src} class or function expected`);
         }
@@ -1731,6 +1774,18 @@ var BotiumMockMessage_1 = class BotiumMockMessage {
 
 };
 
+var Enums = {
+  E_SCRIPTING_MEMORY_COLUMN_MODE: {
+    VARNAMES: 'varnames',
+    TESTCASENAMES: 'testcasenames'
+  }
+};
+Enums.E_SCRIPTING_MEMORY_COLUMN_MODE;
+
+const {
+  E_SCRIPTING_MEMORY_COLUMN_MODE: E_SCRIPTING_MEMORY_COLUMN_MODE$1
+} = Enums;
+
 const normalizeText$1 = (str, doCleanup) => {
   if (str && lodash__default["default"].isArray(str)) {
     str = str.join(' ');
@@ -2259,6 +2314,71 @@ const convoStepToLines$2 = step => {
   return lines.map(l => l.trim());
 };
 
+const linesToScriptingMemories$2 = (lines, columnMode = null) => {
+  const guessScriptingMemoryColumnMode = lines => {
+    if (lines && lines.length > 1) {
+      if (lines[1].trim().startsWith('$')) return E_SCRIPTING_MEMORY_COLUMN_MODE$1.TESTCASENAMES;
+    }
+
+    return E_SCRIPTING_MEMORY_COLUMN_MODE$1.VARNAMES;
+  };
+
+  columnMode = columnMode || guessScriptingMemoryColumnMode(lines);
+  const scriptingMemories = [];
+
+  if (columnMode === E_SCRIPTING_MEMORY_COLUMN_MODE$1.TESTCASENAMES) {
+    const caseNames = lines[0].split('|').map(name => name.trim()).slice(1);
+    const varNames = [];
+    const varValues = [];
+
+    for (let row = 1; row < lines.length; row++) {
+      if (!lines[row] || lines[row].length === 0) continue;
+      const rawRow = lines[row].split('|').map(name => name.trim());
+      varNames.push(rawRow[0]);
+      varValues.push(rawRow.slice(1));
+    }
+
+    for (let caseIndex = 0; caseIndex < caseNames.length; caseIndex++) {
+      const caseName = caseNames[caseIndex];
+      const values = varNames.reduce((agg, varName, varIndex) => {
+        agg[varName] = varValues[varIndex][caseIndex] || null;
+        return agg;
+      }, {});
+      const scriptingMemory = {
+        header: {
+          name: caseName
+        },
+        values: values
+      };
+      scriptingMemories.push(scriptingMemory);
+    }
+  } else {
+    const varNames = lines[0].split('|').map(name => name.trim()).slice(1);
+
+    for (let row = 1; row < lines.length; row++) {
+      if (!lines[row] || lines[row].length === 0) continue;
+      const rawRow = lines[row].split('|').map(name => name.trim());
+      const caseName = rawRow[0];
+      const values = rawRow.slice(1);
+      const varValues = {};
+
+      for (let varIndex = 0; varIndex < varNames.length; varIndex++) {
+        varValues[varNames[varIndex]] = values[varIndex];
+      }
+
+      const scriptingMemory = {
+        header: {
+          name: caseName
+        },
+        values: varValues
+      };
+      scriptingMemories.push(scriptingMemory);
+    }
+  }
+
+  return scriptingMemories;
+};
+
 var helper = {
   normalizeText: normalizeText$1,
   splitStringInNonEmptyLines: splitStringInNonEmptyLines$1,
@@ -2271,7 +2391,8 @@ var helper = {
   convoStepToObject: convoStepToObject$1,
   validSenders: validSenders$3,
   validateSender: validateSender$1,
-  validateConvo: validateConvo$2
+  validateConvo: validateConvo$2,
+  linesToScriptingMemories: linesToScriptingMemories$2
 };
 
 const debug$j = debug__default["default"]('botium-core-ScriptingMemory');
@@ -2286,7 +2407,7 @@ const {
   toString: toString$2
 } = helper;
 const {
-  BotiumError: BotiumError$4
+  BotiumError: BotiumError$5
 } = BotiumError_1; // If they got parameter, then it will be a string always.
 // the receiver can decide what to do with it,
 // convert to int,
@@ -2455,7 +2576,7 @@ const SCRIPTING_FUNCTIONS$1 = lodash__default["default"].mapValues(SCRIPTING_FUN
   return {
     handler: (caps, ...rest) => {
       if (!caps[Capabilities.SECURITY_ALLOW_UNSAFE] && funcOrStruct.unsafe) {
-        throw new BotiumError$4(`Security Error. Using unsafe scripting memory function ${name} is not allowed`, {
+        throw new BotiumError$5(`Security Error. Using unsafe scripting memory function ${name} is not allowed`, {
           type: 'security',
           subtype: 'allow unsafe',
           source: path__default["default"].basename(__filename),
@@ -2604,7 +2725,7 @@ ScriptingMemory.SCRIPTING_FUNCTIONS;
 
 const debug$i = debug__default["default"]('botium-core-Convo');
 const {
-  BotiumError: BotiumError$3,
+  BotiumError: BotiumError$4,
   botiumErrorFromErr: botiumErrorFromErr$1,
   botiumErrorFromList: botiumErrorFromList$1
 } = BotiumError_1;
@@ -2644,7 +2765,9 @@ class ConvoStepAssert {
   }
 
   toString() {
-    return (this.optional ? '?' : '') + (this.not ? '!' : '') + this.name + '(' + (this.args ? this.args.join(',') : 'no args') + ')';
+    return (this.optional ? '?' : '') + (this.not ? '!' : '') + this.name + '(' + (this.args ? this.args.map(a => lodash__default["default"].truncate(a, {
+      length: 200
+    })).join(',') : 'no args') + ')';
   }
 
 }
@@ -2656,7 +2779,9 @@ class ConvoStepLogicHook {
   }
 
   toString() {
-    return this.name + '(' + (this.args ? this.args.join(',') : 'no args') + ')';
+    return this.name + '(' + (this.args ? this.args.map(a => lodash__default["default"].truncate(a, {
+      length: 200
+    })).join(',') : 'no args') + ')';
   }
 
 }
@@ -2668,7 +2793,9 @@ class ConvoStepUserInput {
   }
 
   toString() {
-    return this.name + '(' + (this.args ? this.args.join(',') : 'no args') + ')';
+    return this.name + '(' + (this.args ? this.args.map(a => lodash__default["default"].truncate(a, {
+      length: 200
+    })).join(',') : 'no args') + ')';
   }
 
 }
@@ -3133,7 +3260,7 @@ class Convo$6 {
             }
 
             if (!botMsg || !botMsg.messageText && !botMsg.media && !botMsg.buttons && !botMsg.cards && !botMsg.sourceData && !botMsg.nlp) {
-              const failErr = new BotiumError$3(`${this.header.name}/${convoStep.stepTag}: bot says nothing`);
+              const failErr = new BotiumError$4(`${this.header.name}/${convoStep.stepTag}: bot says nothing`);
               debug$i(failErr);
 
               try {
@@ -3236,7 +3363,7 @@ class Convo$6 {
                 this.scriptingEvents.fail && this.scriptingEvents.fail(failErr, lastMeConvoStep);
               } catch (failErr) {}
 
-              if (container.caps[Capabilities.SCRIPTING_ENABLE_MULTIPLE_ASSERT_ERRORS] && err instanceof BotiumError$3) {
+              if (container.caps[Capabilities.SCRIPTING_ENABLE_MULTIPLE_ASSERT_ERRORS] && err instanceof BotiumError$4) {
                 assertErrors.push(err);
               } else {
                 throw failErr;
@@ -3253,7 +3380,7 @@ class Convo$6 {
               }
             }
           } else {
-            const failErr = new BotiumError$3(`${this.header.name}/${convoStep.stepTag}: invalid sender - ${util__default["default"].inspect(convoStep.sender)}`);
+            const failErr = new BotiumError$4(`${this.header.name}/${convoStep.stepTag}: invalid sender - ${util__default["default"].inspect(convoStep.sender)}`);
             debug$i(failErr);
 
             try {
@@ -3264,7 +3391,7 @@ class Convo$6 {
           }
         } catch (err) {
           if (lastMeConvoStep) {
-            if (err instanceof BotiumError$3 && err.context) {
+            if (err instanceof BotiumError$4 && err.context) {
               err.context.input = new ConvoStep$1(lastMeConvoStep);
               err.context.transcript = [...transcriptSteps, { ...transcriptStep
               }];
@@ -3276,7 +3403,14 @@ class Convo$6 {
           }
 
           transcriptStep.err = err;
-          throw err;
+
+          if (err instanceof BotiumError$4 && container.caps[Capabilities.SCRIPTING_ENABLE_SKIP_ASSERT_ERRORS]) {
+            if (!err.isAsserterError()) {
+              throw err;
+            }
+          } else {
+            throw err;
+          }
         } finally {
           if (convoStep.sender !== 'begin' && convoStep.sender !== 'end' && !skipTranscriptStep) {
             transcriptStep.scriptingMemory = Object.assign({}, scriptingMemory);
@@ -3291,6 +3425,14 @@ class Convo$6 {
       transcript.steps = transcriptSteps.filter(s => s);
       transcript.scriptingMemory = scriptingMemory;
       transcript.convoEnd = new Date();
+
+      if (container.caps[Capabilities.SCRIPTING_ENABLE_SKIP_ASSERT_ERRORS]) {
+        const transcriptStepErrs = transcript.steps.filter(s => s.err).map(s => s.err);
+
+        if (transcriptStepErrs && transcriptStepErrs.length > 0) {
+          transcript.err = botiumErrorFromList$1([transcriptStepErrs, transcript.err].filter(e => e), {});
+        }
+      }
     }
   }
 
@@ -3299,11 +3441,11 @@ class Convo$6 {
 
     if (lodash__default["default"].isArray(expected)) {
       if (!lodash__default["default"].isArray(result)) {
-        throw new BotiumError$3(`${this.header.name}/${convoStep.stepTag}: bot response expected array, got "${result}"`);
+        throw new BotiumError$4(`${this.header.name}/${convoStep.stepTag}: bot response expected array, got "${result}"`);
       }
 
       if (expected.length !== result.length) {
-        throw new BotiumError$3(`${this.header.name}/${convoStep.stepTag}: bot response expected array length ${expected.length}, got ${result.length}`);
+        throw new BotiumError$4(`${this.header.name}/${convoStep.stepTag}: bot response expected array length ${expected.length}, got ${result.length}`);
       }
 
       for (let i = 0; i < expected.length; i++) {
@@ -3314,7 +3456,7 @@ class Convo$6 {
         if (Object.prototype.hasOwnProperty.call(result, key)) {
           this._compareObject(container, scriptingMemory, convoStep, result[key], expected[key]);
         } else {
-          throw new BotiumError$3(`${this.header.name}/${convoStep.stepTag}: bot response "${result}" missing expected property: ${key}`);
+          throw new BotiumError$4(`${this.header.name}/${convoStep.stepTag}: bot response "${result}" missing expected property: ${key}`);
         }
       });
     } else {
@@ -3442,17 +3584,17 @@ class Convo$6 {
           const alreadyThereAt = parentPConvos.indexOf(includeLogicHook);
 
           if (alreadyThereAt >= 0) {
-            throw new BotiumError$3(`Partial convos are included circular. "${includeLogicHook}" is referenced by "/${parentPConvos.slice(0, alreadyThereAt).join('/')}" and by "/${parentPConvos.join('/')}" `);
+            throw new BotiumError$4(`Partial convos are included circular. "${includeLogicHook}" is referenced by "/${parentPConvos.slice(0, alreadyThereAt).join('/')}" and by "/${parentPConvos.join('/')}" `);
           }
 
           if (!partialConvos || Object.keys(partialConvos).length === 0) {
-            throw new BotiumError$3(`Cant find partial convo with name ${includeLogicHook} (There are no partial convos)`);
+            throw new BotiumError$4(`Cant find partial convo with name ${includeLogicHook} (There are no partial convos)`);
           }
 
           const partialConvo = partialConvos[includeLogicHook];
 
           if (!partialConvo) {
-            throw new BotiumError$3(`Cant find partial convo with name ${includeLogicHook} (available partial convos: ${Object.keys(partialConvos).join(',')})`);
+            throw new BotiumError$4(`Cant find partial convo with name ${includeLogicHook} (available partial convos: ${Object.keys(partialConvos).join(',')})`);
           }
 
           _getEffectiveConversationRecursive(partialConvo.conversation, [...parentPConvos, includeLogicHook], result, true);
@@ -3834,7 +3976,7 @@ const {
 } = vm2__default["default"];
 const debug$h = debug__default["default"]('botium-core-HookUtils');
 const {
-  BotiumError: BotiumError$2
+  BotiumError: BotiumError$3
 } = BotiumError_1;
 
 const executeHook$2 = async (caps, hook, args) => {
@@ -3906,7 +4048,7 @@ const getHook$3 = (caps, data) => {
 
     if (resultWithRequire) {
       if (!allowUnsafe) {
-        throw new BotiumError$2('Security Error. Using unsafe custom hook with require is not allowed', {
+        throw new BotiumError$3('Security Error. Using unsafe custom hook with require is not allowed', {
           type: 'security',
           subtype: 'allow unsafe',
           source: path__default["default"].basename(__filename),
@@ -4361,6 +4503,9 @@ var Utterance_1 = class Utterance {
 };
 
 const debug$d = debug__default["default"]('botium-core-CompilerXlsx');
+const {
+  E_SCRIPTING_MEMORY_COLUMN_MODE
+} = Enums;
 const {
   Convo: Convo$5
 } = Convo_1;
@@ -4673,49 +4818,120 @@ var CompilerXlsx_1 = class CompilerXlsx extends CompilerBase_1 {
       }
 
       if (scriptType === Constants.SCRIPTING_TYPE_SCRIPTING_MEMORY) {
-        const variableNames = [];
-        let colindexTemp = colindex + 1;
-
-        while (true) {
-          const variableNameCell = this.colnames[colindexTemp] + rowindex;
+        const guessScriptingMemoryColumnMode = () => {
+          const line1Cell = this.colnames[colindex] + (rowindex + 1);
 
-          if (sheet[variableNameCell] && sheet[variableNameCell].v) {
-            variableNames.push(sheet[variableNameCell].v);
-          } else {
-            break;
+          if (sheet[line1Cell] && sheet[line1Cell].v) {
+            if (sheet[line1Cell].v.startsWith('$')) return E_SCRIPTING_MEMORY_COLUMN_MODE.TESTCASENAMES;
           }
 
-          colindexTemp++;
-        }
+          return E_SCRIPTING_MEMORY_COLUMN_MODE.VARNAMES;
+        };
 
-        rowindex += 1;
+        const columnMode = this.caps[Capabilities.SCRIPTING_MEMORY_COLUMN_MODE] || guessScriptingMemoryColumnMode();
 
-        while (true) {
-          const caseNameCell = this.colnames[colindex] + rowindex;
+        if (columnMode === E_SCRIPTING_MEMORY_COLUMN_MODE.TESTCASENAMES) {
+          const caseNames = [];
+          let colindexTemp = colindex + 1;
+
+          while (true) {
+            const caseNameCell = this.colnames[colindexTemp] + rowindex;
+
+            if (sheet[caseNameCell] && sheet[caseNameCell].v) {
+              caseNames.push(sheet[caseNameCell].v);
+            } else {
+              break;
+            }
+
+            colindexTemp++;
+          }
 
-          if (sheet[caseNameCell] && sheet[caseNameCell].v) {
-            const caseName = sheet[caseNameCell].v;
-            const values = {};
+          const varNames = [];
+          const varValues = [];
+          rowindex += 1;
 
-            for (let i = 0; i < variableNames.length; i++) {
-              const variableValueCell = this.colnames[colindex + 1 + i] + rowindex;
+          while (true) {
+            const varNameCell = this.colnames[colindex] + rowindex;
 
-              if (sheet[variableValueCell] && sheet[variableValueCell].v) {
-                values[variableNames[i]] = sheet[variableValueCell].v.toString();
-              } else {
-                values[variableNames[i]] = null;
+            if (sheet[varNameCell] && sheet[varNameCell].v) {
+              varNames.push(sheet[varNameCell].v);
+              const values = [];
+
+              for (let i = 0; i < caseNames.length; i++) {
+                const variableValueCell = this.colnames[colindex + 1 + i] + rowindex;
+
+                if (sheet[variableValueCell] && sheet[variableValueCell].v) {
+                  values.push(sheet[variableValueCell].v.toString());
+                } else {
+                  values.push(null);
+                }
               }
+
+              varValues.push(values);
+              rowindex += 1;
+            } else {
+              break;
             }
+          }
 
-            rowindex += 1;
+          for (let caseIndex = 0; caseIndex < caseNames.length; caseIndex++) {
+            const caseName = caseNames[caseIndex];
+            const values = varNames.reduce((agg, varName, varIndex) => {
+              agg[varName] = varValues[varIndex][caseIndex] || null;
+              return agg;
+            }, {});
             scriptResults.push({
               header: {
                 name: caseName
               },
               values: values
             });
-          } else {
-            break;
+          }
+        } else {
+          const variableNames = [];
+          let colindexTemp = colindex + 1;
+
+          while (true) {
+            const variableNameCell = this.colnames[colindexTemp] + rowindex;
+
+            if (sheet[variableNameCell] && sheet[variableNameCell].v) {
+              variableNames.push(sheet[variableNameCell].v);
+            } else {
+              break;
+            }
+
+            colindexTemp++;
+          }
+
+          rowindex += 1;
+
+          while (true) {
+            const caseNameCell = this.colnames[colindex] + rowindex;
+
+            if (sheet[caseNameCell] && sheet[caseNameCell].v) {
+              const caseName = sheet[caseNameCell].v;
+              const values = {};
+
+              for (let i = 0; i < variableNames.length; i++) {
+                const variableValueCell = this.colnames[colindex + 1 + i] + rowindex;
+
+                if (sheet[variableValueCell] && sheet[variableValueCell].v) {
+                  values[variableNames[i]] = sheet[variableValueCell].v.toString();
+                } else {
+                  values[variableNames[i]] = null;
+                }
+              }
+
+              rowindex += 1;
+              scriptResults.push({
+                header: {
+                  name: caseName
+                },
+                values: values
+              });
+            } else {
+              break;
+            }
           }
         }
       }
@@ -4875,7 +5091,8 @@ const {
   linesToConvoStep: linesToConvoStep$3,
   convoStepToLines,
   validateConvo,
-  validSenders: validSenders$2
+  validSenders: validSenders$2,
+  linesToScriptingMemories: linesToScriptingMemories$1
 } = helper;
 var CompilerTxt_1 = class CompilerTxt extends CompilerBase_1 {
   constructor(context, caps = {}) {
@@ -5006,30 +5223,12 @@ var CompilerTxt_1 = class CompilerTxt extends CompilerBase_1 {
 
   _compileScriptingMemory(lines) {
     if (lines && lines.length > 1) {
-      const names = lines[0].split('|').map(name => name.trim()).slice(1);
-      const scriptingMemories = [];
-
-      for (let row = 1; row < lines.length; row++) {
-        if (!lines[row] || lines[row].length === 0) continue;
-        const rawRow = lines[row].split('|').map(name => name.trim());
-        const caseName = rawRow[0];
-        const values = rawRow.slice(1);
-        const json = {};
-
-        for (let col = 0; col < names.length; col++) {
-          json[names[col]] = values[col];
-        }
+      const scriptingMemories = linesToScriptingMemories$1(lines, this.caps[Capabilities.SCRIPTING_MEMORY_COLUMN_MODE]);
 
-        const scriptingMemory = {
-          header: {
-            name: caseName
-          },
-          values: json
-        };
-        scriptingMemories.push(scriptingMemory);
+      if (scriptingMemories && scriptingMemories.length > 0) {
+        this.context.AddScriptingMemories(scriptingMemories);
       }
 
-      this.context.AddScriptingMemories(scriptingMemories);
       return scriptingMemories;
     }
   }
@@ -5073,6 +5272,9 @@ var CompilerTxt_1 = class CompilerTxt extends CompilerBase_1 {
 
 };
 
+const {
+  parse
+} = sync__default["default"];
 const debug$c = debug__default["default"]('botium-core-CompilerCsv');
 const {
   Convo: Convo$3
@@ -5145,7 +5347,7 @@ var CompilerCsv_1 = class CompilerCsv extends CompilerBase_1 {
     let rows;
 
     try {
-      rows = sync__default["default"](scriptData, {
+      rows = parse(scriptData, {
         delimiter,
         escape: this.caps[Capabilities.SCRIPTING_CSV_ESCAPE],
         quote: this.caps[Capabilities.SCRIPTING_CSV_QUOTE],
@@ -5284,7 +5486,8 @@ const {
 } = Convo_1;
 const {
   linesToConvoStep: linesToConvoStep$1,
-  validSenders: validSenders$1
+  validSenders: validSenders$1,
+  linesToScriptingMemories
 } = helper;
 var CompilerObjectBase_1 = class CompilerObjectBase extends CompilerBase_1 {
   constructor(context, caps = {}) {
@@ -5393,29 +5596,12 @@ var CompilerObjectBase_1 = class CompilerObjectBase extends CompilerBase_1 {
     if (lines && lines.length > 0) {
       if (lodash__default["default"].isString(lines[0])) {
         if (lines.length > 1) {
-          const names = lines[0].split('|').map(name => name.trim()).slice(1);
-          const scriptingMemories = [];
-
-          for (let row = 1; row < lines.length; row++) {
-            const rawRow = lines[row].split('|').map(name => name.trim());
-            const caseName = rawRow[0];
-            const values = rawRow.slice(1);
-            const json = {};
+          const scriptingMemories = linesToScriptingMemories(lines, this.caps[Capabilities.SCRIPTING_MEMORY_COLUMN_MODE]);
 
-            for (let col = 0; col < names.length; col++) {
-              json[names[col]] = values[col];
-            }
-
-            const scriptingMemory = {
-              header: {
-                name: caseName
-              },
-              values: json
-            };
-            scriptingMemories.push(scriptingMemory);
+          if (scriptingMemories && scriptingMemories.length > 0) {
+            this.context.AddScriptingMemories(scriptingMemories);
           }
 
-          this.context.AddScriptingMemories(scriptingMemories);
           return scriptingMemories;
         }
       } else {
@@ -5608,7 +5794,7 @@ const {
   ConvoStep
 } = Convo_1;
 const {
-  BotiumError: BotiumError$1,
+  BotiumError: BotiumError$2,
   botiumErrorFromList,
   botiumErrorFromErr
 } = BotiumError_1;
@@ -5888,7 +6074,7 @@ var ScriptingProvider_1 = class ScriptingProvider {
           message += ' expected to match ';
           message += tomatch && tomatch.length > 1 ? 'one of ' : '';
           message += `${tomatch.map(e => e ? '"' + e + '"' : '<any response>').join(', ')}`;
-          throw new BotiumError$1(message, {
+          throw new BotiumError$2(message, {
             type: 'asserter',
             source: 'TextMatchAsserter',
             context: {
@@ -5918,7 +6104,7 @@ var ScriptingProvider_1 = class ScriptingProvider {
           message += ' expected NOT to match ';
           message += nottomatch && nottomatch.length > 1 ? 'one of ' : '';
           message += `${nottomatch.map(e => e ? '"' + e + '"' : '<any response>').join(', ')}`;
-          throw new BotiumError$1(message, {
+          throw new BotiumError$2(message, {
             type: 'asserter',
             source: 'TextMatchAsserter',
             context: {
@@ -5965,7 +6151,7 @@ var ScriptingProvider_1 = class ScriptingProvider {
         if (asserter[notAsserterType]) {
           return p(this.retryHelperAsserter, () => asserter[notAsserterType](params));
         } else {
-          return pnot(this.retryHelperAsserter, () => asserter[asserterType](params), new BotiumError$1(`${convoStep.stepTag}: Expected asserter ${asserter.name || asserterSpec.name} with args "${params.args}" to fail`, {
+          return pnot(this.retryHelperAsserter, () => asserter[asserterType](params), new BotiumError$2(`${convoStep.stepTag}: Expected asserter ${asserter.name || asserterSpec.name} with args "${params.args}" to fail`, {
             type: 'asserter',
             source: asserter.name || asserterSpec.name,
             params: {
@@ -6399,7 +6585,7 @@ var ScriptingProvider_1 = class ScriptingProvider {
     });
 
     if (aggregatedNoNames.length) {
-      throw new BotiumError$1('Scripting Memory Definition(s) without name', {
+      throw new BotiumError$2('Scripting Memory Definition(s) without name', {
         type: 'Scripting Memory',
         subtype: 'Scripting Memory without name',
         source: 'ScriptingProvider',
@@ -6415,7 +6601,7 @@ var ScriptingProvider_1 = class ScriptingProvider {
     });
 
     if (aggregatedNoVariables.length) {
-      throw new BotiumError$1(`Scripting Memory Definition(s) ${aggregatedNoVariables.map(e => e.header.name).join(', ')} without variable`, {
+      throw new BotiumError$2(`Scripting Memory Definition(s) ${aggregatedNoVariables.map(e => e.header.name).join(', ')} without variable`, {
         type: 'Scripting Memory',
         subtype: 'Scripting Memory without variable',
         source: 'ScriptingProvider',
@@ -6431,7 +6617,7 @@ var ScriptingProvider_1 = class ScriptingProvider {
     });
 
     if (aggregatedNoVariableNames.length) {
-      throw new BotiumError$1(`Scripting Memory Definition(s) ${aggregatedNoVariableNames.map(e => e.header.name).join(', ')} without variable name`, {
+      throw new BotiumError$2(`Scripting Memory Definition(s) ${aggregatedNoVariableNames.map(e => e.header.name).join(', ')} without variable name`, {
         type: 'Scripting Memory',
         subtype: 'Scripting Memory without variable name',
         source: 'ScriptingProvider',
@@ -6463,7 +6649,7 @@ var ScriptingProvider_1 = class ScriptingProvider {
     }
 
     if (aggregatedDuplicates.length) {
-      throw new BotiumError$1(`Scripting Memory Definition name(s) "${lodash__default["default"].uniq(aggregatedDuplicates.map(d => d.scriptingMemory.header.name)).join(', ')}" are not unique`, {
+      throw new BotiumError$2(`Scripting Memory Definition name(s) "${lodash__default["default"].uniq(aggregatedDuplicates.map(d => d.scriptingMemory.header.name)).join(', ')}" are not unique`, {
         type: 'Scripting Memory',
         subtype: 'Scripting Memory name collision',
         source: 'ScriptingProvider',
@@ -6500,7 +6686,7 @@ var ScriptingProvider_1 = class ScriptingProvider {
     }
 
     if (aggregatedIntersections.length) {
-      throw new BotiumError$1(`Scripting Memory Definitions "${aggregatedIntersections.map(i => i.scriptingMemory.header.name).join(', ')}" are invalid because variable name collision"`, {
+      throw new BotiumError$2(`Scripting Memory Definitions "${aggregatedIntersections.map(i => i.scriptingMemory.header.name).join(', ')}" are invalid because variable name collision"`, {
         type: 'Scripting Memory',
         subtype: 'Scripting Memory variable name collision',
         source: 'ScriptingProvider',
@@ -6589,6 +6775,8 @@ var ScriptingProvider_1 = class ScriptingProvider {
 
     debug$9(`ExpandScriptingMemoryToConvos - ${convosExpandedAll.length} convo expanded, added to convos (${this.convos.length}). Result ${convosExpandedAll.length + this.convos.length} convo`);
     this.convos = this.convos.concat(convosExpandedAll);
+
+    this._sortConvos();
   }
 
   ExpandUtterancesToConvos({
@@ -6628,6 +6816,9 @@ var ScriptingProvider_1 = class ScriptingProvider {
         },
         conversation: [{
           sender: 'me',
+          logicHooks: [{
+            name: 'SKIP_BOT_UNCONSUMED'
+          }],
           messageText: utt.name,
           stepTag: 'Step 1 - tell utterance'
         }, useNameAsIntent ? {
@@ -6943,7 +7134,7 @@ var ScriptingProvider_1 = class ScriptingProvider {
       }
     } else if (scriptingMemories) {
       if (!scriptingMemories.header || !scriptingMemories.header.name) {
-        throw new BotiumError$1('Scripting Memory Definition has no name', {
+        throw new BotiumError$2('Scripting Memory Definition has no name', {
           type: 'Compiler',
           subtype: 'Scripting memory without name',
           source: 'ScriptingProvider',
@@ -6954,7 +7145,7 @@ var ScriptingProvider_1 = class ScriptingProvider {
       }
 
       if (!scriptingMemories.values || !Object.keys(scriptingMemories.values).length) {
-        throw new BotiumError$1('Scripting Memory Definition has no variables', {
+        throw new BotiumError$2('Scripting Memory Definition has no variables', {
           type: 'Compiler',
           subtype: 'Scripting memory without variable',
           source: 'ScriptingProvider',
@@ -6965,7 +7156,7 @@ var ScriptingProvider_1 = class ScriptingProvider {
       }
 
       if (scriptingMemories.values && !lodash__default["default"].isUndefined(scriptingMemories.values[''])) {
-        throw new BotiumError$1('Scripting Memory Definition variable has no name', {
+        throw new BotiumError$2('Scripting Memory Definition variable has no name', {
           type: 'Compiler',
           subtype: 'Scripting memory without variable name',
           source: 'ScriptingProvider',
@@ -7400,7 +7591,7 @@ var BaseContainer_1 = class BaseContainer {
     this.tempDirectory = tempDirectory;
     this.cleanupTasks = [];
     this.queues = {};
-    this.userSaysLimiter = null;
+    this.bottleneck = null;
   }
 
   Validate() {
@@ -7410,18 +7601,33 @@ var BaseContainer_1 = class BaseContainer {
     this.onBotResponseHook = getHook$1(this.caps, this.caps[Capabilities.CUSTOMHOOK_ONBOTRESPONSE]);
     this.onStopHook = getHook$1(this.caps, this.caps[Capabilities.CUSTOMHOOK_ONSTOP]);
     this.onCleanHook = getHook$1(this.caps, this.caps[Capabilities.CUSTOMHOOK_ONCLEAN]);
-    return Promise.resolve();
-  }
 
-  Build() {
-    if (this.caps[Capabilities.RATELIMIT_USERSAYS_MAXCONCURRENT] || this.caps[Capabilities.RATELIMIT_USERSAYS_MINTIME]) {
+    if (this.caps[Capabilities.RATELIMIT_BOTTLENECK_FN]) {
+      if (lodash__default["default"].isFunction(this.caps[Capabilities.RATELIMIT_BOTTLENECK_FN])) {
+        this.bottleneck = this.caps[Capabilities.RATELIMIT_BOTTLENECK_FN];
+        debug$7('Validate: Applying userSays rate limits from capability');
+      } else {
+        const limiter = new bottleneck__default["default"](this.caps[Capabilities.RATELIMIT_BOTTLENECK_FN]);
+
+        this.bottleneck = fn => limiter.schedule(fn);
+
+        debug$7(`Validate: Applying userSays rate limits ${util__default["default"].inspect(this.caps[Capabilities.RATELIMIT_BOTTLENECK_FN])}`);
+      }
+    } else if (this.caps[Capabilities.RATELIMIT_USERSAYS_MAXCONCURRENT] || this.caps[Capabilities.RATELIMIT_USERSAYS_MINTIME]) {
       const opts = {};
       if (this.caps[Capabilities.RATELIMIT_USERSAYS_MAXCONCURRENT]) opts.maxConcurrent = this.caps[Capabilities.RATELIMIT_USERSAYS_MAXCONCURRENT];
       if (this.caps[Capabilities.RATELIMIT_USERSAYS_MINTIME]) opts.minTime = this.caps[Capabilities.RATELIMIT_USERSAYS_MINTIME];
-      this.userSaysLimiter = new bottleneck__default["default"](opts);
-      debug$7(`Build: Applying userSays rate limits ${util__default["default"].inspect(opts)}`);
+      const limiter = new bottleneck__default["default"](opts);
+
+      this.bottleneck = fn => limiter.schedule(fn);
+
+      debug$7(`Validate: Applying userSays rate limits ${util__default["default"].inspect(opts)}`);
     }
 
+    return Promise.resolve();
+  }
+
+  Build() {
     return new Promise((resolve, reject) => {
       this._RunCustomHook('onBuild', this.onBuildHook).then(() => resolve(this)).catch(err => reject(err));
     });
@@ -7447,8 +7653,8 @@ var BaseContainer_1 = class BaseContainer {
       meMsg
     }).then(() => this.UserSaysImpl(meMsg));
 
-    if (this.userSaysLimiter) {
-      return this.userSaysLimiter.schedule(run);
+    if (this.bottleneck) {
+      return this.bottleneck(run);
     } else {
       return run();
     }
@@ -7927,16 +8133,23 @@ const {
 const {
   escapeJSONString
 } = Utils;
+const {
+  BotiumError: BotiumError$1
+} = BotiumError_1;
 
 mustache__default["default"].escape = s => s;
 
 var SimpleRestContainer_1 = class SimpleRestContainer {
   constructor({
     queueBotSays,
-    caps
+    caps,
+    bottleneck
   }) {
     this.queueBotSays = queueBotSays;
     this.caps = Object.assign({}, Defaults, caps);
+
+    this.bottleneck = bottleneck || (fn => fn());
+
     this.processInbound = false;
     this.redisTopic = this.caps[Capabilities.SIMPLEREST_REDIS_TOPIC] || 'SIMPLEREST_INBOUND_SUBSCRIPTION';
 
@@ -8223,31 +8436,82 @@ var SimpleRestContainer_1 = class SimpleRestContainer {
       }
 
       for (const jsonPathRoot of jsonPathRoots) {
-        const media = [];
-        const buttons = [];
-        const jsonPathsMedia = getAllCapValues(Capabilities.SIMPLEREST_MEDIA_JSONPATH, this.caps);
-        jsonPathsMedia.forEach(jsonPath => {
-          const responseMedia = jsonpath__default["default"].query(jsonPathRoot, jsonPath);
-
-          if (responseMedia) {
-            (lodash__default["default"].isArray(responseMedia) ? lodash__default["default"].flattenDeep(responseMedia) : [responseMedia]).forEach(m => media.push({
-              mediaUri: m,
-              mimeType: mimeTypes__default["default"].lookup(m) || 'application/unknown'
-            }));
-            debug$4(`found response media: ${util__default["default"].inspect(media)}`);
+        const _retrieveMedia = (jsonPathMediaRoot, jsonPathsMedia) => {
+          const retrievedMedia = [];
+          jsonPathsMedia.forEach(jsonPath => {
+            const responseMedia = jsonpath__default["default"].query(jsonPathMediaRoot, jsonPath);
+
+            if (responseMedia) {
+              (lodash__default["default"].isArray(responseMedia) ? lodash__default["default"].flattenDeep(responseMedia) : [responseMedia]).forEach(m => retrievedMedia.push({
+                mediaUri: m,
+                mimeType: mimeTypes__default["default"].lookup(m) || 'application/unknown'
+              }));
+            }
+          });
+          return retrievedMedia;
+        };
+
+        const _retrieveButtons = (jsonPathButtonRoot, jsonPathsButtons) => {
+          const retrievedButtons = [];
+          jsonPathsButtons.forEach(jsonPath => {
+            const responseButtons = jsonpath__default["default"].query(jsonPathButtonRoot, jsonPath);
+
+            if (responseButtons) {
+              (lodash__default["default"].isArray(responseButtons) ? lodash__default["default"].flattenDeep(responseButtons) : [responseButtons]).forEach(b => retrievedButtons.push({
+                text: b
+              }));
+            }
+          });
+          return retrievedButtons;
+        };
+
+        const _getCardText = responseCardText => {
+          if (responseCardText) {
+            const texts = lodash__default["default"].isArray(responseCardText) ? lodash__default["default"].flattenDeep(responseCardText) : [responseCardText];
+
+            if (texts.length > 1) {
+              debug$4(`more than one text found for card: ${util__default["default"].inspect(texts)}`);
+            }
+
+            if (texts.length > 0) {
+              return texts[0];
+            }
           }
-        });
-        const jsonPathsButtons = getAllCapValues(Capabilities.SIMPLEREST_BUTTONS_JSONPATH, this.caps);
-        jsonPathsButtons.forEach(jsonPath => {
-          const responseButtons = jsonpath__default["default"].query(jsonPathRoot, jsonPath);
-
-          if (responseButtons) {
-            (lodash__default["default"].isArray(responseButtons) ? lodash__default["default"].flattenDeep(responseButtons) : [responseButtons]).forEach(b => buttons.push({
-              text: b
-            }));
-            debug$4(`found response buttons: ${util__default["default"].inspect(buttons)}`);
+        };
+
+        const media = _retrieveMedia(jsonPathRoot, getAllCapValues(Capabilities.SIMPLEREST_MEDIA_JSONPATH, this.caps));
+
+        debug$4(`found response media: ${util__default["default"].inspect(media)}`);
+
+        const buttons = _retrieveButtons(jsonPathRoot, getAllCapValues(Capabilities.SIMPLEREST_BUTTONS_JSONPATH, this.caps));
+
+        debug$4(`found response buttons: ${util__default["default"].inspect(buttons)}`);
+        const cards = [];
+        const jsonPathsCards = getAllCapValues(Capabilities.SIMPLEREST_CARDS_JSONPATH, this.caps);
+        jsonPathsCards.forEach(jsonPath => {
+          const responseCards = jsonpath__default["default"].query(jsonPathRoot, jsonPath);
+
+          if (responseCards) {
+            (lodash__default["default"].isArray(responseCards) ? lodash__default["default"].flattenDeep(responseCards) : [responseCards]).forEach(c => {
+              const card = {};
+              const jsonPathsCardText = getAllCapValues(Capabilities.SIMPLEREST_CARD_TEXT_JSONPATH, this.caps);
+              jsonPathsCardText.forEach(jsonPath => {
+                card.text = _getCardText(jsonpath__default["default"].query(c, jsonPath));
+              });
+              const jsonPathsCardSubText = getAllCapValues(Capabilities.SIMPLEREST_CARD_SUBTEXT_JSONPATH, this.caps);
+              jsonPathsCardSubText.forEach(jsonPath => {
+                card.subtext = _getCardText(jsonpath__default["default"].query(c, jsonPath));
+              });
+              card.buttons = _retrieveButtons(c, getAllCapValues(Capabilities.SIMPLEREST_CARD_BUTTONS_JSONPATH, this.caps));
+              card.media = _retrieveMedia(c, getAllCapValues(Capabilities.SIMPLEREST_CARD_ATTACHMENTS_JSONPATH, this.caps));
+
+              if (lodash__default["default"].keys(card).length > 0) {
+                cards.push(card);
+              }
+            });
           }
         });
+        debug$4(`found response cards: ${util__default["default"].inspect(cards)}`);
         let hasMessageText = false;
         const jsonPathsTexts = getAllCapValues(Capabilities.SIMPLEREST_RESPONSE_JSONPATH, this.caps);
 
@@ -8264,7 +8528,8 @@ var SimpleRestContainer_1 = class SimpleRestContainer {
               sourceData: body,
               messageText,
               media,
-              buttons
+              buttons,
+              cards
             };
             await executeHook(this.caps, this.responseHook, Object.assign({
               botMsg,
@@ -8280,7 +8545,8 @@ var SimpleRestContainer_1 = class SimpleRestContainer {
             messageText: '',
             sourceData: body,
             media,
-            buttons
+            buttons,
+            cards
           };
           const beforeHookKeys = Object.keys(botMsg);
           await executeHook(this.caps, this.responseHook, Object.assign({
@@ -8289,7 +8555,7 @@ var SimpleRestContainer_1 = class SimpleRestContainer {
           }, this.view));
           const afterHookKeys = Object.keys(botMsg);
 
-          if (beforeHookKeys.length !== afterHookKeys.length || !!(botMsg.messageText && botMsg.messageText.length > 0) || botMsg.media.length > 0 || botMsg.buttons.length > 0 || !this.caps[Capabilities.SIMPLEREST_IGNORE_EMPTY]) {
+          if (beforeHookKeys.length !== afterHookKeys.length || !!(botMsg.messageText && botMsg.messageText.length > 0) || botMsg.media.length > 0 || botMsg.buttons.length > 0 || botMsg.cards.length > 0 || !this.caps[Capabilities.SIMPLEREST_IGNORE_EMPTY]) {
             result.push(botMsg);
           }
         }
@@ -8316,6 +8582,17 @@ var SimpleRestContainer_1 = class SimpleRestContainer {
               debug$4(Utils.shortenJsonString(body));
             }
 
+            if (body) {
+              const jsonBody = Utils.toJsonWeak(body);
+              const errKey = Object.keys(jsonBody).find(k => k.startsWith('err') || k.startsWith('fail'));
+
+              if (errKey) {
+                return reject(new BotiumError$1(`got error response: ${response.statusCode}/${response.statusMessage} - ${jsonBody[errKey]}`, {
+                  message: Utils.shortenJsonString(body)
+                }));
+              }
+            }
+
             return reject(new Error(`got error response: ${response.statusCode}/${response.statusMessage}`));
           }
 
@@ -8413,6 +8690,16 @@ var SimpleRestContainer_1 = class SimpleRestContainer {
       }
     }
 
+    if (msg.ADD_FORM_PARAM && Object.keys(msg.ADD_FORM_PARAM).length > 0) {
+      requestOptions.form = {};
+
+      for (const formKey of Object.keys(msg.ADD_FORM_PARAM)) {
+        const formValue = this._getMustachedVal(lodash__default["default"].isString(msg.ADD_FORM_PARAM[formKey]) ? msg.ADD_FORM_PARAM[formKey] : JSON.stringify(msg.ADD_FORM_PARAM[formKey]), false);
+
+        requestOptions.form[formKey] = formValue;
+      }
+    }
+
     if (msg.ADD_HEADER && Object.keys(msg.ADD_HEADER).length > 0) {
       requestOptions.headers = requestOptions.headers || {};
 
@@ -8454,7 +8741,7 @@ var SimpleRestContainer_1 = class SimpleRestContainer {
         err,
         response,
         body
-      } = await new Promise(resolve => {
+      } = await this.bottleneck(() => new Promise(resolve => {
         request__default["default"](pingConfig, (err, response, body) => {
           resolve({
             err,
@@ -8462,7 +8749,7 @@ var SimpleRestContainer_1 = class SimpleRestContainer {
             body
           });
         });
-      });
+      }));
 
       if (err) {
         debug$4(`_waitForUrlResponse error on url check ${pingConfig.uri}: ${err}`);
@@ -8986,6 +9273,7 @@ var PluginConnectorContainer_1 = class PluginConnectorContainer extends BaseCont
     this.pluginInstance = tryLoadPlugin(this.caps[Capabilities.CONTAINERMODE], this.caps[Capabilities.PLUGINMODULEPATH], {
       container: this,
       queueBotSays: msg => this._QueueBotSays(msg),
+      bottleneck: this.bottleneck,
       eventEmitter: this.eventEmitter,
       caps: this.caps,
       sources: this.sources,
@@ -9233,9 +9521,9 @@ var BotDriver_1 = class BotDriver {
 
   Build() {
     debug$1(`Build - Botium Core Version: ${version}`);
-    debug$1(`Build - Capabilites: ${util__default["default"].inspect(this.caps)}`);
-    debug$1(`Build - Sources : ${util__default["default"].inspect(this.sources)}`);
-    debug$1(`Build - Envs : ${util__default["default"].inspect(this.envs)}`);
+    debug$1(`Build - Capabilites: ${JSON.stringify(lodash__default["default"].pickBy(this.caps, (value, key) => Defaults$1.Capabilities[key] !== value), null, 2)}`);
+    debug$1(`Build - Sources: ${JSON.stringify(lodash__default["default"].pickBy(this.sources, (value, key) => Defaults$1.Sources[key] !== value), null, 2)}`);
+    debug$1(`Build - Envs: ${JSON.stringify(lodash__default["default"].pickBy(this.envs, (value, key) => Defaults$1.Envs[key] !== value), null, 2)}`);
     this.eventEmitter.emit(Events.CONTAINER_BUILDING);
     return new Promise((resolve, reject) => {
       let repo = null;
@@ -9683,6 +9971,7 @@ var botiumCore = {
   ScriptingConstants: Constants,
   Capabilities: Capabilities,
   Defaults: Defaults$1,
+  Enums: Enums,
   Source: Source,
   Events: Events,
   Plugins: Plugins,
@@ -9702,31 +9991,33 @@ var botiumCore_2 = botiumCore.ScriptingProvider;
 var botiumCore_3 = botiumCore.ScriptingConstants;
 var botiumCore_4 = botiumCore.Capabilities;
 var botiumCore_5 = botiumCore.Defaults;
-var botiumCore_6 = botiumCore.Source;
-var botiumCore_7 = botiumCore.Events;
-var botiumCore_8 = botiumCore.Plugins;
-var botiumCore_9 = botiumCore.BotiumError;
-var botiumCore_10 = botiumCore.ScriptingMemory;
-var botiumCore_11 = botiumCore.HookUtils;
-var botiumCore_12 = botiumCore.LogicHookConstants;
-var botiumCore_13 = botiumCore.Lib;
-var botiumCore_14 = botiumCore.InboundProxy;
-var botiumCore_15 = botiumCore.BotiumMockRichMessageTypes;
+var botiumCore_6 = botiumCore.Enums;
+var botiumCore_7 = botiumCore.Source;
+var botiumCore_8 = botiumCore.Events;
+var botiumCore_9 = botiumCore.Plugins;
+var botiumCore_10 = botiumCore.BotiumError;
+var botiumCore_11 = botiumCore.ScriptingMemory;
+var botiumCore_12 = botiumCore.HookUtils;
+var botiumCore_13 = botiumCore.LogicHookConstants;
+var botiumCore_14 = botiumCore.Lib;
+var botiumCore_15 = botiumCore.InboundProxy;
+var botiumCore_16 = botiumCore.BotiumMockRichMessageTypes;
 
 exports.BotDriver = botiumCore_1;
-exports.BotiumError = botiumCore_9;
-exports.BotiumMockRichMessageTypes = botiumCore_15;
+exports.BotiumError = botiumCore_10;
+exports.BotiumMockRichMessageTypes = botiumCore_16;
 exports.Capabilities = botiumCore_4;
 exports.Defaults = botiumCore_5;
-exports.Events = botiumCore_7;
-exports.HookUtils = botiumCore_11;
-exports.InboundProxy = botiumCore_14;
-exports.Lib = botiumCore_13;
-exports.LogicHookConstants = botiumCore_12;
-exports.Plugins = botiumCore_8;
+exports.Enums = botiumCore_6;
+exports.Events = botiumCore_8;
+exports.HookUtils = botiumCore_12;
+exports.InboundProxy = botiumCore_15;
+exports.Lib = botiumCore_14;
+exports.LogicHookConstants = botiumCore_13;
+exports.Plugins = botiumCore_9;
 exports.ScriptingConstants = botiumCore_3;
-exports.ScriptingMemory = botiumCore_10;
+exports.ScriptingMemory = botiumCore_11;
 exports.ScriptingProvider = botiumCore_2;
-exports.Source = botiumCore_6;
+exports.Source = botiumCore_7;
 exports["default"] = botiumCore;
 //# sourceMappingURL=botium-cjs.js.map