@microsoft/agents-activity 0.2.14 → 0.4.1

package/dist/src/conversation/roleTypes.d.ts

@@ -7,8 +7,17 @@ import { z } from 'zod';
  * Enum representing the different role types in a conversation.
  */
 export declare enum RoleTypes {
+    /**
+     * Represents a user in the conversation.
+     */
     User = "user",
+    /**
+     * Represents an agent or bot in the conversation.
+     */
     Agent = "bot",
+    /**
+     * Represents a skill in the conversation.
+     */
     Skill = "skill"
 }
 /**

package/dist/src/conversation/roleTypes.js

@@ -11,8 +11,17 @@ const zod_1 = require("zod");
  */
 var RoleTypes;
 (function (RoleTypes) {
+    /**
+     * Represents a user in the conversation.
+     */
     RoleTypes["User"] = "user";
+    /**
+     * Represents an agent or bot in the conversation.
+     */
     RoleTypes["Agent"] = "bot";
+    /**
+     * Represents a skill in the conversation.
+     */
     RoleTypes["Skill"] = "skill";
 })(RoleTypes || (exports.RoleTypes = RoleTypes = {}));
 /**

package/dist/src/conversation/roleTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"roleTypes.js","sourceRoot":"","sources":["../../../src/conversation/roleTypes.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAuB;AAEvB;;GAEG;AACH,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,0BAAa,CAAA;IACb,0BAAa,CAAA;IACb,4BAAe,CAAA;AACjB,CAAC,EAJW,SAAS,yBAAT,SAAS,QAIpB;AAED;;GAEG;AACU,QAAA,iBAAiB,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAA"}
+{"version":3,"file":"roleTypes.js","sourceRoot":"","sources":["../../../src/conversation/roleTypes.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAuB;AAEvB;;GAEG;AACH,IAAY,SAeX;AAfD,WAAY,SAAS;IACnB;;OAEG;IACH,0BAAa,CAAA;IAEb;;OAEG;IACH,0BAAa,CAAA;IAEb;;OAEG;IACH,4BAAe,CAAA;AACjB,CAAC,EAfW,SAAS,yBAAT,SAAS,QAepB;AAED;;GAEG;AACU,QAAA,iBAAiB,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAA"}

package/dist/src/deliveryModes.d.ts

@@ -7,9 +7,21 @@ import { z } from 'zod';
  * Enum representing delivery modes.
  */
 export declare enum DeliveryModes {
+    /**
+     * Represents the normal delivery mode.
+     */
     Normal = "normal",
+    /**
+     * Represents a notification delivery mode.
+     */
     Notification = "notification",
+    /**
+     * Represents a delivery mode where replies are expected.
+     */
     ExpectReplies = "expectReplies",
+    /**
+     * Represents an ephemeral delivery mode.
+     */
     Ephemeral = "ephemeral"
 }
 /**

package/dist/src/deliveryModes.js

@@ -11,9 +11,21 @@ const zod_1 = require("zod");
  */
 var DeliveryModes;
 (function (DeliveryModes) {
+    /**
+     * Represents the normal delivery mode.
+     */
     DeliveryModes["Normal"] = "normal";
+    /**
+     * Represents a notification delivery mode.
+     */
     DeliveryModes["Notification"] = "notification";
+    /**
+     * Represents a delivery mode where replies are expected.
+     */
     DeliveryModes["ExpectReplies"] = "expectReplies";
+    /**
+     * Represents an ephemeral delivery mode.
+     */
     DeliveryModes["Ephemeral"] = "ephemeral";
 })(DeliveryModes || (exports.DeliveryModes = DeliveryModes = {}));
 /**

package/dist/src/deliveryModes.js.map

@@ -1 +1 @@
-{"version":3,"file":"deliveryModes.js","sourceRoot":"","sources":["../../src/deliveryModes.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAuB;AAEvB;;GAEG;AACH,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,kCAAiB,CAAA;IACjB,8CAA6B,CAAA;IAC7B,gDAA+B,CAAA;IAC/B,wCAAuB,CAAA;AACzB,CAAC,EALW,aAAa,6BAAb,aAAa,QAKxB;AAED;;GAEG;AACU,QAAA,sBAAsB,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC,CAAA"}
+{"version":3,"file":"deliveryModes.js","sourceRoot":"","sources":["../../src/deliveryModes.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAuB;AAEvB;;GAEG;AACH,IAAY,aAoBX;AApBD,WAAY,aAAa;IACvB;;OAEG;IACH,kCAAiB,CAAA;IAEjB;;OAEG;IACH,8CAA6B,CAAA;IAE7B;;OAEG;IACH,gDAA+B,CAAA;IAE/B;;OAEG;IACH,wCAAuB,CAAA;AACzB,CAAC,EApBW,aAAa,6BAAb,aAAa,QAoBxB;AAED;;GAEG;AACU,QAAA,sBAAsB,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC,CAAA"}

package/dist/src/inputHints.d.ts

@@ -7,8 +7,17 @@ import { z } from 'zod';
  * Enum representing input hints.
  */
 export declare enum InputHints {
+    /**
+     * Indicates that the bot is ready to accept input from the user.
+     */
     AcceptingInput = "acceptingInput",
+    /**
+     * Indicates that the bot is ignoring input from the user.
+     */
     IgnoringInput = "ignoringInput",
+    /**
+     * Indicates that the bot is expecting input from the user.
+     */
     ExpectingInput = "expectingInput"
 }
 /**

package/dist/src/inputHints.js

@@ -11,8 +11,17 @@ const zod_1 = require("zod");
  */
 var InputHints;
 (function (InputHints) {
+    /**
+     * Indicates that the bot is ready to accept input from the user.
+     */
     InputHints["AcceptingInput"] = "acceptingInput";
+    /**
+     * Indicates that the bot is ignoring input from the user.
+     */
     InputHints["IgnoringInput"] = "ignoringInput";
+    /**
+     * Indicates that the bot is expecting input from the user.
+     */
     InputHints["ExpectingInput"] = "expectingInput";
 })(InputHints || (exports.InputHints = InputHints = {}));
 /**

package/dist/src/inputHints.js.map

@@ -1 +1 @@
-{"version":3,"file":"inputHints.js","sourceRoot":"","sources":["../../src/inputHints.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAuB;AAEvB;;GAEG;AACH,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,+CAAiC,CAAA;IACjC,6CAA+B,CAAA;IAC/B,+CAAiC,CAAA;AACnC,CAAC,EAJW,UAAU,0BAAV,UAAU,QAIrB;AAED;;GAEG;AACU,QAAA,mBAAmB,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC,CAAA"}
+{"version":3,"file":"inputHints.js","sourceRoot":"","sources":["../../src/inputHints.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAuB;AAEvB;;GAEG;AACH,IAAY,UAeX;AAfD,WAAY,UAAU;IACpB;;OAEG;IACH,+CAAiC,CAAA;IAEjC;;OAEG;IACH,6CAA+B,CAAA;IAE/B;;OAEG;IACH,+CAAiC,CAAA;AACnC,CAAC,EAfW,UAAU,0BAAV,UAAU,QAerB;AAED;;GAEG;AACU,QAAA,mBAAmB,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC,CAAA"}

package/dist/src/messageReactionTypes.d.ts

@@ -7,7 +7,13 @@ import { z } from 'zod';
  * Enum representing message reaction types.
  */
 export declare enum MessageReactionTypes {
+    /**
+     * Represents a 'like' reaction to a message.
+     */
     Like = "like",
+    /**
+     * Represents a '+1' reaction to a message.
+     */
     PlusOne = "plusOne"
 }
 /**

package/dist/src/messageReactionTypes.js

@@ -11,7 +11,13 @@ const zod_1 = require("zod");
  */
 var MessageReactionTypes;
 (function (MessageReactionTypes) {
+    /**
+     * Represents a 'like' reaction to a message.
+     */
     MessageReactionTypes["Like"] = "like";
+    /**
+     * Represents a '+1' reaction to a message.
+     */
     MessageReactionTypes["PlusOne"] = "plusOne";
 })(MessageReactionTypes || (exports.MessageReactionTypes = MessageReactionTypes = {}));
 /**

package/dist/src/messageReactionTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"messageReactionTypes.js","sourceRoot":"","sources":["../../src/messageReactionTypes.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAuB;AAEvB;;GAEG;AACH,IAAY,oBAGX;AAHD,WAAY,oBAAoB;IAC9B,qCAAa,CAAA;IACb,2CAAmB,CAAA;AACrB,CAAC,EAHW,oBAAoB,oCAApB,oBAAoB,QAG/B;AAED;;GAEG;AACU,QAAA,6BAA6B,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA"}
+{"version":3,"file":"messageReactionTypes.js","sourceRoot":"","sources":["../../src/messageReactionTypes.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAuB;AAEvB;;GAEG;AACH,IAAY,oBAUX;AAVD,WAAY,oBAAoB;IAC9B;;OAEG;IACH,qCAAa,CAAA;IAEb;;OAEG;IACH,2CAAmB,CAAA;AACrB,CAAC,EAVW,oBAAoB,oCAApB,oBAAoB,QAU/B;AAED;;GAEG;AACU,QAAA,6BAA6B,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA"}

package/dist/src/textFormatTypes.d.ts

@@ -7,8 +7,17 @@ import { z } from 'zod';
  * Enum representing text format types.
  */
 export declare enum TextFormatTypes {
+    /**
+     * Represents text formatted using Markdown.
+     */
     Markdown = "markdown",
+    /**
+     * Represents plain text without any formatting.
+     */
     Plain = "plain",
+    /**
+     * Represents text formatted using XML.
+     */
     Xml = "xml"
 }
 /**

package/dist/src/textFormatTypes.js

@@ -11,8 +11,17 @@ const zod_1 = require("zod");
  */
 var TextFormatTypes;
 (function (TextFormatTypes) {
+    /**
+     * Represents text formatted using Markdown.
+     */
     TextFormatTypes["Markdown"] = "markdown";
+    /**
+     * Represents plain text without any formatting.
+     */
     TextFormatTypes["Plain"] = "plain";
+    /**
+     * Represents text formatted using XML.
+     */
     TextFormatTypes["Xml"] = "xml";
 })(TextFormatTypes || (exports.TextFormatTypes = TextFormatTypes = {}));
 /**

package/dist/src/textFormatTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"textFormatTypes.js","sourceRoot":"","sources":["../../src/textFormatTypes.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAuB;AAEvB;;GAEG;AACH,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,wCAAqB,CAAA;IACrB,kCAAe,CAAA;IACf,8BAAW,CAAA;AACb,CAAC,EAJW,eAAe,+BAAf,eAAe,QAI1B;AAED;;GAEG;AACU,QAAA,wBAAwB,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA"}
+{"version":3,"file":"textFormatTypes.js","sourceRoot":"","sources":["../../src/textFormatTypes.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAuB;AAEvB;;GAEG;AACH,IAAY,eAeX;AAfD,WAAY,eAAe;IACzB;;OAEG;IACH,wCAAqB,CAAA;IAErB;;OAEG;IACH,kCAAe,CAAA;IAEf;;OAEG;IACH,8BAAW,CAAA;AACb,CAAC,EAfW,eAAe,+BAAf,eAAe,QAe1B;AAED;;GAEG;AACU,QAAA,wBAAwB,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@microsoft/agents-activity",
-  "version": "0.2.14",
+  "version": "0.4.1",
   "homepage": "https://github.com/microsoft/Agents-for-js",
   "repository": {
     "type": "git",
@@ -20,7 +20,7 @@
   "types": "dist/src/index.d.ts",
   "dependencies": {
     "uuid": "^11.1.0",
-    "zod": "^3.24.3"
+    "zod": "^3.24.4"
   },
   "license": "MIT",
   "files": [

package/src/action/actionTypes.ts

@@ -9,16 +9,59 @@ import { z } from 'zod'
  * Enum representing the types of actions.
  */
 export enum ActionTypes {
+  /**
+   * Opens a URL in the default browser.
+   */
   OpenUrl = 'openUrl',
+
+  /**
+   * Sends a message back to the bot as a simple string.
+   */
   ImBack = 'imBack',
+
+  /**
+   * Sends a message back to the bot with additional data.
+   */
   PostBack = 'postBack',
+
+  /**
+   * Plays an audio file.
+   */
   PlayAudio = 'playAudio',
+
+  /**
+   * Plays a video file.
+   */
   PlayVideo = 'playVideo',
+
+  /**
+   * Displays an image.
+   */
   ShowImage = 'showImage',
+
+  /**
+   * Downloads a file.
+   */
   DownloadFile = 'downloadFile',
+
+  /**
+   * Initiates a sign-in process.
+   */
   Signin = 'signin',
+
+  /**
+   * Initiates a phone call.
+   */
   Call = 'call',
+
+  /**
+   * Sends a message back to the bot with additional metadata.
+   */
   MessageBack = 'messageBack',
+
+  /**
+   * Opens an application.
+   */
   OpenApp = 'openApp',
 }
 

