@microsoft/teamsfx 2.0.0-experimental.0 → 2.0.1-alpha.ba6cc7dba.0

package/types/teamsfx.d.ts

@@ -1,8 +1,7 @@
 /// <reference types="node" />
 
 import { AccessToken } from '@azure/identity';
-import { Activity } from 'botbuilder-core';
-import { Activity as Activity_2 } from 'botbuilder';
+import { Activity } from 'botbuilder';
 import { Attachment } from 'botbuilder';
 import { AuthenticationProvider } from '@microsoft/microsoft-graph-client';
 import { AxiosInstance } from 'axios';
@@ -12,29 +11,54 @@ import { CardAction } from 'botbuilder';
 import { CardImage } from 'botbuilder';
 import { ChannelInfo } from 'botbuilder';
 import { Client } from '@microsoft/microsoft-graph-client';
+import { ComponentDialog } from 'botbuilder-dialogs';
 import { ConnectionConfig } from 'tedious';
 import { ConversationReference } from 'botbuilder';
+import { ConversationState } from 'botbuilder';
 import { Dialog } from 'botbuilder-dialogs';
 import { DialogContext } from 'botbuilder-dialogs';
 import { DialogTurnResult } from 'botbuilder-dialogs';
 import { GetTokenOptions } from '@azure/identity';
 import { HeroCard } from 'botbuilder';
+import { InvokeResponse } from 'botbuilder';
+import { MessagingExtensionResponse } from 'botbuilder';
 import { O365ConnectorCard } from 'botbuilder';
 import { ReceiptCard } from 'botbuilder';
 import { SecureContextOptions } from 'tls';
+import { SigninStateVerificationQuery } from 'botbuilder';
+import { StatePropertyAccessor } from 'botbuilder';
+import { StatusCodes } from 'botbuilder';
+import { Storage as Storage_2 } from 'botbuilder';
+import { TeamDetails } from 'botbuilder';
 import { TeamsChannelAccount } from 'botbuilder';
 import { ThumbnailCard } from 'botbuilder';
 import { TokenCredential } from '@azure/identity';
 import { TokenResponse } from 'botframework-schema';
-import { TurnContext } from 'botbuilder-core';
-import { TurnContext as TurnContext_2 } from 'botbuilder';
+import { TurnContext } from 'botbuilder';
+import { UserState } from 'botbuilder';
 import { WebRequest } from 'botbuilder';
 import { WebResponse } from 'botbuilder';
 
