@microsoft/teams-js 2.1.1-beta.0 → 2.2.1-beta.0

package/dist/MicrosoftTeams.d.ts

@@ -5,56 +5,86 @@
     * Namespace to interact with the logging part of the SDK.
     * This object is used to send the app logs on demand to the host client
     *
-    * Hide from docs
-    *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export namespace logs {
         /**
             * @hidden
-            * Hide from docs
-            * ------
+            *
             * Registers a handler for getting app log
             *
             * @param handler - The handler to invoke to get the app log
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function registerGetLogHandler(handler: () => string): void;
+        /**
+            * @hidden
+            *
+            * @returns boolean to represent whether the logs capability is supported
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
         function isSupported(): boolean;
 }
 
 /**
     * @hidden
-    * Hide from docs
-    * --------
+    *
     * Information about all members in a chat
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export interface ChatMembersInformation {
         members: ThreadMember[];
 }
 /**
     * @hidden
-    * Hide from docs
-    * --------
+    *
     * Information about a chat member
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export interface ThreadMember {
         /**
             * @hidden
             * The member's user principal name in the current tenant.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         upn: string;
 }
+/**
+    * @hidden
+    *
+    * @internal
+    * Limited to Microsoft-internal use
+    */
 export enum NotificationTypes {
         fileDownloadStart = "fileDownloadStart",
         fileDownloadComplete = "fileDownloadComplete"
 }
+/**
+    * @hidden
+    *
+    * @internal
+    * Limited to Microsoft-internal use
+    */
 export interface ShowNotificationParameters {
         message: string;
         notificationType: NotificationTypes;
 }
 /**
     * @hidden
-    * Hide from docs.
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export enum ViewerActionTypes {
         view = "view",
@@ -63,143 +93,197 @@ export enum ViewerActionTypes {
 }
 /**
     * @hidden
-    * Hide from docs.
-    * ------
+    *
     * User setting changes that can be subscribed to
     */
 export enum UserSettingTypes {
         /**
             * @hidden
             * Use this key to subscribe to changes in user's file open preference
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         fileOpenPreference = "fileOpenPreference",
         /**
             * @hidden
             * Use this key to subscribe to theme changes
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         theme = "theme"
 }
 /**
     * @hidden
-    * Hide from docs.
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export interface FilePreviewParameters {
         /**
             * @hidden
             * The developer-defined unique ID for the file.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         entityId: string;
         /**
             * @hidden
             * The display name of the file.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         title: string;
         /**
             * @hidden
             * An optional description of the file.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         description?: string;
         /**
             * @hidden
             * The file extension; e.g. pptx, docx, etc.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         type: string;
         /**
             * @hidden
             * A url to the source of the file, used to open the content in the user's default browser
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         objectUrl: string;
         /**
             * @hidden
             * Optional; an alternate self-authenticating url used to preview the file in Mobile clients and offer it for download by the user
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         downloadUrl?: string;
         /**
             * @hidden
             * Optional; an alternate url optimized for previewing the file in web and desktop clients
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         webPreviewUrl?: string;
         /**
             * @hidden
             * Optional; an alternate url that allows editing of the file in web and desktop clients
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         webEditUrl?: string;
         /**
             * @hidden
             * Optional; the base url of the site where the file is hosted
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         baseUrl?: string;
         /**
             * @hidden
-            * Deprecated; prefer using viewerAction instead
+            * Deprecated; prefer using {@linkcode viewerAction} instead
             * Optional; indicates whether the file should be opened in edit mode
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         editFile?: boolean;
         /**
             * @hidden
             * Optional; the developer-defined unique ID for the sub-entity to return to when the file stage closes.
             * This field should be used to restore to a specific state within an entity, such as scrolling to or activating a specific piece of content.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         subEntityId?: string;
         /**
             * @hidden
             * Optional; indicates the mode in which file should be opened. Takes precedence over edit mode.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         viewerAction?: ViewerActionTypes;
         /**
             * @hidden
             * Optional; indicates how user prefers to open the file
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         fileOpenPreference?: FileOpenPreference;
         /**
+            * @hidden
             * Optional; id required to enable conversation button in files. Will be channel id in case file is shared in a channel or the chat id in p2p chat case.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         conversationId?: string;
 }
 /**
     * @hidden
-    * Hide from docs
-    * --------
+    *
     * Query parameters used when fetching team information
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export interface TeamInstanceParameters {
         /**
             * @hidden
             * Flag allowing to select favorite teams only
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         favoriteTeamsOnly?: boolean;
 }
 /**
     * @hidden
-    * Hide from docs
-    * --------
+    *
     * Information on userJoined Teams
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export interface UserJoinedTeamsInformation {
         /**
             * @hidden
             * List of team information
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         userJoinedTeams: TeamInformation[];
 }
 
-/**
-    * @internal
-    */
-export function initializePrivateApis(): void;
 /**
     * @hidden
-    * Hide from docs.
-    * ------
     * Upload a custom App manifest directly to both team and personal scopes.
     * This method works just for the first party Apps.
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export function uploadCustomApp(manifestBlob: Blob, onComplete?: (status: boolean, reason?: string) => void): void;
 /**
     * @hidden
-    * Internal use only
     * Sends a custom action MessageRequest to host or parent window
     *
     * @param actionName - Specifies name of the custom action to be sent
@@ -208,11 +292,11 @@ export function uploadCustomApp(manifestBlob: Blob, onComplete?: (status: boolea
     * @returns id of sent message
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export function sendCustomMessage(actionName: string, args?: any[], callback?: (...args: any[]) => void): void;
 /**
     * @hidden
-    * Internal use only
     * Sends a custom action MessageEvent to a child iframe/window, only if you are not using auth popup.
     * Otherwise it will go to the auth popup (which becomes the child)
     *
@@ -221,17 +305,18 @@ export function sendCustomMessage(actionName: string, args?: any[], callback?: (
     * @returns id of sent message
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export function sendCustomEvent(actionName: string, args?: any[]): void;
 /**
     * @hidden
-    * Internal use only
     * Adds a handler for an action sent by a child window or parent window
     *
     * @param actionName - Specifies name of the action message to handle
     * @param customHandler - The callback to invoke when the action message is received. The return value is sent to the child
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export function registerCustomHandler(actionName: string, customHandler: (...args: any[]) => any[]): void;
 /**
@@ -242,94 +327,129 @@ export function registerCustomHandler(actionName: string, customHandler: (...arg
     * @param handler - When a subscribed setting is updated this handler is called
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export function registerUserSettingsChangeHandler(settingTypes: UserSettingTypes[], handler: (settingType: UserSettingTypes, value: any) => void): void;
 /**
     * @hidden
-    * Hide from docs.
-    * ------
     * Opens a client-friendly preview of the specified file.
     *
     * @param file - The file to preview.
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export function openFilePreview(filePreviewParameters: FilePreviewParameters): void;
 
 /**
     * @hidden
-    * Hide from docs.
-    * ------
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export interface OpenConversationRequest {
         /**
             * @hidden
             * The Id of the subEntity where the conversation is taking place
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         subEntityId: string;
         /**
             * @hidden
             * The title of the conversation
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         title: string;
         /**
             * @hidden
             * The Id of the conversation. This is optional and should be specified whenever a previous conversation about a specific sub-entity has already been started before
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         conversationId?: string;
         /**
             * @hidden
             * The Id of the channel. This is optional and should be specified whenever a conversation is started or opened in a personal app scope
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         channelId?: string;
         /**
             * @hidden
             * The entity Id of the tab
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         entityId: string;
         /**
             * @hidden
             * A function that is called once the conversation Id has been created
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         onStartConversation?: (conversationResponse: ConversationResponse) => void;
         /**
             * @hidden
             * A function that is called if the pane is closed
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         onCloseConversation?: (conversationResponse: ConversationResponse) => void;
 }
 /**
     * @hidden
-    * Hide from docs.
-    * ------
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export interface ConversationResponse {
         /**
             * @hidden
+            *
+            * Limited to Microsoft-internal use
             * The Id of the subEntity where the conversation is taking place
             */
         subEntityId: string;
         /**
             * @hidden
             * The Id of the conversation. This is optional and should be specified whenever a previous conversation about a specific sub-entity has already been started before
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         conversationId?: string;
         /**
             * @hidden
             * The Id of the channel. This is optional and should be specified whenever a conversation is started or opened in a personal app scope
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         channelId?: string;
         /**
             * @hidden
             * The entity Id of the tab
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         entityId?: string;
 }
 /**
     * @hidden
     * Namespace to interact with the conversational subEntities inside the tab
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export namespace conversations {
         /**
@@ -339,13 +459,18 @@ export namespace conversations {
             * Allows the user to start or continue a conversation with each subentity inside the tab
             *
             * @returns Promise resolved upon completion
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function openConversation(openConversationRequest: OpenConversationRequest): Promise<void>;
         /**
             * @hidden
-            * Hide from docs
-            * --------------
+            *
             * Allows the user to close the conversation in the right pane
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function closeConversation(): void;
         /**
@@ -359,23 +484,34 @@ export namespace conversations {
             * @returns Promise resolved with information on all chat members
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function getChatMembers(): Promise<ChatMembersInformation>;
+        /**
+            * @returns boolean to represent whether conversations capability is supported
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
         function isSupported(): boolean;
 }
 
 /**
     * @hidden
-    * Hide from docs
-    * ------
+    *
     * Namespace to interact with the files specific part of the SDK.
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export namespace files {
         /**
             * @hidden
-            * Hide from docs
-            * ------
+            *
             * Cloud storage providers registered with Microsoft Teams
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export enum CloudStorageProvider {
                 Dropbox = "DROPBOX",
@@ -396,10 +532,11 @@ export namespace files {
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             *
             * External third-party cloud storages providers interface
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface IExternalProvider extends IWopiService {
                 providerType: CloudStorageProviderType;
@@ -407,9 +544,11 @@ export namespace files {
         }
         /**
             * @hidden
-            * Hide from docs
             *
             * Cloud storage provider type enums
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export enum CloudStorageProviderType {
                 Sharepoint = 0,
@@ -425,155 +564,231 @@ export namespace files {
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             *
             * Cloud storage folder interface
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface CloudStorageFolder {
                 /**
                     * @hidden
                     * ID of the cloud storage folder
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 id: string;
                 /**
                     * @hidden
                     * Display Name/Title of the cloud storage folder
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 title: string;
                 /**
                     * @hidden
                     * ID of the cloud storage folder in the provider
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 folderId: string;
                 /**
                     * @hidden
                     * Type of the cloud storage folder provider integration
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 providerType: CloudStorageProviderType;
                 /**
                     * @hidden
                     * Code of the supported cloud storage folder provider
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 providerCode: CloudStorageProvider;
                 /**
                     * @hidden
                     * Display name of the owner of the cloud storage folder provider
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 ownerDisplayName: string;
                 /**
                     * @hidden
                     * Sharepoint specific siteURL of the folder
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 siteUrl?: string;
                 /**
                     * @hidden
                     * Sharepoint specific serverRelativeUrl of the folder
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 serverRelativeUrl?: string;
                 /**
                     * @hidden
                     * Sharepoint specific libraryType of the folder
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 libraryType?: string;
                 /**
                     * @hidden
                     * Sharepoint specific accessType of the folder
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 accessType?: string;
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             *
             * Cloud storage item interface
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface CloudStorageFolderItem {
                 /**
                     * @hidden
                     * ID of the item in the provider
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 id: string;
                 /**
                     * @hidden
                     * Display name/title
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 title: string;
                 /**
                     * @hidden
                     * Key to differentiate files and subdirectory
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 isSubdirectory: boolean;
                 /**
                     * @hidden
                     * File extension
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 type: string;
                 /**
                     * @hidden
                     * Last modifed time of the item
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 lastModifiedTime: string;
                 /**
                     * @hidden
                     * Display size of the items in bytes
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 size: number;
                 /**
                     * @hidden
                     * URL of the file
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 objectUrl: string;
                 /**
                     * @hidden
                     * Temporary access token for the item
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 accessToken?: string;
         }
         /**
             * @hidden
-            * Hide from docs
             *
             * Files entity user interface
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface IFilesEntityUser {
                 /**
+                    * @hidden
                     * User name.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 displayName: string;
                 /**
+                    * @hidden
                     * User email.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 email: string;
                 /**
+                    * @hidden
                     * User MRI.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 mri: string;
         }
         /**
             * @hidden
-            * Hide from docs
             *
             * Special Document Library enum
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export enum SpecialDocumentLibraryType {
                 ClassMaterials = "classMaterials"
         }
         /**
             * @hidden
-            * Hide from docs
             *
             * Document Library Access enum
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export enum DocumentLibraryAccessType {
                 Readonly = "readonly"
         }
         /**
             * @hidden
-            * Hide from docs
             *
             * SharePoint file interface
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface ISharePointFile {
                 siteId?: string;
@@ -600,9 +815,11 @@ export namespace files {
         }
         /**
             * @hidden
-            * Hide from docs
             *
             * Download status enum
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export enum FileDownloadStatus {
                 Downloaded = "Downloaded",
@@ -611,45 +828,99 @@ export namespace files {
         }
         /**
             * @hidden
-            * Hide from docs
             *
             * Download Files interface
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface IFileItem {
                 /**
+                    * @hidden
                     * ID of the file metadata
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 objectId?: string;
                 /**
+                    * @hidden
                     * Path of the file
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 path?: string;
                 /**
+                    * @hidden
                     * Size of the file in bytes
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 sizeInBytes?: number;
                 /**
+                    * @hidden
                     * Download status
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 status?: FileDownloadStatus;
                 /**
+                    * @hidden
                     * Download timestamp
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 timestamp: Date;
                 /**
+                    * @hidden
                     * File name
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 title: string;
                 /**
+                    * @hidden
                     * Type of file i.e. the file extension.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 extension: string;
         }
+        /**
+            * @hidden
+            * Object used to represent a file
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        export interface File extends Blob {
+                /**
+                    * Last modified timestamp
+                    */
+                lastModified: Date;
+                /**
+                    * Name of the file
+                    */
+                name: string;
+                /**
+                    * The file path to uniquely identify it within the file hierarchy
+                    */
+                filePath: string;
+        }
         /**
             * @hidden
             * Hide from docs
             *
             * Actions specific to 3P cloud storage provider file and / or account
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export enum CloudStorageProviderFileAction {
                 Download = "DOWNLOAD",
@@ -661,6 +932,9 @@ export namespace files {
             * Hide from docs
             *
             * Interface for 3P cloud storage provider request content type
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface CloudStorageProviderRequest<T> {
                 content: T;
@@ -670,6 +944,9 @@ export namespace files {
             * Hide from docs
             *
             * Base interface for 3P cloud storage provider action request content
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface CloudStorageProviderContent {
                 providerCode: CloudStorageProvider;
@@ -680,16 +957,23 @@ export namespace files {
             *
             * Interface representing 3P cloud storage provider add new file action.
             * The file extension represents type of file e.g. docx, pptx etc. and need not be prefixed with dot(.)
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface CloudStorageProviderNewFileContent extends CloudStorageProviderContent {
                 newFileName: string;
                 newFileExtension: string;
+                destinationFolder: CloudStorageFolderItem | ISharePointFile;
         }
         /**
             * @hidden
             * Hide from docs
             *
             * Interface representing 3P cloud storage provider rename existing file action
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface CloudStorageProviderRenameFileContent extends CloudStorageProviderContent {
                 existingFile: CloudStorageFolderItem | ISharePointFile;
@@ -699,12 +983,39 @@ export namespace files {
             * @hidden
             * Hide from docs
             *
-            * Interface representing 3P cloud storage provider actions like Upload / Download / Delete file(s)
+            * Interface representing 3P cloud storage provider delete existing file(s) action
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
-        export interface CloudStorageProviderActionContent extends CloudStorageProviderContent {
-                action: CloudStorageProviderFileAction;
+        export interface CloudStorageProviderDeleteFileContent extends CloudStorageProviderContent {
                 itemList: CloudStorageFolderItem[] | ISharePointFile[];
         }
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Interface representing 3P cloud storage provider download existing file(s) action
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        export interface CloudStorageProviderDownloadFileContent extends CloudStorageProviderContent {
+                itemList: CloudStorageFolderItem[] | ISharePointFile[];
+        }
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Interface representing 3P cloud storage provider upload existing file(s) action
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        export interface CloudStorageProviderUploadFileContent extends CloudStorageProviderContent {
+                itemList: File[];
+                destinationFolder: CloudStorageFolderItem | ISharePointFile;
+        }
         /**
             * @hidden
             * Hide from docs
@@ -712,6 +1023,9 @@ export namespace files {
             * Gets a list of cloud storage folders added to the channel
             * @param channelId - ID of the channel whose cloud storage folders should be retrieved
             * @param callback - Callback that will be triggered post folders load
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function getCloudStorageFolders(channelId: string, callback: (error: SdkError, folders: CloudStorageFolder[]) => void): void;
         /**
@@ -722,6 +1036,9 @@ export namespace files {
             *
             * @param channelId - ID of the channel to add cloud storage folder
             * @param callback - Callback that will be triggered post add folder flow is compelete
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function addCloudStorageFolder(channelId: string, callback: (error: SdkError, isFolderAdded: boolean, folders: CloudStorageFolder[]) => void): void;
         /**
@@ -734,6 +1051,9 @@ export namespace files {
             * @param channelId - ID of the channel where folder is to be deleted
             * @param folderToDelete - cloud storage folder to be deleted
             * @param callback - Callback that will be triggered post delete
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function deleteCloudStorageFolder(channelId: string, folderToDelete: CloudStorageFolder, callback: (error: SdkError, isFolderDeleted: boolean) => void): void;
         /**
@@ -746,6 +1066,9 @@ export namespace files {
             * @param folder - Cloud storage folder (CloudStorageFolder) / sub directory (CloudStorageFolderItem)
             * @param providerCode - Code of the cloud storage folder provider
             * @param callback - Callback that will be triggered post contents are loaded
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function getCloudStorageFolderContents(folder: CloudStorageFolder | CloudStorageFolderItem, providerCode: CloudStorageProvider, callback: (error: SdkError, items: CloudStorageFolderItem[]) => void): void;
         /**
@@ -758,6 +1081,9 @@ export namespace files {
             * @param file - cloud storage file that should be opened
             * @param providerCode - Code of the cloud storage folder provider
             * @param fileOpenPreference - Whether file should be opened in web/inline
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function openCloudStorageFile(file: CloudStorageFolderItem, providerCode: CloudStorageProvider, fileOpenPreference?: FileOpenPreference.Web | FileOpenPreference.Inline): void;
         /**
@@ -766,12 +1092,18 @@ export namespace files {
             * third party cloud storage accounts that the tenant supports
             * @param excludeAddedProviders: return a list of support third party
             * cloud storages that hasn't been added yet.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function getExternalProviders(excludeAddedProviders: boolean, callback: (error: SdkError, providers: IExternalProvider[]) => void): void;
         /**
             * @hidden
             * Allow 1st party apps to call this function to move files
             * among SharePoint and third party cloud storages.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function copyMoveFiles(selectedFiles: CloudStorageFolderItem[] | ISharePointFile[], providerCode: CloudStorageProvider, destinationFolder: CloudStorageFolderItem | ISharePointFile, destinationProviderCode: CloudStorageProvider, isMove: boolean, callback: (error?: SdkError) => void): void;
         /**
@@ -781,6 +1113,9 @@ export namespace files {
             *
             * Gets list of downloads for current user
             * @param callback Callback that will be triggered post downloads load
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function getFileDownloads(callback: (error?: SdkError, files?: IFileItem[]) => void): void;
         /**
@@ -790,6 +1125,9 @@ export namespace files {
             * Open download preference folder if fileObjectId value is undefined else open folder containing the file with id fileObjectId
             * @param fileObjectId - Id of the file whose containing folder should be opened
             * @param callback Callback that will be triggered post open download folder/path
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function openDownloadFolder(fileObjectId: string, callback: (error?: SdkError) => void): void;
         /**
@@ -801,6 +1139,9 @@ export namespace files {
             * for selected 3P provider is performed on success of which the selected 3P provider support is added for user
             *
             * @param callback Callback that will be triggered post add 3P cloud storage provider action
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function addCloudStorageProvider(callback: (error?: SdkError) => void): void;
         /**
@@ -813,6 +1154,9 @@ export namespace files {
             *
             * @param logoutRequest 3P cloud storage provider remove action request content
             * @param callback Callback that will be triggered post signout of 3P cloud storage provider action
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function removeCloudStorageProvider(logoutRequest: CloudStorageProviderRequest<CloudStorageProviderContent>, callback: (error?: SdkError) => void): void;
         /**
@@ -823,8 +1167,11 @@ export namespace files {
             *
             * @param addNewFileRequest 3P cloud storage provider add action request content
             * @param callback Callback that will be triggered post adding a new file flow is finished
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
-        export function addCloudStorageProviderFile(addNewFileRequest: CloudStorageProviderRequest<CloudStorageProviderNewFileContent>, callback: (error?: SdkError) => void): void;
+        export function addCloudStorageProviderFile(addNewFileRequest: CloudStorageProviderRequest<CloudStorageProviderNewFileContent>, callback: (error?: SdkError, actionStatus?: boolean) => void): void;
         /**
             * @hidden
             * Hide from docs
@@ -833,22 +1180,52 @@ export namespace files {
             *
             * @param renameFileRequest 3P cloud storage provider rename action request content
             * @param callback Callback that will be triggered post renaming an existing file flow is finished
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        export function renameCloudStorageProviderFile(renameFileRequest: CloudStorageProviderRequest<CloudStorageProviderRenameFileContent>, callback: (error?: SdkError, actionStatus?: boolean) => void): void;
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Initiates the delete 3P cloud storage file(s) / folder (folder has to be empty) flow,
+            * which will delete existing file(s) / folder from the given 3P provider
+            *
+            * @param deleteFileRequest 3P cloud storage provider delete action request content
+            * @param callback Callback that will be triggered post deleting existing file(s) flow is finished
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
-        export function renameCloudStorageProviderFile(renameFileRequest: CloudStorageProviderRequest<CloudStorageProviderRenameFileContent>, callback: (error?: SdkError) => void): void;
+        export function deleteCloudStorageProviderFile(deleteFileRequest: CloudStorageProviderRequest<CloudStorageProviderDeleteFileContent>, callback: (error?: SdkError, actionStatus?: boolean) => void): void;
         /**
             * @hidden
             * Hide from docs
             *
-            * Initiates the 3P cloud storage provider file action (Upload / Download / Delete) flow
+            * Initiates the download 3P cloud storage file(s) flow,
+            * which will download existing file(s) from the given 3P provider in the teams client side without sharing any file info in the callback
             *
-            * Upload Action : Allows uploading file(s) to the given 3P cloud storage provider
-            * Download Action : Allows downloading file(s) from the given 3P cloud storage provider
-            * Delete Action : Allows deleting file(s) from the given 3P cloud storage provider
+            * @param downloadFileRequest 3P cloud storage provider download file(s) action request content
+            * @param callback Callback that will be triggered post downloading existing file(s) flow is finished
             *
-            * @param cloudStorageProviderFileActionRequest 3P cloud storage provider file action (Upload / Download / Delete) request content
-            * @param callback Callback that will be triggered post 3P cloud storage action
+            * @internal
+            * Limited to Microsoft-internal use
             */
-        export function performCloudStorageProviderFileAction(cloudStorageProviderFileActionRequest: CloudStorageProviderRequest<CloudStorageProviderActionContent>, callback: (error?: SdkError) => void): void;
+        export function downloadCloudStorageProviderFile(downloadFileRequest: CloudStorageProviderRequest<CloudStorageProviderDownloadFileContent>, callback: (error?: SdkError, actionStatus?: boolean) => void): void;
+        /**
+            * @hidden
+            * Hide from docs
+            *
+            * Initiates the upload 3P cloud storage file(s) flow, which will upload file(s) to the given 3P provider
+            *
+            * @param uploadFileRequest 3P cloud storage provider upload file(s) action request content
+            * @param callback Callback that will be triggered post uploading file(s) flow is finished
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        export function uploadCloudStorageProviderFile(uploadFileRequest: CloudStorageProviderRequest<CloudStorageProviderUploadFileContent>, callback: (error?: SdkError, actionStatus?: boolean) => void): void;
         /**
             * @hidden
             * Hide from docs
@@ -858,6 +1235,7 @@ export namespace files {
             *
             * @param handler - When 3P cloud storage provider list is updated this handler is called
             *
+            * @internal Limited to Microsoft-internal use
             */
         export function registerCloudStorageProviderListChangeHandler(handler: () => void): void;
         /**
@@ -869,151 +1247,194 @@ export namespace files {
             *
             * @param handler - When 3P cloud storage provider content is updated this handler is called
             *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function registerCloudStorageProviderContentChangeHandler(handler: () => void): void;
         export {};
 }
 
+/**
+    * @hidden
+    *
+    * @internal
+    * Limited to Microsoft-internal use
+    */
 export namespace meetingRoom {
         /**
             * @hidden
-            * Hide from docs
-            * ------
+            *
             * Data structure to represent a meeting room.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface MeetingRoomInfo {
                 /**
                     * @hidden
                     * Endpoint id of the meeting room.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 endpointId: string;
                 /**
                     * @hidden
                     * Device name of the meeting room.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 deviceName: string;
                 /**
                     * @hidden
                     * Client type of the meeting room.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 clientType: string;
                 /**
                     * @hidden
                     * Client version of the meeting room.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 clientVersion: string;
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Type of Media control capabilities of a meeting room.
             */
         type MediaControls = 'toggleMute' | 'toggleCamera' | 'toggleCaptions' | 'volume';
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Types of Stage Layout control capabilities of a meeting room.
             */
         type StageLayoutControls = 'showVideoGallery' | 'showContent' | 'showVideoGalleryAndContent' | 'showLargeGallery' | 'showTogether';
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Types of Meeting Control capabilities of a meeting room.
             */
         type MeetingControls = 'leaveMeeting';
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Types of Stage Layout State of a meeting room.
             */
         type StageLayoutStates = 'Gallery' | 'Content + gallery' | 'Content' | 'Large gallery' | 'Together mode';
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Data structure to represent capabilities of a meeting room.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface MeetingRoomCapability {
                 /**
                     * @hidden
                     * Media control capabilities, value can be "toggleMute", "toggleCamera", "toggleCaptions", "volume".
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 mediaControls: MediaControls[];
                 /**
                     * @hidden
                     * Main stage layout control capabilities, value can be "showVideoGallery", "showContent", "showVideoGalleryAndContent", "showLargeGallery", "showTogether".
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 stageLayoutControls: StageLayoutControls[];
                 /**
                     * @hidden
                     * Meeting control capabilities, value can be "leaveMeeting".
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 meetingControls: MeetingControls[];
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Data structure to represent states of a meeting room.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export interface MeetingRoomState {
                 /**
                     * @hidden
                     * Current mute state, true: mute, false: unmute.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 toggleMute: boolean;
                 /**
                     * @hidden
                     * Current camera state, true: camera on, false: camera off.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 toggleCamera: boolean;
                 /**
                     * @hidden
                     * Current captions state, true: captions on, false: captions off.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 toggleCaptions: boolean;
                 /**
                     * @hidden
                     * Current main stage layout state, value can be one of "Gallery", "Content + gallery", "Content", "Large gallery" and "Together mode".
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 stageLayout: StageLayoutStates;
                 /**
                     * @hidden
                     * Current leaveMeeting state, true: leave, false: no-op.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 leaveMeeting: boolean;
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Fetch the meeting room info that paired with current client.
             *
             * @returns Promise resolved with meeting room info or rejected with SdkError value
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function getPairedMeetingRoomInfo(): Promise<MeetingRoomInfo>;
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Send a command to paired meeting room.
             *
             * @param commandName The command name.
             * @returns Promise resolved upon completion or rejected with SdkError value
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function sendCommandToPairedMeetingRoom(commandName: string): Promise<void>;
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Registers a handler for meeting room capabilities update.
             * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
             *
             * @param handler The handler to invoke when the capabilities of meeting room update.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function registerMeetingRoomCapabilitiesUpdateHandler(handler: (capabilities: MeetingRoomCapability) => void): void;
         /**
@@ -1023,57 +1444,91 @@ export namespace meetingRoom {
             * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
             *
             * @param handler The handler to invoke when the states of meeting room update.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         export function registerMeetingRoomStatesUpdateHandler(handler: (states: MeetingRoomState) => void): void;
+        /**
+            * @hidden
+            *
+            * @returns boolean to represent whether the meetingRoom capability is supported
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
         export function isSupported(): boolean;
         export {};
 }
 
 export namespace notifications {
-    /**
-      * @hidden
-      * Hide from docs.
-      * ------
-      * display notification API.
-      *
-      * @param message - Notification message.
-      * @param notificationType - Notification type
-      *
-      * @internal
-      */
-    function showNotification(showNotificationParameters: ShowNotificationParameters): void;
-    function isSupported(): boolean;
+        /**
+            * @hidden
+            * display notification API.
+            *
+            * @param message - Notification message.
+            * @param notificationType - Notification type
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        function showNotification(showNotificationParameters: ShowNotificationParameters): void;
+        /**
+            * @hidden
+            * @returns boolean to represent whether the notifications capability is supported
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        function isSupported(): boolean;
 }
 
+/**
+    * @hidden
+    *
+    * @internal
+    * Limited to Microsoft-internal use
+    */
 export namespace remoteCamera {
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Data structure to represent patricipant details needed to request control of camera.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         interface Participant {
                 /**
                     * @hidden
                     * Id of participant.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 id: string;
                 /**
                     * @hidden
                     * Display name of participant.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 displayName?: string;
                 /**
                     * @hidden
                     * Active indicates whether the participant's device is actively being controlled.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 active?: boolean;
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Enum used to indicate possible camera control commands.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         enum ControlCommand {
                 Reset = "Reset",
@@ -1086,62 +1541,90 @@ export namespace remoteCamera {
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Data structure to indicate the current state of the device.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         interface DeviceState {
                 /**
                     * @hidden
                     * All operation are available to apply.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 available: boolean;
                 /**
                     * @hidden
                     * Either camera doesnt support to get state or It unable to apply command.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 error: boolean;
                 /**
                     * @hidden
                     * Reset max out or already applied. Client Disable Reset.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 reset: boolean;
                 /**
                     * @hidden
                     * ZoomIn maxed out.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 zoomIn: boolean;
                 /**
                     * @hidden
                     * ZoomOut maxed out.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 zoomOut: boolean;
                 /**
                     * @hidden
                     * PanLeft reached max left.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 panLeft: boolean;
                 /**
                     * @hidden
                     * PanRight reached max right.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 panRight: boolean;
                 /**
                     * @hidden
                     * TiltUp reached top.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 tiltUp: boolean;
                 /**
                     * @hidden
                     * TiltDown reached bottom.
+                    *
+                    * @internal Limited to Microsoft-internal use
                     */
                 tiltDown: boolean;
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Enum used to indicate the reason for the error.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         enum ErrorReason {
                 CommandResetError = 0,
@@ -1155,27 +1638,35 @@ export namespace remoteCamera {
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Data structure to indicate the status of the current session.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         interface SessionStatus {
                 /**
                     * @hidden
                     * Whether the far-end user is controlling a  device.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 inControl: boolean;
                 /**
                     * @hidden
                     * Reason the  control session was terminated.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 terminatedReason?: SessionTerminatedReason;
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Enum used to indicate the reason the session was terminated.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         enum SessionTerminatedReason {
                 None = 0,
@@ -1192,20 +1683,19 @@ export namespace remoteCamera {
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Fetch a list of the participants with controllable-cameras in a meeting.
             *
             * @param callback - Callback contains 2 parameters, error and participants.
             * error can either contain an error of type SdkError, incase of an error, or null when fetch is successful
             * participants can either contain an array of Participant objects, incase of a successful fetch or null when it fails
             * participants: object that contains an array of participants with controllable-cameras
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function getCapableParticipants(callback: (error: SdkError | null, participants: Participant[] | null) => void): void;
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Request control of a participant's camera.
             *
             * @param participant - Participant specifies the participant to send the request for camera control.
@@ -1213,25 +1703,30 @@ export namespace remoteCamera {
             * error can either contain an error of type SdkError, incase of an error, or null when fetch is successful
             * requestResponse can either contain the true/false value, incase of a successful request or null when it fails
             * requestResponse: True means request was accepted and false means request was denied
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function requestControl(participant: Participant, callback: (error: SdkError | null, requestResponse: boolean | null) => void): void;
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Send control command to the participant's camera.
             *
             * @param ControlCommand - ControlCommand specifies the command for controling the camera.
             * @param callback - Callback to invoke when the command response returns.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function sendControlCommand(ControlCommand: ControlCommand, callback: (error: SdkError | null) => void): void;
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Terminate the remote  session
             *
             * @param callback - Callback to invoke when the command response returns.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function terminateSession(callback: (error: SdkError | null) => void): void;
         /**
@@ -1240,6 +1735,9 @@ export namespace remoteCamera {
             * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
             *
             * @param handler - The handler to invoke when the list of participants with controllable-cameras changes.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function registerOnCapableParticipantsChangeHandler(handler: (participantChange: Participant[]) => void): void;
         /**
@@ -1248,6 +1746,9 @@ export namespace remoteCamera {
             * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
             *
             * @param handler - The handler to invoke when there is an error from the camera handler.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function registerOnErrorHandler(handler: (error: ErrorReason) => void): void;
         /**
@@ -1256,6 +1757,9 @@ export namespace remoteCamera {
             * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
             *
             * @param handler - The handler to invoke when the controlled device changes state.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function registerOnDeviceStateChangeHandler(handler: (deviceStateChange: DeviceState) => void): void;
         /**
@@ -1264,46 +1768,76 @@ export namespace remoteCamera {
             * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
             *
             * @param handler - The handler to invoke when the current session status changes.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function registerOnSessionStatusChangeHandler(handler: (sessionStatusChange: SessionStatus) => void): void;
+        /**
+            * @hidden
+            * @returns boolean to represent whether the remoteCamera capability is supported
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
         function isSupported(): boolean;
 }
 
 /**
     * @hidden
     * Namespace to interact with the application entities specific part of the SDK.
+    *
+    * @internal
+    * Limited to Microsoft-internal use
     */
 export namespace appEntity {
         /**
             * @hidden
-            * Hide from docs
-            * --------
+            *
             * Information on an app entity
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         interface AppEntity {
                 /**
                     * @hidden
                     * ID of the application
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 appId: string;
                 /**
                     * @hidden
                     * URL for the application's icon
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 appIconUrl: string;
                 /**
                     * @hidden
                     * Content URL for the app entity
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 contentUrl: string;
                 /**
                     * @hidden
                     * The display name for the app entity
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 displayName: string;
                 /**
                     * @hidden
                     * Website URL for the app entity. It is meant to be opened by the user in a browser.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 websiteUrl: string;
         }
@@ -1319,12 +1853,20 @@ export namespace appEntity {
             * @param callback Callback that will be triggered once the app entity information is available.
             *                 The callback takes two arguments: an SdkError in case something happened (i.e.
             *                 no permissions to execute the API) and the app entity configuration, if available
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function selectAppEntity(threadId: string, categories: string[], subEntityId: string, callback: (sdkError?: SdkError, appEntity?: AppEntity) => void): void;
         /**
+            * @hidden
+            *
             * Checks if appEntity capability is supported by the host
             * @returns true if the appEntity capability is enabled in runtime.supports.appEntity and
             * false if it is disabled
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function isSupported(): boolean;
 }
@@ -1332,10 +1874,9 @@ export namespace appEntity {
 /**
     * @hidden
     * Namespace to interact with the `teams` specific part of the SDK.
-    * ------
-    * Hide from docs
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export namespace teams {
         enum ChannelType {
@@ -1343,6 +1884,12 @@ export namespace teams {
                 Private = 1,
                 Shared = 2
         }
+        /**
+            * @hidden
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
         interface ChannelInfo {
                 siteUrl: string;
                 objectId: string;
@@ -1352,11 +1899,12 @@ export namespace teams {
         }
         /**
             * @hidden
-            * Hide from docs
-            * ------
             * Get a list of channels belong to a Team
             *
             * @param groupId - a team's objectId
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function getTeamChannels(groupId: string, callback: (error: SdkError, channels: ChannelInfo[]) => void): void;
         /**
@@ -1366,6 +1914,9 @@ export namespace teams {
             *
             * @param threadId - ID of the thread where the app entity will be created; if threadId is not
             * provided, the threadId from route params will be used.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function refreshSiteUrl(threadId: string, callback: (error: SdkError) => void): void;
         /**
@@ -1374,55 +1925,65 @@ export namespace teams {
             *
             * @returns true if the teams capability is enabled in runtime.supports.teams and
             * false if it is disabled
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         function isSupported(): boolean;
         /**
             * @hidden
-            * Hide from docs
-            * ------
-            *
             * @internal
+            * Limited to Microsoft-internal use
             */
         namespace fullTrust {
+                /**
+                    * @hidden
+                    * @internal
+                    * Limited to Microsoft-internal use
+                    */
                 namespace joinedTeams {
                         /**
                             * @hidden
-                            * Hide from docs
-                            * ------
                             * Allows an app to retrieve information of all user joined teams
                             *
                             * @param teamInstanceParameters - Optional flags that specify whether to scope call to favorite teams
                             * @returns Promise that resolves with information about the user joined teams or rejects with an error when the operation has completed
+                            *
+                            * @internal
+                            * Limited to Microsoft-internal use
                             */
                         function getUserJoinedTeams(teamInstanceParameters?: TeamInstanceParameters): Promise<UserJoinedTeamsInformation>;
                         /**
                             * @hidden
-                            * Hide from docs
-                            * ------
                             * Checks if teams.fullTrust.joinedTeams capability is supported by the host
                             *
                             * @returns true if the teams.fullTrust.joinedTeams capability is enabled in
                             * runtime.supports.teams.fullTrust.joinedTeams and false if it is disabled
+                            *
+                            * @internal
+                            * Limited to Microsoft-internal use
                             */
                         function isSupported(): boolean;
                 }
                 /**
                     * @hidden
-                    * Hide from docs
-                    * ------
                     * Allows an app to get the configuration setting value
                     *
                     * @param key - The key for the config setting
                     * @returns Promise that resolves with the value for the provided configuration setting or rejects with an error when the operation has completed
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 function getConfigSetting(key: string): Promise<string>;
                 /**
                     * @hidden
-                    * Hide from docs
-                    * ------
                     * Checks if teams.fullTrust capability is supported by the host
                     * @returns true if the teams.fullTrust capability is enabled in runtime.supports.teams.fullTrust and
                     * false if it is disabled
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 function isSupported(): boolean;
         }
@@ -1488,13 +2049,12 @@ export namespace authentication {
         function getAuthToken(authTokenRequest?: AuthTokenRequest): void;
         /**
             * @hidden
-            * Hide from docs.
-            * ------
             * Requests the decoded Azure AD user identity on behalf of the app.
             *
             * @returns Promise that resolves with the {@link UserProfile}.
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function getUser(): Promise<UserProfile>;
         /**
@@ -1502,12 +2062,11 @@ export namespace authentication {
             * As of 2.0.0, please use {@link authentication.getUser authentication.getUser(): Promise\<UserProfile\>} instead.
             *
             * @hidden
-            * Hide from docs.
-            * ------
             * Requests the decoded Azure AD user identity on behalf of the app.
             *
             * @param userRequest - It passes success/failure callbacks in the userRequest object(deprecated)
             * @internal
+            * Limited to Microsoft-internal use
             */
         function getUser(userRequest: UserRequest): void;
         /**
@@ -1602,26 +2161,34 @@ export namespace authentication {
         type AuthTokenRequest = AuthTokenRequestParameters & LegacyCallBacks;
         /**
             * @hidden
-            * Hide from docs.
-            * ------
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         interface UserProfile {
                 /**
                     * @hidden
                     * The intended recipient of the token. The application that receives the token must verify that the audience
                     * value is correct and reject any tokens intended for a different audience.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 aud: string;
                 /**
                     * @hidden
                     * Identifies how the subject of the token was authenticated.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 amr: string[];
                 /**
                     * @hidden
                     * Stores the time at which the token was issued. It is often used to measure token freshness.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 iat: number;
                 /**
@@ -1629,28 +2196,43 @@ export namespace authentication {
                     * Identifies the security token service (STS) that constructs and returns the token. In the tokens that Azure AD
                     * returns, the issuer is sts.windows.net. The GUID in the issuer claim value is the tenant ID of the Azure AD
                     * directory. The tenant ID is an immutable and reliable identifier of the directory.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 iss: string;
                 /**
                     * @hidden
                     * Provides the last name, surname, or family name of the user as defined in the Azure AD user object.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 family_name: string;
                 /**
                     * @hidden
                     * Provides the first or "given" name of the user, as set on the Azure AD user object.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 given_name: string;
                 /**
                     * @hidden
                     * Provides a human-readable value that identifies the subject of the token. This value is not guaranteed to
                     * be unique within a tenant and is designed to be used only for display purposes.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 unique_name: string;
                 /**
                     * @hidden
                     * Contains a unique identifier of an object in Azure AD. This value is immutable and cannot be reassigned or
                     * reused. Use the object ID to identify an object in queries to Azure AD.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 oid: string;
                 /**
@@ -1659,6 +2241,9 @@ export namespace authentication {
                     * This value is immutable and cannot be reassigned or reused, so it can be used to perform authorization
                     * checks safely. Because the subject is always present in the tokens the Azure AD issues, we recommended
                     * using this value in a general-purpose authorization system.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 sub: string;
                 /**
@@ -1666,6 +2251,9 @@ export namespace authentication {
                     * An immutable, non-reusable identifier that identifies the directory tenant that issued the token. You can
                     * use this value to access tenant-specific directory resources in a multitenant application. For example,
                     * you can use this value to identify the tenant in a call to the Graph API.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 tid: string;
                 /**
@@ -1674,6 +2262,9 @@ export namespace authentication {
                     * should verify that the current date is within the token lifetime; otherwise it should reject the token. The
                     * service might allow for up to five minutes beyond the token lifetime to account for any differences in clock
                     * time ("time skew") between Azure AD and the service.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 exp: number;
                 /**
@@ -1682,16 +2273,25 @@ export namespace authentication {
                     * should verify that the current date is within the token lifetime; otherwise it should reject the token. The
                     * service might allow for up to five minutes beyond the token lifetime to account for any differences in clock
                     * time ("time skew") between Azure AD and the service.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 nbf: number;
                 /**
                     * @hidden
                     * Stores the user name of the user principal.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 upn: string;
                 /**
                     * @hidden
                     * Stores the version number of the token.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 ver: string;
         }
@@ -1699,11 +2299,10 @@ export namespace authentication {
             * @deprecated
             * As of 2.0.0, this interface has been deprecated in favor of a Promise-based pattern.
             * @hidden
-            * Hide from docs.
-            * ------
             * Describes the UserRequest. Success callback describes how a successful request is handled.
             * Failure callback describes how a failed request is handled.
             * @internal
+            * Limited to Microsoft-internal use
             */
         interface UserRequest {
                 /**
@@ -1808,6 +2407,7 @@ export interface TabInstance {
         tabName: string;
         /**
             * @internal
+            * Limited to Microsoft-internal use
             * @protected
             */
         internalTabInstanceId?: string;
@@ -1931,20 +2531,95 @@ export enum FileOpenPreference {
         Desktop = "desktop",
         Web = "web"
 }
+/**
+    * Possible Action Types
+    *
+    * @beta
+    */
+export enum ActionObjectType {
+        M365Content = "m365content"
+}
+/**
+    * Data pertaining to object(s) the action is being performed on
+    *
+    * @param T The type of action being implemented
+    *
+    * @beta
+    */
+export interface BaseActionObject<T extends ActionObjectType> {
+        type: T;
+}
+/**
+    * Stores information needed to represent M365 Content stored
+    * in OneDrive or Sharepoint
+    *
+    * @beta
+    */
+export interface M365ContentAction extends BaseActionObject<ActionObjectType.M365Content> {
+        /**
+            * Only office content IDs are passed to the app. Apps should use these ids
+            * to query the Microsoft graph for more details.
+            */
+        itemId: string;
+        secondaryId?: SecondaryId;
+}
+/**
+    * Contains information on what Graph item is being queried
+    *
+    * @beta
+    */
+export interface SecondaryId {
+        name: SecondaryM365ContentIdName;
+        value: string;
+}
+/**
+    * These correspond with field names in the MSGraph
+    *
+    * @beta
+    */
+export enum SecondaryM365ContentIdName {
+        DriveId = "driveId",
+        GroupId = "groupId",
+        SiteId = "siteId",
+        UserId = "userId"
+}
+/**
+    * Information common to all actions
+    *
+    * @beta
+    */
+export interface ActionInfo {
+        /**
+            * Maps to the action id supplied inside the manifest
+            */
+        actionId: string;
+        /**
+            * Array of corresponding action objects
+            */
+        actionObjects: BaseActionObject<ActionObjectType>[];
+}
 /**
     * @deprecated
-    * As of 2.0.0, please use {@link app.Context} instead.
+    * As of 2.0.0, please use the {@link app.Context} interface and its updated properties instead.
     *
     * @remarks
-    * For more details on the updated {@link app.Context} interface, visit
-    * {@link https://docs.microsoft.com/microsoftteams/platform/tabs/how-to/using-teams-client-sdk#updates-to-the-context-interface}.
+    * For more details about the updated {@link app.Context} interface, visit the
+    * [Teams JavaScript client SDK](https://docs.microsoft.com/microsoftteams/platform/tabs/how-to/using-teams-client-sdk#updates-to-the-context-interface)
+    * overview article.
     *
     * Represents the structure of the received context message.
     */
 export interface Context {
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.team.groupId} instead
+            * As of 2.0.0, please use {@link ActionInfo | app.Context.actionInfo} instead
+            *
+            * Common information applicable to all content actions
+            */
+        actionInfo?: ActionInfo;
+        /**
+            * @deprecated
+            * As of 2.0.0, please use {@link app.TeamInfo.groupId | app.Context.team.groupId} instead
             *
             * The Office 365 group ID for the team with which the content is associated.
             * This field is available only when the identity permission is requested in the manifest.
@@ -1952,49 +2627,49 @@ export interface Context {
         groupId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.team.internalId} instead
+            * As of 2.0.0, please use {@link app.TeamInfo.internalId | app.Context.team.internalId} instead
             *
             * The Microsoft Teams ID for the team with which the content is associated.
             */
         teamId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.team.displayName} instead
+            * As of 2.0.0, please use {@link app.TeamInfo.displayName | app.Context.team.displayName} instead
             *
             * The name for the team with which the content is associated.
             */
         teamName?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.channel.id} instead
+            * As of 2.0.0, please use {@link app.ChannelInfo.id | app.Context.channel.id} instead
             *
             * The Microsoft Teams ID for the channel with which the content is associated.
             */
         channelId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.channel.displayName} instead
+            * As of 2.0.0, please use {@link app.ChannelInfo.displayName | app.Context.channel.displayName} instead
             *
             * The name for the channel with which the content is associated.
             */
         channelName?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.channel.membershipType} instead
+            * As of 2.0.0, please use {@link app.ChannelInfo.membershipType | app.Context.channel.membershipType} instead
             *
             * The type of the channel with which the content is associated.
             */
         channelType?: ChannelType;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.page.id} instead
+            * As of 2.0.0, please use {@link app.PageInfo.id | app.Context.page.id} instead
             *
             * The developer-defined unique ID for the entity this content points to.
             */
         entityId: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.page.subPageId} instead
+            * As of 2.0.0, please use {@link app.PageInfo.subPageId | app.Context.page.subPageId} instead
             *
             * The developer-defined unique ID for the sub-entity this content points to.
             * This field should be used to restore to a specific state within an entity,
@@ -2003,7 +2678,7 @@ export interface Context {
         subEntityId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.locale} instead
+            * As of 2.0.0, please use {@link app.AppInfo.locale | app.Context.app.locale} instead
             *
             * The current locale that the user has configured for the app formatted as
             * languageId-countryId (for example, en-us).
@@ -2011,7 +2686,7 @@ export interface Context {
         locale: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.osLocaleInfo} instead
+            * As of 2.0.0, please use {@link app.AppInfo.osLocaleInfo | app.Context.app.osLocaleInfo} instead
             *
             * More detailed locale info from the user's OS if available. Can be used together with
             * the @microsoft/globe NPM package to ensure your app respects the user's OS date and
@@ -2021,7 +2696,8 @@ export interface Context {
         /**
             * @deprecated
             *
-            * As of 2.0.0, please use {@link app.Context.user.loginHint} or {@link app.Context.user.userPrincipalName} instead.
+            * As of 2.0.0, please use {@link app.UserInfo.loginHint | app.Context.user.loginHint} or
+            * {@link app.UserInfo.userPrincipalName | app.Context.user.userPrincipalName} instead.
             * The UPN of the current user.
             * Because a malicious party can run your content in a browser, this value should
             * be used only as a hint as to who the user is and never as proof of identity.
@@ -2030,7 +2706,7 @@ export interface Context {
         upn?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.tenant.id} instead
+            * As of 2.0.0, please use {@link app.TenantInfo.id | app.Context.user.tenant.id} instead
             *
             * The Azure AD tenant ID of the current user.
             * Because a malicious party can run your content in a browser, this value should
@@ -2040,77 +2716,77 @@ export interface Context {
         tid?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.theme} instead
+            * As of 2.0.0, please use {@link app.AppInfo.theme | app.Context.app.theme} instead
             *
             * The current UI theme.
             */
         theme?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.page.isFullScreen} instead
+            * As of 2.0.0, please use {@link app.PageInfo.isFullScreen | app.Context.page.isFullScreen} instead
             *
             * Indication whether the tab is in full-screen mode.
             */
         isFullScreen?: boolean;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.team.type} instead
+            * As of 2.0.0, please use {@link app.TeamInfo.type | app.Context.team.type} instead
             *
             * The type of the team.
             */
         teamType?: TeamType;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.sharePointSite.teamSiteUrl} instead
+            * As of 2.0.0, please use {@link app.SharePointSiteInfo.teamSiteUrl | app.Context.sharePointSite.teamSiteUrl} instead
             *
             * The root SharePoint site associated with the team.
             */
         teamSiteUrl?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.sharePointSite.teamSiteDomain} instead
+            * As of 2.0.0, please use {@link app.SharePointSiteInfo.teamSiteDomain | app.Context.sharePointSite.teamSiteDomain} instead
             *
             * The domain of the root SharePoint site associated with the team.
             */
         teamSiteDomain?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.sharePointSite.teamSitePath} instead
+            * As of 2.0.0, please use {@link app.SharePointSiteInfo.teamSitePath | app.Context.sharePointSite.teamSitePath} instead
             *
             * The relative path to the SharePoint site associated with the team.
             */
         teamSitePath?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.channel.ownerTeamTenantId} instead
