@botpress/adk-cli 1.8.0 → 1.8.2

package/dist/cli.js

@@ -349370,11 +349370,11 @@ function expand_(str, isTop) {
           if (pad) {
             const need = width - c5.length;
             if (need > 0) {
-              const z26 = new Array(need + 1).join("0");
+              const z27 = new Array(need + 1).join("0");
               if (i2 < 0) {
-                c5 = "-" + z26 + c5.slice(1);
+                c5 = "-" + z27 + c5.slice(1);
               } else {
-                c5 = z26 + c5;
+                c5 = z27 + c5;
               }
             }
           }
@@ -352569,7 +352569,15 @@ var import_const, import_const2, __create4, __defProp8, __getOwnPropDesc3, __get
     return tracker;
   }
   throw new Error("PromiseTracker not found in context. Make sure to initialize it in your runtime setup.");
-}, InterfaceMappings, BOT_ID_HEADER = "x-bot-id", BOT_USER_ID_HEADER = "x-bot-user-id", WEBHOOK_ID_HEADER = "x-webhook-id", CONFIGURATION_TYPE_HEADER = "x-bp-configuration-type", CONFIGURATION_PAYLOAD_HEADER = "x-bp-configuration", OPERATION_TYPE_HEADER = "x-bp-operation", OPERATION_SUBTYPE_HEADER = "x-bp-type", LOG_DELIMITER = `<|MESSAGE_END|>
+}, InterfaceMappings = class {
+  mappings = {};
+  registerMappings(mappings) {
+    this.mappings = { ...this.mappings, ...mappings };
+  }
+  getIntegrationAction(interfaceName, actionName, integrationName) {
+    return this.mappings[interfaceName]?.actions[`${integrationName}:${actionName}`];
+  }
+}, interfaceMappings, BOT_ID_HEADER = "x-bot-id", BOT_USER_ID_HEADER = "x-bot-user-id", WEBHOOK_ID_HEADER = "x-webhook-id", CONFIGURATION_TYPE_HEADER = "x-bp-configuration-type", CONFIGURATION_PAYLOAD_HEADER = "x-bp-configuration", OPERATION_TYPE_HEADER = "x-bp-operation", OPERATION_SUBTYPE_HEADER = "x-bp-type", LOG_DELIMITER = `<|MESSAGE_END|>
 `, AgentRegistry = class {
   _data = null;
   initialize(data) {
@@ -354093,7 +354101,7 @@ var import_const, import_const2, __create4, __defProp8, __getOwnPropDesc3, __get
   } else {
     return { ...EMPTY_STATE };
   }
-}, WorkflowCallbackEvent, WorkflowScheduleEvent, WorkflowContinueEvent, SubworkflowFinished, WorkflowDataRequestEvent2, HTML_TAGS, Message, dedent, Transcript, AttachmentSchema, TranscriptItemSchema, TranscriptSchema, BaseConversationInstance = class {
+}, WorkflowCallbackEvent, WorkflowScheduleEvent, WorkflowContinueEvent, SubworkflowFinished, WorkflowDataRequestEvent2, HTML_TAGS, Message, dedent, Transcript, DefaultMessageTypes, AudioComponent, ImageComponent, VideoComponent, LocationComponent, ChoiceComponent, DropdownComponent, CarouselComponent, AttachmentSchema, TranscriptItemSchema, TranscriptSchema, BaseConversationInstance = class {
   id;
   channel;
   integration;
@@ -354127,7 +354135,7 @@ var import_const, import_const2, __create4, __defProp8, __getOwnPropDesc3, __get
     }
   }
   async startTyping() {
-    const mapping = InterfaceMappings.getIntegrationAction("typingIndicator", "startTypingIndicator", this.integration);
+    const mapping = interfaceMappings.getIntegrationAction("typingIndicator", "startTypingIndicator", this.integration);
     if (mapping) {
       const message3 = context.get("message", { optional: true });
       await this.client.callAction({
@@ -354140,7 +354148,7 @@ var import_const, import_const2, __create4, __defProp8, __getOwnPropDesc3, __get
     }
   }
   async stopTyping() {
-    const mapping = InterfaceMappings.getIntegrationAction("typingIndicator", "stopTypingIndicator", this.integration);
+    const mapping = interfaceMappings.getIntegrationAction("typingIndicator", "stopTypingIndicator", this.integration);
     if (mapping) {
       const message3 = context.get("message", { optional: true });
       await this.client.callAction({
@@ -355498,6 +355506,7 @@ var init_internal = __esm(() => {
   init_dist16();
   init_dist8();
   init_dist8();
+  init_dist8();
   init_node5();
   init_dist8();
   init_dist8();
@@ -355524,7 +355533,7 @@ var init_internal = __esm(() => {
   });
   init_define_PACKAGE_VERSIONS = __esm2({
     "<define:__PACKAGE_VERSIONS__>"() {
-      define_PACKAGE_VERSIONS_default = { runtime: "1.8.0", adk: "1.8.0", sdk: "4.19.0", llmz: "0.0.33", zai: "2.5.0", cognitive: "0.2.0" };
+      define_PACKAGE_VERSIONS_default = { runtime: "1.8.2", adk: "1.8.2", sdk: "4.19.0", llmz: "0.0.33", zai: "2.5.0", cognitive: "0.2.0" };
     }
   });
   init_globalThis = __esm2({
@@ -388308,15 +388317,7 @@ ${issues.join(`
   init_define_PACKAGE_VERSIONS();
   init_define_BUILD();
   init_define_PACKAGE_VERSIONS();
