@microsoft/teamsfx 2.1.1-alpha.f8e51b9d8.0 → 2.2.0-alpha.d2fbcaf19.0

package/types/teamsfx.d.ts

@@ -11,6 +11,7 @@ import { CardAction } from 'botbuilder';
 import { CardImage } from 'botbuilder';
 import { ChannelInfo } from 'botbuilder';
 import { Client } from '@microsoft/microsoft-graph-client';
+import { CloudAdapter } from 'botbuilder';
 import { ComponentDialog } from 'botbuilder-dialogs';
 import { ConnectionConfig } from 'tedious';
 import { ConversationReference } from 'botbuilder';
@@ -24,6 +25,8 @@ import { InvokeResponse } from 'botbuilder';
 import { MessagingExtensionResponse } from 'botbuilder';
 import { O365ConnectorCard } from 'botbuilder';
 import { ReceiptCard } from 'botbuilder';
+import { Request as Request_2 } from 'botbuilder';
+import { Response as Response_2 } from 'botbuilder';
 import { SecureContextOptions } from 'tls';
 import { SigninStateVerificationQuery } from 'botbuilder';
 import { StatePropertyAccessor } from 'botbuilder';
@@ -292,6 +295,25 @@ export declare class BearerTokenAuthProvider implements AuthProvider {
     AddAuthenticationInfo(config: AxiosRequestConfig): Promise<AxiosRequestConfig>;
 }
 
+declare namespace BotBuilderCloudAdapter {
+    export {
+        ConversationOptions_2 as ConversationOptions,
+        NotificationOptions_3 as NotificationOptions,
+        ConversationBot_2 as ConversationBot,
+        BotSsoExecutionDialog,
+        Channel_2 as Channel,
+        Member_2 as Member,
+        NotificationBot_2 as NotificationBot,
+        sendAdaptiveCard_2 as sendAdaptiveCard,
+        sendMessage_2 as sendMessage,
+        TeamsBotInstallation_2 as TeamsBotInstallation,
+        SearchScope_2 as SearchScope,
+        CommandBot_2 as CommandBot,
+        CardActionBot_2 as CardActionBot
+    }
+}
+export { BotBuilderCloudAdapter }
+
 /**
  * Interface for SSO configuration for Bot SSO
  */
@@ -477,6 +499,9 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                   /**
                    * A card action bot to respond to adaptive card universal actions.
                    */
+                  /**
+                   * @deprecated Use `BotBuilderCloudAdapter.CardActionBot` instead.
+                   */
                   export declare class CardActionBot {
                       private readonly adapter;
                       private middleware;
@@ -499,6 +524,33 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                       registerHandlers(actionHandlers: TeamsFxAdaptiveCardActionHandler[]): void;
                   }
 
+                  /**
+                   * A card action bot to respond to adaptive card universal actions.
+                   */
+                  declare class CardActionBot_2 {
+                      private readonly adapter;
+                      private middleware;
+                      /**
+                       * Create a new instance of the `CardActionBot`.
+                       *
+                       * @param adapter - The bound `CloudAdapter`.
+                       * @param options - The initialize options.
+                       */
+                      constructor(adapter: CloudAdapter, options?: CardActionOptions);
+                      /**
+                       * Register a card action handler to the bot.
+                       *
+                       * @param actionHandler - A card action handler to be registered.
+                       */
+                      registerHandler(actionHandler: TeamsFxAdaptiveCardActionHandler): void;
+                      /**
+                       * Register 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}.
                    */
@@ -587,12 +639,70 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                       private newConversation;
                   }
 