+            * As of 2.0.0, please use {@link app.ChannelInfo.ownerTenantId | app.Context.channel.ownerTenantId} instead
             *
             * The tenant ID of the host team.
             */
         hostTeamTenantId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.channel.ownerGroupId} instead
+            * As of 2.0.0, please use {@link app.ChannelInfo.ownerGroupId | app.Context.channel.ownerGroupId} instead
             *
             * The AAD group ID of the host team.
             */
         hostTeamGroupId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.channel.relativeUrl} instead
+            * As of 2.0.0, please use {@link app.ChannelInfo.relativeUrl | app.Context.channel.relativeUrl} instead
             *
             * The relative path to the SharePoint folder associated with the channel.
             */
         channelRelativeUrl?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.host.sessionId} instead
+            * As of 2.0.0, please use {@link app.AppHostInfo.sessionId | app.Context.app.host.sessionId} instead
             *
             * Unique ID for the current Teams session for use in correlating telemetry data.
             */
         sessionId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.team.userRole} instead
+            * As of 2.0.0, please use {@link app.TeamInfo.userRole | app.Context.team.userRole} instead
             *
             * The user's role in the team.
             * Because a malicious party can run your content in a browser, this value should
@@ -2119,14 +2795,14 @@ export interface Context {
         userTeamRole?: UserTeamRole;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.chat.id} instead