-  InterfaceMappings = class {
-    static mappings = {};
-    static registerMappings(mappings) {
-      this.mappings = { ...this.mappings, ...mappings };
-    }
-    static getIntegrationAction(interfaceName, actionName, integrationName) {
-      return this.mappings[interfaceName]?.actions[`${integrationName}:${actionName}`];
-    }
-  };
+  interfaceMappings = getSingleton("__ADK_GLOBAL_INTERFACE_MAPPINGS", () => new InterfaceMappings);
   init_define_BUILD();
   init_define_PACKAGE_VERSIONS();
   init_define_BUILD();
@@ -390873,6 +390874,257 @@ ${iteration.status.execution_error.stack}`;
   };
   init_define_BUILD();
   init_define_PACKAGE_VERSIONS();
+  DefaultMessageTypes = {
+    text: Dy2.defaults["text"].schema,
+    audio: Dy2.defaults["audio"].schema,
+    card: Dy2.defaults["card"].schema,
+    image: Dy2.defaults["image"].schema,
+    carousel: Dy2.defaults["carousel"].schema,
+    choice: Dy2.defaults["choice"].schema,
+    dropdown: Dy2.defaults["dropdown"].schema,
+    file: Dy2.defaults["file"].schema,
+    location: Dy2.defaults["location"].schema,
+    video: Dy2.defaults["video"].schema,
+    bloc: Dy2.defaults["bloc"].schema
+  };
+  AudioComponent = new Autonomous.Component({
+    type: "leaf",
+    aliases: [],
+    name: "Audio",
+    description: `Send an audio file to the user, which will be playable by the user whithin the chat interface. The audio file should be in a supported format (e.g., MP3, WAV) and accessible via a public URL.`,
+    examples: [
+      {
+        name: " Basic Audio Message",
+        description: "Sends a simple audio message to the user",
+        code: `
+yield <Message>
+  Here's an **awesome** audio clip for you!
+  <Audio audioUrl="https://example.com/path/to/audio.mp3" />
+</Message>`
+      }
+    ],
+    leaf: {
+      props: X2.object({
+        audioUrl: X2.string().url().describe("The URL of the audio file to be sent.")
+      })
+    }
+  });
+  ImageComponent = new Autonomous.Component({
+    type: "leaf",
+    aliases: ["img"],
+    name: "Image",
+    description: `Send an image to the user, which will be displayed within the chat interface. The image should be in a supported format (e.g., JPEG, PNG) and accessible via a public URL.`,
+    examples: [
+      {
+        name: " Basic Image Message",
+        description: "Sends a simple image message to the user",
+        code: `
+yield <Message>
+  Here's an **awesome** image for you!
+  <Image imageUrl="https://example.com/path/to/image.jpg" />
+</Message>`
+      }
+    ],
+    leaf: {
+      props: X2.object({
+        imageUrl: X2.string().url().describe("The URL of the image to be sent.")
+      })
+    }
+  });
+  VideoComponent = new Autonomous.Component({
+    type: "leaf",
+    aliases: [],
+    name: "Video",
+    description: `Send a video to the user, which will be playable within the chat interface. The video should be in a supported format (e.g., MP4, WebM) and accessible via a public URL.`,
+    examples: [
+      {
+        name: " Basic Video Message",
+        description: "Sends a simple video message to the user",
+        code: `
+yield <Message>
+  Here's an **awesome** video for you!
+  <Video videoUrl="https://example.com/path/to/video.mp4" />
+</Message>`
+      }
+    ],
+    leaf: {
+      props: X2.object({
+        videoUrl: X2.string().url().describe("The URL of the video to be sent.")
+      })
+    }
+  });
+  LocationComponent = new Autonomous.Component({
+    type: "leaf",
+    aliases: [],
+    name: "Location",
+    description: `Send a location to the user, which will be displayed as a map within the chat interface. The location should include latitude and longitude coordinates.
+The location can also optionally include an address and a title for better context.`,
+    examples: [
+      {
+        name: " Basic Location Message",
+        description: "Sends a simple location message to the user",
+        code: `
+yield <Message>
+  Here's the location you requested!
+  <Location latitude={37.7749} longitude={-122.4194} />
+</Message>`
+      },
+      {
+        name: " Location Message with Address and Title",
+        description: "Sends a location message with additional address and title information",
+        code: `
+yield <Message>
+  Here's the location of our office!
+  <Location 
+    latitude={45.506342} 
+    longitude={-73.572012} 
+    address="400 Blvd. De Maisonneuve Ouest #200, Montreal, Quebec H3A 1L4, Canada"
+    title="Botpress HQ" 
+  />
+</Message>`
+      }
+    ],
+    leaf: {
+      props: X2.object({
+        latitude: X2.number().describe("The latitude of the location to be sent."),
+        longitude: X2.number().describe("The longitude of the location to be sent."),
+        address: X2.string().optional().describe("The address of the location to be sent."),
+        title: X2.string().optional().describe("The title of the location to be sent.")
+      })
+    }
+  });
+  ChoiceComponent = new Autonomous.Component({
+    type: "leaf",
+    aliases: ["choices", "option", "options", "buttons"],
+    name: "Choice",
+    description: `Present a choice to the user with multiple options.
+The user can select one of the provided options, and the selection will be sent back to the system for further processing.
+You can include up to 10 options for the user to choose from.
+Values for each option should be unique identifiers that can be used to identify the user's selection.`,
+    examples: [
+      {
+        name: " Basic Choice Message",
+        description: "Presents a simple choice message to the user",
+        code: `
+yield <Message>
+  Please choose one of the following options:
+  <Choice 
+    text="Select an option:"
+    options={[
+      { label: "Option 1", value: "option_1" },
+      { label: "Option 2", value: "option_2" },
+      { label: "Option 3", value: "option_3" }
+    ]}
+  />
+</Message>`
+      }
+    ],
+    leaf: {
+      props: X2.object({
+        text: X2.string().describe("The prompt text for the choice."),
+        options: X2.array(X2.object({
+          label: X2.string().describe("The label of the option to be displayed to the user."),
+          value: X2.string().describe("The value of the option to be sent back when selected.")
+        })).describe("The list of options to present to the user.")
+      })
+    }
+  });
+  DropdownComponent = new Autonomous.Component({
+    type: "leaf",
+    aliases: ["dropdown", "select", "combo"],
+    name: "Dropdown",
+    description: `Present a dropdown menu to the user with multiple options.
+The user can select one of the provided options from the dropdown, and the selection will be sent back to the system for further processing.
+Unlike the Choice component, the Dropdown component is typically used when there are more options to choose from, providing a more compact UI.
+The dropdown can include up to 100 options for the user to choose from.
+Values for each option should be unique identifiers that can be used to identify the user's selection.`,
+    examples: [
+      {
+        name: " Basic Dropdown Message",
+        description: "Presents a simple dropdown message to the user",
+        code: `
+yield <Message>
+  Please select a fruit from the dropdown:
+  <Dropdown 
+    text="Choose an option:"
+    options={[
+      { label: "\uD83C\uDF50 Pear", value: "pear" },
+      { label: "\uD83C\uDF4E Apple", value: "apple" },
+      { label: "\uD83C\uDF4C Banana", value: "banana" }
+    ]}
+  />
+</Message>`
+      }
+    ],
+    leaf: {
+      props: X2.object({
+        text: X2.string().describe("The prompt text for the dropdown."),
+        options: X2.array(X2.object({
+          label: X2.string().describe("The label of the option to be displayed to the user."),
+          value: X2.string().describe("The value of the option to be sent back when selected.")
+        })).describe("The list of options to present in the dropdown.")
+      })
+    }
+  });
+  CarouselComponent = new Autonomous.Component({
+    type: "leaf",
+    aliases: ["carousel", "cards", "card"],
+    name: "Carousel",
+    description: `Send a carousel of cards to the user, allowing them to browse through multiple items.
+Carousels are useful for displaying a collection of related items in a compact and interactive format.
+It is also possible to send a single card using the Carousel component, useful for sending a combination of image, text, and actions in one message such as a receipt or product detail.
+Each item in the carousel is represented as a card, which can include an image, title, subtitle, and actions.
+Users can navigate through the carousel by swiping or clicking on navigation controls.
+You can include multiple cards in the carousel, each with its own set of actions. A carousel can contain between 1 and 10 items (cards).`,
+    examples: [
+      {
+        name: " Basic Carousel Message",
+        description: "Sends a simple carousel message to the user",
+        code: `
+yield <Message>
+  Here is an **exciting** carousel for you!
+  <Carousel 
+    items={[
+      {
+        title: "Product 1",
+        subtitle: "Description of Product 1",
+        imageUrl: "https://example.com/path/to/image1.jpg",
+        actions: [
+          { action: "postback", label: "Buy Now", value: "buy_product_1" },
+          { action: "url", label: "View Details", value: "https://example.com/product_1" }
+        ]
+      },
+      {
+        title: "Product 2",
+        subtitle: "Description of Product 2",
+        imageUrl: "https://example.com/path/to/image2.jpg",
+        actions: [
+          { action: "postback", label: "Buy Now", value: "buy_product_2" },
+          { action: "url", label: "View Details", value: "https://example.com/product_2" }
+        ]
+      }
+    ]}
+  />
+</Message>`
+      }
+    ],
+    leaf: {
+      props: X2.object({
+        items: X2.array(X2.object({
+          title: X2.string().describe("The title of the carousel item."),
+          subtitle: X2.string().optional().describe("The subtitle of the carousel item."),
+          imageUrl: X2.string().url().optional().describe("The URL of the image to be displayed on the carousel item."),
+          actions: X2.array(X2.object({
+            action: X2.enum(["postback", "url", "say"]).describe("The type of action for the button."),
+            label: X2.string().describe("The label of the button to be displayed to the user."),
+            value: X2.string().describe("The value associated with the button action.")
+          })).max(3).describe("The list of actions (buttons) to include on the carousel item.")
+        })).describe("The list of items (cards) to include in the carousel.")
+      })
+    }
+  });
+  init_define_BUILD();
+  init_define_PACKAGE_VERSIONS();
   init_define_BUILD();
   init_define_PACKAGE_VERSIONS();
   AttachmentSchema = X2.object({
@@ -390942,6 +391194,7 @@ ${iteration.status.execution_error.stack}`;
       const client = context.get("client");
       const botpressConversation = context.get("conversation");
       const conversationInstance = new BaseConversationInstance(botpressConversation, client);
+      const startTypingPromise = conversationInstance.startTyping().catch(() => {});
       let type;
       let requestObject = undefined;
       if (message3) {
@@ -391049,6 +391302,7 @@ ${iteration.status.execution_error.stack}`;
         execute: execute2
       });
       controller.abort();