+                  /**
+                   * A {@link NotificationTarget} that represents a team channel.
+                   *
+                   * @remarks
+                   * It's recommended to get channels from {@link TeamsBotInstallation.channels()}.
+                   */
+                  declare class Channel_2 implements NotificationTarget {
+                      /**
+                       * The parent {@link TeamsBotInstallation} where this channel is created from.
+                       */
+                      readonly parent: TeamsBotInstallation_2;
+                      /**
+                       * Detailed channel information.
+                       */
+                      readonly info: ChannelInfo;
+                      /**
+                       * Notification target type. For channel it's always "Channel".
+                       */
+                      readonly type: NotificationTargetType;
+                      /**
+                       * Constructor.
+                       *
+                       * @remarks
+                       * It's recommended to get channels from {@link TeamsBotInstallation.channels()}, instead of using this constructor.
+                       *
+                       * @param parent - The parent {@link TeamsBotInstallation} where this channel is created from.
+                       * @param info - Detailed channel information.
+                       */
+                      constructor(parent: TeamsBotInstallation_2, info: ChannelInfo);
+                      /**
+                       * 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`.
+                       *
+                       * @returns The response of sending message.
+                       */
+                      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`.
+                       *
+                       * @returns The response of sending adaptive card message.
+                       */
+                      sendAdaptiveCard(card: unknown, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
+                      /**
+                       * @internal
+                       */
+                      private newConversation;
+                  }
+
                   /**
                    * A command bot for receiving commands and sending responses in Teams.
                    *
                    * @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.
                    */
+                  /**
+                   * @deprecated Use `BotBuilderCloudAdapter.CommandBot` instead.
+                   */
                   export declare class CommandBot {
                       private readonly adapter;
                       private readonly middleware;
@@ -631,6 +741,52 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                       private validateSsoActivityHandler;
                   }
 
+                  /**
+                   * A command bot for receiving commands and sending responses in Teams.
+                   *
+                   * @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.
+                   */
+                  declare class CommandBot_2 {
+                      private readonly adapter;
+                      private readonly middleware;
+                      private readonly ssoConfig;
+                      /**
+                       * Create a new instance of the `CommandBot`.
+                       *
+                       * @param adapter - The bound `CloudAdapter`.
+                       * @param options - The initialize options
+                       * @param ssoCommandActivityHandler - SSO execution activity handler.
+                       * @param ssoConfig - SSO configuration for Bot SSO.
+                       */
+                      constructor(adapter: CloudAdapter, options?: CommandOptions, ssoCommandActivityHandler?: BotSsoExecutionActivityHandler, ssoConfig?: BotSsoConfig);
+                      /**
+                       * Register a command into the command bot.
+                       *
+                       * @param command - The command to be registered.
+                       */
+                      registerCommand(command: TeamsFxBotCommandHandler): void;
+                      /**
+                       * Register commands into the command bot.
+                       *
+                       * @param commands - The commands to be registered.
+                       */
+                      registerCommands(commands: TeamsFxBotCommandHandler[]): void;
+                      /**
+                       * Register a sso command into the command bot.
+                       *
+                       * @param ssoCommand - The sso command to be registered.
+                       */
+                      registerSsoCommand(ssoCommand: TeamsFxBotSsoCommandHandler): void;
+                      /**
+                       * Register sso commands into the command bot.
+                       *
+                       * @param ssoCommands - The sso commands to be registered.
+                       */
+                      registerSsoCommands(ssoCommands: TeamsFxBotSsoCommandHandler[]): void;
+                      private validateSsoActivityHandler;
+                  }
+
                   /**
                    * Interface for a command message that can handled in a command handler.
                    */
@@ -710,6 +866,9 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                    *
                    * For notification, set `notification.storage` in {@link ConversationOptions} to use your own storage implementation.
                    */
+                  /**
+                   * @deprecated Use `BotBuilderCloudAdapter.ConversationBot` instead.
+                   */
                   export declare class ConversationBot {
                       /**
                        * The bot adapter.
@@ -761,8 +920,119 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                       requestHandler(req: WebRequest, res: WebResponse, logic?: (context: TurnContext) => Promise<any>): Promise<void>;
                   }
 
+                  /**
+                   * Provide utilities for bot conversation, including:
+                   *   - handle command and response.
+                   *   - send notification to varies targets (e.g., member, group, channel).
+                   *
+                   * @example
+                   * For command and response, you can register your commands through the constructor, or use the `registerCommand` and `registerCommands` API to add commands later.
+                   *
+                   * ```typescript
+                   * import { BotBuilderCloudAdapter } from "@microsoft/teamsfx";
+                   * import ConversationBot = BotBuilderCloudAdapter.ConversationBot;
+                   *
+                   * // register through constructor
+                   * const conversationBot = new ConversationBot({
+                   *   command: {
+                   *     enabled: true,
+                   *     commands: [ new HelloWorldCommandHandler() ],
+                   *   },
+                   * });
+                   *
+                   * // register through `register*` API
+                   * conversationBot.command.registerCommand(new HelpCommandHandler());
+                   * ```
+                   *
+                   * For notification, you can enable notification at initialization, then send notifications at any time.
+                   *
+                   * ```typescript
+                   * import { BotBuilderCloudAdapter } from "@microsoft/teamsfx";
+                   * import ConversationBot = BotBuilderCloudAdapter.ConversationBot;
+                   *
+                   * // enable through constructor
+                   * const conversationBot = new ConversationBot({
+                   *   notification: {
+                   *     enabled: true,
+                   *   },
+                   * });
+                   *
+                   * // get all bot installations and send message
+                   * for (const target of await conversationBot.notification.installations()) {
+                   *   await target.sendMessage("Hello Notification");
+                   * }
+                   *
+                   * // alternative - send message to all members
+                   * for (const target of await conversationBot.notification.installations()) {
+                   *   for (const member of await target.members()) {
+                   *     await member.sendMessage("Hello Notification");
+                   *   }
+                   * }
+                   * ```
+                   *
+                   * @remarks
+                   * Set `adapter` in {@link ConversationOptions} to use your own bot adapter.
+                   *
+                   * 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.
+                   */
+                  declare class ConversationBot_2 {
+                      /**
+                       * The bot adapter.
+                       */
+                      readonly adapter: CloudAdapter;
+                      /**
+                       * The entrypoint of command and response.
+                       */
+                      readonly command?: CommandBot_2;
+                      /**
+                       * The entrypoint of notification.
+                       */
+                      readonly notification?: NotificationBot_2;
+                      /**
+                       * The action handler used for adaptive card universal actions.
+                       */
+                      readonly cardAction?: CardActionBot_2;
+                      /**
+                       * Create new instance of the `ConversationBot`.
+                       *
+                       * @remarks
+                       * It's recommended to create your own adapter and storage for production environment instead of the default one.
+                       *
+                       * @param options - The initialize options.
+                       */
+                      constructor(options: ConversationOptions_2);
+                      private createDefaultAdapter;
+                      /**
+                       * The request handler to integrate with web request.
+                       *
+                       * @param req - An incoming HTTP [Request](xref:botbuilder.Request).
+                       * @param res - The corresponding HTTP [Response](xref:botbuilder.Response).
+                       * @param logic - The additional function to handle bot context.
+                       *
+                       * @example
+                       * For example, to use with Restify:
+                       * ``` typescript
+                       * // The default/empty behavior
+                       * server.use(restify.plugins.bodyParser());
+                       * server.post("api/messages", conversationBot.requestHandler);
+                       *
+                       * // Or, add your own logic
+                       * server.use(restify.plugins.bodyParser());
+                       * server.post("api/messages", async (req, res) => {
+                       *   await conversationBot.requestHandler(req, res, async (context) => {
+                       *     // your-own-context-logic
+                       *   });
+                       * });
+                       * ```
+                       */
+                      requestHandler(req: Request_2, res: Response_2, logic?: (context: TurnContext) => Promise<any>): Promise<void>;
+                  }
+
                   /**
                    * Options to initialize {@link ConversationBot}
+                   * @deprecated Please use BotBuilderCloudAdapter.ConversationOptions instead.
                    */
                   export declare interface ConversationOptions {
                       /**
@@ -816,6 +1086,61 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                       };
                   }
 
+                  /**
+                   * Options to initialize {@link ConversationBot}
+                   */
+                  declare interface ConversationOptions_2 {
+                      /**
+                       * The bot adapter. If not provided, a default adapter will be created:
+                       * - with `adapterConfig` as constructor parameter.
+                       * - with a default error handler that logs error to console, sends trace activity, and sends error message to user.
+                       *
+                       * @remarks
+                       * If neither `adapter` nor `adapterConfig` is provided, will use BOT_ID and BOT_PASSWORD from environment variables.
+                       */
+                      adapter?: CloudAdapter;
+                      /**
+                       * If `adapter` is not provided, this `adapterConfig` will be passed to the new `CloudAdapter` when created internally.
+                       *
+                       * @remarks
+                       * If neither `adapter` nor `adapterConfig` is provided, will use BOT_ID and BOT_PASSWORD from environment variables.
+                       */
+                      adapterConfig?: {
+                          [key: string]: unknown;
+                      };
+                      /**
+                       * Configurations for sso command bot
+                       */
+                      ssoConfig?: BotSsoConfig;
+                      /**
+                       * The command part.
+                       */
+                      command?: CommandOptions & {
+                          /**
+                           * Whether to enable command or not.
+                           */
+                          enabled?: boolean;
+                      };
+                      /**
+                       * The notification part.
+                       */
+                      notification?: NotificationOptions_3 & {
+                          /**
+                           * Whether to enable notification or not.
+                           */
+                          enabled?: boolean;
+                      };
+                      /**
+                       * The adaptive card action handler part.
+                       */
+                      cardAction?: CardActionOptions & {
+                          /**
+                           * Whether to enable adaptive card actions or not.
+                           */
+                          enabled?: boolean;
+                      };
+                  }
+
                   /**
                    * Initializes new Axios instance with specific auth provider
                    *
@@ -1200,9 +1525,9 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                        * 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.
+                       * @param message - A text message included in a invoke response.
                        *
-                       * @returns {InvokeResponse} An InvokeResponse object.
+                       * @returns An `InvokeResponse` object.
                        */
                       static textMessage(message: string): InvokeResponse;
                       /**
@@ -1212,9 +1537,9 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                        * 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.
+                       * @param card - The adaptive card JSON payload.
                        *
-                       * @returns {InvokeResponse} An InvokeResponse object.
+                       * @returns An `InvokeResponse` object.
                        */
                       static adaptiveCard(card: unknown): InvokeResponse;
                       /**
@@ -1223,20 +1548,20 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                        * 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:
+                       * @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.
+                       * @param errorMessage - The error message.
                        *
-                       * @returns {InvokeResponse} An InvokeResponse object.
+                       * @returns 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.
+                       * @param statusCode - The status code.
+                       * @param body - The value of the response body.
                        *
-                       * @returns {InvokeResponse} An InvokeResponse object.
+                       * @returns An `InvokeResponse` object.
                        */
                       static createInvokeResponse(statusCode: StatusCodes, body?: unknown): InvokeResponse;
                   }
@@ -1343,6 +1668,61 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                       private newConversation;
                   }
 
+                  /**
+                   * A {@link NotificationTarget} that represents a team member.
+                   *
+                   * @remarks
+                   * It's recommended to get members from {@link TeamsBotInstallation.members()}.
+                   */
+                  declare class Member_2 implements NotificationTarget {
+                      /**
+                       * The parent {@link TeamsBotInstallation} where this member is created from.
+                       */
+                      readonly parent: TeamsBotInstallation_2;
+                      /**
+                       * Detailed member account information.
+                       */
+                      readonly account: TeamsChannelAccount;
+                      /**
+                       * Notification target type. For member it's always "Person".
+                       */
+                      readonly type: NotificationTargetType;
+                      /**
+                       * Constructor.
+                       *
+                       * @remarks
+                       * It's recommended to get members from {@link TeamsBotInstallation.members()}, instead of using this constructor.
+                       *
+                       * @param parent - The parent {@link TeamsBotInstallation} where this member is created from.
+                       * @param account - Detailed member account information.
+                       */
+                      constructor(parent: TeamsBotInstallation_2, account: TeamsChannelAccount);
+                      /**
+                       * 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`.
+                       *
+                       * @returns The response of sending message.
+                       */
+                      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`.
+                       *
+                       * @returns The response of sending adaptive card message.
+                       */
+                      sendAdaptiveCard(card: unknown, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
+                      /**
+                       * @internal
+                       */
+                      private newConversation;
+                  }
+
                   /**
                    * Provides utility method to build bot message with cards that supported in Teams.
                    */
@@ -1526,6 +1906,9 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                   /**
                    * Provide utilities to send notification to varies targets (e.g., member, group, channel).
                    */
+                  /**
+                   * @deprecated Use `BotBuilderCloudAdapter.NotificationBot` instead.
+                   */
                   export declare class NotificationBot {
                       private readonly conversationReferenceStore;
                       private readonly adapter;
@@ -1589,8 +1972,80 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                       private matchSearchScope;
                   }
 
+                  /**
+                   * Provide utilities to send notification to varies targets (e.g., member, group, channel).
+                   */
+                  declare class NotificationBot_2 {
+                      private readonly conversationReferenceStore;
+                      private readonly adapter;
+                      private readonly botAppId;
+                      /**
+                       * Constructor of the notification bot.
+                       *
+                       * @remarks
+                       * To ensure accuracy, it's recommended to initialize before handling any message.
+                       *
+                       * @param adapter - The bound `CloudAdapter`
+                       * @param options - The initialize options
+                       */
+                      constructor(adapter: CloudAdapter, options?: NotificationOptions_3);
+                      /**
+                       * Get all targets where the bot is installed.
+                       *
+                       * @remarks
+                       * The result is retrieving from the persisted storage.
+                       *
+                       * @returns An array of {@link TeamsBotInstallation}.
+                       */
+                      installations(): Promise<TeamsBotInstallation_2[]>;
+                      /**
+                       * Return 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_2) => Promise<boolean>, scope?: SearchScope_2): Promise<Member_2 | undefined>;
+                      /**
+                       * Return the first {@link Channel} where predicate is true, and undefined otherwise.
+                       * (Ensure the bot app is installed into the `General` channel, otherwise undefined will be returned.)
+                       *
+                       * @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_2, teamDetails: TeamDetails | undefined) => Promise<boolean>): Promise<Channel_2 | undefined>;
+                      /**
+                       * Return 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_2) => Promise<boolean>, scope?: SearchScope_2): Promise<Member_2[]>;
+                      /**
+                       * Return all {@link Channel} where predicate is true, and empty array otherwise.
+                       * (Ensure the bot app is installed into the `General` channel, otherwise empty array will be returned.)
+                       *
+                       * @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_2, teamDetails: TeamDetails | undefined) => Promise<boolean>): Promise<Channel_2[]>;
+                      private matchSearchScope;
+                  }
+
                   /**
                    * Options to initialize {@link NotificationBot}.
+                   * @deprecated Please use BotBuilderCloudAdapter.NotificationOptions instead.
                    */
                   declare interface NotificationOptions_2 {
                       /**
@@ -1608,6 +2063,31 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                   }
                   export { NotificationOptions_2 as NotificationOptions }
 
+                  /**
+                   * Options to initialize {@link NotificationBot}.
+                   */
+                  declare interface NotificationOptions_3 {
+                      /**
+                       * An optional input of bot app Id.
+                       *
+                       * @remarks
+                       * If `botAppId` is not provided, `process.env.BOT_ID` will be used by default.
+                       */
+                      botAppId?: string;
+                      /**
+                       * An optional storage to persist bot notification connections.
+                       *
+                       * @remarks
+                       * If `storage` is not provided, a default local file storage will be used,
+                       * which stores notification connections into:
+                       *   - `.notification.localstore.json` if running locally
+                       *   - `${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.
+                       */
+                      storage?: NotificationTargetStorage;
+                  }
+
                   /**
                    * Represent a notification target.
                    */
@@ -1852,6 +2332,30 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                       All = 7
                   }
 