+            * As of 2.0.0, please use {@link app.ChatInfo.id | app.Context.chat.id} instead
             *
             * The Microsoft Teams ID for the chat with which the content is associated.
             */
         chatId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.loginHint} instead
+            * As of 2.0.0, please use {@link app.UserInfo.loginHint | app.Context.user.loginHint} instead
             *
             * A value suitable for use as a login_hint when authenticating with Azure AD.
             * Because a malicious party can run your content in a browser, this value should
@@ -2136,7 +2812,7 @@ export interface Context {
         loginHint?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.userPrincipalName} instead
+            * As of 2.0.0, please use {@link app.UserInfo.userPrincipalName | app.Context.user.userPrincipalName} instead
             *
             * The UPN of the current user. This may be an externally-authenticated UPN (e.g., guest users).
             * Because a malicious party run your content in a browser, this value should
@@ -2146,7 +2822,7 @@ export interface Context {
         userPrincipalName?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.id} instead
+            * As of 2.0.0, please use {@link app.UserInfo.id | app.Context.user.id} instead
             *
             * The Azure AD object id of the current user.
             * Because a malicious party run your content in a browser, this value should
@@ -2156,7 +2832,7 @@ export interface Context {
         userObjectId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.team.isArchived} instead
+            * As of 2.0.0, please use {@link app.TeamInfo.isArchived | app.Context.team.isArchived} instead
             *
             * Indicates whether team is archived.
             * Apps should use this as a signal to prevent any changes to content associated with archived teams.
