@tiledesk/tiledesk-server 2.28.2 → 2.29.0

package/services/chatbotService.js

@@ -1,5 +1,6 @@
 const axios = require("axios").default;
 const winston = require('../config/winston');
+const botEvent = require('../event/botEvent');
 let Faq_kb = require("../models/faq_kb");
 
 class ChatbotService {
@@ -9,11 +10,20 @@ class ChatbotService {
   async fork(id_faq_kb, api_url, token, project_id, options) {
     winston.debug("(ChatbotService) fork");
 
+    // `true` is the older skip-subagents flag; publish passes `{ skipSubagents, forPublish }`.
+    const skipSubagents = options === true || (options && options.skipSubagents === true);
     const forPublish = options && options.forPublish === true;
-    const forPublishQuery = forPublish ? '&for_publish=true' : '';
+
+    let url = api_url + '/' + project_id + '/faq_kb/fork/' + id_faq_kb + '?projectid=' + project_id + '&public=false&globals=true';
+    if (skipSubagents) {
+      url += '&skipSubagents=true';
+    }
+    if (forPublish) {
+      url += '&for_publish=true';
+    }
 
     return await axios({
-      url: api_url + '/' + project_id + '/faq_kb/fork/' + id_faq_kb + '?projectid=' + project_id + '&public=false&globals=true' + forPublishQuery,
+      url: url,
       headers: {
         'Content-Type': 'application/json',
         'Authorization': token
@@ -45,8 +55,11 @@ class ChatbotService {
         },
         method: 'GET'
       }).then((resbody) => {
-        winston.debug("(ChatbotService) forking private chatbot " + resbody.data.name)
         let chatbot = resbody.data;
+        if (typeof chatbot === 'string') {
+          chatbot = JSON.parse(chatbot);
+        }
+        winston.debug("(ChatbotService) forking private chatbot " + chatbot.name)
         return chatbot;
       }).catch((err) => {
         winston.error('(ChatbotService) FAQ_KB EXPORTJSON ERROR ' + err);
@@ -63,8 +76,11 @@ class ChatbotService {
         },
         method: 'GET'
       }).then((resbody) => {
-        winston.debug("(ChatbotService) forking public chatbot " + resbody.data.name);
         let chatbot = resbody.data;
+        if (typeof chatbot === 'string') {
+          chatbot = JSON.parse(chatbot);
+        }
+        winston.debug("(ChatbotService) forking public chatbot " + chatbot.name);
         return chatbot
       }).catch((err) => {
         winston.error('(ChatbotService) FAQ_KB CHATBOT TEMPLATES ERROR ' + err);
@@ -100,8 +116,10 @@ class ChatbotService {
   
     winston.debug("(ChatbotService) importFaqs");
 
+    // Full import into the newly created parent: intents + nested subagents.
+    // Subagents are parent-scoped and get parent_id remapped by chatbotController.import.
     return await axios({
-      url: api_url + '/' + project_id + '/faq_kb/importjson/' + id_faq_kb + "?intentsOnly=true",
+      url: api_url + '/' + project_id + '/faq_kb/importjson/' + id_faq_kb,
       headers: {
         'Content-Type': 'application/json',
         'Authorization': token
@@ -125,6 +143,67 @@ class ChatbotService {
         return Promise.reject(err);
       });
   }
+
+  _tilebotEndpoint() {
+    const port = process.env.PORT || '3000';
+    let endpoint = process.env.API_ENDPOINT
+      ? process.env.API_ENDPOINT + "/modules/tilebot/ext/"
+      : ("http://localhost:" + port + "/modules/tilebot/ext/");
+
+    if (process.env.TILEBOT_ENDPOINT) {
+      endpoint = process.env.TILEBOT_ENDPOINT + "/ext/";
+    }
+    return endpoint;
+  }
+
+  async publish({ id_faq_kb, chatbot_id, api_url, token, project_id, user_id, release_note, req }) {
+    const sourceId = chatbot_id || id_faq_kb;
+    winston.debug("(ChatbotService) publish id_faq_kb: " + id_faq_kb + " source: " + sourceId);
+
+    // Keep callsubagent.botId on the development subagent. Its url points at the published snapshot.
+    // for_publish skips FAQ_KB_CREATE on the trashed snapshot; FAQ_KB_PUBLISH is emitted below.
+    const forked = await this.fork(sourceId, api_url, token, project_id, { skipSubagents: true, forPublish: true });
+    const forkedChatBotId = forked.bot_id;
+    winston.debug("(ChatbotService) publish forkedChatBotId: " + forkedChatBotId);
+
+    const updatedForkedChatbot = await Faq_kb.findByIdAndUpdate(
+      forkedChatBotId,
+      {
+        $unset: { slug: 1 },
+        trashed: true,
+        root_id: id_faq_kb,
+        release_note: release_note,
+        publishedBy: user_id,
+        publishedAt: new Date().getTime()
+      },
+      { new: true, upsert: true }
+    ).exec();
+    winston.debug("(ChatbotService) publish updatedForkedChatbot: ", updatedForkedChatbot);
+    botEvent.emit('faqbot.update', updatedForkedChatbot);
+
+    const tilebotEndpoint = this._tilebotEndpoint();
+    winston.debug("(ChatbotService) TILEBOT_ENDPOINT: " + tilebotEndpoint);
+
+    const updatedOriginalChatbot = await Faq_kb.findByIdAndUpdate(
+      id_faq_kb,
+      { url: tilebotEndpoint + forkedChatBotId },
+      { new: true, upsert: true }
+    ).exec();
+    winston.debug("(ChatbotService) publish updatedOriginalChatbot: ", updatedOriginalChatbot);
+
+    await this.setModified(id_faq_kb, false);
+    botEvent.emit('faqbot.update', updatedOriginalChatbot);
+    botEvent.emit('faqbot.publish', {
+      req,
+      chatbot: updatedOriginalChatbot,
+      publishedBotId: forkedChatBotId,
+      release_note
+    });
+
+    return { bot_id: forkedChatBotId };
+  }
+
 }
 
+
 module.exports = { ChatbotService }

package/services/faqService.js

@@ -5,66 +5,152 @@ const botEvent = require('../event/botEvent');
 const chatbotTypes = require("../models/chatbotTypes");
 const chatbotTemplates = require("../models/chatbotTemplates");
 const templates = require('../template/chatbot');
+const subagentNotes = require('../template/chatbot/subagent_notes');
 
 class FaqService {
 
-  create(id_project, id_user, data) {
+  // create(id_project, id_user, data) {
 
-    return new Promise((resolve, reject) => {
+  //   return new Promise((resolve, reject) => {
 
-      var newFaq_kb = new Faq_kb({
-        name: data.name,
-        slug: data.slug,
-        description: data.description,
-        url: data.url,
-        id_project: id_project,
-        webhook_url: data.webhook_url,
-        webhook_enabled: data.webhook_enabled,
-        type: data.type,
-        subtype: data.subtype,
-        language: data.language,
-        public: false,
-        certified: false,
-        mainCategory: data.mainCategory,
-        intentsEngine: data.intentsEngine,
-        trashed: false,
-        createdBy: id_user,
-        updatedBy: id_user,
-        attributes: data.attributes
-      });
+  //     if (data.type === "subagent" && !data.parent_id) {
+  //       return reject('Parent ID is required for subagent');
+  //     }
 
-      newFaq_kb.save((err, savedFaq_kb) => {
+  //     var newFaq_kb = new Faq_kb({
+  //       name: data.name,
+  //       slug: data.slug,
+  //       description: data.description,
+  //       url: data.url,
+  //       id_project: id_project,
+  //       webhook_url: data.webhook_url,
+  //       webhook_enabled: data.webhook_enabled,
+  //       type: data.type,
+  //       subtype: data.subtype,
+  //       language: data.language,
+  //       public: false,
+  //       certified: false,
+  //       mainCategory: data.mainCategory,
+  //       intentsEngine: data.intentsEngine,
+  //       trashed: false,
+  //       createdBy: id_user,
+  //       updatedBy: id_user,
+  //       attributes: data.attributes,
+  //       parent_id: data.parent_id
+  //     });
 
-        if (err) {
-          winston.error('(FaqService) error saving new chatbot ', err)
-          return reject('Error saving object.');
-        }
+  //     newFaq_kb.save((err, savedFaq_kb) => {
 
-        winston.debug('(FaqService) saved chatbot ', savedFaq_kb.toObject())
-        botEvent.emit('faqbot.create', savedFaq_kb);
+  //       if (err) {
+  //         winston.error('(FaqService) error saving new chatbot ', err)
+  //         return reject('Error saving object.');
+  //       }
 
-        winston.debug('type ' + data.type)
+  //       winston.debug('(FaqService) saved chatbot ', savedFaq_kb.toObject())
+  //       botEvent.emit('faqbot.create', savedFaq_kb);
 
-        if (data.type === "internal" || data.type === "tilebot") {
+  //       winston.debug('type ' + data.type)
 
-          let template = this.#resolveTemplate(data.subtype, data.template);
-          winston.debug('template ' + template);
+  //       if (data.type === "internal" || data.type === "tilebot") {
 
-          let options = {};
-          if (data.namespace_id) {
-            options.namespace_id = data.namespace_id;
-          }
+  //         let template = this.#resolveTemplate(data.subtype, data.template);
+  //         winston.debug('template ' + template);
 
-          this.createGreetingsAndOperationalsFaqs(savedFaq_kb._id, savedFaq_kb.createdBy, savedFaq_kb.id_project, template, options);
+  //         let options = {};
+  //         if (data.namespace_id) {
+  //           options.namespace_id = data.namespace_id;
+  //         }
 
-        } else {
-          winston.debug('(FaqService) Chatbot type: external bot');
-        }
+  //         this.createGreetingsAndOperationalsFaqs(savedFaq_kb._id, savedFaq_kb.createdBy, savedFaq_kb.id_project, template, options);
 
-        return resolve(savedFaq_kb);
-      });
+  //       } else {
+  //         winston.debug('(FaqService) Chatbot type: external bot');
+  //       }
+
+  //       return resolve(savedFaq_kb);
+  //     });
+
+  //   });
+  // }
+
+  async create(id_project, id_user, data) {
+
+    if (!this.validateSubagent(data)) {
+      throw new Error("parent_id is required for subtype 'subagent'");
+    }
+
+    let chatbot = this.createChatbotObject(id_project, id_user, data);
+
+    let template;
+    if (data.type === "internal" || data.type === "tilebot") {
+      template = this.#resolveTemplate(data.subtype, data.template);
+      if (template === 'blank_subagent') {
+        this.#applyBlankSubagentAttributes(chatbot);
+      }
+    }
+
+    let savedChatbot;
+    try {
+      savedChatbot = await chatbot.save();
+      winston.verbose('(FaqService) saved chatbot ', savedChatbot.toObject());
+    } catch (error) {
+      throw error;
+    }
+
+    if (template) {
+      let options = {};
+      if (data.namespace_id) {
+        options.namespace_id = data.namespace_id;
+      }
+      this.createGreetingsAndOperationalsFaqs(savedChatbot._id, savedChatbot.createdBy, savedChatbot.id_project, template, options);
+    }
+
+    botEvent.emit('faqbot.create', savedChatbot);
+    return savedChatbot;
+  }
 
+  #applyBlankSubagentAttributes(chatbot) {
+    const notes = JSON.parse(JSON.stringify(subagentNotes.notes)).map(note => {
+      note.id_faq_kb = chatbot._id.toString();
+      return note;
     });
+
+    chatbot.attributes = {
+      ...(chatbot.attributes || {}),
+      notes
+    };
+  }
+
+  createChatbotObject(id_project, id_user, data) {
+    return new Faq_kb({
+      name: data.name,
+      slug: data.slug,
+      description: data.description,
+      url: data.url,
+      id_project: id_project.toString(),
+      webhook_url: data.webhook_url,
+      webhook_enabled: data.webhook_enabled,
+      type: data.type,
+      subtype: data.subtype,
+      language: data.language,
+      public: false,
+      certified: false,
+      mainCategory: data.mainCategory,
+      intentsEngine: data.intentsEngine,
+      trashed: false,
+      createdBy: id_user,
+      updatedBy: id_user,
+      attributes: data.attributes,
+      parent_id: data.parent_id
+    })
+  }
+
+  validateSubagent(data) {
+    if (data.subtype === "subagent" && !data.parent_id) {
+      winston.error('(FaqService) parent_id is required for subtype ' + data.subtype);
+      return false;
+    }
+    return true;
   }
 
   #resolveTemplate(subtype, template) {

package/template/chatbot/blank.js

@@ -3,9 +3,26 @@ const uuidv4 = require('uuid/v4');
 module.exports = function generateTemplate(options) {
     
     const custom_intent_id = uuidv4();
-
+    const default_fallback_intent_id = uuidv4();
+    
     return [
         {
+            "webhook_enabled": false,
+            "enabled": true,
+            "actions": [],
+            "intent_display_name": "defaultFallback",
+            "attributes": {
+                "position": {
+                    "x": 714,
+                    "y": 528
+                },
+                "nextBlockAction": {
+                    "_tdActionId": "5b689996-317b-4761-9bc0-cc78d1f390cb",
+                    "_tdActionType": "intent",
+                    "intentName": "#" + default_fallback_intent_id
+                }
+            }
+        }, {
             "webhook_enabled": false,
             "enabled": true,
             "actions": [{
@@ -24,10 +41,11 @@ module.exports = function generateTemplate(options) {
                     }]
                 }
             }],
-            "intent_display_name": "defaultFallback",
+            "intent_display_name": "untitled_block_2",
+            "intent_id": default_fallback_intent_id,
             "attributes": {
                 "position": {
-                    "x": 714,
+                    "x": 1114,
                     "y": 528
                 }
             }

package/template/chatbot/blank_subagent.js

@@ -0,0 +1,139 @@
+const uuidv4 = require('uuid/v4');
+
+module.exports = function generateTemplate(options) {
+
+    const custom_intent_id = uuidv4();
+    const return_custom_intent_id = uuidv4();
+    const default_fallback_intent_id = uuidv4();
+
+    return [
+        {
+            "webhook_enabled": false,
+            "enabled": true,
+            "actions": [{
+                "_tdActionType": "intent",
+                "intentName": "#" + custom_intent_id
+            }],
+            "question": "",
+            "intent_display_name": "start",
+            "attributes": {
+                "position": {
+                    "x": 172,
+                    "y": 384
+                }
+            },
+            "agents_available": false,
+        },
+        {
+            "webhook_enabled": false,
+            "enabled": true,
+            "actions": [{
+                "_tdActionTitle": "",
+                "_tdActionType": "reply",
+                "attributes": {
+                    "disableInputMessage": false,
+                    "commands": [
+                        {
+                            "type": "wait",
+                            "time": 500
+                        },
+                        {
+                            "type": "message",
+                            "message": {
+                                "type": "text",
+                                "text": "A chat message will be sent to the visitor",
+                                "attributes": {
+                                    "attachment": {
+                                        "type": "template",
+                                        "buttons": [],
+                                        "json_buttons": "",
+                                        "json_gallery": ""
+                                    }
+                                }
+                            }
+                        }
+                    ]
+                },
+
+            }],
+            "intent_display_name": "untitled_block_1",
+            "intent_id": custom_intent_id,
+            "agents_available": false,
+            "attributes": {
+                "position": {
+                    "x": 612,
+                    "y": 312
+                },
+                "nextBlockAction": {
+                    "_tdActionId": "5b689996-317b-4761-9bc0-cc78d1f390ca",
+                    "_tdActionType": "intent",
+                    "intentName": "#" + return_custom_intent_id
+                },
+                "connectors": {},
+                "color": "156,163,205",
+                "readonly": false
+            },
+        },
+        {
+            "webhook_enabled": false,
+            "enabled": true,
+            "actions": [{
+                "_tdActionType": "returnstack",
+            }],
+            "intent_display_name": "return",
+            "agents_available": false,
+            "intent_id": return_custom_intent_id,
+            "attributes": {
+                "position": {
+                    "x": 1129,
+                    "y": 361
+                }
+            },
+            "agents_available": false,
+        },
+        {
+            "webhook_enabled": false,
+            "enabled": true,
+            "actions": [],
+            "intent_display_name": "defaultFallback",
+            "attributes": {
+                "position": {
+                    "x": 315,
+                    "y": 699
+                },
+                "nextBlockAction": {
+                    "_tdActionId": "5b689996-317b-4761-9bc0-cc78d1f390cb",
+                    "_tdActionType": "intent",
+                    "intentName": "#" + default_fallback_intent_id
+                }
+            }
+        }, {
+            "webhook_enabled": false,
+            "enabled": true,
+            "actions": [{
+                "_tdActionType": "reply",
+                "text": "I didn't understand. Can you rephrase your question?",
+                "attributes": {
+                    "commands": [{
+                        "type": "wait",
+                        "time": 500
+                    }, {
+                        "type": "message",
+                        "message": {
+                            "type": "text",
+                            "text": "I didn't understand. Can you rephrase your question?"
+                        }
+                    }]
+                }
+            }],
+            "intent_display_name": "untitled_block_2",
+            "intent_id": default_fallback_intent_id,
+            "attributes": {
+                "position": {
+                    "x": 721,
+                    "y": 699
+                }
+            }
+        }
+    ]
+}

package/template/chatbot/blank_voice.js

@@ -3,6 +3,7 @@ const uuidv4 = require('uuid/v4');
 module.exports = function generateTemplate(options) {
 
     const custom_intent_id = uuidv4();
+    const default_fallback_intent_id = uuidv4();
 
     return [
         {
@@ -24,6 +25,22 @@ module.exports = function generateTemplate(options) {
             }
         },
         {
+            "webhook_enabled": false,
+            "enabled": true,
+            "actions": [],
+            "intent_display_name": "defaultFallback",
+            "attributes": {
+                "position": {
+                    "x": 714,
+                    "y": 528
+                },
+                "nextBlockAction": {
+                    "_tdActionId": "5b689996-317b-4761-9bc0-cc78d1f390cb",
+                    "_tdActionType": "intent",
+                    "intentName": "#" + default_fallback_intent_id
+                }
+            }
+        }, {
             "webhook_enabled": false,
             "enabled": true,
             "actions": [{
@@ -40,13 +57,13 @@ module.exports = function generateTemplate(options) {
                             "text": "I didn't understand. Can you rephrase your question?"
                         }
                     }]
-                },
+                }
             }],
-            "intent_display_name": "defaultFallback",
+            "intent_display_name": "untitled_block_2",
+            "intent_id": default_fallback_intent_id,
             "attributes": {
-                "readonly": true,
                 "position": {
-                    "x": 714,
+                    "x": 1114,
                     "y": 528
                 }
             }

package/template/chatbot/blank_voice_twilio.js

@@ -3,6 +3,7 @@ const uuidv4 = require('uuid/v4');
 module.exports = function generateTemplate(options) {
 
     const custom_intent_id = uuidv4();
+    const default_fallback_intent_id = uuidv4();
 
     return [
         {
@@ -26,6 +27,22 @@ module.exports = function generateTemplate(options) {
             }
         },
         {
+            "webhook_enabled": false,
+            "enabled": true,
+            "actions": [],
+            "intent_display_name": "defaultFallback",
+            "attributes": {
+                "position": {
+                    "x": 714,
+                    "y": 528
+                },
+                "nextBlockAction": {
+                    "_tdActionId": "5b689996-317b-4761-9bc0-cc78d1f390cb",
+                    "_tdActionType": "intent",
+                    "intentName": "#" + default_fallback_intent_id
+                }
+            }
+        }, {
             "webhook_enabled": false,
             "enabled": true,
             "actions": [{
@@ -39,17 +56,16 @@ module.exports = function generateTemplate(options) {
                         "type": "message",
                         "message": {
                             "type": "text",
-                            "text": "I didn't understand. Can you rephrase your question?",
+                            "text": "I didn't understand. Can you rephrase your question?"
                         }
                     }]
                 }
             }],
-            "intent_display_name": "defaultFallback",
-            "agents_available": false,
+            "intent_display_name": "untitled_block_2",
+            "intent_id": default_fallback_intent_id,
             "attributes": {
-                "readonly": true,
                 "position": {
-                    "x": 714,
+                    "x": 1114,
                     "y": 528
                 }
             }

package/template/chatbot/index.js

@@ -3,6 +3,7 @@ module.exports = {
     blank: require('./blank'),
     blank_webhook: require('./blank_webhook'),
     blank_copilot: require('./blank_copilot'),
+    blank_subagent: require('./blank_subagent'),
     official_copilot: require('./official_copilot'),
     blank_voice: require('./blank_voice'),
     blank_voice_twilio: require('./blank_voice_twilio'),

package/template/chatbot/subagent_notes.js

@@ -0,0 +1,30 @@
+module.exports = {
+    "notes": [
+        {
+            "id_faq_kb": "6a70ab21cb52270013040601",
+            "note_id": "fda256bb-d34a-4bd6-b0d0-018360500318",
+            "x": 675.106,
+            "y": 202,
+            "type": "rect",
+            "text": "",
+            "width": 130,
+            "height": 42,
+            "createdAt": "2026-08-03T15:51:49.143Z",
+            "backgroundColor": "rgba(75, 79, 82, 100)",
+            "borderColor": "rgba(67, 140, 181, 1)",
+            "borderWidth": 0,
+            "isNew": true,
+            "backgroundOpacity": 100,
+            "borderOpacity": 100,
+            "boxShadow": true,
+            "fontSize": "0.96em",
+            "fontFamily": "Open Sans, sans-serif",
+            "rotation": 0,
+            "scale": [
+                1.74501,
+                1.70771
+            ],
+            "title": "<p><span class=\"ql-color-ffffff\">Replace this block with your subagent logic</span></p>"
+        }
+    ]
+}