+      startTypingPromise.then(() => conversationInstance.stopTyping().catch(() => {}));
     }
   };
   init_define_BUILD();
@@ -637236,11 +637490,11 @@ function expand_3(str, isTop) {
           if (pad) {
             const need = width - c5.length;
             if (need > 0) {
-              const z26 = new Array(need + 1).join("0");
+              const z27 = new Array(need + 1).join("0");
               if (i2 < 0) {
-                c5 = "-" + z26 + c5.slice(1);
+                c5 = "-" + z27 + c5.slice(1);
               } else {
-                c5 = z26 + c5;
+                c5 = z27 + c5;
               }
             }
           }
@@ -640318,7 +640572,15 @@ var import_const3, import_const4, __create5, __defProp9, __getOwnPropDesc4, __ge
     return tracker;
   }
   throw new Error("PromiseTracker not found in context. Make sure to initialize it in your runtime setup.");
-}, InterfaceMappings2, LOG_DELIMITER2 = `<|MESSAGE_END|>
+}, InterfaceMappings2 = class {
+  mappings = {};
+  registerMappings(mappings) {
+    this.mappings = { ...this.mappings, ...mappings };
+  }
+  getIntegrationAction(interfaceName, actionName, integrationName) {
+    return this.mappings[interfaceName]?.actions[`${integrationName}:${actionName}`];
+  }
+}, interfaceMappings2, LOG_DELIMITER2 = `<|MESSAGE_END|>
 `, AgentRegistry2 = class {
   _data = null;
   initialize(data) {
@@ -641865,7 +642127,7 @@ var import_const3, import_const4, __create5, __defProp9, __getOwnPropDesc4, __ge
   } else {
     return { ...EMPTY_STATE2 };
   }
-}, WorkflowCallbackEvent2, WorkflowScheduleEvent2, WorkflowContinueEvent2, SubworkflowFinished2, WorkflowDataRequestEvent, HTML_TAGS2, Message2, dedent3, Transcript2, AttachmentSchema2, TranscriptItemSchema2, TranscriptSchema2, BaseConversationInstance2 = class {
+}, WorkflowCallbackEvent2, WorkflowScheduleEvent2, WorkflowContinueEvent2, SubworkflowFinished2, WorkflowDataRequestEvent, HTML_TAGS2, Message2, dedent3, Transcript2, DefaultMessageTypes2, AudioComponent2, ImageComponent2, VideoComponent2, LocationComponent2, ChoiceComponent2, DropdownComponent2, CarouselComponent2, AttachmentSchema2, TranscriptItemSchema2, TranscriptSchema2, BaseConversationInstance2 = class {
   id;
   channel;
   integration;
@@ -641899,7 +642161,7 @@ var import_const3, import_const4, __create5, __defProp9, __getOwnPropDesc4, __ge
     }
   }
   async startTyping() {
-    const mapping = InterfaceMappings2.getIntegrationAction("typingIndicator", "startTypingIndicator", this.integration);
+    const mapping = interfaceMappings2.getIntegrationAction("typingIndicator", "startTypingIndicator", this.integration);
     if (mapping) {
       const message3 = context3.get("message", { optional: true });
       await this.client.callAction({
@@ -641912,7 +642174,7 @@ var import_const3, import_const4, __create5, __defProp9, __getOwnPropDesc4, __ge
     }
   }
   async stopTyping() {
-    const mapping = InterfaceMappings2.getIntegrationAction("typingIndicator", "stopTypingIndicator", this.integration);
+    const mapping = interfaceMappings2.getIntegrationAction("typingIndicator", "stopTypingIndicator", this.integration);
     if (mapping) {
       const message3 = context3.get("message", { optional: true });
       await this.client.callAction({
@@ -642791,6 +643053,7 @@ var init_library = __esm(() => {
   init_dist8();
   init_dist8();
   init_dist8();
+  init_dist8();
   init_dist10();
   init_dist8();
   import_const3 = __toESM(require_dist2(), 1);
@@ -642811,7 +643074,7 @@ var init_library = __esm(() => {
   });
   init_define_PACKAGE_VERSIONS2 = __esm3({
     "<define:__PACKAGE_VERSIONS__>"() {
-      define_PACKAGE_VERSIONS_default2 = { runtime: "1.8.0", adk: "1.8.0", sdk: "4.19.0", llmz: "0.0.33", zai: "2.5.0", cognitive: "0.2.0" };
+      define_PACKAGE_VERSIONS_default2 = { runtime: "1.8.2", adk: "1.8.2", sdk: "4.19.0", llmz: "0.0.33", zai: "2.5.0", cognitive: "0.2.0" };
     }
   });
   init_globalThis2 = __esm3({
@@ -675414,15 +675677,7 @@ globstar while`, file, fr5, pattern, pr3, swallowee);
   init_define_PACKAGE_VERSIONS2();
   init_define_BUILD2();
   init_define_PACKAGE_VERSIONS2();