+                  /**
+                   * 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`.
+                   */
+                  declare enum SearchScope_2 {
+                      /**
+                       * 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.
                    *
@@ -1863,6 +2367,18 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                    */
                   export declare function sendAdaptiveCard(target: NotificationTarget, card: unknown, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
 
+                  /**
+                   * Send an adaptive card message to a notification target.
+                   *
+                   * @param target - The notification target.
+                   * @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`.
+                   *
+                   * @returns The response of sending adaptive card message.
+                   */
+                  declare function sendAdaptiveCard_2(target: NotificationTarget, card: unknown, onError?: (context: TurnContext, error: Error) => Promise<void>): Promise<MessageResponse>;
+
                   /**
                    * Send a plain text message to a notification target.
                    *
@@ -1874,6 +2390,18 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                    */
                   export declare function sendMessage(target: NotificationTarget, text: string, 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.
+                   * @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.
+                   */
+                  declare function sendMessage_2(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.
                    *
@@ -1923,6 +2451,9 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                    * @remarks
                    * It's recommended to get bot installations from {@link ConversationBot.installations()}.
                    */
+                  /**
+                   * @deprecated Use `BotBuilderCloudAdapter.TeamsBotInstallation` instead.
+                   */
                   export declare class TeamsBotInstallation implements NotificationTarget {
                       /**
                        * The bound `BotFrameworkAdapter`.
@@ -1989,6 +2520,88 @@ export declare class BotSsoExecutionDialog extends ComponentDialog {
                       getTeamDetails(): Promise<TeamDetails | undefined>;
                   }
 
+                  /**
+                   * A {@link NotificationTarget} that represents a bot installation. Teams Bot could be installed into
+                   * - Personal chat
+                   * - Group chat
+                   * - Team (by default the `General` channel)
+                   *
+                   * @remarks
+                   * It's recommended to get bot installations from {@link ConversationBot.installations()}.
+                   */
+                  declare class TeamsBotInstallation_2 implements NotificationTarget {
+                      /**
+                       * The bound `CloudAdapter`.
+                       */
+                      readonly adapter: CloudAdapter;
+                      /**
+                       * The bound `ConversationReference`.
+                       */
+                      readonly conversationReference: Partial<ConversationReference>;
+                      /**
+                       * The bot app id.
+                       */
+                      readonly botAppId: string;
+                      /**
+                       * Notification target type.
+                       *
+                       * @remarks
+                       * - "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.
+                       */
+                      readonly type?: NotificationTargetType;
+                      /**
+                       * Constructor
+                       *
+                       * @remarks
+                       * It's recommended to get bot installations from {@link ConversationBot.installations()}, instead of using this constructor.
+                       *
+                       * @param adapter - The bound `CloudAdapter`.
+                       * @param conversationReference - The bound `ConversationReference`.
+                       * @param botAppId - The bot app id.
+                       */
+                      constructor(adapter: CloudAdapter, conversationReference: Partial<ConversationReference>, botAppId: string);
+                      /**
+                       * 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`.
+                       *
+                       * @returns The response of sending message.
+                       */
+                      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`.
+                       *
+                       * @returns The response of sending adaptive card message.
+                       */
+                      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.
+                       */
+                      channels(): Promise<Channel_2[]>;
+                      /**
+                       * Get members from this bot installation.
+                       *
+                       * @returns An array of members from where the bot is installed.
+                       */
+                      members(): Promise<Member_2[]>;
+                      /**
+                       * 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>;
+                  }
+
                   /**
                    * Creates a new prompt that leverage Teams Single Sign On (SSO) support for bot to automatically sign in user and
                    * help receive oauth token, asks the user to consent if needed.