@microsoft/teams-js 2.7.2-beta.0 → 2.8.0-beta.1

package/dist/MicrosoftTeams.d.ts

@@ -2220,6 +2220,9 @@ export namespace authentication {
         /**
             * Initiates an authentication request, which opens a new window with the specified settings.
             *
+            * @remarks
+            * The authentication flow must start and end from the same domain, otherwise success and failure messages won't be returned to the window that initiated the call.
+            *
             * @param authenticateParameters - The parameters for the authentication request. It is a required parameter since v2 upgrade
             *
             * @returns Promise that will be fulfilled with the result from the authentication pop-up if successful.
@@ -2234,6 +2237,9 @@ export namespace authentication {
             *
             * Initiates an authentication request, which opens a new window with the specified settings.
             *
+            * @remarks
+            * The authentication flow must start and end from the same domain, otherwise success and failure messages won't be returned to the window that initiated the call.
+            *
             * @param authenticateParameters - The parameters for the authentication request.
             *
             */
@@ -2647,6 +2653,12 @@ export enum ChannelType {
         Shared = "Shared"
 }
 export const errorNotSupportedOnPlatform: SdkError;
+/**
+    * @hidden
+    *
+    * Minimum Adaptive Card version supported by the host.
+    */
+export const minAdaptiveCardVersion: AdaptiveCardVersion;
 
 /**
     * Represents information about tabs for an app
@@ -3302,6 +3314,37 @@ export interface DeepLinkParameters {
             */
         subEntityWebUrl?: string;
 }
+/**
+    * @hidden
+    * Shared Dialog Properties
+    */
+export interface BaseDialogInfo {
+        size: DialogSize;
+        /**
+            * Title of the dialog module.
+            */
+        title?: string;
+}
+/**
+    * Data structure to describe dialog information needed to open an Adaptive Card-based dialog.
+    */
+export interface AdaptiveCardDialogInfo extends BaseDialogInfo {
+        /**
+            * JSON defining an Adaptive Card.
+            */
+        card: string;
+}
+/**
+    * Data structure to describe dialog information needed to open a bot-based Adaptive Card-based dialog.
+    */
+export interface BotAdaptiveCardDialogInfo extends AdaptiveCardDialogInfo {
+        /**
+            * Specifies a bot ID to send the result of the user's interaction with the dialog module.
+            * The bot will receive a task/complete invoke event with a JSON object
+            * in the event payload.
+            */
+        completionBotId: string;
+}
 /**
     * Data structure to represent the size of a dialog
     */
@@ -3316,22 +3359,17 @@ export interface DialogSize {
         width: DialogDimension | number;
 }
 /**
-    * Data structure to describe dialog information needed to open a url based dialog.
+    * Data structure to describe dialog information needed to open a url-based dialog.
     */