-  InterfaceMappings2 = class {
-    static mappings = {};
-    static registerMappings(mappings) {
-      this.mappings = { ...this.mappings, ...mappings };
-    }
-    static getIntegrationAction(interfaceName, actionName, integrationName) {
-      return this.mappings[interfaceName]?.actions[`${integrationName}:${actionName}`];
-    }
-  };
+  interfaceMappings2 = getSingleton2("__ADK_GLOBAL_INTERFACE_MAPPINGS", () => new InterfaceMappings2);
   init_define_BUILD2();
   init_define_PACKAGE_VERSIONS2();
   init_define_BUILD2();
@@ -678522,6 +678777,257 @@ ${issues.join(`
   };
   init_define_BUILD2();
   init_define_PACKAGE_VERSIONS2();
+  DefaultMessageTypes2 = {
+    text: Dy2.defaults["text"].schema,
+    audio: Dy2.defaults["audio"].schema,
+    card: Dy2.defaults["card"].schema,
+    image: Dy2.defaults["image"].schema,
+    carousel: Dy2.defaults["carousel"].schema,
+    choice: Dy2.defaults["choice"].schema,
+    dropdown: Dy2.defaults["dropdown"].schema,
+    file: Dy2.defaults["file"].schema,
+    location: Dy2.defaults["location"].schema,
+    video: Dy2.defaults["video"].schema,
+    bloc: Dy2.defaults["bloc"].schema
+  };
+  AudioComponent2 = new Autonomous2.Component({
+    type: "leaf",
+    aliases: [],
+    name: "Audio",
+    description: `Send an audio file to the user, which will be playable by the user whithin the chat interface. The audio file should be in a supported format (e.g., MP3, WAV) and accessible via a public URL.`,
+    examples: [
+      {
+        name: " Basic Audio Message",
+        description: "Sends a simple audio message to the user",
+        code: `
+yield <Message>
+  Here's an **awesome** audio clip for you!
+  <Audio audioUrl="https://example.com/path/to/audio.mp3" />
+</Message>`
+      }
+    ],
+    leaf: {
+      props: X2.object({
+        audioUrl: X2.string().url().describe("The URL of the audio file to be sent.")
+      })
+    }
+  });
+  ImageComponent2 = new Autonomous2.Component({
+    type: "leaf",
+    aliases: ["img"],
+    name: "Image",
+    description: `Send an image to the user, which will be displayed within the chat interface. The image should be in a supported format (e.g., JPEG, PNG) and accessible via a public URL.`,
+    examples: [
+      {
+        name: " Basic Image Message",
+        description: "Sends a simple image message to the user",
+        code: `
+yield <Message>
+  Here's an **awesome** image for you!
+  <Image imageUrl="https://example.com/path/to/image.jpg" />
+</Message>`
+      }
+    ],
+    leaf: {
+      props: X2.object({
+        imageUrl: X2.string().url().describe("The URL of the image to be sent.")
+      })
+    }
+  });
+  VideoComponent2 = new Autonomous2.Component({
+    type: "leaf",
+    aliases: [],
+    name: "Video",
+    description: `Send a video to the user, which will be playable within the chat interface. The video should be in a supported format (e.g., MP4, WebM) and accessible via a public URL.`,
+    examples: [
+      {
+        name: " Basic Video Message",
+        description: "Sends a simple video message to the user",
+        code: `
+yield <Message>
+  Here's an **awesome** video for you!
+  <Video videoUrl="https://example.com/path/to/video.mp4" />
+</Message>`
+      }
+    ],
+    leaf: {
+      props: X2.object({
+        videoUrl: X2.string().url().describe("The URL of the video to be sent.")
+      })
+    }
+  });
+  LocationComponent2 = new Autonomous2.Component({
+    type: "leaf",
+    aliases: [],
+    name: "Location",
+    description: `Send a location to the user, which will be displayed as a map within the chat interface. The location should include latitude and longitude coordinates.
+The location can also optionally include an address and a title for better context.`,
+    examples: [
+      {
+        name: " Basic Location Message",
+        description: "Sends a simple location message to the user",
+        code: `
+yield <Message>
+  Here's the location you requested!
+  <Location latitude={37.7749} longitude={-122.4194} />
+</Message>`
+      },
+      {
+        name: " Location Message with Address and Title",
+        description: "Sends a location message with additional address and title information",
+        code: `
+yield <Message>
+  Here's the location of our office!
+  <Location 
+    latitude={45.506342} 
+    longitude={-73.572012} 
+    address="400 Blvd. De Maisonneuve Ouest #200, Montreal, Quebec H3A 1L4, Canada"
+    title="Botpress HQ" 
+  />
+</Message>`
+      }
+    ],
+    leaf: {
+      props: X2.object({
+        latitude: X2.number().describe("The latitude of the location to be sent."),
+        longitude: X2.number().describe("The longitude of the location to be sent."),
+        address: X2.string().optional().describe("The address of the location to be sent."),
+        title: X2.string().optional().describe("The title of the location to be sent.")
+      })
+    }
+  });
+  ChoiceComponent2 = new Autonomous2.Component({
+    type: "leaf",
+    aliases: ["choices", "option", "options", "buttons"],
+    name: "Choice",
+    description: `Present a choice to the user with multiple options.
+The user can select one of the provided options, and the selection will be sent back to the system for further processing.
+You can include up to 10 options for the user to choose from.
+Values for each option should be unique identifiers that can be used to identify the user's selection.`,
+    examples: [
+      {
+        name: " Basic Choice Message",
+        description: "Presents a simple choice message to the user",
+        code: `
+yield <Message>
+  Please choose one of the following options:
+  <Choice 
+    text="Select an option:"
+    options={[
+      { label: "Option 1", value: "option_1" },
+      { label: "Option 2", value: "option_2" },
+      { label: "Option 3", value: "option_3" }
+    ]}
+  />
+</Message>`
+      }
+    ],
+    leaf: {
+      props: X2.object({
+        text: X2.string().describe("The prompt text for the choice."),
+        options: X2.array(X2.object({
+          label: X2.string().describe("The label of the option to be displayed to the user."),
+          value: X2.string().describe("The value of the option to be sent back when selected.")
+        })).describe("The list of options to present to the user.")
+      })
+    }
+  });
+  DropdownComponent2 = new Autonomous2.Component({
+    type: "leaf",
+    aliases: ["dropdown", "select", "combo"],
+    name: "Dropdown",
+    description: `Present a dropdown menu to the user with multiple options.
+The user can select one of the provided options from the dropdown, and the selection will be sent back to the system for further processing.
+Unlike the Choice component, the Dropdown component is typically used when there are more options to choose from, providing a more compact UI.
+The dropdown can include up to 100 options for the user to choose from.
+Values for each option should be unique identifiers that can be used to identify the user's selection.`,
+    examples: [
+      {
+        name: " Basic Dropdown Message",
+        description: "Presents a simple dropdown message to the user",
+        code: `
+yield <Message>
+  Please select a fruit from the dropdown:
+  <Dropdown 
+    text="Choose an option:"
+    options={[
+      { label: "\uD83C\uDF50 Pear", value: "pear" },
+      { label: "\uD83C\uDF4E Apple", value: "apple" },
+      { label: "\uD83C\uDF4C Banana", value: "banana" }
+    ]}
+  />
+</Message>`
+      }
+    ],
+    leaf: {
+      props: X2.object({
+        text: X2.string().describe("The prompt text for the dropdown."),
+        options: X2.array(X2.object({
+          label: X2.string().describe("The label of the option to be displayed to the user."),
+          value: X2.string().describe("The value of the option to be sent back when selected.")
+        })).describe("The list of options to present in the dropdown.")
+      })
+    }
+  });
+  CarouselComponent2 = new Autonomous2.Component({
+    type: "leaf",
+    aliases: ["carousel", "cards", "card"],
+    name: "Carousel",
+    description: `Send a carousel of cards to the user, allowing them to browse through multiple items.
+Carousels are useful for displaying a collection of related items in a compact and interactive format.
+It is also possible to send a single card using the Carousel component, useful for sending a combination of image, text, and actions in one message such as a receipt or product detail.
+Each item in the carousel is represented as a card, which can include an image, title, subtitle, and actions.
+Users can navigate through the carousel by swiping or clicking on navigation controls.
+You can include multiple cards in the carousel, each with its own set of actions. A carousel can contain between 1 and 10 items (cards).`,
+    examples: [
+      {
+        name: " Basic Carousel Message",
+        description: "Sends a simple carousel message to the user",
+        code: `
+yield <Message>
+  Here is an **exciting** carousel for you!
+  <Carousel 
+    items={[
+      {
+        title: "Product 1",
+        subtitle: "Description of Product 1",
+        imageUrl: "https://example.com/path/to/image1.jpg",
+        actions: [
+          { action: "postback", label: "Buy Now", value: "buy_product_1" },
+          { action: "url", label: "View Details", value: "https://example.com/product_1" }
+        ]
+      },
+      {
+        title: "Product 2",
+        subtitle: "Description of Product 2",
+        imageUrl: "https://example.com/path/to/image2.jpg",
+        actions: [
+          { action: "postback", label: "Buy Now", value: "buy_product_2" },
+          { action: "url", label: "View Details", value: "https://example.com/product_2" }
+        ]
+      }
+    ]}
+  />
+</Message>`
+      }
+    ],
+    leaf: {
+      props: X2.object({
+        items: X2.array(X2.object({
+          title: X2.string().describe("The title of the carousel item."),
+          subtitle: X2.string().optional().describe("The subtitle of the carousel item."),
+          imageUrl: X2.string().url().optional().describe("The URL of the image to be displayed on the carousel item."),
+          actions: X2.array(X2.object({
+            action: X2.enum(["postback", "url", "say"]).describe("The type of action for the button."),
+            label: X2.string().describe("The label of the button to be displayed to the user."),
+            value: X2.string().describe("The value associated with the button action.")
+          })).max(3).describe("The list of actions (buttons) to include on the carousel item.")
+        })).describe("The list of items (cards) to include in the carousel.")
+      })
+    }
+  });
+  init_define_BUILD2();
+  init_define_PACKAGE_VERSIONS2();
   init_define_BUILD2();
   init_define_PACKAGE_VERSIONS2();
   AttachmentSchema2 = X2.object({
@@ -678591,6 +679097,7 @@ ${issues.join(`
       const client = context3.get("client");
       const botpressConversation = context3.get("conversation");
       const conversationInstance = new BaseConversationInstance2(botpressConversation, client);
+      const startTypingPromise = conversationInstance.startTyping().catch(() => {});
       let type;
       let requestObject = undefined;
       if (message3) {
@@ -678698,6 +679205,7 @@ ${issues.join(`
         execute: execute2
       });
       controller.abort();
+      startTypingPromise.then(() => conversationInstance.stopTyping().catch(() => {}));
     }
   };
   init_define_BUILD2();