+/**
+ * Options used to control how the response card will be sent to users.
+ */
+export declare enum AdaptiveCardResponse {
+    /**
+     * The response card will be replaced the current one for the interactor who trigger the action.
+     */
+    ReplaceForInteractor = 0,
+    /**
+     * The response card will be replaced the current one for all users in the chat.
+     */
+    ReplaceForAll = 1,
+    /**
+     * The response card will be sent as a new message for all users in the chat.
+     */
+    NewForAll = 2
+}
+
 /**
  * Define available location for API Key location
- *
- * @beta
  */
 export declare enum ApiKeyLocation {
     /**
@@ -49,8 +73,6 @@ export declare enum ApiKeyLocation {
 
 /**
  * Provider that handles API Key authentication
- *
- * @beta
  */
 export declare class ApiKeyProvider implements AuthProvider {
     private keyName;
@@ -64,8 +86,6 @@ export declare class ApiKeyProvider implements AuthProvider {
      *
      * @throws {@link ErrorCode|InvalidParameter} - when key name or key value is empty.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @beta
      */
     constructor(keyName: string, keyValue: string, keyLocation: ApiKeyLocation);
     /**
@@ -78,8 +98,6 @@ export declare class ApiKeyProvider implements AuthProvider {
      *
      * @throws {@link ErrorCode|AuthorizationInfoAlreadyExists} - when API key already exists in request header or url query parameter.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @beta
      */
     AddAuthenticationInfo(config: AxiosRequestConfig): Promise<AxiosRequestConfig>;
 }
@@ -95,8 +113,6 @@ export declare class ApiKeyProvider implements AuthProvider {
  *
  * @remarks
  * Only works in in server side.
- *
- * @beta
  */
 export declare class AppCredential implements TokenCredential {
     private readonly msalClient;
@@ -110,8 +126,6 @@ export declare class AppCredential implements TokenCredential {
      *
      * @throws {@link ErrorCode|InvalidConfiguration} when client id, client secret or tenant id is not found in config.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is nodeJS.
-     *
-     * @beta
      */
     constructor(authConfig: AuthenticationConfiguration);
     /**
@@ -137,8 +151,6 @@ export declare class AppCredential implements TokenCredential {
      *
      * @returns Access token with expected scopes.
      * Throw error if get access token failed.
-     *
-     * @beta
      */
     getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken | null>;
     /**
@@ -153,7 +165,6 @@ export declare class AppCredential implements TokenCredential {
 
 /**
  * Authentication related configuration.
- * @beta
  */
 export declare interface AuthenticationConfiguration {
     /**
@@ -200,8 +211,6 @@ export declare interface AuthenticationConfiguration {
 
 /**
  * Defines method that injects authentication info to http requests
- *
- * @beta
  */
 export declare interface AuthProvider {
     /**
@@ -209,8 +218,6 @@ export declare interface AuthProvider {
      *
      * @param { AxiosRequestConfig } config - Contains all the request information and can be updated to include extra authentication info.
      * Refer https://axios-http.com/docs/req_config for detailed document.
-     *
-     * @beta
      */
     AddAuthenticationInfo: (config: AxiosRequestConfig) => Promise<AxiosRequestConfig>;
 }
@@ -219,8 +226,6 @@ export { AxiosInstance }
 
 /**
  * Provider that handles Basic authentication
- *
- * @beta
  */
 export declare class BasicAuthProvider implements AuthProvider {
     private userName;
@@ -232,8 +237,6 @@ export declare class BasicAuthProvider implements AuthProvider {
      *
      * @throws {@link ErrorCode|InvalidParameter} - when username or password is empty.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @beta
      */
     constructor(userName: string, password: string);
     /**
@@ -246,23 +249,17 @@ export declare class BasicAuthProvider implements AuthProvider {
      *
      * @throws {@link ErrorCode|AuthorizationInfoAlreadyExists} - when Authorization header or auth property already exists in request configuration.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @beta
      */
     AddAuthenticationInfo(config: AxiosRequestConfig): Promise<AxiosRequestConfig>;
 }
 
 /**
  * Provider that handles Bearer Token authentication
- *
- * @beta
  */
 export declare class BearerTokenAuthProvider implements AuthProvider {
     private getToken;
     /**
      * @param { () => Promise<string> } getToken - Function that returns the content of bearer token used in http request
-     *
-     * @beta
      */
     constructor(getToken: () => Promise<string>);
     /**
@@ -274,16 +271,217 @@ export declare class BearerTokenAuthProvider implements AuthProvider {
      * @returns Updated axios request config.
      *
      * @throws {@link ErrorCode|AuthorizationInfoAlreadyExists} - when Authorization header already exists in request configuration.
-     *
-     * @beta
      */
     AddAuthenticationInfo(config: AxiosRequestConfig): Promise<AxiosRequestConfig>;
 }
 
 /**
- * Provider that handles Certificate authentication
+ * Interface for SSO configuration for Bot SSO
+ */
+export declare interface BotSsoConfig {
+    /**
+     * aad related configurations
+     */
+    aad: {
+        /**
+         * The list of scopes for which the token will have access
+         */
+        scopes: string[];
+    } & AuthenticationConfiguration;
+    dialog?: {
+        /**
+         * Custom sso execution activity handler class which should implement the interface {@link BotSsoExecutionActivityHandler}. If not provided, it will use {@link DefaultBotSsoExecutionActivityHandler} by default
+         */
+        CustomBotSsoExecutionActivityHandler?: new (ssoConfig: BotSsoConfig) => BotSsoExecutionActivityHandler;
+        /**
+         * Conversation state for sso command bot, if not provided, it will use internal memory storage to create a new one.
+         */
+        conversationState?: ConversationState;
+        /**
+         * User state for sso command bot, if not provided, it will use internal memory storage to create a new one.
+         */
+        userState?: UserState;
+        /**
+         * Used by {@link BotSsoExecutionDialog} to remove duplicated messages, if not provided, it will use internal memory storage
+         */
+        dedupStorage?: Storage_2;
+        /**
+         * Settings used to configure an teams sso prompt dialog.
+         */
+        ssoPromptConfig?: {
+            /**
+             * Number of milliseconds the prompt will wait for the user to authenticate.
+             * Defaults to a value `900,000` (15 minutes.)
+             */
+            timeout?: number;
+            /**
+             * Value indicating whether the TeamsBotSsoPrompt should end upon receiving an
+             * invalid message.  Generally the TeamsBotSsoPrompt will end the auth flow when receives user
+             * message not related to the auth flow. Setting the flag to false ignores the user's message instead.
+             * Defaults to value `true`
+             */
+            endOnInvalidMessage?: boolean;
+        };
+    };
+}
+
+/**
+ * Interface for user to customize SSO execution activity handler
+ *
+ * @remarks
+ * Bot SSO execution activity handler is to handle SSO login process and trigger SSO command using {@link BotSsoExecutionDialog}.
+ * You can use this interface to implement your own SSO execution dialog, and pass it to ConversationBot options:
  *
- * @beta
+ * ```typescript
+ * export const commandBot = new ConversationBot({
+ *   ...
+ *   ssoConfig: {
+ *     ...
+ *     dialog: {
+ *       CustomBotSsoExecutionActivityHandler: YourCustomBotSsoExecutionActivityHandler,
+ *     }
+ *   },
+ *    ...
+ * });
+ * ```
+ * For details information about how to implement a BotSsoExecutionActivityHandler, please refer DefaultBotSsoExecutionActivityHandler class source code: https://aka.ms/teamsfx-default-sso-execution-activity-handler
+ */
+export declare interface BotSsoExecutionActivityHandler {
+    /**
+     * Add {@link TeamsFxBotSsoCommandHandler} instance to {@link BotSsoExecutionDialog}
+     * @param handler {@link BotSsoExecutionDialogHandler} callback function
+     * @param triggerPatterns The trigger pattern
+     *
+     * @remarks
+     * This function is used to add SSO command to {@link BotSsoExecutionDialog} instance.
+     */
+    addCommand(handler: BotSsoExecutionDialogHandler, triggerPatterns: TriggerPatterns): void;
+    /**
+     * Called to initiate the event emission process.
+     * @param context The context object for the current turn.
+     */
+    run(context: TurnContext): Promise<void>;
+    /**
+     * Receives invoke activities with Activity name of 'signin/verifyState'.
+     * @param context A context object for this turn.
+     * @param query Signin state (part of signin action auth flow) verification invoke query.
+     * @returns A promise that represents the work queued.
+     *
+     * @remarks
+     * It should trigger {@link BotSsoExecutionDialog} instance to handle signin process
+     */
+    handleTeamsSigninVerifyState(context: TurnContext, query: SigninStateVerificationQuery): Promise<void>;
+    /**
+     * Receives invoke activities with Activity name of 'signin/tokenExchange'
+     * @param context A context object for this turn.
+     * @param query Signin state (part of signin action auth flow) verification invoke query
+     * @returns A promise that represents the work queued.
+     *
+     * @remark
+     * It should trigger {@link BotSsoExecutionDialog} instance to handle signin process
+     */
+    handleTeamsSigninTokenExchange(context: TurnContext, query: SigninStateVerificationQuery): Promise<void>;
+}
+
+/**
+ * Sso execution dialog, use to handle sso command
+ */
+export declare class BotSsoExecutionDialog extends ComponentDialog {
+    private dedupStorage;
+    private dedupStorageKeys;
+    private commandMapping;
+    /**
+     * Creates a new instance of the BotSsoExecutionDialog.
+     * @param dedupStorage Helper storage to remove duplicated messages
+     * @param settings The list of scopes for which the token will have access
+     * @param teamsfx {@link TeamsFx} instance for authentication
+     */
+    constructor(dedupStorage: Storage_2, ssoPromptSettings: TeamsBotSsoPromptSettings, teamsfx: TeamsFx, dialogName?: string);
+    /**
+     * Add TeamsFxBotSsoCommandHandler instance
+     * @param handler {@link BotSsoExecutionDialogHandler} callback function
+     * @param triggerPatterns The trigger pattern
+     */
+    addCommand(handler: BotSsoExecutionDialogHandler, triggerPatterns: TriggerPatterns): void;
+    private getCommandHash;
+    /**
+     * The run method handles the incoming activity (in the form of a DialogContext) and passes it through the dialog system.
+     *
+     * @param context The context object for the current turn.
+     * @param accessor The instance of StatePropertyAccessor for dialog system.
+     */
+    run(context: TurnContext, accessor: StatePropertyAccessor): Promise<void>;
+    private getActivityText;
+    private commandRouteStep;
+    private ssoStep;
+    private dedupStep;
+    /**
+     * Called when the component is ending.
+     *
+     * @param context Context for the current turn of conversation.
+     */
+    protected onEndDialog(context: TurnContext): Promise<void>;
+    /**
+     * If a user is signed into multiple Teams clients, the Bot might receive a "signin/tokenExchange" from each client.
+     * Each token exchange request for a specific user login will have an identical activity.value.Id.
+     * Only one of these token exchange requests should be processed by the bot. For a distributed bot in production,
+     * this requires a distributed storage to ensure only one token exchange is processed.
+     * @param context Context for the current turn of conversation.
+     * @returns boolean value indicate whether the message should be removed
+     */
+    private shouldDedup;
+    private getStorageKey;
+    private matchPattern;
+    private isPatternMatched;
+    private getMatchesCommandId;
+    /**
+     * Ensure bot is running in MS Teams since TeamsBotSsoPrompt is only supported in MS Teams channel.
+     * @param dc dialog context
+     * @throws {@link ErrorCode|ChannelNotSupported} if bot channel is not MS Teams
+     * @internal
+     */
+    private ensureMsTeamsChannel;
+}
+
+export declare type BotSsoExecutionDialogHandler = (context: TurnContext, tokenResponse: TeamsBotSsoPromptTokenResponse, message: CommandMessage) => Promise<void>;
+
+/**
+ * A card action bot to respond to adaptive card universal actions.
+ */
+export declare class CardActionBot {
+    private readonly adapter;
+    private middleware;
+    /**
+     * Creates a new instance of the `CardActionBot`.
+     *
+     * @param adapter The bound `BotFrameworkAdapter`.
+     * @param options - initialize options
+     */
+    constructor(adapter: BotFrameworkAdapter, options?: CardActionOptions);
+    /**
+     * Registers a card action handler to the bot.
+     * @param actionHandler A card action handler to be registered.
+     */
+    registerHandler(actionHandler: TeamsFxAdaptiveCardActionHandler): void;
+    /**
+     * Registers card action handlers to the bot.
+     * @param actionHandlers A set of card action handlers to be registered.
+     */
+    registerHandlers(actionHandlers: TeamsFxAdaptiveCardActionHandler[]): void;
+}
+
+/**
+ * Options to initialize {@link CardActionBot}.
+ */
+export declare interface CardActionOptions {
+    /**
+     * The action handlers to registered with the action bot. Each command should implement the interface {@link TeamsFxAdaptiveCardActionHandler} so that it can be correctly handled by this bot.
+     */
+    actions?: TeamsFxAdaptiveCardActionHandler[];
+}
+
+/**
+ * Provider that handles Certificate authentication
  */
 export declare class CertificateAuthProvider implements AuthProvider {
     private certOption;
@@ -292,8 +490,6 @@ export declare class CertificateAuthProvider implements AuthProvider {
      * @param { SecureContextOptions } certOption - information about the cert used in http requests
      *
      * @throws {@link ErrorCode|InvalidParameter} - when cert option is empty.
-     *
-     * @beta
      */
     constructor(certOption: SecureContextOptions);
     /**
@@ -305,8 +501,6 @@ export declare class CertificateAuthProvider implements AuthProvider {
      * @returns Updated axios request config.
      *
      * @throws {@link ErrorCode|InvalidParameter} - when custom httpsAgent in the request has duplicate properties with certOption provided in constructor.
-     *
-     * @beta
      */
     AddAuthenticationInfo(config: AxiosRequestConfig): Promise<AxiosRequestConfig>;
 }
@@ -316,26 +510,18 @@ export declare class CertificateAuthProvider implements AuthProvider {
  *
  * @remarks
  * It's recommended to get channels from {@link TeamsBotInstallation.channels()}.
- *
- * @beta
  */
 export declare class Channel implements NotificationTarget {
     /**
      * The parent {@link TeamsBotInstallation} where this channel is created from.
-     *
-     * @beta
      */
     readonly parent: TeamsBotInstallation;
     /**
      * Detailed channel information.
-     *
-     * @beta
      */
     readonly info: ChannelInfo;
     /**
      * Notification target type. For channel it's always "Channel".
-     *
-     * @beta
      */
     readonly type: NotificationTargetType;
     /**
@@ -346,28 +532,26 @@ export declare class Channel implements NotificationTarget {
      *
      * @param parent - The parent {@link TeamsBotInstallation} where this channel is created from.
      * @param info - Detailed channel information.
-     *
-     * @beta
      */
     constructor(parent: TeamsBotInstallation, info: ChannelInfo);
     /**
      * Send a plain text message.
      *
      * @param text - the plain text message.
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
+     * @param onError - an optional error handler that can catch exceptions during message sending.
+     * If not defined, error will be handled by `BotAdapter.onTurnError`.
+     * @returns the response of sending message.
      */
-    sendMessage(text: string): Promise<void>;
+    sendMessage(text: string, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
     /**
      * Send an adaptive card message.
      *
      * @param card - the adaptive card raw JSON.
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
+     * @param onError - an optional error handler that can catch exceptions during adaptive card sending.
+     * If not defined, error will be handled by `BotAdapter.onTurnError`.
+     * @returns the response of sending adaptive card message.
      */
-    sendAdaptiveCard(card: unknown): Promise<void>;
+    sendAdaptiveCard(card: unknown, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
     /**
      * @internal
      */
@@ -379,37 +563,43 @@ export declare class Channel implements NotificationTarget {
  *
  * @remarks
  * Ensure each command should ONLY be registered with the command once, otherwise it'll cause unexpected behavior if you register the same command more than once.
- *
- * @beta
  */
 export declare class CommandBot {
     private readonly adapter;
     private readonly middleware;
+    private readonly ssoConfig;
     /**
      * Creates a new instance of the `CommandBot`.
      *
      * @param adapter The bound `BotFrameworkAdapter`.
      * @param options - initialize options
-     *
-     * @beta
      */
-    constructor(adapter: BotFrameworkAdapter, options?: CommandOptions);
+    constructor(adapter: BotFrameworkAdapter, options?: CommandOptions, ssoCommandActivityHandler?: BotSsoExecutionActivityHandler, ssoConfig?: BotSsoConfig);
     /**
      * Registers a command into the command bot.
      *
-     * @param command The command to registered.
-     *
-     * @beta
+     * @param command The command to register.
      */
     registerCommand(command: TeamsFxBotCommandHandler): void;
     /**
      * Registers commands into the command bot.
      *
-     * @param commands The command to registered.
-     *
-     * @beta
+     * @param commands The commands to register.
      */
     registerCommands(commands: TeamsFxBotCommandHandler[]): void;
+    /**
+     * Registers a sso command into the command bot.
+     *
+     * @param command The command to register.
+     */
+    registerSsoCommand(ssoCommand: TeamsFxBotSsoCommandHandler): void;
+    /**
+     * Registers commands into the command bot.
+     *
+     * @param commands The commands to register.
+     */
+    registerSsoCommands(ssoCommands: TeamsFxBotSsoCommandHandler[]): void;
+    private validateSsoActivityHandler;
 }
 
 /**
@@ -428,16 +618,16 @@ export declare interface CommandMessage {
 
 /**
  * Options to initialize {@link CommandBot}.
- *
- * @beta
  */
 export declare interface CommandOptions {
     /**
      * The commands to registered with the command bot. Each command should implement the interface {@link TeamsFxBotCommandHandler} so that it can be correctly handled by this command bot.
-     *
-     * @beta
      */
     commands?: TeamsFxBotCommandHandler[];
+    /**
+     * The commands to registered with the sso command bot. Each sso command should implement the interface {@link TeamsFxBotSsoCommandHandler} so that it can be correctly handled by this command bot.
+     */
+    ssoCommands?: TeamsFxBotSsoCommandHandler[];
 }
 
 /**
@@ -490,28 +680,24 @@ export declare interface CommandOptions {
  * For command and response, ensure each command should ONLY be registered with the command once, otherwise it'll cause unexpected behavior if you register the same command more than once.
  *
  * For notification, set `notification.storage` in {@link ConversationOptions} to use your own storage implementation.
- *
- * @beta
  */
 export declare class ConversationBot {
     /**
      * The bot adapter.
-     *
-     * @beta
      */
     readonly adapter: BotFrameworkAdapter;
     /**
      * The entrypoint of command and response.
-     *
-     * @beta
      */
     readonly command?: CommandBot;
     /**
      * The entrypoint of notification.
-     *
-     * @beta
      */
     readonly notification?: NotificationBot;
+    /**
+     * The action handler used for adaptive card universal actions.
+     */
+    readonly cardAction?: CardActionBot;
     /**
      * Creates new instance of the `ConversationBot`.
      *
@@ -519,8 +705,6 @@ export declare class ConversationBot {
      * It's recommended to create your own adapter and storage for production environment instead of the default one.
      *
      * @param options - initialize options
-     *
-     * @beta
      */
     constructor(options: ConversationOptions);
     private createDefaultAdapter;
@@ -544,16 +728,12 @@ export declare class ConversationBot {
      *   });
      * });
      * ```
-     *
-     * @beta
      */
-    requestHandler(req: WebRequest, res: WebResponse, logic?: (context: TurnContext_2) => Promise<any>): Promise<void>;
+    requestHandler(req: WebRequest, res: WebResponse, logic?: (context: TurnContext) => Promise<any>): Promise<void>;
 }
 
 /**
  * Options to initialize {@link ConversationBot}
- *
- * @beta
  */
 export declare interface ConversationOptions {
     /**
@@ -563,8 +743,6 @@ export declare interface ConversationOptions {
      *
      * @remarks
      * If neither `adapter` nor `adapterConfig` is provided, will use BOT_ID and BOT_PASSWORD from environment variables.
-     *
-     * @beta
      */
     adapter?: BotFrameworkAdapter;
     /**
@@ -572,35 +750,38 @@ export declare interface ConversationOptions {
      *
      * @remarks
      * If neither `adapter` nor `adapterConfig` is provided, will use BOT_ID and BOT_PASSWORD from environment variables.
-     *
-     * @beta
      */
     adapterConfig?: {
         [key: string]: unknown;
     };
+    /**
+     * Configurations for sso command bot
+     */
+    ssoConfig?: BotSsoConfig;
     /**
      * The command part.
-     *
-     * @beta
      */
     command?: CommandOptions & {
         /**
          * Whether to enable command or not.
-         *
-         * @beta
          */
         enabled?: boolean;
     };
     /**
      * The notification part.
-     *
-     * @beta
      */
     notification?: NotificationOptions_2 & {
         /**
          * Whether to enable notification or not.
-         *
-         * @beta
+         */
+        enabled?: boolean;
+    };
+    /**
+     * The adaptive card action handler part.
+     */
+    cardAction?: CardActionOptions & {
+        /**
+         * Whether to enable adaptive card actions or not.
          */
         enabled?: boolean;
     };
@@ -617,8 +798,6 @@ export declare interface ConversationOptions {
  * ```typescript
  * const client = createApiClient("https://my-api-endpoint-base-url", new BasicAuthProvider("xxx","xxx"));
  * ```
- *
- * @beta
  */
 export declare function createApiClient(apiEndpoint: string, authProvider: AuthProvider): AxiosInstance;
 
@@ -670,8 +849,6 @@ export declare function createApiClient(apiEndpoint: string, authProvider: AuthP
  * @throws {@link ErrorCode|InvalidParameter} when scopes is not a valid string or string array.
  *
  * @returns Graph client with specified scopes.
- *
- * @beta
  */
 export declare function createMicrosoftGraphClient(teamsfx: TeamsFxConfiguration, scopes?: string | string[]): Client;
 
@@ -709,7 +886,6 @@ export declare function createPfxCertOption(pfx: string | Buffer, options?: {
 
 /**
  * Error code to trace the error types.
- * @beta
  */
 export declare enum ErrorCode {
     /**
@@ -732,6 +908,30 @@ export declare enum ErrorCode {
      * Channel is not supported error.
      */
     ChannelNotSupported = "ChannelNotSupported",
+    /**
+     * Failed to retrieve sso token
+     */
+    FailedToRetrieveSsoToken = "FailedToRetrieveSsoToken",
+    /**
+     * Failed to process sso handler
+     */
+    FailedToProcessSsoHandler = "FailedToProcessSsoHandler",
+    /**
+     * Cannot find command
+     */
+    CannotFindCommand = "CannotFindCommand",
+    /**
+     * Failed to run sso step
+     */
+    FailedToRunSsoStep = "FailedToRunSsoStep",
+    /**
+     * Failed to run dedup step
+     */
+    FailedToRunDedupStep = "FailedToRunDedupStep",
+    /**
+     * Sso activity handler is undefined
+     */
+    SsoActivityHandlerIsUndefined = "SsoActivityHandlerIsUndefined",
     /**
      * Runtime is not supported error.
      */
@@ -772,8 +972,6 @@ export declare enum ErrorCode {
 
 /**
  * Error class with code and message thrown by the SDK.
- *
- * @beta
  */
 export declare class ErrorWithCode extends Error {
     /**
@@ -787,8 +985,6 @@ export declare class ErrorWithCode extends Error {
      *
      * @param {string} message - error message.
      * @param {ErrorCode} code - error code.
-     *
-     * @beta
      */
     constructor(message?: string, code?: ErrorCode);
 }
@@ -797,11 +993,13 @@ export declare class ErrorWithCode extends Error {
  * Get log level.
  *
  * @returns Log level
- *
- * @beta
  */
 export declare function getLogLevel(): LogLevel | undefined;
 
+export declare interface GetTeamsUserTokenOptions extends GetTokenOptions {
+    resources?: string[];
+}
+
 /**
  * Generate connection configuration consumed by tedious.
  *
@@ -813,15 +1011,30 @@ export declare function getLogLevel(): LogLevel | undefined;
  * @throws {@link ErrorCode|InvalidConfiguration} when SQL config resource configuration is invalid.
  * @throws {@link ErrorCode|InternalError} when get user MSI token failed or MSI token is invalid.
  * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
- *
- * @beta
  */
 export declare function getTediousConnectionConfig(teamsfx: TeamsFx, databaseName?: string): Promise<ConnectionConfig>;
 
 /**
- * Identity type to use in authentication.
+ * Users execute query in message extension with SSO or access token.
  *
- * @beta
+ * @param {TurnContext} context - The context object for the current turn.
+ * @param {AuthenticationConfiguration} config - User custom the message extension authentication configuration.
+ * @param {string| string[]} scopes - The list of scopes for which the token will have access.
+ * @param {function} logic - Business logic when executing the query in message extension with SSO or access token.
+ *
+ * @throws {@link ErrorCode|InternalError} when User invoke not response to message extension query.
+ * @throws {@link ErrorCode|InternalError} when failed to get access token with unknown error.
+ * @throws {@link ErrorCode|TokenExpiredError} when SSO token has already expired.
+ * @throws {@link ErrorCode|ServiceError} when failed to get access token from simple auth server.
+ * @throws {@link ErrorCode|InvalidParameter} when scopes is not a valid string or string array.
+ * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is nodeJS.
+ *
+ * @returns A MessageExtension Response for the activity. If the logic not return any, return void instead.
+ */
+export declare function handleMessageExtensionQueryWithToken(context: TurnContext, config: AuthenticationConfiguration | null, scopes: string | string[], logic: (token: MessageExtensionTokenResponse) => Promise<any>): Promise<MessagingExtensionResponse | void>;
+
+/**
+ * Identity type to use in authentication.
  */
 export declare enum IdentityType {
     /**
@@ -835,15 +1048,102 @@ export declare enum IdentityType {
 }
 
 /**
- * Log function for customized logging.
+ * Status code for an `application/vnd.microsoft.error` invoke response.
+ */
+export declare enum InvokeResponseErrorCode {
+    /**
+     * Invalid request.
+     */
+    BadRequest = 400,
+    /**
+     * Internal server error.
+     */
+    InternalServerError = 500
+}
+
+/**
+ * Provides methods for formatting various invoke responses a bot can send to respond to an invoke request.
+ *
+ * @remarks
+ * All of these functions return an {@link InvokeResponse} object, which can be
+ * passed as input to generate a new `invokeResponse` activity.
+ *
+ * This example sends an invoke response that contains an adaptive card.
+ *
+ * ```typescript
  *
- * @beta
+ * const myCard = {
+ *    type: "AdaptiveCard",
+ *    body: [
+ *     {
+ *       "type": "TextBlock",
+ *       "text": "This is a sample card"
+ *     }],
+ *     $schema: "http://adaptivecards.io/schemas/adaptive-card.json",
+ *     version: "1.4"
+ *  };
+ *
+ * const invokeResponse = InvokeResponseFactory.adaptiveCard(myCard);
+ * await context.sendActivity({
+ *    type: ActivityTypes.InvokeResponse,
+ *    value: invokeResponse,
+ *  });
+ * ```
+ */
+export declare class InvokeResponseFactory {
+    /**
+     * Create an invoke response from a text message.
+     * The type of the invoke response is `application/vnd.microsoft.activity.message`
+     * indicates the request was successfully processed.
+     *
+     * @param message A text message included in a invoke response.
+     *
+     * @returns {InvokeResponse} An InvokeResponse object.
+     */
+    static textMessage(message: string): InvokeResponse;
+    /**
+     * Create an invoke response from an adaptive card.
+     *
+     * The type of the invoke response is `application/vnd.microsoft.card.adaptive` indicates
+     * the request was successfully processed, and the response includes an adaptive card
+     * that the client should display in place of the current one.
+     *
+     * @param card The adaptive card JSON payload.
+     *
+     * @returns {InvokeResponse} An InvokeResponse object.
+     */
+    static adaptiveCard(card: unknown): InvokeResponse;
+    /**
+     * Create an invoke response with error code and message.
+     *
+     * The type of the invoke response is `application/vnd.microsoft.error` indicates
+     * the request was failed to processed.
+     *
+     * @param errorCode The status code indicates error, available values:
+     *  - 400 (BadRequest): indicate the incoming request was invalid.
+     *  - 500 (InternalServerError): indicate an unexpected error occurred.
+     * @param errorMessage The error message.
+     *
+     * @returns {InvokeResponse} An InvokeResponse object.
+     */
+    static errorResponse(errorCode: InvokeResponseErrorCode, errorMessage: string): InvokeResponse;
+    /**
+     * Create an invoke response with status code and response value.
+     * @param statusCode The status code.
+     * @param body The value of the response body.
+     *
+     * @returns {InvokeResponse} An InvokeResponse object.
+     */
+    static createInvokeResponse(statusCode: StatusCodes, body?: unknown): InvokeResponse;
+}
+
+/**
+ * Log function for customized logging.
  */
 export declare type LogFunction = (level: LogLevel, message: string) => void;
 
 /**
  * Interface for customized logger.
- * @beta
  */
 export declare interface Logger {
     /**
@@ -866,8 +1166,6 @@ export declare interface Logger {
 
 /**
  * Log level.
- *
- * @beta
  */
 export declare enum LogLevel {
     /**
@@ -893,26 +1191,18 @@ export declare enum LogLevel {
  *
  * @remarks
  * It's recommended to get members from {@link TeamsBotInstallation.members()}.
- *
- * @beta
  */
 export declare class Member implements NotificationTarget {
     /**
      * The parent {@link TeamsBotInstallation} where this member is created from.
-     *
-     * @beta
      */
     readonly parent: TeamsBotInstallation;
     /**
      * Detailed member account information.
-     *
-     * @beta
      */
     readonly account: TeamsChannelAccount;
     /**
      * Notification target type. For member it's always "Person".
-     *
-     * @beta
      */
     readonly type: NotificationTargetType;
     /**
@@ -923,28 +1213,26 @@ export declare class Member implements NotificationTarget {
      *
      * @param parent - The parent {@link TeamsBotInstallation} where this member is created from.
      * @param account - Detailed member account information.
-     *
-     * @beta
      */
     constructor(parent: TeamsBotInstallation, account: TeamsChannelAccount);
     /**
      * Send a plain text message.
      *
      * @param text - the plain text message.
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
+     * @param onError - an optional error handler that can catch exceptions during message sending.
+     * If not defined, error will be handled by `BotAdapter.onTurnError`.
+     * @returns the response of sending message.
      */
-    sendMessage(text: string): Promise<void>;
+    sendMessage(text: string, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
     /**
      * Send an adaptive card message.
      *
      * @param card - the adaptive card raw JSON.
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
+     * @param onError - an optional error handler that can catch exceptions during adaptive card sending.
+     * If not defined, error will be handled by `BotAdapter.onTurnError`.
+     * @returns the response of sending adaptive card message.
      */
-    sendAdaptiveCard(card: unknown): Promise<void>;
+    sendAdaptiveCard(card: unknown, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
     /**
      * @internal
      */
@@ -990,19 +1278,15 @@ export declare class MessageBuilder {
      *   description: "sample card description"
      * });
      * ```
-     *
-     * @beta
      */
-    static attachAdaptiveCard<TData extends object>(cardTemplate: unknown, data: TData): Partial<Activity_2>;
+    static attachAdaptiveCard<TData extends object>(cardTemplate: unknown, data: TData): Partial<Activity>;
     /**
      * Build a bot message activity attached with an adaptive card.
      *
      * @param card The adaptive card content.
      * @returns A bot message activity attached with an adaptive card.
-     *
-     * @beta
      */
-    static attachAdaptiveCardWithoutData(card: unknown): Partial<Activity_2>;
+    static attachAdaptiveCardWithoutData(card: unknown): Partial<Activity>;
     /**
      * Build a bot message activity attached with an hero card.
      *
@@ -1022,10 +1306,8 @@ export declare class MessageBuilder {
      *      ['action']
      * );
      * ```
-     *
-     * @beta
      */
-    static attachHeroCard(title: string, images?: (CardImage | string)[], buttons?: (CardAction | string)[], other?: Partial<HeroCard>): Partial<Activity_2>;
+    static attachHeroCard(title: string, images?: (CardImage | string)[], buttons?: (CardAction | string)[], other?: Partial<HeroCard>): Partial<Activity>;
     /**
      * Returns an attachment for a sign-in card.
      *
@@ -1037,27 +1319,21 @@ export declare class MessageBuilder {
      *
      * @remarks
      * For channels that don't natively support sign-in cards, an alternative message is rendered.
-     *
-     * @beta
      */
-    static attachSigninCard(title: string, url: string, text?: string): Partial<Activity_2>;
+    static attachSigninCard(title: string, url: string, text?: string): Partial<Activity>;
     /**
      * Build a bot message activity attached with an Office 365 connector card.
      *
      * @param card A description of the Office 365 connector card.
      * @returns A bot message activity attached with an Office 365 connector card.
-     *
-     * @beta
      */
-    static attachO365ConnectorCard(card: O365ConnectorCard): Partial<Activity_2>;
+    static attachO365ConnectorCard(card: O365ConnectorCard): Partial<Activity>;
     /**
      * Build a message activity attached with a receipt card.
      * @param card A description of the receipt card.
      * @returns A message activity attached with a receipt card.
-     *
-     * @beta
      */
-    static AttachReceiptCard(card: ReceiptCard): Partial<Activity_2>;
+    static AttachReceiptCard(card: ReceiptCard): Partial<Activity>;
     /**
      *
      * @param title The card title.
@@ -1066,24 +1342,42 @@ export declare class MessageBuilder {
      *      is converted to an `imBack` button with a title and value set to the value of the string.
      * @param other Optional. Any additional properties to include on the card.
      * @returns A message activity attached with a thumbnail card
-     *
-     * @beta
      */
-    static attachThumbnailCard(title: string, images?: (CardImage | string)[], buttons?: (CardAction | string)[], other?: Partial<ThumbnailCard>): Partial<Activity_2>;
+    static attachThumbnailCard(title: string, images?: (CardImage | string)[], buttons?: (CardAction | string)[], other?: Partial<ThumbnailCard>): Partial<Activity>;
     /**
      * Add an attachement to a bot activity.
      * @param attachement The attachment object to attach.
      * @returns A message activity with an attachment.
-     *
-     * @beta
      */
-    static attachContent(attachement: Attachment): Partial<Activity_2>;
+    static attachContent(attachement: Attachment): Partial<Activity>;
+}
+
+/**
+ * Token response provided by Teams Bot SSO prompt
+ */
+export declare interface MessageExtensionTokenResponse extends TokenResponse {
+    /**
+     * SSO token for user
+     */
+    ssoToken: string;
+    /**
+     * Expire time of SSO token
+     */
+    ssoTokenExpiration: string;
+}
+
+/**
+ * The response of a message action, e.g., `sendMessage`, `sendAdaptiveCard`.
+ */
+declare interface MessageResponse {
+    /**
+     * Id of the message.
+     */
+    id?: string;
 }
 
 /**
  * Microsoft Graph auth provider for Teams Framework
- *
- * @beta
  */
 export declare class MsGraphAuthProvider implements AuthenticationProvider {
     private teamsfx;
@@ -1097,8 +1391,6 @@ export declare class MsGraphAuthProvider implements AuthenticationProvider {
      * @throws {@link ErrorCode|InvalidParameter} when scopes is not a valid string or string array.
      *
      * @returns An instance of MsGraphAuthProvider.
-     *
-     * @beta
      */
     constructor(teamsfx: TeamsFxConfiguration, scopes?: string | string[]);
     /**
@@ -1118,8 +1410,6 @@ export declare class MsGraphAuthProvider implements AuthenticationProvider {
 
 /**
  * Provide utilities to send notification to varies targets (e.g., member, group, channel).
- *
- * @beta
  */
 export declare class NotificationBot {
     private readonly conversationReferenceStore;
@@ -1132,8 +1422,6 @@ export declare class NotificationBot {
      *
      * @param adapter - the bound `BotFrameworkAdapter`
      * @param options - initialize options
-     *
-     * @beta
      */
     constructor(adapter: BotFrameworkAdapter, options?: NotificationOptions_2);
     /**
@@ -1143,16 +1431,49 @@ export declare class NotificationBot {
      * The result is retrieving from the persisted storage.
      *
      * @returns - an array of {@link TeamsBotInstallation}.
-     *
-     * @beta
      */
     installations(): Promise<TeamsBotInstallation[]>;
+    /**
+     * Returns the first {@link Member} where predicate is true, and undefined otherwise.
+     *
+     * @param predicate find calls predicate once for each member of the installation,
+     * until it finds one where predicate returns true. If such a member is found, find
+     * immediately returns that member. Otherwise, find returns undefined.
+     * @param scope the scope to find members from the installations
+     * (personal chat, group chat, Teams channel).
+     * @returns the first {@link Member} where predicate is true, and undefined otherwise.
+     */
+    findMember(predicate: (member: Member) => Promise<boolean>, scope?: SearchScope): Promise<Member | undefined>;
+    /**
+     * Returns the first {@link Channel} where predicate is true, and undefined otherwise.
+     *
+     * @param predicate find calls predicate once for each channel of the installation,
+     * until it finds one where predicate returns true. If such a channel is found, find
+     * immediately returns that channel. Otherwise, find returns undefined.
+     * @returns the first {@link Channel} where predicate is true, and undefined otherwise.
+     */
+    findChannel(predicate: (channel: Channel, teamDetails: TeamDetails | undefined) => Promise<boolean>): Promise<Channel | undefined>;
+    /**
+     * Returns all {@link Member} where predicate is true, and empty array otherwise.
+     *
+     * @param predicate find calls predicate for each member of the installation.
+     * @param scope the scope to find members from the installations
+     * (personal chat, group chat, Teams channel).
+     * @returns an array of {@link Member} where predicate is true, and empty array otherwise.
+     */
+    findAllMembers(predicate: (member: Member) => Promise<boolean>, scope?: SearchScope): Promise<Member[]>;
+    /**
+     * Returns all {@link Channel} where predicate is true, and empty array otherwise.
+     *
+     * @param predicate find calls predicate for each channel of the installation.
+     * @returns an array of {@link Channel} where predicate is true, and empty array otherwise.
+     */
+    findAllChannels(predicate: (channel: Channel, teamDetails: TeamDetails | undefined) => Promise<boolean>): Promise<Channel[]>;
+    private matchSearchScope;
 }
 
 /**
  * Options to initialize {@link NotificationBot}.
- *
- * @beta
  */
 declare interface NotificationOptions_2 {
     /**
@@ -1165,8 +1486,6 @@ declare interface NotificationOptions_2 {
      *   - "${process.env.TEMP}/.notification.localstore.json" if `process.env.RUNNING_ON_AZURE` is set to "1"
      *
      * It's recommended to use your own shared storage for production environment.
-     *
-     * @beta
      */
     storage?: NotificationTargetStorage;
 }
@@ -1174,38 +1493,36 @@ export { NotificationOptions_2 as NotificationOptions }
 
 /**
  * Represent a notification target.
- *
- * @beta
  */
 export declare interface NotificationTarget {
     /**
      * The type of target, could be "Channel" or "Group" or "Person".
-     *
-     * @beta
      */
     readonly type?: NotificationTargetType;
     /**
      * Send a plain text message.
      *
      * @param text - the plain text message.
+     * @param onError - an optional error handler that can catch exceptions during message sending.
+     * If not defined, error will be handled by `BotAdapter.onTurnError`.
      *
-     * @beta
+     * @returns the response of sending message.
      */
-    sendMessage(text: string): Promise<void>;
+    sendMessage(text: string, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
     /**
      * Send an adaptive card message.
      *
      * @param card - the adaptive card raw JSON.
+     * @param onError - an optional error handler that can catch exceptions during adaptive card sending.
+     * If not defined, error will be handled by `BotAdapter.onTurnError`.
      *
-     * @beta
+     * @returns the response of sending adaptive card message.
      */
-    sendAdaptiveCard(card: unknown): Promise<void>;
+    sendAdaptiveCard(card: unknown, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
 }
 
 /**
  * Interface for a storage provider that stores and retrieves notification target references.
- *
- * @beta
  */
 export declare interface NotificationTargetStorage {
     /**
@@ -1214,8 +1531,6 @@ export declare interface NotificationTargetStorage {
      * @param key - the key of a notification target.
      *
      * @returns - the notification target. Or undefined if not found.
-     *
-     * @beta
      */
     read(key: string): Promise<{
         [key: string]: unknown;
@@ -1224,8 +1539,6 @@ export declare interface NotificationTargetStorage {
      * List all stored notification targets.
      *
      * @returns - an array of notification target. Or an empty array if nothing is stored.
-     *
-     * @beta
      */
     list(): Promise<{
         [key: string]: unknown;
@@ -1235,8 +1548,6 @@ export declare interface NotificationTargetStorage {
      *
      * @param key - the key of a notification target.
      * @param object - the notification target.
-     *
-     * @beta
      */
     write(key: string, object: {
         [key: string]: unknown;
@@ -1245,8 +1556,6 @@ export declare interface NotificationTargetStorage {
      * Delete one notification target by its key.
      *
      * @param key - the key of a notification target.
-     *
-     * @beta
      */
     delete(key: string): Promise<void>;
 }
@@ -1258,10 +1567,22 @@ export declare interface NotificationTargetStorage {
  * - "Channel" means to a team channel. (By default, notification to a team will be sent to its "General" channel.)
  * - "Group" means to a group chat.
  * - "Person" means to a personal chat.
- *
- * @beta
  */
-export declare type NotificationTargetType = "Channel" | "Group" | "Person";
+export declare enum NotificationTargetType {
+    /**
+     * The notification will be sent to a team channel.
+     * (By default, notification to a team will be sent to its "General" channel.)
+     */
+    Channel = "Channel",
+    /**
+     * The notification will be sent to a group chat.
+     */
+    Group = "Group",
+    /**
+     * The notification will be sent to a personal chat.
+     */
+    Person = "Person"
+}
 
 /**
  * Represent on-behalf-of flow to get user identity, and it is designed to be used in server side.
@@ -1273,8 +1594,6 @@ export declare type NotificationTargetType = "Channel" | "Group" | "Person";
  *
  * @remarks
  * Can only be used in server side.
- *
- * @beta
  */
 export declare class OnBehalfOfUserCredential implements TokenCredential {
     private msalClient;
@@ -1291,8 +1610,6 @@ export declare class OnBehalfOfUserCredential implements TokenCredential {
      * @throws {@link ErrorCode|InvalidConfiguration} when client id, client secret, certificate content, authority host or tenant id is not found in config.
      * @throws {@link ErrorCode|InternalError} when SSO token is not valid.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @beta
      */
     constructor(ssoToken: string, config: AuthenticationConfiguration);
     /**
@@ -1327,8 +1644,6 @@ export declare class OnBehalfOfUserCredential implements TokenCredential {
      * @remarks
      * If scopes is empty string or array, it returns SSO token.
      * If scopes is non-empty, it returns access token for target scope.
-     *
-     * @beta
      */
     getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken | null>;
     /**
@@ -1343,34 +1658,56 @@ export declare class OnBehalfOfUserCredential implements TokenCredential {
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
      *
      * @returns Basic user info with user displayName, objectId and preferredUserName.
-     *
-     * @beta
      */
     getUserInfo(): UserInfo;
     private generateAuthServerError;
 }
 
+/**
+ * The search scope when calling {@link NotificationBot.findMember} and {@link NotificationBot.findAllMembers}.
+ * The search scope is a flagged enum and it can be combined with `|`.
+ * For example, to search from personal chat and group chat, use `SearchScope.Person | SearchScope.Group`.
+ */
+export declare enum SearchScope {
+    /**
+     * Search members from the installations in personal chat only.
+     */
+    Person = 1,
+    /**
+     * Search members from the installations in group chat only.
+     */
+    Group = 2,
+    /**
+     * Search members from the installations in Teams channel only.
+     */
+    Channel = 4,
+    /**
+     * Search members from all installations including personal chat, group chat and Teams channel.
+     */
+    All = 7
+}
+
 /**
  * Send an adaptive card message to a notification target.
  *
  * @param target - the notification target.
  * @param card - the adaptive card raw JSON.
- * @returns A `Promise` representing the asynchronous operation.
- *
- * @beta
+ * @param onError - an optional error handler that can catch exceptions during adaptive card sending.
+ * If not defined, error will be handled by `BotAdapter.onTurnError`.
+ * @returns the response of sending adaptive card message.
  */
-export declare function sendAdaptiveCard(target: NotificationTarget, card: unknown): Promise<void>;
+export declare function sendAdaptiveCard(target: NotificationTarget, card: unknown, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
 
 /**
  * Send a plain text message to a notification target.
  *
  * @param target - the notification target.
  * @param text - the plain text message.
- * @returns A `Promise` representing the asynchronous operation.
- *
- * @beta
+ * @param onError - an optional error handler that can catch exceptions during message sending.
+ * If not defined, error will be handled by `BotAdapter.onTurnError`.
+ * @returns the response of sending message.
  */
-export declare function sendMessage(target: NotificationTarget, text: string): Promise<void>;
+export declare function sendMessage(target: NotificationTarget, text: string, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
 
 /**
  * Set custom log function. Use the function if it's set. Priority is lower than setLogger.
@@ -1385,8 +1722,6 @@ export declare function sendMessage(target: NotificationTarget, text: string): P
  *   }
  * });
  * ```
- *
- * @beta
  */
 export declare function setLogFunction(logFunction?: LogFunction): void;
 
@@ -1404,8 +1739,6 @@ export declare function setLogFunction(logFunction?: LogFunction): void;
  *   error: console.error,
  * });
  * ```
- *
- * @beta
  */
 export declare function setLogger(logger?: Logger): void;
 
@@ -1413,8 +1746,6 @@ export declare function setLogger(logger?: Logger): void;
  * Update log level helper.
  *
  * @param { LogLevel } level - log level in configuration
- *
- * @beta
  */
 export declare function setLogLevel(level: LogLevel): void;
 
@@ -1426,20 +1757,14 @@ export declare function setLogLevel(level: LogLevel): void;
  *
  * @remarks
  * It's recommended to get bot installations from {@link ConversationBot.installations()}.
- *
- * @beta
  */
 export declare class TeamsBotInstallation implements NotificationTarget {
     /**
      * The bound `BotFrameworkAdapter`.
-     *
-     * @beta
      */
     readonly adapter: BotFrameworkAdapter;
     /**
      * The bound `ConversationReference`.
-     *
-     * @beta
      */
     readonly conversationReference: Partial<ConversationReference>;
     /**
@@ -1449,8 +1774,6 @@ export declare class TeamsBotInstallation implements NotificationTarget {
      * - "Channel" means bot is installed into a team and notification will be sent to its "General" channel.
      * - "Group" means bot is installed into a group chat.
      * - "Person" means bot is installed into a personal scope and notification will be sent to personal chat.
-     *
-     * @beta
      */
     readonly type?: NotificationTargetType;
     /**
@@ -1461,44 +1784,44 @@ export declare class TeamsBotInstallation implements NotificationTarget {
      *
      * @param adapter - the bound `BotFrameworkAdapter`.
      * @param conversationReference - the bound `ConversationReference`.
-     *
-     * @beta
      */
     constructor(adapter: BotFrameworkAdapter, conversationReference: Partial<ConversationReference>);
     /**
      * Send a plain text message.
      *
      * @param text - the plain text message.
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
+     * @param onError - an optional error handler that can catch exceptions during message sending.
+     * If not defined, error will be handled by `BotAdapter.onTurnError`.
+     * @returns the response of sending message.
      */
-    sendMessage(text: string): Promise<void>;
+    sendMessage(text: string, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
     /**
      * Send an adaptive card message.
      *
      * @param card - the adaptive card raw JSON.
-     * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
+     * @param onError - an optional error handler that can catch exceptions during adaptive card sending.
+     * If not defined, error will be handled by `BotAdapter.onTurnError`.
+     * @returns the response of sending adaptive card message.
      */
-    sendAdaptiveCard(card: unknown): Promise<void>;
+    sendAdaptiveCard(card: unknown, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
     /**
      * Get channels from this bot installation.
      *
      * @returns an array of channels if bot is installed into a team, otherwise returns an empty array.
-     *
-     * @beta
      */
     channels(): Promise<Channel[]>;
     /**
      * Get members from this bot installation.
      *
      * @returns an array of members from where the bot is installed.
-     *
-     * @beta
      */
     members(): Promise<Member[]>;
+    /**
+     * Get team details from this bot installation
+     *
+     * @returns the team details if bot is installed into a team, otherwise returns undefined.
+     */
+    getTeamDetails(): Promise<TeamDetails | undefined>;
 }
 
 /**
@@ -1548,8 +1871,6 @@ export declare class TeamsBotInstallation implements NotificationTarget {
  *      }
  * ]));
  * ```
- *
- * @beta
  */
 export declare class TeamsBotSsoPrompt extends Dialog {
     private teamsfx;
@@ -1563,8 +1884,6 @@ export declare class TeamsBotSsoPrompt extends Dialog {
      *
      * @throws {@link ErrorCode|InvalidParameter} when scopes is not a valid string or string array.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @beta
      */
     constructor(teamsfx: TeamsFx, dialogId: string, settings: TeamsBotSsoPromptSettings);
     /**
@@ -1580,8 +1899,6 @@ export declare class TeamsBotSsoPrompt extends Dialog {
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
      *
      * @returns A `Promise` representing the asynchronous operation.
-     *
-     * @beta
      */
     beginDialog(dc: DialogContext): Promise<DialogTurnResult>;
     /**
@@ -1599,8 +1916,6 @@ export declare class TeamsBotSsoPrompt extends Dialog {
      *
      * @throws {@link ErrorCode|ChannelNotSupported} when bot channel is not MS Teams.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is browser.
-     *
-     * @beta
      */
     continueDialog(dc: DialogContext): Promise<DialogTurnResult>;
     private loadAndValidateConfig;
@@ -1650,8 +1965,6 @@ export declare class TeamsBotSsoPrompt extends Dialog {
 
 /**
  * Settings used to configure an TeamsBotSsoPrompt instance.
- *
- * @beta
  */
 export declare interface TeamsBotSsoPromptSettings {
     /**
@@ -1674,8 +1987,6 @@ export declare interface TeamsBotSsoPromptSettings {
 
 /**
  * Token response provided by Teams Bot SSO prompt
- *
- * @beta
  */
 export declare interface TeamsBotSsoPromptTokenResponse extends TokenResponse {
     /**
@@ -1690,7 +2001,6 @@ export declare interface TeamsBotSsoPromptTokenResponse extends TokenResponse {
 
 /**
  * A class providing credential and configuration.
- * @beta
  */
 export declare class TeamsFx implements TeamsFxConfiguration {
     private configuration;
@@ -1704,15 +2014,12 @@ export declare class TeamsFx implements TeamsFxConfiguration {
      * @param customConfig - key/value pairs of customized configuration that overrides default ones.
      *
      * @throws {@link ErrorCode|IdentityTypeNotSupported} when setting app identity in browser.
-     *
-     * @beta
      */
-    constructor(identityType?: IdentityType, customConfig?: Record<string, string>);
+    constructor(identityType?: IdentityType, customConfig?: Record<string, string> | AuthenticationConfiguration);
     /**
      * Identity type set by user.
      *
      * @returns identity type.
-     * @beta
      */
     getIdentityType(): IdentityType;
     /**
@@ -1723,15 +2030,14 @@ export declare class TeamsFx implements TeamsFxConfiguration {
      * identity is chose, will return {@link AppCredential}.
      *
      * @returns instance implements TokenCredential interface.
-     * @beta
      */
     getCredential(): TokenCredential;
     /**
      * Get user information.
+     * @param {string[]} resources - The optional list of resources for full trust Teams apps.
      * @returns UserInfo object.
-     * @beta
      */
-    getUserInfo(): Promise<UserInfo>;
+    getUserInfo(resources?: string[]): Promise<UserInfo>;
     /**
      * Popup login page to get user's access token with specific scopes.
      *
@@ -1746,40 +2052,35 @@ export declare class TeamsFx implements TeamsFxConfiguration {
      * await teamsfx.login("https://graph.microsoft.com/User.Read Calendars.Read"); // multiple scopes using string
      * ```
      * @param scopes - The list of scopes for which the token will have access, before that, we will request user to consent.
+     * @param {string[]} resources - The optional list of resources for full trust Teams apps.
      *
      * @throws {@link ErrorCode|InternalError} when failed to login with unknown error.
      * @throws {@link ErrorCode|ConsentFailed} when user canceled or failed to consent.
      * @throws {@link ErrorCode|InvalidParameter} when scopes is not a valid string or string array.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is nodeJS.
-     *
-     * @beta
      */
-    login(scopes: string | string[]): Promise<void>;
+    login(scopes: string | string[], resources?: string[]): Promise<void>;
     /**
      * Set SSO token when using user identity in NodeJS.
      * @param {string} ssoToken - used for on behalf of user flow.
      * @returns self instance.
-     * @beta
      */
     setSsoToken(ssoToken: string): TeamsFx;
     /**
      * Usually used by service plugins to retrieve specific config
      * @param {string} key - configuration key.
      * @returns value in configuration.
-     * @beta
      */
     getConfig(key: string): string;
     /**
      * Check the value of specific key.
      * @param {string} key - configuration key.
      * @returns true if corresponding value is not empty string.
-     * @beta
      */
     hasConfig(key: string): boolean;
     /**
      * Get all configurations.
      * @returns key value mappings.
-     * @beta
      */
     getConfigs(): Record<string, string>;
     /**
@@ -1788,10 +2089,49 @@ export declare class TeamsFx implements TeamsFxConfiguration {
     private loadFromEnv;
 }
 
+/**
+ * Interface for adaptive card action handler that can process card action invoke and return a response.
+ */
+export declare interface TeamsFxAdaptiveCardActionHandler {
+    /**
+     * The verb defined in adaptive card action that can trigger this handler.
+     * The verb string here is case-insensitive.
+     */
+    triggerVerb: string;
+    /**
+     * Specify the behavior for how the card response will be sent in Teams conversation.
+     * The default value is `AdaptiveCardResponse.ReplaceForInteractor`, which means the card
+     * response will replace the current one only for the interactor.
+     */
+    adaptiveCardResponse?: AdaptiveCardResponse;
+    /**
+     * The handler function that will be invoked when the action is fired.
+     * @param context The turn context.
+     * @param actionData The contextual data that associated with the action.
+     *
+     * @returns A `Promise` representing a invoke response for the adaptive card invoke action.
+     * You can use the `InvokeResponseFactory` utility class to create an invoke response from
+     *  - A text message:
+     *   ```typescript
+     *   return InvokeResponseFactory.textMessage("Action is processed successfully!");
+     *   ```
+     *  - An adaptive card:
+     *    ```typescript
+     *    const responseCard = AdaptiveCards.declare(helloWorldCard).render(actionData);
+     return InvokeResponseFactory.adaptiveCard(responseCard);
+     *    ```
+     *  - An error response:
+     *     ```typescript
+     *     return InvokeResponseFactory.errorResponse(InvokeResponseErrorCode.BadRequest, "Invalid request");
+     *     ```
+     *
+     * @remark For more details about the invoke response format, refer to https://docs.microsoft.com/en-us/adaptive-cards/authoring-cards/universal-action-model#response-format.
+     */
+    handleActionInvoked(context: TurnContext, actionData: any): Promise<InvokeResponse>;
+}
+
 /**
  * Interface for a command handler that can process command to a TeamsFx bot and return a response.
- *
- * @beta
  */
 export declare interface TeamsFxBotCommandHandler {
     /**
@@ -1809,16 +2149,34 @@ export declare interface TeamsFxBotCommandHandler {
     handleCommandReceived(context: TurnContext, message: CommandMessage): Promise<string | Partial<Activity> | void>;
 }
 
+/**
+ * Interface for a command handler that can process sso command to a TeamsFx bot and return a response.
+ */
+export declare interface TeamsFxBotSsoCommandHandler {
+    /**
+     * The string or regular expression patterns that can trigger this handler.
+     */
+    triggerPatterns: TriggerPatterns;
+    /**
+     * Handles a bot command received activity.
+     *
+     * @param context The bot context.
+     * @param message The command message the user types from Teams.
+     * @param tokenResponse The tokenResponse which contains sso token that can be used to exchange access token for the bot.
+     * @returns A `Promise` representing an activity or text to send as the command response.
+     * Or no return value if developers want to send the response activity by themselves in this method.
+     */
+    handleCommandReceived(context: TurnContext, message: CommandMessage, tokenResponse: TeamsBotSsoPromptTokenResponse): Promise<string | Partial<Activity> | void>;
+}
+
 /**
  * TeamsFx interface that provides credential and configuration.
- * @beta
  */
 declare interface TeamsFxConfiguration {
     /**
      * Identity type set by user.
      *
      * @returns identity type.
-     * @beta
      */
     getIdentityType(): IdentityType;
     /**
@@ -1829,15 +2187,14 @@ declare interface TeamsFxConfiguration {
      * identity is chose, will return {@link AppCredential}.
      *
      * @returns instance implements TokenCredential interface.
-     * @beta
      */
     getCredential(): TokenCredential;
     /**
      * Get user information.
+     * @param {string[]} resources - The optional list of resources for full trust Teams apps.
      * @returns UserInfo object.
-     * @beta
      */
-    getUserInfo(): Promise<UserInfo>;
+    getUserInfo(resources?: string[]): Promise<UserInfo>;
     /**
      * Popup login page to get user's access token with specific scopes.
      *
@@ -1852,40 +2209,35 @@ declare interface TeamsFxConfiguration {
      * await teamsfx.login("https://graph.microsoft.com/User.Read Calendars.Read"); // multiple scopes using string
      * ```
      * @param scopes - The list of scopes for which the token will have access, before that, we will request user to consent.
+     * @param {string[]} resources - The optional list of resources for full trust Teams apps.
      *
      * @throws {@link ErrorCode|InternalError} when failed to login with unknown error.
      * @throws {@link ErrorCode|ConsentFailed} when user canceled or failed to consent.
      * @throws {@link ErrorCode|InvalidParameter} when scopes is not a valid string or string array.
      * @throws {@link ErrorCode|RuntimeNotSupported} when runtime is nodeJS.
-     *
-     * @beta
      */
-    login(scopes: string | string[]): Promise<void>;
+    login(scopes: string | string[], resources?: string[]): Promise<void>;
     /**
      * Set SSO token when using user identity in NodeJS.
      * @param {string} ssoToken - used for on behalf of user flow.
      * @returns self instance.
-     * @beta
      */
     setSsoToken(ssoToken: string): TeamsFxConfiguration;
     /**
      * Usually used by service plugins to retrieve specific config
      * @param {string} key - configuration key.
      * @returns value in configuration.
-     * @beta
      */
     getConfig(key: string): string;
     /**
      * Check the value of specific key.
      * @param {string} key - configuration key.
      * @returns true if corresponding value is not empty string.
-     * @beta
      */
     hasConfig(key: string): boolean;
     /**
      * Get all configurations.
      * @returns key value mappings.
-     * @beta
      */
     getConfigs(): Record<string, string>;
 }
@@ -1895,38 +2247,38 @@ declare interface TeamsFxConfiguration {
  *
  * @remarks
  * Can only be used within Teams.
- *
- * @beta
  */
 export declare class TeamsUserCredential implements TokenCredential {
     /**
      * Constructor of TeamsUserCredential.
      * @remarks
      * Can only be used within Teams.
-     * @beta
      */
     constructor(authConfig: AuthenticationConfiguration);
     /**
      * Popup login page to get user's access token with specific scopes.
+     *
+     * @param {string[]} resources - The optional list of resources for full trust Teams apps.
+     *
      * @remarks
      * Can only be used within Teams.
-     * @beta
      */
-    login(scopes: string | string[]): Promise<void>;
+    login(scopes: string | string[], resources?: string[]): Promise<void>;
     /**
      * Get access token from credential.
      * @remarks
      * Can only be used within Teams.
-     * @beta
      */
     getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken | null>;
     /**
      * Get basic user info from SSO token
+     *
+     * @param {string[]} resources - The optional list of resources for full trust Teams apps.
+     *
      * @remarks
      * Can only be used within Teams.
-     * @beta
      */
-    getUserInfo(): Promise<UserInfo>;
+    getUserInfo(resources?: string[]): Promise<UserInfo>;
 }
 
 /**
@@ -1936,8 +2288,6 @@ export declare type TriggerPatterns = string | RegExp | (string | RegExp)[];
 
 /**
  * UserInfo with user displayName, objectId and preferredUserName.
- *
- * @beta
  */
 export declare interface UserInfo {
     /**
@@ -1952,6 +2302,12 @@ export declare interface UserInfo {
      * @readonly
      */
     objectId: string;
+    /**
+     * User tenant ID.
+     *
+     * @readonly
+     */
+    tenantId: string;
     /**
      * Usually be the email address.
      *