@@ -2164,14 +2840,14 @@ export interface Context {
         isTeamArchived?: boolean;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.host.name} instead
+            * As of 2.0.0, please use {@link app.AppHostInfo.name | app.Context.app.host.name} instead
             *
             * The name of the host client. Possible values are: Office, Orange, Outlook, Teams
             */
         hostName?: HostName;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.host.clientType} instead
+            * As of 2.0.0, please use {@link app.AppHostInfo.clientType | app.Context.app.host.clientType} instead
             *
             * The type of the host client. Possible values are : android, ios, web, desktop, rigel(deprecated, use teamsRoomsWindows instead),
             * surfaceHub, teamsRoomsWindows, teamsRoomsAndroid, teamsPhones, teamsDisplays
@@ -2179,35 +2855,35 @@ export interface Context {
         hostClientType?: HostClientType;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.page.frameContext} instead
+            * As of 2.0.0, please use {@link app.PageInfo.frameContext | app.Context.page.frameContext} instead
             *
             * The context where tab url is loaded (content, task, setting, remove, sidePanel)
             */
         frameContext?: FrameContexts;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.sharepoint} instead
+            * As of 2.0.0, please use {@link app.Context | app.Context.sharepoint} instead
             *
             * SharePoint context. This is only available when hosted in SharePoint.
             */
         sharepoint?: any;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.tenant.teamsSku} instead