package/src/action/semanticActionStateTypes.ts

@@ -9,8 +9,19 @@ import { z } from 'zod'
  * Enum representing the state types of a semantic action.
  */
 export enum SemanticActionStateTypes {
+  /**
+   * Indicates the start of a semantic action.
+   */
   Start = 'start',
+
+  /**
+   * Indicates the continuation of a semantic action.
+   */
   Continue = 'continue',
+
+  /**
+   * Indicates the completion of a semantic action.
+   */
   Done = 'done',
 }
 

package/src/activity.ts

@@ -3,27 +3,27 @@
  * Licensed under the MIT License.
  */
 
-import { z } from 'zod'
 import { v4 as uuid } from 'uuid'
-import { ActivityTypes, activityTypesZodSchema } from './activityTypes'
+import { z } from 'zod'
+import { SemanticAction, semanticActionZodSchema } from './action/semanticAction'
 import { SuggestedActions, suggestedActionsZodSchema } from './action/suggestedActions'
 import { ActivityEventNames, activityEventNamesZodSchema } from './activityEventNames'
 import { ActivityImportance, activityImportanceZodSchema } from './activityImportance'
-import { TextHighlight, textHighlightZodSchema } from './textHighlight'
-import { SemanticAction, semanticActionZodSchema } from './action/semanticAction'
+import { ActivityTypes, activityTypesZodSchema } from './activityTypes'
+import { Attachment, attachmentZodSchema } from './attachment/attachment'
+import { AttachmentLayoutTypes, attachmentLayoutTypesZodSchema } from './attachment/attachmentLayoutTypes'
 import { ChannelAccount, channelAccountZodSchema } from './conversation/channelAccount'