@@ -682882,7 +683390,7 @@ class AgentProjectGenerator {
         deploy: "adk deploy"
       },
       dependencies: {
-        "@botpress/runtime": "^1.8.0"
+        "@botpress/runtime": "^1.8.2"
       },
       devDependencies: {
         typescript: "^5.9.3"
@@ -686790,7 +687298,7 @@ var import_ts_morph, __defProp10, __commonJS6 = (cb5, mod) => () => (mod || cb5(
 `));
     return code;
   }
-}, ADK_VERSION = "1.8.0", relative2 = (from, to3) => {
+}, ADK_VERSION = "1.8.2", relative2 = (from, to3) => {
   const fromDir = path102.dirname(from);
   const relative32 = path102.relative(fromDir, to3);
   return relative32.startsWith(".") ? relative32 : `./${relative32}`;
@@ -687004,7 +687512,7 @@ var init_dist17 = __esm(() => {
   require_package3 = __commonJS6((exports2, module) => {
     module.exports = {
       name: "@botpress/adk",
-      version: "1.8.0",
+      version: "1.8.2",
       description: "Core ADK library for building AI agents on Botpress",
       type: "module",
       main: "dist/index.js",
@@ -687051,7 +687559,7 @@ var init_dist17 = __esm(() => {
         "@botpress/cli": "^4.23",
         "@botpress/client": "^1.27.2",
         "@botpress/cognitive": "^0.2.0",
-        "@botpress/runtime": "^1.8.0",
+        "@botpress/runtime": "^1.8.2",
         "@botpress/sdk": "^4.18.1",
         "@bpinternal/yargs-extra": "^0.0.21",
         "@parcel/watcher": "^2.5.1",
@@ -693587,7 +694095,7 @@ var init_Separator = __esm(async () => {
 var require_package4 = __commonJS((exports2, module) => {
   module.exports = {
     name: "@botpress/adk",
-    version: "1.8.0",
+    version: "1.8.2",
     description: "Core ADK library for building AI agents on Botpress",
     type: "module",
     main: "dist/index.js",
@@ -693634,7 +694142,7 @@ var require_package4 = __commonJS((exports2, module) => {
       "@botpress/cli": "^4.23",
       "@botpress/client": "^1.27.2",
       "@botpress/cognitive": "^0.2.0",
-      "@botpress/runtime": "^1.8.0",
+      "@botpress/runtime": "^1.8.2",
       "@botpress/sdk": "^4.18.1",
       "@bpinternal/yargs-extra": "^0.0.21",
       "@parcel/watcher": "^2.5.1",
@@ -695155,7 +695663,7 @@ function checkRuntimeVersion(agentRoot) {
 `));
   }
 }