+            * As of 2.0.0, please use {@link app.TenantInfo.teamsSku | app.Context.tenant.teamsSku} instead
             *
             * The type of license for the current users tenant.
             */
         tenantSKU?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.licenseType} instead
+            * As of 2.0.0, please use {@link app.UserInfo.licenseType | app.Context.user.licenseType} instead
             *
             * The license type for the current user.
             */
         userLicenseType?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.parentMessageId} instead
+            * As of 2.0.0, please use {@link app.AppInfo.parentMessageId | app.Context.app.parentMessageId} instead
             *
             * The ID of the parent message from which this task module was launched.
             * This is only available in task modules launched from bot cards.
@@ -2215,119 +2891,119 @@ export interface Context {
         parentMessageId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.host.ringId} instead
+            * As of 2.0.0, please use {@link app.AppHostInfo.ringId | app.Context.app.host.ringId} instead
             *
             * Current ring ID
             */
         ringId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.sessionId} instead
+            * As of 2.0.0, please use {@link app.AppInfo.sessionId | app.Context.app.sessionId} instead
             *
             * Unique ID for the current session for use in correlating telemetry data.
             */
         appSessionId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.appLaunchId} instead
+            * As of 2.0.0, please use {@link app.AppInfo.appLaunchId | app.Context.app.appLaunchId} instead
             *
             * ID for the current visible app which is different for across cached sessions. Used for correlating telemetry data``
             */
         appLaunchId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.isCallingAllowed} instead