+import { Channels } from './conversation/channels'
 import { ConversationAccount, conversationAccountZodSchema } from './conversation/conversationAccount'
-import { TextFormatTypes, textFormatTypesZodSchema } from './textFormatTypes'
-import { AttachmentLayoutTypes, attachmentLayoutTypesZodSchema } from './attachment/attachmentLayoutTypes'
-import { MessageReaction, messageReactionZodSchema } from './messageReaction'
-import { InputHints, inputHintsZodSchema } from './inputHints'
-import { Attachment, attachmentZodSchema } from './attachment/attachment'
-import { Entity, entityZodSchema } from './entity/entity'
 import { ConversationReference, conversationReferenceZodSchema } from './conversation/conversationReference'
 import { EndOfConversationCodes, endOfConversationCodesZodSchema } from './conversation/endOfConversationCodes'
 import { DeliveryModes, deliveryModesZodSchema } from './deliveryModes'
-import { Channels } from './conversation/channels'
+import { Entity, entityZodSchema } from './entity/entity'
 import { Mention } from './entity/mention'
+import { InputHints, inputHintsZodSchema } from './inputHints'
+import { MessageReaction, messageReactionZodSchema } from './messageReaction'
+import { TextFormatTypes, textFormatTypesZodSchema } from './textFormatTypes'
+import { TextHighlight, textHighlightZodSchema } from './textHighlight'
 
 /**
  * Zod schema for validating an Activity object.
@@ -77,51 +77,234 @@ export const activityZodSchema = z.object({
  * Represents an activity in a conversation.
  */
 export class Activity {
+  /**
+   * The type of the activity.
+   */
   type: ActivityTypes | string
+
+  /**
+   * The text content of the activity.
+   */
   text?: string
+
+  /**
+   * The unique identifier of the activity.
+   */
   id?: string
+
+  /**
+   * The channel ID where the activity originated.
+   */
   channelId?: string
+
+  /**
+   * The account of the sender of the activity.
+   */
   from?: ChannelAccount
+
+  /**
+   * The timestamp of the activity.
+   */
   timestamp?: Date | string
+
+  /**
+   * The local timestamp of the activity.
+   */
   localTimestamp?: Date | string
+
+  /**
+   * The local timezone of the activity.
+   */
   localTimezone?: string
+
+  /**
+   * The caller ID of the activity.
+   */
   callerId?: string
+
+  /**
+   * The service URL of the activity.
+   */
   serviceUrl?: string
+
+  /**
+   * The conversation account associated with the activity.
+   */
   conversation?: ConversationAccount
+
+  /**
+   * The recipient of the activity.
+   */
   recipient?: ChannelAccount
+
+  /**
+   * The text format of the activity.
+   */
   textFormat?: TextFormatTypes | string
+
+  /**
+   * The attachment layout of the activity.
+   */
   attachmentLayout?: AttachmentLayoutTypes | string
+
+  /**
+   * The members added to the conversation.
+   */
   membersAdded?: ChannelAccount[]
+
+  /**
+   * The members removed from the conversation.
+   */
   membersRemoved?: ChannelAccount[]
+
+  /**
+   * The reactions added to the activity.
+   */
   reactionsAdded?: MessageReaction[]
+
+  /**
+   * The reactions removed from the activity.
+   */
   reactionsRemoved?: MessageReaction[]
+
+  /**
+   * The topic name of the activity.
+   */
   topicName?: string
+
+  /**
+   * Indicates whether the history is disclosed.
+   */
   historyDisclosed?: boolean
+
+  /**
+   * The locale of the activity.
+   */
   locale?: string
+
+  /**
+   * The speech text of the activity.
+   */
   speak?: string
+
+  /**
+   * The input hint for the activity.
+   */
   inputHint?: InputHints | string
+
+  /**
+   * The summary of the activity.
+   */
   summary?: string
+
+  /**
+   * The suggested actions for the activity.
+   */
   suggestedActions?: SuggestedActions
+
+  /**
+   * The attachments of the activity.
+   */
   attachments?: Attachment[]
+
+  /**
+   * The entities associated with the activity.
+   */
   entities?: Entity[]
+
+  /**
+   * The channel-specific data for the activity.
+   */
   channelData?: any
+
+  /**
+   * The action associated with the activity.
+   */
   action?: string
+
+  /**
+   * The ID of the activity being replied to.
+   */
   replyToId?: string
+
+  /**
+   * The label for the activity.
+   */
   label?: string
+
+  /**
+   * The value type of the activity.
+   */
   valueType?: string
+
+  /**
+   * The value associated with the activity.
+   */
   value?: unknown
+
+  /**
+   * The name of the activity event.
+   */
   name?: ActivityEventNames | string
+
+  /**
+   * The conversation reference for the activity.
+   */
   relatesTo?: ConversationReference
+
+  /**
+   * The end-of-conversation code for the activity.
+   */
   code?: EndOfConversationCodes | string
+
+  /**
+   * The expiration time of the activity.
+   */
   expiration?: string | Date
+
+  /**
+   * The importance of the activity.
+   */
   importance?: ActivityImportance | string
+
+  /**
+   * The delivery mode of the activity.
+   */
   deliveryMode?: DeliveryModes | string
+
+  /**
+   * The list of keywords to listen for in the activity.
+   */
   listenFor?: string[]
+
+  /**
+   * The text highlights in the activity.
+   */
   textHighlights?: TextHighlight[]
+
+  /**
+   * The semantic action associated with the activity.
+   */
   semanticAction?: SemanticAction
+
+  /**
+   * The raw timestamp of the activity.
+   */
   rawTimestamp?: string
+
+  /**
+   * The raw expiration time of the activity.
+   */
   rawExpiration?: string
+
+  /**
+   * The raw local timestamp of the activity.
+   */
   rawLocalTimestamp?: string
+
+  /**
+   * Additional properties of the activity.
+   */
   [x: string]: unknown
 
   /**
@@ -292,6 +475,97 @@ export class Activity {
     return result
   }
 
+  /**
+   * Normalizes mentions in the activity by removing mention tags and optionally removing recipient mention.
+   * @param removeMention Whether to remove the recipient mention from the activity.
+   */
+  public normalizeMentions (removeMention: boolean = false): void {
+    if (this.type === ActivityTypes.Message) {
+      if (removeMention) {
+        // Strip recipient mention tags and text
+        this.removeRecipientMention()
+
+        // Strip entity.mention records for recipient id
+        if (this.entities !== undefined && this.recipient?.id) {
+          this.entities = this.entities.filter((entity) => {
+            if (entity.type.toLowerCase() === 'mention') {
+              const mention = entity as unknown as Mention
+              return mention.mentioned.id !== this.recipient?.id
+            }
+            return true
+          })
+        }
+      }
+
+      // Remove <at> </at> tags keeping the inner text
+      if (this.text) {
+        this.text = Activity.removeAt(this.text)
+      }
+
+      // Remove <at> </at> tags from mention records keeping the inner text
+      if (this.entities !== undefined) {
+        const mentions = this.getMentions(this)
+        for (const mention of mentions) {
+          if (mention.text) {
+            mention.text = Activity.removeAt(mention.text)?.trim()
+          }
+        }
+      }
+    }
+  }
+
+  /**
+   * Removes <at> </at> tags from the specified text.
+   * @param text The text to process.
+   * @returns The text with <at> </at> tags removed.
+   */
+  private static removeAt (text: string): string {
+    if (!text) {
+      return text
+    }
+
+    let foundTag: boolean
+    do {
+      foundTag = false
+      const iAtStart = text.toLowerCase().indexOf('<at')
+      if (iAtStart >= 0) {
+        const iAtEnd = text.indexOf('>', iAtStart)
+        if (iAtEnd > 0) {
+          const iAtClose = text.toLowerCase().indexOf('</at>', iAtEnd)
+          if (iAtClose > 0) {
+            // Replace </at>
+            let followingText = text.substring(iAtClose + 5)
+
+            // If first char of followingText is not whitespace, insert space
+            if (followingText.length > 0 && !(/\s/.test(followingText[0]))) {
+              followingText = ` ${followingText}`
+            }
+
+            text = text.substring(0, iAtClose) + followingText
+
+            // Get tag content (text between <at...> and </at>)
+            const tagContent = text.substring(iAtEnd + 1, iAtClose)
+
+            // Replace <at ...> with just the tag content
+            let prefixText = text.substring(0, iAtStart)
+
+            // If prefixText is not empty and doesn't end with whitespace, add a space
+            if (prefixText.length > 0 && !(/\s$/.test(prefixText))) {
+              prefixText += ' '
+            }
+
+            text = prefixText + tagContent + followingText
+
+            // We found one, try again, there may be more
+            foundTag = true
+          }
+        }
+      }
+    } while (foundTag)
+
+    return text
+  }
+
   /**
    * Removes the mention text for a given ID.
    * @param id The ID of the mention to remove.