-export interface UrlDialogInfo {
+export interface UrlDialogInfo extends BaseDialogInfo {
         /**
             * The url to be rendered in the webview/iframe.
             *
             * @remarks
             * The domain of the url must match at least one of the
-            * valid domains specified in the validDomains block of the manifest
+            * valid domains specified in the [validDomains block](https://learn.microsoft.com/microsoftteams/platform/resources/schema/manifest-schema#validdomains) of the app manifest
             */
         url: string;
-        size: DialogSize;
-        /**
-            * Title of the task module.
-            */
-        title?: string;
         /**
             * If client doesnt support the URL, the URL that needs to be opened in the browser.
             */
@@ -3508,6 +3546,17 @@ export enum DevicePermission {
         GeoLocation = "geolocation",
         Media = "media"
 }
+/** @hidden */
+export interface HostVersionsInfo {
+        adaptiveCardSchemaVersion?: AdaptiveCardVersion;
+}
+/**
+    * Represents the major and minor versions of the Adaptive Card schema in the current host
+    */
+export interface AdaptiveCardVersion {
+        majorVersion: number;
+        minorVersion: number;
+}
 
 /**
     * Namespace to interact with app initialization and lifecycle.
@@ -3801,7 +3850,8 @@ export namespace app {
                     */
                 isPSTNCallingAllowed?: boolean;
                 /**
-                    * The license type for the current user.
+                    * The license type for the current user. Possible values are:
+                    * "Unknown", "Teacher", "Student", "Free", "SmbBusinessVoice", "SmbNonVoice", "FrontlineWorker"
                     */
                 licenseType?: string;
                 /**
@@ -3901,7 +3951,7 @@ export namespace app {
                     */
                 meeting?: MeetingInfo;
                 /**
-                    * When hosted in SharePoint, this is the [SharePoint PageContext](https://learn.microsoft.com/en-us/javascript/api/sp-page-context/pagecontext?view=sp-typescript-latest), else `undefined`
+                    * When hosted in SharePoint, this is the [SharePoint PageContext](https://learn.microsoft.com/javascript/api/sp-page-context/pagecontext?view=sp-typescript-latest), else `undefined`
                     */
                 sharepoint?: any;
                 /**
@@ -4166,7 +4216,7 @@ export namespace dialog {
                     */
                 err?: string;
                 /**
-                    * Value provided in the `result` parameter by the dialog when the {@linkcode submit} function
+                    * Value provided in the `result` parameter by the dialog when the {@linkcode url.submit} function
                     * was called.
                     * If the dialog was closed by the user without submitting (e.g., using a control in the corner
                     * of the dialog), this value will be `undefined` here.
@@ -4179,7 +4229,7 @@ export namespace dialog {
             */
         type PostMessageChannel = (message: any) => void;
         /**
-            * Handler used for receiving results when a dialog closes, either the value passed by {@linkcode submit}
+            * Handler used for receiving results when a dialog closes, either the value passed by {@linkcode url.submit}
             * or an error if the dialog was closed by the user.
             * @beta
             */
@@ -4196,68 +4246,130 @@ export namespace dialog {
             * @beta
             */
         function initialize(): void;
-        /**
-            * Allows app to open a url based dialog.
-            *
-            * @remarks
-            * This function cannot be called from inside of a dialog
-            *
-            * @param urlDialogInfo - An object containing the parameters of the dialog module.
-            * @param submitHandler - Handler that triggers when a dialog calls the {@linkcode submit} function or when the user closes the dialog.
-            * @param messageFromChildHandler - Handler that triggers if dialog sends a message to the app.
-            *
-            * @returns a function that can be used to send messages to the dialog.
-            *
-            * @beta
-            */
-        function open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void;
-        /**
-            * Submit the dialog module and close the dialog
-            *
-            * @param result - The result to be sent to the bot or the app. Typically a JSON object or a serialized version of it,
-            *  If this function is called from a dialog while {@link M365ContentAction} is set in the context object by the host, result will be ignored
-            *
-            * @param appIds - Valid application(s) that can receive the result of the submitted dialogs. Specifying this parameter helps prevent malicious apps from retrieving the dialog result. Multiple app IDs can be specified because a web app from a single underlying domain can power multiple apps across different environments and branding schemes.
-            *
-            * @beta
-            */
-        function submit(result?: string | object, appIds?: string | string[]): void;
-        /**
-            *  Send message to the parent from dialog
-            *
-            *  @remarks
-            * This function is only called from inside of a dialog
-            *
-            * @param message - The message to send to the parent
-            *
-            * @beta
-            */
-        function sendMessageToParentFromDialog(message: any): void;
-        /**
-            *  Send message to the dialog from the parent
-            *
-            * @param message - The message to send
-            *
-            * @beta
-            */
-        function sendMessageToDialog(message: any): void;
-        /**
-            * Register a listener that will be triggered when a message is received from the app that opened the dialog.
-            *
-            * @remarks
-            * This function is only called from inside of a dialog.
-            *
-            * @param listener - The listener that will be triggered.
-            *
-            * @beta
-            */
-        function registerOnMessageFromParent(listener: PostMessageChannel): void;
+        namespace url {
+                /**
+                    * Allows app to open a url based dialog.
+                    *
+                    * @remarks
+                    * This function cannot be called from inside of a dialog
+                    *
+                    * @param urlDialogInfo - An object containing the parameters of the dialog module.
+                    * @param submitHandler - Handler that triggers when a dialog calls the {@linkcode submit} function or when the user closes the dialog.
+                    * @param messageFromChildHandler - Handler that triggers if dialog sends a message to the app.
+                    *
+                    * @beta
+                    */
+                function open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void;
+                /**
+                    * Submit the dialog module and close the dialog
+                    *
+                    * @remarks
+                    * This function is only intended to be called from code running within the dialog. Calling it from outside the dialog will have no effect.
+                    *
+                    * @param result - The result to be sent to the bot or the app. Typically a JSON object or a serialized version of it,
+                    *  If this function is called from a dialog while {@link M365ContentAction} is set in the context object by the host, result will be ignored
+                    *
+                    * @param appIds - Valid application(s) that can receive the result of the submitted dialogs. Specifying this parameter helps prevent malicious apps from retrieving the dialog result. Multiple app IDs can be specified because a web app from a single underlying domain can power multiple apps across different environments and branding schemes.
+                    *
+                    * @beta
+                    */
+                function submit(result?: string | object, appIds?: string | string[]): void;
+                /**
+                    *  Send message to the parent from dialog
+                    *
+                    * @remarks
+                    * This function is only intended to be called from code running within the dialog. Calling it from outside the dialog will have no effect.
+                    *
+                    * @param message - The message to send to the parent
+                    *
+                    * @beta
+                    */
+                function sendMessageToParentFromDialog(message: any): void;
+                /**
+                    *  Send message to the dialog from the parent
+                    *
+                    * @param message - The message to send
+                    *
+                    * @beta
+                    */
+                function sendMessageToDialog(message: any): void;
+                /**
+                    * Register a listener that will be triggered when a message is received from the app that opened the dialog.
+                    *
+                    * @remarks
+                    * This function is only intended to be called from code running within the dialog. Calling it from outside the dialog will have no effect.
+                    *
+                    * @param listener - The listener that will be triggered.
+                    *
+                    * @beta
+                    */
+                function registerOnMessageFromParent(listener: PostMessageChannel): void;
+                /**
+                    * Checks if dialog.url module is supported by the host
+                    *
+                    * @returns boolean to represent whether dialog.url module is supported
+                    *
+                    * @throws Error if {@linkcode app.initialize} has not successfully completed
+                    *
+                    * @beta
+                    */
+                function isSupported(): boolean;
+                /**
+                    * Namespace to open a dialog that sends results to the bot framework
+                    *
+                    * @beta
+                    */
+                namespace bot {
+                        /**
+                            * Allows an app to open the dialog module using bot.
+                            *
+                            * @param botUrlDialogInfo - An object containing the parameters of the dialog module including completionBotId.
+                            * @param submitHandler - Handler that triggers when the dialog has been submitted or closed.
+                            * @param messageFromChildHandler - Handler that triggers if dialog sends a message to the app.
+                            *
+                            * @returns a function that can be used to send messages to the dialog.
+                            *
+                            * @beta
+                            */
+                        function open(botUrlDialogInfo: BotUrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void;
+                        /**
+                            * Checks if dialog.url.bot capability is supported by the host
+                            *
+                            * @returns boolean to represent whether dialog.url.bot is supported
+                            *
+                            * @throws Error if {@linkcode app.initialize} has not successfully completed
+                            *
+                            * @beta
+                            */
+                        function isSupported(): boolean;
+                }
+                /**
+                    * @hidden
+                    *
+                    * Convert UrlDialogInfo to DialogInfo to send the information to host in {@linkcode open} API.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
+                    */
+                function getDialogInfoFromUrlDialogInfo(urlDialogInfo: UrlDialogInfo): DialogInfo;
+                /**
+                    * @hidden
+                    *
+                    * Convert BotUrlDialogInfo to DialogInfo to send the information to host in {@linkcode bot.open} API.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
+                    */
+                function getDialogInfoFromBotUrlDialogInfo(botUrlDialogInfo: BotUrlDialogInfo): DialogInfo;
+        }
         /**
             * Checks if dialog capability is supported by the host
             * @returns boolean to represent whether dialog capabilty is supported
             *
             * @throws Error if {@linkcode app.initialize} has not successfully completed
             *
+            * @throws Error if {@linkcode app.initialize} has not successfully completed
+            *
             * @beta
             */
         function isSupported(): boolean;
@@ -4286,55 +4398,91 @@ export namespace dialog {
                 function isSupported(): boolean;
         }
         /**
-            * Namespace to open a dialog that sends results to the bot framework
-            *
+            * Subcapability for interacting with adaptive card dialogs
             * @beta
             */
-        namespace bot {
+        namespace adaptiveCard {
                 /**
-                    * Allows an app to open the dialog module using bot.
+                    * Allows app to open an adaptive card based dialog.
                     *
-                    * @param botUrlDialogInfo - An object containing the parameters of the dialog module including completionBotId.
-                    * @param submitHandler - Handler that triggers when the dialog has been submitted or closed.
-                    * @param messageFromChildHandler - Handler that triggers if dialog sends a message to the app.
+                    * @remarks
+                    * This function cannot be called from inside of a dialog
                     *
-                    * @returns a function that can be used to send messages to the dialog.
+                    * @param adaptiveCardDialogInfo - An object containing the parameters of the dialog module {@link AdaptiveCardDialogInfo}.
+                    * @param submitHandler - Handler that triggers when a dialog calls the {@linkcode url.submit} function or when the user closes the dialog.
                     *
                     * @beta
                     */
-                function open(botUrlDialogInfo: BotUrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void;
+                function open(adaptiveCardDialogInfo: AdaptiveCardDialogInfo, submitHandler?: DialogSubmitHandler): void;
                 /**
-                    * Checks if dialog.bot capability is supported by the host
-                    * @returns boolean to represent whether dialog.bot is supported
+                    * Checks if dialog.adaptiveCard module is supported by the host
+                    *
+                    * @returns boolean to represent whether dialog.adaptiveCard module is supported
                     *
                     * @throws Error if {@linkcode app.initialize} has not successfully completed
                     *
                     * @beta
                     */
                 function isSupported(): boolean;
+                /**
+                    * Namespace for interaction with adaptive card dialogs that need to communicate with the bot framework
+                    *
+                    * @beta
+                    */
+                namespace bot {
+                        /**
+                            * Allows an app to open an adaptive card-based dialog module using bot.
+                            *
+                            * @param botAdaptiveCardDialogInfo - An object containing the parameters of the dialog module including completionBotId.
+                            * @param submitHandler - Handler that triggers when the dialog has been submitted or closed.
+                            *
+                            * @beta
+                            */
+                        function open(botAdaptiveCardDialogInfo: BotAdaptiveCardDialogInfo, submitHandler?: DialogSubmitHandler): void;
+                        /**
+                            * Checks if dialog.adaptiveCard.bot capability is supported by the host
+                            *
+                            * @returns boolean to represent whether dialog.adaptiveCard.bot is supported
+                            *
+                            * @throws Error if {@linkcode app.initialize} has not successfully completed
+                            *
+                            * @beta
+                            */
+                        function isSupported(): boolean;
+                }
+                /**
+                    * @hidden
+                    * Hide from docs
+                    * --------
+                    * Convert AdaptiveCardDialogInfo to DialogInfo to send the information to host in {@linkcode adaptiveCard.open} API.
+                    *
+                    * @internal
+                    */
+                function getDialogInfoFromAdaptiveCardDialogInfo(adaptiveCardDialogInfo: AdaptiveCardDialogInfo): DialogInfo;
+                /**
+                    * @hidden
+                    * Hide from docs
+                    * --------
+                    * Convert BotAdaptiveCardDialogInfo to DialogInfo to send the information to host in {@linkcode adaptiveCard.open} API.
+                    *
+                    * @internal
+                    */
+                function getDialogInfoFromBotAdaptiveCardDialogInfo(botAdaptiveCardDialogInfo: BotAdaptiveCardDialogInfo): DialogInfo;
+                /**
+                    * @hidden
+                    * Converts {@link TaskInfo} to {@link AdaptiveCardDialogInfo}
+                    * @param taskInfo - TaskInfo object to convert
+                    * @returns - converted AdaptiveCardDialogInfo
+                    */
+                function getAdaptiveCardDialogInfoFromTaskInfo(taskInfo: TaskInfo): AdaptiveCardDialogInfo;
+                /**
+                    * @hidden
+                    * Converts {@link TaskInfo} to {@link BotAdaptiveCardDialogInfo}
+                    * @param taskInfo - TaskInfo object to convert
+                    * @returns - converted BotAdaptiveCardDialogInfo
+                    */
+                function getBotAdaptiveCardDialogInfoFromTaskInfo(taskInfo: TaskInfo): BotAdaptiveCardDialogInfo;
         }
-        /**
-            * @hidden
-            *
-            * Convert UrlDialogInfo to DialogInfo to send the information to host in {@linkcode open} API.
-            *
-            * @internal
-            * Limited to Microsoft-internal use
-            *
-            * @beta
-            */
-        function getDialogInfoFromUrlDialogInfo(urlDialogInfo: UrlDialogInfo): DialogInfo;
-        /**
-            * @hidden
-            *
-            * Convert BotUrlDialogInfo to DialogInfo to send the information to host in {@linkcode bot.open} API.
-            *
-            * @internal
-            * Limited to Microsoft-internal use
-            *
-            * @beta
-            */
-        function getDialogInfoFromBotUrlDialogInfo(botUrlDialogInfo: BotUrlDialogInfo): DialogInfo;
 }
 
 /**
@@ -4438,6 +4586,12 @@ export namespace geoLocation {
         }
 }
 
+/**
+  * @returns The {@linkcode AdaptiveCardVersion} representing the Adaptive Card schema
+  * version supported by the host, or undefined if the host does not support Adaptive Cards
+  */
+export function getAdaptiveCardSchemaVersion(): AdaptiveCardVersion | undefined;
+
 /**
     * Navigation-specific part of the SDK.
     */
@@ -4844,7 +4998,7 @@ export namespace pages {
                 interface NavigateWithinAppParams {
                         /**
                             * The developer-defined unique ID for the page defined in the manifest or when first configuring
-                            * the page. (Known as {entityId} prior to TeamsJS v.2.0.0)
+                            * the page. (Known as {@linkcode Context.entityId} prior to TeamsJS v.2.0.0)
                             */
                         pageId: string;
                         /**
@@ -5700,45 +5854,126 @@ export namespace meeting {
         /**
             * Property bag for the meeting reaction received event
             *
+            * @hidden
+            * Hide from docs.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            *
             * @beta
             */
         interface MeetingReactionReceivedEventData {
                 /**
                     * Indicates the type of meeting reaction received
+                    *
+                    * @hidden
+                    * Hide from docs.
                     */
                 meetingReactionType?: MeetingReactionType;
                 /**
                     * error object in case there is a failure
+                    *
+                    * @hidden
+                    * Hide from docs.
                     */
                 error?: SdkError;
         }
         /**
             * Interface for raiseHandState properties
             *
+            * @hidden
+            * Hide from docs.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            *
             * @beta
             */
         interface IRaiseHandState {
-                /** Indicates whether the selfParticipant's hand is raised or not*/
+                /** Indicates whether the selfParticipant's hand is raised or not
+                    *
+                    * @hidden
+                    * Hide from docs.
+                    */
                 isHandRaised: boolean;
         }
         /**
             * Property bag for the raiseHandState changed event
             *
+            * @hidden
+            * Hide from docs.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            *
             * @beta
             */
         interface RaiseHandStateChangedEventData {
                 /**
                     * entire raiseHandState object for the selfParticipant
+                    *
+                    * @hidden
+                    * Hide from docs.
                     */
                 raiseHandState: IRaiseHandState;
                 /**
                     * error object in case there is a failure
+                    *
+                    * @hidden
+                    * Hide from docs.
                     */
                 error?: SdkError;
         }
+        /**
+            * Interface for mic state change
+            *
+            * @hidden
+            * Hide from docs.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            *
+            * @beta
+            */
+        interface MicState {
+                /**
+                    * Indicates the mute status of the mic
+                    */
+                isMicMuted: boolean;
+        }
+        /**
+            * Interface for RequestAppAudioHandling properties
+            *
+            * @hidden
+            * Hide from docs.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            *
+            * @beta
+            */
+        interface RequestAppAudioHandlingParams {
+                /**
+                    * Indicates whether the app is requesting to start handling audio, or if
+                    * it's giving audio back to the host
+                    */
+                isAppHandlingAudio: boolean;
+                /**
+                    * Callback for the host to tell the app to change its microphone state
+                    * @param micState The microphone state for the app to use
+                    * @returns A promise with the updated microphone state
+                    */
+                micMuteStateChangedCallback: (micState: MicState) => Promise<MicState>;
+        }
         /**
             * Different types of meeting reactions that can be sent/received
             *
+            * @hidden
+            * Hide from docs.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            *
             * @beta
             */
         enum MeetingReactionType {
@@ -5893,6 +6128,12 @@ export namespace meeting {
             *
             * @param handler The handler to invoke when the selfParticipant's (current user's) raiseHandState changes.
             *
+            * @hidden
+            * Hide from docs.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            *
             * @beta
             */
         function registerRaiseHandStateChangedHandler(handler: (eventData: RaiseHandStateChangedEventData) => void): void;
@@ -5902,6 +6143,12 @@ export namespace meeting {
             *
             * @param handler The handler to invoke when the selfParticipant (current user) successfully sends a meeting reaction
             *
+            * @hidden
+            * Hide from docs.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            *
             * @beta
             */
         function registerMeetingReactionReceivedHandler(handler: (eventData: MeetingReactionReceivedEventData) => void): void;
@@ -5938,6 +6185,46 @@ export namespace meeting {
                     */
                 function setOptions(shareInformation: ShareInformation): void;
         }
+        /**
+            * Have the app handle audio (mic & speaker) and turn off host audio.
+            *
+            * When {@link RequestAppAudioHandlingParams.isAppHandlingAudio} is true, the host will switch to audioless mode
+            *   Registers for mic mute status change events, which are events that the app can receive from the host asking the app to
+            *   mute or unmute the microphone.
+            *
+            * When {@link RequestAppAudioHandlingParams.isAppHandlingAudio} is false, the host will switch out of audioless mode
+            *   Unregisters the mic mute status change events so the app will no longer receive these events
+            *
+            * @throws Error if {@linkcode app.initialize} has not successfully completed
+            * @throws Error if {@link RequestAppAudioHandlingParams.micMuteStateChangedCallback} parameter is not defined
+            *
+            * @param requestAppAudioHandlingParams - {@link RequestAppAudioHandlingParams} object with values for the audio switchover
+            * @param callback - Callback with one parameter, the result
+            * can either be true (the host is now in audioless mode) or false (the host is not in audioless mode)
+            *
+            * @hidden
+            * Hide from docs.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            *
+            * @beta
+            */
+        function requestAppAudioHandling(requestAppAudioHandlingParams: RequestAppAudioHandlingParams, callback: (isHostAudioless: boolean) => void): void;
+        /**
+            * Notifies the host that the microphone state has changed in the app.
+            * @param micState - The new state that the microphone is in
+            *   isMicMuted - Boolean to indicate the current mute status of the mic.
+            *
+            * @hidden
+            * Hide from docs.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            *
+            * @beta
+            */
+        function updateMicState(micState: MicState): void;
 }
 
 export namespace monetization {
@@ -6529,7 +6816,7 @@ export namespace search {
 
 /**
     * Namespace to open a share dialog for web content.
-    * For more info, see {@link https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/build-and-test/share-to-teams-from-personal-app-or-tab Share to Teams from personal app or tab}
+    * For more info, see [Share to Teams from personal app or tab](https://learn.microsoft.com/microsoftteams/platform/concepts/build-and-test/share-to-teams-from-personal-app-or-tab)
     */
 export namespace sharing {
         export const SharingAPIMessages: {
@@ -7119,9 +7406,9 @@ export namespace settings {
 export namespace tasks {
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link dialog.open dialog.open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void} for url based dialogs
-            * and {@link dialog.bot.open dialog.bot.open(botUrlDialogInfo: BotUrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void} for bot based dialogs. In Teams,
-            * this function can be used for adaptive card based dialogs. Support for adaptive card based dialogs is coming to other hosts in the future.
+            * As of 2.8.0, please use {@link dialog.url.open dialog.url.open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void} for url based dialogs
+            * and {@link dialog.url.bot.open dialog.url.bot.open(botUrlDialogInfo: BotUrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void} for bot-based dialogs. In Teams,
+            * this function can be used for Adaptive Card-based dialogs. Support for Adaptive Card-based dialogs is coming to other hosts in the future.
             *
             * Allows an app to open the task module.
             *
@@ -7140,7 +7427,7 @@ export namespace tasks {
         function updateTask(taskInfo: TaskInfo): void;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link dialog.submit} instead.
+            * As of 2.8.0, please use {@link dialog.url.submit} instead.
             *
             * Submit the task module.
             *