+            * As of 2.0.0, please use {@link app.UserInfo.isCallingAllowed | app.Context.user.isCallingAllowed} instead
             *
             * Represents whether calling is allowed for the current logged in User
             */
         isCallingAllowed?: boolean;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.isPSTNCallingAllowed} instead
+            * As of 2.0.0, please use {@link app.UserInfo.isPSTNCallingAllowed | app.Context.user.isPSTNCallingAllowed} instead
             *
             * Represents whether PSTN calling is allowed for the current logged in User
             */
         isPSTNCallingAllowed?: boolean;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.meeting.id} instead
+            * As of 2.0.0, please use {@link app.MeetingInfo.id | app.Context.meeting.id} instead
             *
             * Meeting Id used by tab when running in meeting context
             */
         meetingId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.channel.defaultOneNoteSectionId} instead
+            * As of 2.0.0, please use {@link app.ChannelInfo.defaultOneNoteSectionId | app.Context.channel.defaultOneNoteSectionId} instead
             *
             * The OneNote section ID that is linked to the channel.
             */
         defaultOneNoteSectionId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.page.isMultiWindow} instead
+            * As of 2.0.0, please use {@link app.PageInfo.isMultiWindow | app.Context.page.isMultiWindow} instead
             *
             * Indication whether the tab is in a pop out window
             */
         isMultiWindow?: boolean;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.iconPositionVertical} instead
