npm - @botpress/api - Versions diffs - 0.27.7 → 0.27.9 - Mend

@botpress/api 0.27.7 → 0.27.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/index.js CHANGED Viewed

@@ -242865,9 +242865,9 @@ var require_lib3 = __commonJS({
   }
 });
-// ../../node_modules/.pnpm/@readme+openapi-parser@2.5.0_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/util.js
+// ../../node_modules/.pnpm/@readme+openapi-parser@2.5.1_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/util.js
 var require_util12 = __commonJS({
-  "../../node_modules/.pnpm/@readme+openapi-parser@2.5.0_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/util.js"(exports) {
+  "../../node_modules/.pnpm/@readme+openapi-parser@2.5.1_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/util.js"(exports) {
     var util3 = require("util");
     var url2 = require_url2();
     exports.format = util3.format;
@@ -258675,9 +258675,9 @@ var require_dist4 = __commonJS({
   }
 });
-// ../../node_modules/.pnpm/@readme+openapi-parser@2.5.0_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/validators/schema.js
+// ../../node_modules/.pnpm/@readme+openapi-parser@2.5.1_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/validators/schema.js
 var require_schema6 = __commonJS({
-  "../../node_modules/.pnpm/@readme+openapi-parser@2.5.0_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/validators/schema.js"(exports, module2) {
+  "../../node_modules/.pnpm/@readme+openapi-parser@2.5.1_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/validators/schema.js"(exports, module2) {
     var { openapi } = require_lib4();
     var { ono } = require_cjs();
     var betterAjvErrors = require_lib8();
@@ -258711,6 +258711,7 @@ var require_schema6 = __commonJS({
         const err = ajv.errors;
         let additionalErrors = 0;
         let reducedErrors = reduceAjvErrors(err);
+        const totalErrors = reducedErrors.length;
         if (reducedErrors.length >= LARGE_SPEC_ERROR_CAP) {
           try {
             if (JSON.stringify(api2).length >= LARGE_SPEC_SIZE_CAP) {
@@ -258731,7 +258732,7 @@ var require_schema6 = __commonJS({
           message += "\n\n";
           message += `Plus an additional ${additionalErrors} errors. Please resolve the above and re-run validation to see more.`;
         }
-        throw ono.syntax(err, { details: err }, message);
+        throw ono.syntax(err, { details: err, totalErrors }, message);
       }
     }
     function initializeAjv(draft04 = true) {
@@ -258791,9 +258792,9 @@ var require_lib9 = __commonJS({
   }
 });
-// ../../node_modules/.pnpm/@readme+openapi-parser@2.5.0_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/validators/spec/openapi.js
+// ../../node_modules/.pnpm/@readme+openapi-parser@2.5.1_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/validators/spec/openapi.js
 var require_openapi = __commonJS({
-  "../../node_modules/.pnpm/@readme+openapi-parser@2.5.0_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/validators/spec/openapi.js"(exports, module2) {
+  "../../node_modules/.pnpm/@readme+openapi-parser@2.5.1_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/validators/spec/openapi.js"(exports, module2) {
     var swaggerMethods = require_lib9();
     var { ono } = require_cjs();
     var util3 = require_util12();
@@ -258939,9 +258940,9 @@ var require_openapi = __commonJS({
   }
 });
-// ../../node_modules/.pnpm/@readme+openapi-parser@2.5.0_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/validators/spec/swagger.js
+// ../../node_modules/.pnpm/@readme+openapi-parser@2.5.1_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/validators/spec/swagger.js
 var require_swagger = __commonJS({
-  "../../node_modules/.pnpm/@readme+openapi-parser@2.5.0_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/validators/spec/swagger.js"(exports, module2) {
+  "../../node_modules/.pnpm/@readme+openapi-parser@2.5.1_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/validators/spec/swagger.js"(exports, module2) {
     var swaggerMethods = require_lib9();
     var { ono } = require_cjs();
     var util3 = require_util12();
@@ -259164,9 +259165,9 @@ var require_swagger = __commonJS({
   }
 });
-// ../../node_modules/.pnpm/@readme+openapi-parser@2.5.0_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/validators/spec.js
+// ../../node_modules/.pnpm/@readme+openapi-parser@2.5.1_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/validators/spec.js
 var require_spec = __commonJS({
-  "../../node_modules/.pnpm/@readme+openapi-parser@2.5.0_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/validators/spec.js"(exports, module2) {
+  "../../node_modules/.pnpm/@readme+openapi-parser@2.5.1_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/validators/spec.js"(exports, module2) {
     var validateOpenAPI = require_openapi();
     var validateSwagger = require_swagger();
     module2.exports = function validateSpec(api2) {
@@ -259178,9 +259179,9 @@ var require_spec = __commonJS({
   }
 });
-// ../../node_modules/.pnpm/@readme+openapi-parser@2.5.0_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/options.js
+// ../../node_modules/.pnpm/@readme+openapi-parser@2.5.1_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/options.js
 var require_options3 = __commonJS({
-  "../../node_modules/.pnpm/@readme+openapi-parser@2.5.0_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/options.js"(exports, module2) {
+  "../../node_modules/.pnpm/@readme+openapi-parser@2.5.1_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/options.js"(exports, module2) {
     var $RefParserOptions = require_options2();
     var util3 = require_util12();
     var schemaValidator = require_schema6();
@@ -259201,9 +259202,9 @@ var require_options3 = __commonJS({
   }
 });
-// ../../node_modules/.pnpm/@readme+openapi-parser@2.5.0_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/index.js
+// ../../node_modules/.pnpm/@readme+openapi-parser@2.5.1_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/index.js
 var require_lib10 = __commonJS({
-  "../../node_modules/.pnpm/@readme+openapi-parser@2.5.0_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/index.js"(exports, module2) {
+  "../../node_modules/.pnpm/@readme+openapi-parser@2.5.1_openapi-types@12.1.3/node_modules/@readme/openapi-parser/lib/index.js"(exports, module2) {
     var { ono } = require_cjs();
     var $RefParser = require_lib3();
     var dereference = require_dereference2();
@@ -259317,7 +259318,7 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
-// ../../node_modules/.pnpm/@bpinternal+opapi@0.10.12_openapi-types@12.1.3/node_modules/@bpinternal/opapi/dist/index.mjs
+// ../../node_modules/.pnpm/@bpinternal+opapi@0.10.15_openapi-types@12.1.3/node_modules/@bpinternal/opapi/dist/index.mjs
 var import_zod_openapi = __toESM(require_src(), 1);
 var import_zod_openapi2 = __toESM(require_src(), 1);
 var import_path = __toESM(require("path"), 1);
@@ -259363,7 +259364,7 @@ var title = (str2) => {
   return str2.split(/(?=[A-Z])|[\.\-\s_]/).map((s2) => s2.trim()).filter((s2) => !!s2).map((s2) => capitalize(s2.toLowerCase())).join(" ");
 };
-// ../../node_modules/.pnpm/@bpinternal+opapi@0.10.12_openapi-types@12.1.3/node_modules/@bpinternal/opapi/dist/index.mjs
+// ../../node_modules/.pnpm/@bpinternal+opapi@0.10.15_openapi-types@12.1.3/node_modules/@bpinternal/opapi/dist/index.mjs
 var import_decompress = __toESM(require_decompress(), 1);
 var import_fs3 = __toESM(require("fs"), 1);
 var import_promises = __toESM(require("fs/promises"), 1);
@@ -262280,7 +262281,7 @@ var {
   mergeConfig: mergeConfig2
 } = axios_default;
-// ../../node_modules/.pnpm/@bpinternal+opapi@0.10.12_openapi-types@12.1.3/node_modules/@bpinternal/opapi/dist/index.mjs
+// ../../node_modules/.pnpm/@bpinternal+opapi@0.10.15_openapi-types@12.1.3/node_modules/@bpinternal/opapi/dist/index.mjs
 var import_json_schema_to_typescript = __toESM(require_src3(), 1);
 var import_fs4 = __toESM(require("fs"), 1);
 var import_path3 = __toESM(require("path"), 1);
@@ -266616,7 +266617,7 @@ async function openapiTS(schema3, options = {}) {
 }
 var dist_default = openapiTS;
-// ../../node_modules/.pnpm/@bpinternal+opapi@0.10.12_openapi-types@12.1.3/node_modules/@bpinternal/opapi/dist/index.mjs
+// ../../node_modules/.pnpm/@bpinternal+opapi@0.10.15_openapi-types@12.1.3/node_modules/@bpinternal/opapi/dist/index.mjs
 var import_openapi3_ts = __toESM(require_dist3(), 1);
 var import_verror2 = __toESM(require_verror(), 1);
 var import_verror3 = __toESM(require_verror(), 1);
@@ -270257,7 +270258,7 @@ var z = /* @__PURE__ */ Object.freeze({
   ZodError
 });
-// ../../node_modules/.pnpm/@bpinternal+opapi@0.10.12_openapi-types@12.1.3/node_modules/@bpinternal/opapi/dist/index.mjs
+// ../../node_modules/.pnpm/@bpinternal+opapi@0.10.15_openapi-types@12.1.3/node_modules/@bpinternal/opapi/dist/index.mjs
 var import_openapi_parser = __toESM(require_lib10(), 1);
 var import_json_schema_to_typescript2 = __toESM(require_src3(), 1);
 var import_zod_openapi4 = __toESM(require_src(), 1);
@@ -271484,7 +271485,7 @@ function createState(props, opts = {}) {
       throw new import_verror3.VError(`Invalid operation name ${name}. It must be alphanumeric and start with a letter`);
     }
     if (schemas[name]) {
-      throw new import_verror3.VError(`Operation ${name} already exists`);
+      throw new import_verror3.VError(`Schema ${name} already exists`);
     }
     schemas[name] = {
       section: schemaEntry.section,
@@ -272350,7 +272351,7 @@ const parseOperationRequest =
   ) =>
   async (props: OperationProps, req: unknown): Promise<types.Response> => {
-    const validate = ajv.compile(requestSchema)
+    const validate = ajv.compile<unknown>(requestSchema)
     const isValid = validate(req)
     if (!isValid) {
       const message = validate.errors?.[0]?.message ?? 'Invalid request'
@@ -272415,6 +272416,23 @@ var exportRouteTree = (operations) => async (path2) => {
   content += CREATE_ROUTE_TREE_FOOT;
   await import_fs7.default.promises.writeFile(path2, content);
 };
+var fixSchema2 = (schema22) => {
+  schema22 = replaceNullableWithUnion(schema22);
+  schema22 = setDefaultAdditionalProperties(schema22, false);
+  return schema22;
+};
+var toTs2 = async (originalSchema, name) => {
+  let { title: title4, ...schema22 } = originalSchema;
+  schema22 = fixSchema2(schema22);
+  const typeCode = await (0, import_json_schema_to_typescript3.compile)(schema22, name, {
+    unknownAny: false,
+    bannerComment: "",
+    additionalProperties: false,
+    ignoreMinAndMaxItems: true
+  });
+  return `${typeCode}
+`;
+};
 var exportSchemas = (schemas) => async (outDir) => {
   await import_promises4.default.mkdir(outDir, { recursive: true });
   const jsonFiles = [];
@@ -272431,7 +272449,7 @@ var exportSchemas = (schemas) => async (outDir) => {
     await import_promises4.default.writeFile(jsonFilePath, jsonCode);
     jsonFiles.push({ name, filename: jsonFileName });
     const typeFileName = `${name}.t`;
-    const typeCode = await (0, import_json_schema_to_typescript3.compile)(jsonSchema, name, { unknownAny: false });
+    const typeCode = await toTs2(jsonSchema, name);
     const typeFilePath = import_path6.default.join(outDir, `${typeFileName}.ts`);
     await import_promises4.default.writeFile(typeFilePath, typeCode);
     typeFiles.push({ name, filename: typeFileName });
@@ -272686,7 +272704,11 @@ var generateHandler2 = async (state2, outDir) => {
   await exportHandler(handlerFile);
   generateOpenapi(state2, outDir);
 };
-var schema2 = import_zod_openapi2.extendApi;
+var schema2 = (schema22, schemaObject) => {
+  const This = schema22.constructor;
+  const copy = new This(schema22._def);
+  return (0, import_zod_openapi2.extendApi)(copy, schemaObject);
+};
 function exportClient(state2) {
   function _exportClient(dir = ".", props, postProcessors) {
     let options;
@@ -272742,7 +272764,7 @@ var state = {
             "channel": {
               "type": "string",
               "maxLength": 200,
-              "description": "Unique identifier of the integration that was installed on the bot"
+              "description": "Channel name"
             },
             "tags": {
               "type": "object",
@@ -272895,7 +272917,7 @@ var state = {
             "channel": {
               "type": "string",
               "maxLength": 200,
-              "description": "Unique identifier of the integration that was installed on the bot"
+              "description": "Channel name"
             },
             "tags": {
               "type": "object",
@@ -273185,7 +273207,7 @@ var state = {
             "type": {
               "type": "string",
               "maxLength": 200,
-              "description": "Unique identifier of the integration that was installed on the bot"
+              "description": "Type of the [Event](#schema_event)."
             },
             "payload": {
               "type": "object",
@@ -273373,18 +273395,18 @@ var state = {
               "type": "string",
               "minLength": 28,
               "maxLength": 36,
-              "description": "User id"
+              "description": "ID of the [User](#schema_user)"
             },
             "conversationId": {
               "type": "string",
               "minLength": 28,
               "maxLength": 36,
-              "description": "User id"
+              "description": "ID of the [Conversation](#schema_conversation)"
             },
             "type": {
               "type": "string",
               "maxLength": 200,
-              "description": "Unique identifier of the integration that was installed on the bot"
+              "description": "Type of the [Message](#schema_message) represents the resource type that the message is related to"
             },
             "tags": {
               "type": "object",
@@ -273392,7 +273414,7 @@ var state = {
                 "type": "string",
                 "maxLength": 500
               },
-              "description": "Set of [Tags](#tags) that you can attach to a [Message](#schema_message). The set of [Tags](#tags) available on a [Message](#schema_message) is restricted by the list of [Tags](#tags) defined previously by the [Bot](#schema_bot). Individual keys can be unset by posting an empty value to them."
+              "description": "Set of [Tags](/docs/developers/concepts/tags) that you can attach to a [Message](#schema_message). The set of [Tags](/docs/developers/concepts/tags) available on a [Message](#schema_message) is restricted by the list of [Tags](/docs/developers/concepts/tags) defined previously by the [Bot](#schema_bot). Individual keys can be unset by posting an empty value to them."
             },
             "schedule": {
               "type": "object",
@@ -273401,7 +273423,7 @@ var state = {
                   "type": "string",
                   "maxLength": 28,
                   "minLength": 24,
-                  "description": "When the [Event](#schema_event) will be sent, in the ISO 8601 format"
+                  "description": "When the [Message](#schema_message) will be sent, in the ISO 8601 format"
                 },
                 "delay": {
                   "type": "number",
@@ -273462,18 +273484,18 @@ var state = {
               "type": "string",
               "minLength": 28,
               "maxLength": 36,
-              "description": "User id"
+              "description": "ID of the [User](#schema_user)"
             },
             "conversationId": {
               "type": "string",
               "minLength": 28,
               "maxLength": 36,
-              "description": "User id"
+              "description": "ID of the [Conversation](#schema_conversation)"
             },
             "type": {
               "type": "string",
               "maxLength": 200,
-              "description": "Unique identifier of the integration that was installed on the bot"
+              "description": "Type of the [Message](#schema_message) represents the resource type that the message is related to"
             },
             "tags": {
               "type": "object",
@@ -273481,7 +273503,7 @@ var state = {
                 "type": "string",
                 "maxLength": 500
               },
-              "description": "Set of [Tags](#tags) that you can attach to a [Message](#schema_message). The set of [Tags](#tags) available on a [Message](#schema_message) is restricted by the list of [Tags](#tags) defined previously by the [Bot](#schema_bot). Individual keys can be unset by posting an empty value to them."
+              "description": "Set of [Tags](/docs/developers/concepts/tags) that you can attach to a [Message](#schema_message). The set of [Tags](/docs/developers/concepts/tags) available on a [Message](#schema_message) is restricted by the list of [Tags](/docs/developers/concepts/tags) defined previously by the [Bot](#schema_bot). Individual keys can be unset by posting an empty value to them."
             },
             "schedule": {
               "type": "object",
@@ -273490,7 +273512,7 @@ var state = {
                   "type": "string",
                   "maxLength": 28,
                   "minLength": 24,
-                  "description": "When the [Event](#schema_event) will be sent, in the ISO 8601 format"
+                  "description": "When the [Message](#schema_message) will be sent, in the ISO 8601 format"
                 },
                 "delay": {
                   "type": "number",
@@ -273514,7 +273536,7 @@ var state = {
       },
       "section": "message",
       "response": {
-        "description": "Returns a [Message](#schema_message) object if a valid identifier was provided. Returns [an error](#errors) otherwise",
+        "description": "Returns a [Message](#schema_message) object if a valid identifier was provided. Returns an [Error](#errors) otherwise",
         "schema": {
           "type": "object",
           "properties": {
@@ -273545,7 +273567,7 @@ var state = {
       },
       "section": "message",
       "response": {
-        "description": "Returns a [Message](#schema_message) object if a valid identifier was provided. Returns [an error](#errors) otherwise",
+        "description": "Returns a [Message](#schema_message) object if a valid identifier was provided. Returns an [Error](#errors) otherwise",
         "schema": {
           "type": "object",
           "properties": {
@@ -273584,7 +273606,7 @@ var state = {
               "additionalProperties": {
                 "type": "string"
               },
-              "description": "Set of [Tags](#tags) that you can attach to a [Conversation](#schema_conversation). The set of [Tags](#tags) available on a [Conversation](#schema_conversation) is restricted by the list of [Tags](#tags) defined previously by the [Bot](#schema_bot). Individual keys can be unset by posting an empty value to them."
+              "description": "Set of [Tags](/docs/developers/concepts/tags) that you can attach to a [Conversation](#schema_conversation). The set of [Tags](/docs/developers/concepts/tags) available on a [Conversation](#schema_conversation) is restricted by the list of [Tags](/docs/developers/concepts/tags) defined previously by the [Bot](#schema_bot). Individual keys can be unset by posting an empty value to them."
             }
           },
           "required": [
@@ -273613,7 +273635,7 @@ var state = {
     },
     "listMessages": {
       "name": "listMessages",
-      "description": "Retrieves a list of [Messages](#schema_message) you\u2019ve previously created. The messages are returned in sorted order, with the most recent appearing first. The list can be filtered using [Tags](#tags).",
+      "description": "Retrieves a list of [Message](#schema_message) you\u2019ve previously created. The messages are returned in sorted order, with the most recent appearing first. The list can be filtered using [Tags](/docs/developers/concepts/tags).",
       "method": "get",
       "path": "/v1/chat/messages",
       "parameters": {
@@ -273641,7 +273663,7 @@ var state = {
       },
       "section": "message",
       "response": {
-        "description": "Returns a list of [Messages](#schema_message) objects.",
+        "description": "Returns a list of [Message](#schema_message) objects.",
         "schema": {
           "type": "object",
           "properties": {
@@ -273714,7 +273736,7 @@ var state = {
             "integrationName": {
               "type": "string",
               "maxLength": 200,
-              "description": "[DEPRECATED] To create a user from within a bot, call an action of the integration instead.",
+              "description": "[DEPRECATED] To create a [User](#schema_user) from within a bot, call an action of the integration instead.",
               "deprecated": true
             },
             "name": {
@@ -273737,7 +273759,7 @@ var state = {
       },
       "section": "user",
       "response": {
-        "description": "Returns a [User](#schema_user) object if creation succeeds. Returns [an error](#errors) otherwise",
+        "description": "Returns a [User](#schema_user) object if creation succeeds. Returns an [Error](#errors) otherwise",
         "status": 201,
         "schema": {
           "type": "object",
@@ -273769,7 +273791,7 @@ var state = {
       },
       "section": "user",
       "response": {
-        "description": "Returns a [User](#schema_user) object if a valid identifier was provided. Returns [an error](#errors) otherwise",
+        "description": "Returns a [User](#schema_user) object if a valid identifier was provided. Returns an [Error](#errors) otherwise",
         "schema": {
           "type": "object",
           "properties": {
@@ -273787,7 +273809,7 @@ var state = {
     },
     "listUsers": {
       "name": "listUsers",
-      "description": "Retrieves a list of [User](#schema_user) previously created. The users are returned in sorted order, with the most recent appearing first. The list can be filtered using [Tags](#tags).",
+      "description": "Retrieves a list of [User](#schema_user) previously created. The users are returned in sorted order, with the most recent appearing first. The list can be filtered using [Tags](/docs/developers/concepts/tags).",
       "method": "get",
       "path": "/v1/chat/users",
       "parameters": {
@@ -273866,7 +273888,7 @@ var state = {
             "integrationName": {
               "type": "string",
               "maxLength": 200,
-              "description": "[DEPRECATED] To create a user from within a bot, call an action of the integration instead.",
+              "description": "[DEPRECATED] To create a [User](#schema_user) from within a bot, call an action of the integration instead.",
               "deprecated": true
             },
             "name": {
@@ -273889,7 +273911,7 @@ var state = {
       },
       "section": "user",
       "response": {
-        "description": "Returns a [User](#schema_user) object if a valid identifier was provided. Returns [an error](#errors) otherwise",
+        "description": "Returns a [User](#schema_user) object if a valid identifier was provided. Returns an [Error](#errors) otherwise",
         "schema": {
           "type": "object",
           "properties": {
@@ -274256,7 +274278,7 @@ var state = {
             "type": {
               "type": "string",
               "maxLength": 200,
-              "description": "Unique identifier of the integration that was installed on the bot"
+              "description": "Type of the action"
             },
             "input": {
               "type": "object",
@@ -274339,7 +274361,7 @@ var state = {
       },
       "section": "task",
       "response": {
-        "description": "Returns a [Task](#schema_task) object if a valid identifier was provided. Returns [an error](#errors) otherwise",
+        "description": "Returns a [Task](#schema_task) object if a valid identifier was provided. Returns an [Error](#errors) otherwise",
         "schema": {
           "type": "object",
           "properties": {
@@ -274378,7 +274400,7 @@ var state = {
             "type": {
               "type": "string",
               "maxLength": 200,
-              "description": "Unique identifier of the integration that was installed on the bot"
+              "description": "Type of the task"
             },
             "data": {
               "type": "object",
@@ -274421,7 +274443,7 @@ var state = {
       },
       "section": "task",
       "response": {
-        "description": "Returns a [Task](#schema_task) object if creation succeeds. Returns [an error](#errors) otherwise",
+        "description": "Returns a [Task](#schema_task) object if creation succeeds. Returns an [Error](#errors) otherwise",
         "status": 201,
         "schema": {
           "type": "object",
@@ -274503,7 +274525,7 @@ var state = {
       },
       "section": "task",
       "response": {
-        "description": "Returns an updated [Task](#schema_task) object if a valid identifier was provided. Returns [an error](#errors) otherwise",
+        "description": "Returns an updated [Task](#schema_task) object if a valid identifier was provided. Returns an [Error](#errors) otherwise",
         "schema": {
           "type": "object",
           "properties": {
@@ -274543,7 +274565,7 @@ var state = {
     },
     "listTasks": {
       "name": "listTasks",
-      "description": "Retrieves a list of [Task](#schema_task) you've previously created. The tasks are returned in sorted order, with the most recent appearing first. The list can be filtered using [Tags](#tags).",
+      "description": "Retrieves a list of [Task](#schema_task) you've previously created. The tasks are returned in sorted order, with the most recent appearing first. The list can be filtered using [Tags](/docs/developers/concepts/tags).",
       "method": "get",
       "path": "/v1/chat/tasks",
       "parameters": {
@@ -275087,17 +275109,17 @@ var state = {
                     "type": "string",
                     "minLength": 28,
                     "maxLength": 36,
-                    "description": "User id"
+                    "description": "ID of the [Integration](#schema_integration)"
                   },
                   "name": {
                     "type": "string",
                     "maxLength": 200,
-                    "description": "Unique identifier of the integration that was installed on the bot"
+                    "description": "Name of the [Integration](#schema_integration)"
                   },
                   "version": {
                     "type": "string",
                     "maxLength": 200,
-                    "description": "Unique identifier of the integration that was installed on the bot"
+                    "description": "Version of the [Integration](#schema_integration)"
                   },
                   "createdAt": {
                     "type": "string",
@@ -275211,7 +275233,7 @@ var state = {
                   "type": "string",
                   "minLength": 28,
                   "maxLength": 36,
-                  "description": "User id"
+                  "description": "ID of the [Integration](#schema_integration)"
                 },
                 "createdAt": {
                   "type": "string",
@@ -275243,17 +275265,17 @@ var state = {
                 "url": {
                   "type": "string",
                   "maxLength": 2e3,
-                  "description": "Title describing the task"
+                  "description": "URL of the [Integration](#schema_integration)"
                 },
                 "name": {
                   "type": "string",
                   "maxLength": 200,
-                  "description": "Unique identifier of the integration that was installed on the bot"
+                  "description": "Name of the [Integration](#schema_integration)"
                 },
                 "version": {
                   "type": "string",
                   "maxLength": 200,
-                  "description": "Unique identifier of the integration that was installed on the bot"
+                  "description": "Version of the [Integration](#schema_integration)"
                 },
                 "configuration": {
                   "type": "object",
@@ -275263,8 +275285,7 @@ var state = {
                       "properties": {
                         "linkTemplateScript": {
                           "type": "string",
-                          "maxLength": 2e3,
-                          "description": "Title describing the task"
+                          "maxLength": 2e3
                         },
                         "required": {
                           "type": "boolean"
@@ -275722,7 +275743,7 @@ var state = {
                   "type": "string",
                   "minLength": 28,
                   "maxLength": 36,
-                  "description": "User id"
+                  "description": "ID of the [Integration](#schema_integration)"
                 },
                 "createdAt": {
                   "type": "string",
@@ -275754,17 +275775,17 @@ var state = {
                 "url": {
                   "type": "string",
                   "maxLength": 2e3,
-                  "description": "Title describing the task"
+                  "description": "URL of the [Integration](#schema_integration)"
                 },
                 "name": {
                   "type": "string",
                   "maxLength": 200,
-                  "description": "Unique identifier of the integration that was installed on the bot"
+                  "description": "Name of the [Integration](#schema_integration)"
                 },
                 "version": {
                   "type": "string",
                   "maxLength": 200,
-                  "description": "Unique identifier of the integration that was installed on the bot"
+                  "description": "Version of the [Integration](#schema_integration)"
                 },
                 "configuration": {
                   "type": "object",
@@ -275774,8 +275795,7 @@ var state = {
                       "properties": {
                         "linkTemplateScript": {
                           "type": "string",
-                          "maxLength": 2e3,
-                          "description": "Title describing the task"
+                          "maxLength": 2e3
                         },
                         "required": {
                           "type": "boolean"
@@ -276283,8 +276303,7 @@ var state = {
                     "properties": {
                       "cron": {
                         "type": "string",
-                        "maxLength": 200,
-                        "description": "Unique identifier of the integration that was installed on the bot"
+                        "maxLength": 200
                       }
                     },
                     "required": [
@@ -276294,8 +276313,7 @@ var state = {
                   },
                   "type": {
                     "type": "string",
-                    "maxLength": 200,
-                    "description": "Unique identifier of the integration that was installed on the bot"
+                    "maxLength": 200
                   },
                   "payload": {
                     "type": "object",
@@ -276789,8 +276807,7 @@ var state = {
                     "properties": {
                       "cron": {
                         "type": "string",
-                        "maxLength": 200,
-                        "description": "Unique identifier of the integration that was installed on the bot"
+                        "maxLength": 200
                       }
                     },
                     "required": [
@@ -276800,8 +276817,7 @@ var state = {
                   },
                   "type": {
                     "type": "string",
-                    "maxLength": 200,
-                    "description": "Unique identifier of the integration that was installed on the bot"
+                    "maxLength": 200
                   },
                   "payload": {
                     "type": "object",
@@ -276975,7 +276991,7 @@ var state = {
                     "type": "string",
                     "minLength": 28,
                     "maxLength": 36,
-                    "description": "User id"
+                    "description": "Id of the [Bot](#schema_bot)"
                   },
                   "createdAt": {
                     "type": "string",
@@ -279390,12 +279406,12 @@ var state = {
             "name": {
               "type": "string",
               "maxLength": 200,
-              "description": "Unique identifier of the integration that was installed on the bot"
+              "description": "Name of the [Integration](#schema_integration)"
             },
             "version": {
               "type": "string",
               "maxLength": 200,
-              "description": "Unique identifier of the integration that was installed on the bot"
+              "description": "Version of the [Integration](#schema_integration)"
             },
             "configuration": {
               "type": "object",
@@ -279413,8 +279429,7 @@ var state = {
                     },
                     "linkTemplateScript": {
                       "type": "string",
-                      "maxLength": 2e3,
-                      "description": "Title describing the task"
+                      "maxLength": 2e3
                     }
                   },
                   "additionalProperties": false
@@ -279559,13 +279574,11 @@ var state = {
               "properties": {
                 "fallbackHandlerScript": {
                   "type": "string",
-                  "maxLength": 2e3,
-                  "description": "Title describing the task"
+                  "maxLength": 2e3
                 },
                 "extractScript": {
                   "type": "string",
-                  "maxLength": 2e3,
-                  "description": "Title describing the task"
+                  "maxLength": 2e3
                 }
               },
               "additionalProperties": false
@@ -279832,7 +279845,6 @@ var state = {
                     "linkTemplateScript": {
                       "type": "string",
                       "maxLength": 2e3,
-                      "description": "Title describing the task",
                       "nullable": true
                     },
                     "required": {
@@ -279964,13 +279976,11 @@ var state = {
                 "extractScript": {
                   "type": "string",
                   "maxLength": 2e3,
-                  "description": "Title describing the task",
                   "nullable": true
                 },
                 "fallbackHandlerScript": {
                   "type": "string",
                   "maxLength": 2e3,
-                  "description": "Title describing the task",
                   "nullable": true
                 }
               },
@@ -280266,17 +280276,17 @@ var state = {
                     "type": "string",
                     "minLength": 28,
                     "maxLength": 36,
-                    "description": "User id"
+                    "description": "ID of the [Integration](#schema_integration)"
                   },
                   "name": {
                     "type": "string",
                     "maxLength": 200,
-                    "description": "Unique identifier of the integration that was installed on the bot"
+                    "description": "Name of the [Integration](#schema_integration)"
                   },
                   "version": {
                     "type": "string",
                     "maxLength": 200,
-                    "description": "Unique identifier of the integration that was installed on the bot"
+                    "description": "Version of the [Integration](#schema_integration)"
                   },
                   "createdAt": {
                     "type": "string",
@@ -282329,7 +282339,7 @@ var state = {
     "title": "Botpress API",
     "description": "API for Botpress Cloud",
     "server": "https://api.botpress.cloud",
-    "version": "0.27.7",
+    "version": "0.27.9",
     "prefix": "v1"
   },
   "errors": [
@@ -282653,7 +282663,7 @@ var state = {
             "type": "string",
             "minLength": 28,
             "maxLength": 36,
-            "description": "ID of the [Conversation](#schema_conversation)"
+            "description": "Id of the [Bot](#schema_bot)"
           },
           "createdAt": {
             "type": "string",
@@ -282668,7 +282678,7 @@ var state = {
           "signingSecret": {
             "type": "string",
             "maxLength": 2e3,
-            "description": "Title describing the task"
+            "description": "Signing secret of the [Bot](#schema_bot)"
           },
           "integrations": {
             "type": "object",
@@ -282681,27 +282691,24 @@ var state = {
                 "name": {
                   "type": "string",
                   "maxLength": 200,
-                  "description": "Type of the task"
+                  "description": "Name of the [Integration](#schema_integration)"
                 },
                 "version": {
                   "type": "string",
                   "maxLength": 200,
-                  "description": "Type of the task"
+                  "description": "Version of the [Integration](#schema_integration)"
                 },
                 "webhookUrl": {
                   "type": "string",
-                  "maxLength": 2e3,
-                  "description": "Title describing the task"
+                  "maxLength": 2e3
                 },
                 "webhookId": {
                   "type": "string",
-                  "maxLength": 200,
-                  "description": "Type of the task"
+                  "maxLength": 200
                 },
                 "identifier": {
                   "type": "string",
-                  "maxLength": 2e3,
-                  "description": "Title describing the task"
+                  "maxLength": 2e3
                 },
                 "configuration": {
                   "type": "object",
@@ -282721,14 +282728,13 @@ var state = {
                 "statusReason": {
                   "type": "string",
                   "maxLength": 2e3,
-                  "description": "Title describing the task",
                   "nullable": true
                 },
                 "id": {
                   "type": "string",
                   "minLength": 28,
                   "maxLength": 36,
-                  "description": "ID of the [Conversation](#schema_conversation)"
+                  "description": "ID of the [Integration](#schema_integration)"
                 },
                 "createdAt": {
                   "type": "string",
@@ -282964,8 +282970,7 @@ var state = {
                   "properties": {
                     "cron": {
                       "type": "string",
-                      "maxLength": 200,
-                      "description": "Type of the task"
+                      "maxLength": 200
                     }
                   },
                   "required": [
@@ -282975,8 +282980,7 @@ var state = {
                 },
                 "type": {
                   "type": "string",
-                  "maxLength": 200,
-                  "description": "Type of the task"
+                  "maxLength": 200
                 },
                 "payload": {
                   "type": "object",
@@ -283158,7 +283162,7 @@ var state = {
             "type": "string",
             "minLength": 28,
             "maxLength": 36,
-            "description": "ID of the [Conversation](#schema_conversation)"
+            "description": "ID of the [Integration](#schema_integration)"
           },
           "createdAt": {
             "type": "string",
@@ -283190,17 +283194,17 @@ var state = {
           "url": {
             "type": "string",
             "maxLength": 2e3,
-            "description": "Title describing the task"
+            "description": "URL of the [Integration](#schema_integration)"
           },
           "name": {
             "type": "string",
             "maxLength": 200,
-            "description": "Type of the task"
+            "description": "Name of the [Integration](#schema_integration)"
           },
           "version": {
             "type": "string",
             "maxLength": 200,
-            "description": "Type of the task"
+            "description": "Version of the [Integration](#schema_integration)"
           },
           "configuration": {
             "type": "object",
@@ -283210,8 +283214,7 @@ var state = {
                 "properties": {
                   "linkTemplateScript": {
                     "type": "string",
-                    "maxLength": 2e3,
-                    "description": "Title describing the task"
+                    "maxLength": 2e3
                   },
                   "required": {
                     "type": "boolean"
@@ -283998,7 +284001,7 @@ var state = {
             "type": "string",
             "minLength": 28,
             "maxLength": 36,
-            "description": "ID of the [Conversation](#schema_conversation)"
+            "description": "Id of the [User](#schema_user)"
           },
           "createdAt": {
             "type": "string",
@@ -284047,7 +284050,7 @@ var state = {
             "type": "string",
             "minLength": 28,
             "maxLength": 36,
-            "description": "ID of the [Conversation](#schema_conversation)"
+            "description": "Id of the [Conversation](#schema_conversation)"
           },
           "currentTaskId": {
             "type": "string",
@@ -284102,7 +284105,7 @@ var state = {
             "type": "string",
             "minLength": 28,
             "maxLength": 36,
-            "description": "ID of the [Conversation](#schema_conversation)"
+            "description": "Id of the [Event](#schema_event)"
           },
           "createdAt": {
             "type": "string",
@@ -284112,7 +284115,7 @@ var state = {
           "type": {
             "type": "string",
             "maxLength": 200,
-            "description": "Type of the task"
+            "description": "Type of the [Event](#schema_event)."
           },
           "payload": {
             "type": "object",
@@ -284149,8 +284152,8 @@ var state = {
           "failureReason": {
             "type": "string",
             "maxLength": 2e3,
-            "description": "Reason why the event failed to be processed",
-            "nullable": true
+            "nullable": true,
+            "description": "Reason why the event failed to be processed"
           }
         },
         "required": [
@@ -284174,7 +284177,7 @@ var state = {
             "type": "string",
             "minLength": 28,
             "maxLength": 36,
-            "description": "ID of the [Conversation](#schema_conversation)"
+            "description": "Id of the [Message](#schema_message)"
           },
           "createdAt": {
             "type": "string",
@@ -284184,7 +284187,7 @@ var state = {
           "type": {
             "type": "string",
             "maxLength": 200,
-            "description": "Type of the task"
+            "description": "Type of the [Message](#schema_message) represents the resource type that the message is related to"
           },
           "payload": {
             "type": "object",
@@ -284203,7 +284206,7 @@ var state = {
             "type": "string",
             "minLength": 28,
             "maxLength": 36,
-            "description": "ID of the [Conversation](#schema_conversation)"
+            "description": "ID of the [User](#schema_user)"
           },
           "conversationId": {
             "type": "string",
@@ -284242,7 +284245,7 @@ var state = {
             "type": "string",
             "minLength": 28,
             "maxLength": 36,
-            "description": "ID of the [Conversation](#schema_conversation)"
+            "description": "Id of the [State](#schema_state)"
           },
           "createdAt": {
             "type": "string",
@@ -284258,7 +284261,7 @@ var state = {
             "type": "string",
             "minLength": 28,
             "maxLength": 36,
-            "description": "ID of the [Conversation](#schema_conversation)"
+            "description": "Id of the [Bot](#schema_bot)"
           },
           "conversationId": {
             "type": "string",
@@ -284275,7 +284278,7 @@ var state = {
           "name": {
             "type": "string",
             "maxLength": 200,
-            "description": "Type of the task"
+            "description": "Name of the [State](#schema_state) which is declared inside the bot definition"
           },
           "type": {
             "type": "string",
@@ -284316,7 +284319,7 @@ var state = {
             "type": "string",
             "minLength": 28,
             "maxLength": 36,
-            "description": "ID of the [Conversation](#schema_conversation)"
+            "description": "Id of the [Task](#schema_task)"
           },
           "title": {
             "type": "string",