-var semver2, EXPECTED_RUNTIME_VERSION = "1.8.0";
+var semver2, EXPECTED_RUNTIME_VERSION = "1.8.2";
 var init_runtime_version_check = __esm(() => {
   init_source();
   semver2 = __toESM(require_semver2(), 1);
@@ -711248,7 +711756,7 @@ if (!checkNodeVersion(true)) {
   checkNodeVersion(false);
   process.exit(1);
 }
-var CLI_VERSION = "1.8.0";
+var CLI_VERSION = "1.8.2";
 if (CLI_VERSION.startsWith("<<") && CLI_VERSION.endsWith(">>")) {
   try {
     const __filename2 = fileURLToPath12(import.meta.url);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botpress/adk-cli",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "description": "Command-line interface for the Botpress Agent Development Kit (ADK)",
   "type": "module",
   "main": "dist/index.js",
@@ -40,9 +40,9 @@
     "url": "https://github.com/botpress/adk"
   },
   "dependencies": {
-    "@botpress/adk": "^1.8.0",
+    "@botpress/adk": "^1.8.2",
     "@botpress/cli": "^4.23",
-    "@botpress/runtime": "^1.8.0",
+    "@botpress/runtime": "^1.8.2",
     "adm-zip": "^0.5.16",
     "chalk": "^5.4.1",
     "clipboardy": "^4.0.0",