+            * As of 2.0.0, please use {@link app.AppInfo.iconPositionVertical | app.Context.app.iconPositionVertical} instead
             *
             * Personal app icon y coordinate position
             */
         appIconPosition?: number;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.page.sourceOrigin} instead
+            * As of 2.0.0, please use {@link app.PageInfo.sourceOrigin | app.Context.page.sourceOrigin} instead
             *
             * Source origin from where the tab is opened
             */
         sourceOrigin?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.userClickTime} instead
+            * As of 2.0.0, please use {@link app.AppInfo.userClickTime | app.Context.app.userClickTime} instead
             *
             * Time when the user clicked on the tab
             */
         userClickTime?: number;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.team.templateId} instead
+            * As of 2.0.0, please use {@link app.TeamInfo.templateId | app.Context.team.templateId} instead
             *
             * Team Template ID if there was a Team Template associated with the creation of the team.
             */
         teamTemplateId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.app.userFileOpenPreference} instead
+            * As of 2.0.0, please use {@link app.AppInfo.userFileOpenPreference | app.Context.app.userFileOpenPreference} instead
             *
             * Where the user prefers the file to be opened from by default during file open
             */
         userFileOpenPreference?: FileOpenPreference;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.user.displayName} instead
+            * As of 2.0.0, please use {@link app.UserInfo.displayName | app.Context.user.displayName} instead
             *
             * The address book name of the current user.
             */
         userDisplayName?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.sharePointSite.teamSiteId} instead
+            * As of 2.0.0, please use {@link app.SharePointSiteInfo.teamSiteId | app.Context.sharePointSite.teamSiteId} instead
             *
             * Teamsite ID, aka sharepoint site id.
             */
         teamSiteId?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.sharePointSite.mySiteDomain} instead
+            * As of 2.0.0, please use {@link app.SharePointSiteInfo.mySiteDomain | app.Context.sharePointSite.mySiteDomain} instead
             *
             * The SharePoint my site domain associated with the user.
             */
         mySiteDomain?: string;
         /**
             * @deprecated
-            * As of 2.0.0, please use {@link app.Context.sharePointSite.mySitePath} instead
+            * As of 2.0.0, please use {@link app.SharePointSiteInfo.mySitePath | app.Context.sharePointSite.mySitePath} instead
             *
             * The SharePoint relative path to the current users mysite
             */
@@ -2465,9 +3141,9 @@ export interface DialogSize {
 }
 /**
     * @hidden
-    * Hide from docs.
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export interface LoadContext {
         /**
@@ -2939,27 +3615,34 @@ export namespace app {
             */
         interface Context {
                 /**
-                    * Info of the app
+                    * Content Action Info
+                    *
+                    * @beta
+                    */
+                actionInfo?: ActionInfo;
+                /**
+                    * Properties about the current session for your app
                     */
                 app: AppInfo;
                 /**
-                    * Info of the current page of App
+                    * Info about the current page context hosting your app
                     */
                 page: PageInfo;
                 /**
-                    * Info of the user
+                    * Info about the currently logged in user running the app.
+                    * If the current user is not logged in/authenticated (e.g. a meeting app running for an anonymously-joined partcipant) this will be `undefined`.
                     */
                 user?: UserInfo;
                 /**
-                    * Info of the Microsoft Teams channel
+                    * When running in the context of a Teams channel, provides information about the channel, else `undefined`
                     */
                 channel?: ChannelInfo;
                 /**
-                    * Info of the Microsoft Teams chat
+                    * When running in the context of a Teams chat, provides information about the chat, else `undefined`
                     */
                 chat?: ChatInfo;
                 /**
-                    * Info of the Microsoft Teams meeting
+                    * When running in the context of a Teams meeting, provides information about the meeting, else `undefined`
                     */
                 meeting?: MeetingInfo;
                 /**
@@ -2967,11 +3650,13 @@ export namespace app {
                     */
                 sharepoint?: any;
                 /**
-                    * Info of the sharePoint site associated with the team.
+                    * When running in Teams for an organization with a tenant, provides information about the SharePoint site associated with the team.
+                    * Will be `undefined` when not running in Teams for an organization with a tenant.
                     */
                 sharePointSite?: SharePointSiteInfo;
                 /**
-                    * Info of the Microsoft Teams team
+                    * When running in Teams, provides information about the Team context in which your app is running.
+                    * Will be `undefined` when not running in Teams.
                     */
                 team?: TeamInfo;
         }
@@ -2999,20 +3684,18 @@ export namespace app {
         function initialize(validMessageOrigins?: string[]): Promise<void>;
         /**
             * @hidden
-            * Hide from docs.
-            * ------
             * Undocumented function used to set a mock window for unit tests
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function _initialize(hostWindow: any): void;
         /**
             * @hidden
-            * Hide from docs.
-            * ------
             * Undocumented function used to clear state between unit tests
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function _uninitialize(): void;
         /**
@@ -3218,10 +3901,11 @@ export namespace dialog {
         /**
             * @hidden
             * Hide from docs because this function is only used during initialization
-            * ------------------
+            *
             * Adds register handlers for messageForChild upon initialization and only in the tasks FrameContext. {@link FrameContexts.task}
-            * Function is called during app intitialization
+            * Function is called during app initialization
             * @internal
+            * Limited to Microsoft-internal use
             */
         function initialize(): void;
         /**
@@ -3238,7 +3922,7 @@ export namespace dialog {
             */
         function open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void;
         /**
-            * Submit the dialog module.
+            * 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
             * @param appIds - Helps to validate that the call originates from the same appId as the one that invoked the task module
@@ -3314,20 +3998,20 @@ export namespace dialog {
         }
         /**
             * @hidden
-            * Hide from docs
-            * --------
+            *
             * 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
-            * Hide from docs
-            * --------
+            *
             * 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;
 }
@@ -3449,6 +4133,7 @@ export namespace pages {
             * @param handler - The handler for placing focus within the application.
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function registerFocusEnterHandler(handler: (navigateForward: boolean) => void): void;
         /**
@@ -3602,9 +4287,10 @@ export namespace pages {
                 /**
                     * @hidden
                     * Hide from docs because this function is only used during initialization
-                    * ------------------
+                    *
                     * Adds register handlers for settings.save and settings.remove upon initialization. Function is called in {@link app.initializeHelper}
                     * @internal
+                    * Limited to Microsoft-internal use
                     */
                 function initialize(): void;
                 /**
@@ -3836,21 +4522,33 @@ export namespace menus {
         /**
             * @hidden
             * Represents information about item in View Configuration.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
             */
         interface ViewConfiguration {
                 /**
                     * @hidden
                     * Unique identifier of view.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 id: string;
                 /**
                     * @hidden
                     * Display title of the view.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 title: string;
                 /**
                     * @hidden
                     * Additional information for accessibility.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
                     */
                 contentDescription?: string;
         }
@@ -4223,9 +4921,7 @@ export namespace media {
                 notifyEventToApp(mediaEvent: MediaControllerEvent): void;
         }
         /**
-            * @hidden
-            * Hide from docs
-            * --------
+            * @beta
             * Events which are used to communicate between the app and the host client during the media recording flow
             */
         export enum MediaControllerEvent {
@@ -4435,10 +5131,10 @@ export namespace location {
 export namespace meeting {
         /**
             * @hidden
-            * Hide from docs
-            * Data structure to represent a meeting details
+            * Data structure to represent meeting details
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         interface IMeetingDetailsResponse {
                 /**
@@ -4504,10 +5200,10 @@ export namespace meeting {
         }
         /**
             * @hidden
-            * Hide from docs
             * Data structure to represent a conversation object.
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         interface IConversation {
                 /**
@@ -4518,10 +5214,10 @@ export namespace meeting {
         }
         /**
             * @hidden
-            * Hide from docs
             * Data structure to represent an organizer object.
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         interface IOrganizer {
                 /**
@@ -4562,12 +5258,20 @@ export namespace meeting {
                     */
                 isAppSharing: boolean;
         }
+        /**
+            * Property bag for the speakingState changed event
+            *
+            */
         interface ISpeakingState {
                 /**
                     * Indicates whether one or more participants in a meeting are speaking, or
                     * if no participants are speaking
                     */
                 isSpeakingDetected: boolean;
+                /**
+                    * error object in case there is a failure
+                    */
+                error?: SdkError;
         }
         /**
             * Property bag for the meeting reaction received event
@@ -4653,8 +5357,6 @@ export namespace meeting {
         function toggleIncomingClientAudio(callback: (error: SdkError | null, result: boolean | null) => void): void;
         /**
             * @hidden
-            * Hide from docs
-            *
             * Allows an app to get the meeting details for the meeting
             *
             * @param callback - Callback contains 2 parameters, error and meetingDetailsResponse.
@@ -4662,6 +5364,7 @@ export namespace meeting {
             * result can either contain a IMeetingDetailsResponse value, in case of a successful get or null when the get fails
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function getMeetingDetails(callback: (error: SdkError | null, meetingDetails: IMeetingDetailsResponse | null) => void): void;
         /**
@@ -4673,6 +5376,7 @@ export namespace meeting {
             * authenticationTokenOfAnonymousUser can either contain a string value, incase of a successful get or null when the get fails
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function getAuthenticationTokenForAnonymousUser(callback: (error: SdkError | null, authenticationTokenOfAnonymousUser: string | null) => void): void;
         /**
@@ -4750,9 +5454,9 @@ export namespace meeting {
             */
         function getAppContentStageSharingState(callback: (error: SdkError | null, appContentStageSharingState: IAppContentStageSharingState | null) => void): void;
         /**
-            * Registers a handler for changes to paticipant speaking states. If any participant is speaking, isSpeakingDetected
-            * will be true. If no participants are speaking, isSpeakingDetected will be false. Only one handler can be registered
-            * at a time. A subsequent registration replaces an existing registration.
+            * Registers a handler for changes to paticipant speaking states. This API returns {@link ISpeakingState}, which will have isSpeakingDetected
+            * and/or an error object. If any participant is speaking, isSpeakingDetected will be true. If no participants are speaking, isSpeakingDetected
+            * will be false. Default value is false. Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
             *
             * @param handler The handler to invoke when the speaking state of any participant changes (start/stop speaking).
             */
@@ -4782,10 +5486,10 @@ export namespace meeting {
 export namespace monetization {
         /**
             * @hidden
-            * Hide from docs
             * Data structure to represent a subscription plan.
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         interface PlanInfo {
                 /**
@@ -4801,7 +5505,6 @@ export namespace monetization {
         }
         /**
             * @hidden
-            * Hide from docs
             * Open dialog to start user's purchase experience
             *
             * @param planInfo optional parameter. It contains info of the subscription plan pushed to users.
@@ -4809,6 +5512,7 @@ export namespace monetization {
             * @returns Promise that will be resolved when the operation has completed or rejected with SdkError value
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function openPurchaseExperience(planInfo?: PlanInfo): Promise<void>;
         /**
@@ -4816,7 +5520,6 @@ export namespace monetization {
             * As of 2.0.0, please use {@link monetization.openPurchaseExperience monetization.openPurchaseExperience(planInfo?: PlanInfo): Promise\<void\>} instead.
             *
             * @hidden
-            * Hide from docs
             * Open dialog to start user's purchase experience
             *
             * @param callback Callback contains 1 parameters, error.
@@ -4824,6 +5527,7 @@ export namespace monetization {
             * error can either contain an error of type SdkError, incase of an error, or null when get is successful
             *
             * @internal
+            * Limited to Microsoft-internal use
             */
         function openPurchaseExperience(callback: (error: SdkError | null) => void, planInfo?: PlanInfo): void;
         function isSupported(): boolean;
@@ -5426,11 +6130,10 @@ export function initialize(callback?: () => void, validMessageOrigins?: string[]
     * As of 2.0.0, please use {@link app._initialize app._initialize(hostWindow: any): void} instead.
     *
     * @hidden
-    * Hide from docs.
-    * ------
     * Undocumented function used to set a mock window for unit tests
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export function _initialize(hostWindow: any): void;
 /**
@@ -5438,11 +6141,10 @@ export function _initialize(hostWindow: any): void;
     * As of 2.0.0, please use {@link app._uninitialize app._uninitialize(): void} instead.
     *
     * @hidden
-    * Hide from docs.
-    * ------
     * Undocumented function used to clear state between unit tests
     *
     * @internal
+    * Limited to Microsoft-internal use
     */
 export function _uninitialize(): void;
 /**
@@ -5622,7 +6324,7 @@ export function setFrameContext(frameContext: FrameContext): void;
     * @deprecated
     * As of 2.0.0, please use {@link pages.initializeWithFrameContext pages.initializeWithFrameContext(frameInfo: FrameInfo, callback?: () => void, validMessageOrigins?: string[],): void} instead.
     *
-    * Initilize with FrameContext
+    * Initialize with FrameContext
     *
     * @param frameContext - FrameContext information to be set
     * @param callback - The optional callback to be invoked be invoked after initilizing the frame context
@@ -5820,7 +6522,7 @@ export namespace tasks {
         function getBotUrlDialogInfoFromTaskInfo(taskInfo: TaskInfo): BotUrlDialogInfo;
         /**
             * Sets the height and width of the {@link TaskInfo} object to the original height and width, if initially specified,
-            * otherwise uses the height and width values corresponding to {@link TaskModuleDimension.Small}
+            * otherwise uses the height and width values corresponding to {@link TaskModuleDimension | TaskModuleDimension.Small}
             * @param taskInfo TaskInfo object from which to extract size info, if specified
             * @returns TaskInfo with height and width specified
             */