teams_rb 2.0.1 → 2.0.2

data/docs/essentials/on-activity.md

@@ -32,6 +32,20 @@ Each invoke family has named routes — their handler return values become the i
 - Feedback: `on_message_submit_feedback` (thumbs up/down from `add_feedback` — [guide](../in-depth-guides/feedback.md)), `on_message_submit` for any `message/submitAction`
 - `on_suggested_action_submit` for suggested-action submissions
 
+## Conversation updates
+
+`on_conversation_update` matches any `conversationUpdate` activity (members added/removed, channel and team changes). The channel/team lifecycle sub-events also have named routes, matched on `channelData.eventType`:
+
+```ruby
+teams.on_conversation_update { |ctx| }     # any conversationUpdate activity
+teams.on_channel_created  { |ctx| ctx.post "Welcome to #{ctx.activity.channel_data.channel.name}!" }
+teams.on_channel_deleted  { |ctx| }        # also: on_channel_renamed, on_channel_restored
+teams.on_team_renamed     { |ctx| }        # also: on_team_archived, on_team_unarchived,
+                                           #   on_team_deleted, on_team_hard_deleted, on_team_restored
+```
+
+A generic `on_conversation_update` registered before a specific route sees the activity first; declare `|ctx, nxt|` and call `nxt.call` to continue to the specific route (see Middleware below).
+
 ## Meeting events
 
 ```ruby

data/docs/essentials/sending-messages.md

@@ -32,6 +32,7 @@ ctx.update sent.id, "Done!"
 ```ruby
 ctx.post Teams::Api::MessageActivity.new("**markdown**", text_format: "markdown")
 # text_format: plain | markdown | xml | extendedmarkdown
+# ("extendedmarkdown" is in public preview and may be subject to change)
 
 ctx.post Teams::Api::MessageActivity.new("Quarterly numbers")
   .add_ai_generated                                          # "AI generated" badge

data/docs/getting-started/quickstart.md

@@ -5,16 +5,17 @@ Build and run your first Teams bot in Ruby.
 ## Prerequisites
 
 - Ruby 4.0+
-- A Microsoft 365 tenant where you can register a Teams app ([developer program](https://developer.microsoft.com/microsoft-365/dev-program) tenants work)
+- A Microsoft 365 tenant with custom app upload enabled ([developer program](https://developer.microsoft.com/microsoft-365/dev-program) tenants work)
 - A tunnel for local development ([Dev Tunnels](https://learn.microsoft.com/azure/developer/dev-tunnels/get-started), ngrok, or similar)
 
 ## Install
 
-Add the gem to your project:
+Add the SDK and a Rack server for this standalone example:
 
 ```ruby
 # Gemfile
 gem "teams_rb"
+gem "puma"
 ```
 
 ```sh
@@ -38,15 +39,15 @@ end
 run teams.to_rack
 ```
 
-And run it:
+This example uses Puma; `teams_rb` itself does not require a server gem. Run it with:
 
 ```sh
-CLIENT_ID=... CLIENT_SECRET=... TENANT_ID=... bundle exec rackup -p 3978 -o 0.0.0.0
+CLIENT_ID=... CLIENT_SECRET=... TENANT_ID=... bundle exec puma -p 3978
 ```
 
 The app listens for Teams activities on `POST /api/messages`, validates every inbound request against Microsoft's signing keys, and echoes any message back as a quoted reply.
 
-The three environment variables come from your bot registration — [Running in Teams](running-in-teams.md) walks through creating one and connecting Teams to your locally running bot. For local experiments without credentials, `Teams::App.new(skip_auth: true)` disables inbound validation (never use it beyond local testing; the app logs a loud warning when you do).
+The three environment variables come from your bot registration — [Running in Teams](running-in-teams.md) walks through creating one and connecting Teams to your locally running bot. For local experiments without credentials, `Teams::App.new(dangerously_allow_unauthenticated_requests: true)` disables inbound validation (never use it beyond local testing; the app logs a loud warning when you do). The `DANGEROUSLY_ALLOW_UNAUTHENTICATED_REQUESTS` environment variable sets the same option.
 
 ## Where to go next
 

data/docs/getting-started/running-in-teams.md

@@ -1,16 +1,18 @@
 # Running in Teams
 
-Connect your locally running bot to a real Teams client.
+Connect your locally running bot to a real Teams client with the [Teams CLI](https://www.npmjs.com/package/@microsoft/teams.cli).
 
-## 1. Register a bot
+## 1. Install and sign in
 
-Create a Teams app with a bot in the [Teams Developer Portal](https://dev.teams.microsoft.com) (or with Microsoft's Teams CLI). You need three values for the app's environment:
+The CLI requires Node.js 20 or newer:
 
-- `CLIENT_ID` — the bot's Microsoft App ID
-- `CLIENT_SECRET` — a client secret for that app registration
-- `TENANT_ID` — your Entra tenant ID (single-tenant bots)
+```sh
+npm install -g @microsoft/teams.cli
+teams login
+teams status
+```
 
-> If you plan to use [user authentication](../in-depth-guides/user-authentication.md), register the bot as an **Azure Bot resource** from the start (Azure portal → Create resource → Azure Bot → "Use existing app registration"). OAuth connection settings only exist there, and converting a Developer Portal registration later means deleting and recreating it.
+`teams status` should report that sideloading is enabled. If it is disabled, your tenant administrator must enable custom app upload before you can install the bot.
 
 ## 2. Start a tunnel
 
@@ -22,23 +24,44 @@ devtunnel port create teams-bot -p 3978
 devtunnel host teams-bot
 ```
 
-Note the tunnel URL, e.g. `https://abc123-3978.euw.devtunnels.ms`. Dev Tunnels URLs are stable across restarts, so this is one-time setup.
+Note the tunnel URL, such as `https://abc123-3978.euw.devtunnels.ms`. Dev Tunnels URLs are stable across restarts, so creation is a one-time step.
+
+## 3. Register the app and bot
 
-## 3. Point the bot at the tunnel
+From your project directory, pass the public endpoint to the CLI:
+
+```sh
+teams app create \
+  --name my-teams-ruby-bot \
+  --endpoint https://<your-tunnel>/api/messages
+```
 
-In the bot registration, set the **messaging endpoint** to `https://<your-tunnel>/api/messages`, and make sure the **Microsoft Teams channel** is enabled.
+The CLI creates the app registration, manifest, bot, and Teams app. It prints the Teams App ID, an **Install in Teams** link, and the three values your Ruby app needs:
+
+- `CLIENT_ID` — the bot's Microsoft App ID
+- `CLIENT_SECRET` — the bot's client secret
+- `TENANT_ID` — the Entra tenant ID
+
+> If you plan to use [user authentication](../in-depth-guides/user-authentication.md), create an Azure-hosted bot with the CLI's `--azure`, `--subscription`, and `--resource-group` options. OAuth connection settings are not available for Teams-managed bots.
+
+You can instead configure the same resources manually in the [Teams Developer Portal](https://dev.teams.microsoft.com/apps).
 
 ## 4. Run and install
 
+Start the bot with the credentials printed by the CLI:
+
 ```sh
-bundle exec rackup -p 3978 -o 0.0.0.0
+CLIENT_ID=... CLIENT_SECRET=... TENANT_ID=... bundle exec puma -p 3978
 ```
 
-Install the app in Teams (Developer Portal → Preview in Teams) and send it a message. Inbound requests are JWT-validated with your real credentials — no `skip_auth` needed behind a tunnel.
+Open the **Install in Teams** link and send the bot a message. If you need the link again, run `teams app get <teams-app-id> --install-link`.
+
+Inbound requests are JWT-validated with your real credentials; no `dangerously_allow_unauthenticated_requests` is needed behind the tunnel.
 
 ## Troubleshooting
 
-- **No response in Teams**: check the messaging endpoint URL, the Teams channel, and that the tunnel and server are both running. The app logs every inbound activity at debug level and every rejected request at warn level.
-- **401s in your logs**: the requests are reaching you but failing validation — usually a `CLIENT_ID`/`TENANT_ID` mismatch with the registration.
+- **No response in Teams**: run `teams app doctor <teams-app-id>`, then check that the tunnel and server are running.
+- **401s in your logs**: the requests are reaching you but failing validation, usually because the running app has credentials from a different registration.
+- **Sideloading disabled**: ask your tenant administrator to enable custom app upload.
 - **Teams caches aggressively**: after manifest changes, fully quit and reopen the Teams client.
 - **At-least-once delivery**: Bot Framework redelivers activities when your bot errors or responds slowly. If a handler's side effects must not repeat, deduplicate by `ctx.activity.id`.

data/docs/in-depth-guides/adaptive-cards.md

@@ -48,6 +48,23 @@ end
 
 For richer action flows — opening a modal form from a card button — see [Dialogs](dialogs.md).
 
+## Dynamic typeahead search
+
+An `Input.ChoiceSet` with `choices.data` (`Data.Query`) fetches its choices from your bot as the user types. Teams sends an `application/search` invoke; answer it with `on_card_search`:
+
+```ruby
+teams.on_card_search do |ctx|
+  query = ctx.activity.value.query_text
+  Teams::Api::SearchResponse.new(
+    CITIES.grep(/#{Regexp.escape(query)}/i).map do |city|
+      Teams::Api::SearchInvokeResult.new(title: city, value: city)
+    end
+  )
+end
+```
+
+`ctx.activity.value` also carries `dataset` (the `Data.Query` dataset id, for cards with several dynamic inputs) and `query_options` with `skip`/`top` for paging large result sets.
+
 ## Regenerating
 
 The card classes are generated; don't hand-edit `lib/teams/cards/generated.rb`. To regenerate after an upstream card-model change:

data/docs/in-depth-guides/user-authentication.md

@@ -31,7 +31,7 @@ teams.on_sign_in do |ctx, token_response|
 end
 ```
 
-`ctx.sign_in` returns the token when the user is already signed in; otherwise it sends an OAuth card (to a 1:1 conversation when invoked from a group chat) and returns `nil`. The SDK's **default handlers** then complete the sign-in invokes automatically — both the interactive card path (`signin/verifyState`) and silent SSO (`signin/tokenExchange`) — and fire `on_sign_in`. You don't handle the invokes yourself.
+`ctx.sign_in` returns the token when the user is already signed in; otherwise it sends an OAuth card and returns `nil`. In group chats and channels the card is delivered in the conversation as a targeted message only the requesting user sees; in channels the card always uses the sign-in button (silent SSO is not supported in channel scope). The SDK's **default handlers** then complete the sign-in invokes automatically — both the interactive card path (`signin/verifyState`) and silent SSO (`signin/tokenExchange`) — and fire `on_sign_in`. You don't handle the invokes yourself.
 
 `ctx.sign_out` clears the stored token.
 

data/lib/teams/activity_context.rb

@@ -93,8 +93,10 @@ module Teams
 
     # Starts the user sign-in flow: returns the token if the user is already
     # signed in, otherwise sends an OAuth card and returns nil. In group
-    # conversations the card goes to a 1:1 conversation with the user (group
-    # OAuth is not supported by Teams), like the TypeScript/Python SDKs.
+    # chats and channels the card is a targeted message visible only to the
+    # requesting user; channels omit the token exchange resource because
+    # channel scope cannot do the silent SSO exchange, so the card renders
+    # the sign-in button instead.
     def sign_in(connection_name: nil, oauth_card_text: "Please Sign In...", sign_in_button_text: "Sign In")
       connection_name ||= app.default_connection_name
 
@@ -109,19 +111,6 @@ module Teams
         # No token yet; continue with the OAuth card flow.
       end
 
-      conversation_id = conversation_reference.conversation_id
-      if activity.conversation.is_group
-        one_on_one = api.conversations.create(
-          members: [activity.from.to_h],
-          tenant_id: activity.conversation.tenant_id
-        )
-        conversation_id = one_on_one.id
-        # Deliberately posts the plain text notice into the group (matching
-        # TypeScript and Python): group chats don't support SSO, so the card
-        # itself goes to the 1:1 below while the group sees only the notice.
-        post(oauth_card_text)
-      end
-
       state = Base64.strict_encode64(JSON.generate(
         "connectionName" => connection_name,
         "conversation" => conversation_reference.to_h,
@@ -129,10 +118,14 @@ module Teams
       ))
       resource = api.bots.sign_in.get_resource(state:)
 
+      is_channel = activity.conversation.conversation_type == "channel"
+      recipient = activity.from.to_h
+      recipient = recipient.merge("isTargeted" => true) if activity.conversation.is_group
+
       card = {
         "text" => oauth_card_text,
         "connectionName" => connection_name,
-        "tokenExchangeResource" => resource.token_exchange_resource&.to_h,
+        "tokenExchangeResource" => (resource.token_exchange_resource&.to_h unless is_channel),
         "tokenPostResource" => resource.token_post_resource&.to_h,
         "buttons" => [
           { "type" => "signin", "title" => sign_in_button_text, "value" => resource.sign_in_link }
@@ -141,13 +134,13 @@ module Teams
 
       payload = {
         "type" => "message",
-        "recipient" => activity.from.to_h,
+        "recipient" => recipient,
         "attachments" => [
           { "contentType" => "application/vnd.microsoft.card.oauth", "content" => card }
         ]
       }
 
-      app.send_activity(sign_in_reference(conversation_id), payload)
+      app.send_activity(conversation_reference, payload)
       nil
     end
 
@@ -167,16 +160,6 @@ module Teams
 
     private
 
-    def sign_in_reference(conversation_id)
-      return conversation_reference if conversation_id == conversation_reference.conversation_id
-
-      Api::ConversationReference.from_h(
-        conversation_reference.to_h.merge(
-          "conversation" => conversation_reference.conversation.to_h.merge("id" => conversation_id)
-        )
-      )
-    end
-
     def incoming_targeted_sender
       return nil unless activity.message?
       return nil unless activity.recipient.is_targeted == true

data/lib/teams/api/activity_value.rb

@@ -44,6 +44,35 @@ module Teams
       def end_time
         read("EndTime", "endTime", "end_time")
       end
+
+      # application/search invoke fields (Adaptive Card dynamic typeahead
+      # Input.ChoiceSet queries via choices.data / Data.Query).
+      def query_text
+        read("queryText", "query_text")
+      end
+
+      # Pagination options; skip and top read from the nested wrapper.
+      def query_options
+        value = read("queryOptions", "query_options")
+        value.is_a?(Hash) ? ActivityValue.new(value) : value
+      end
+
+      def kind
+        read("kind")
+      end
+
+      # The Data.Query dataset id authored on the Adaptive Card.
+      def dataset
+        read("dataset")
+      end
+
+      def skip
+        read("skip")
+      end
+
+      def top
+        read("top")
+      end
     end
   end
 end

data/lib/teams/api/app_info.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Teams
+  module Api
+    class AppInfo < Model
+      def id
+        read("id")
+      end
+
+      def version
+        read("version")
+      end
+    end
+  end
+end

data/lib/teams/api/channel_data.rb

@@ -3,6 +3,10 @@
 module Teams
   module Api
     class ChannelData < Model
+      def app
+        wrap(read("app"), AppInfo)
+      end
+
       def tenant
         wrap(read("tenant"), TenantInfo)
       end
@@ -55,6 +59,7 @@ module Teams
 
       def to_h
         body = raw.dup
+        body["app"] = app.to_h if app
         body["tenant"] = tenant.to_h if tenant
         body["team"] = team.to_h if team
         body["channel"] = channel.to_h if channel

data/lib/teams/api/conversation_client.rb

@@ -41,7 +41,9 @@ module Teams
       def reply_to_activity(conversation_id, activity_id, activity, service_url: nil)
         body = activity_to_h(activity)
         body = body.merge("replyToId" => activity_id) if body.is_a?(Hash)
-        path = "/v3/conversations/#{escape(conversation_id)}/activities/#{escape(activity_id)}"
+        # Replies POST to the base activities collection; the reply
+        # semantics ride entirely in the body's replyToId.
+        path = "/v3/conversations/#{escape(conversation_id)}/activities"
         url = absolute(path, service_url:)
         @logger&.debug("Teams API POST #{url}")
         http.post(url, json: body)

data/lib/teams/api/message_activity.rb

@@ -3,6 +3,7 @@
 module Teams
   module Api
     class MessageActivity
+      # "extendedmarkdown" is in public preview and may be subject to change.
       TEXT_FORMATS = %w[plain markdown xml extendedmarkdown].freeze
       FEEDBACK_MODES = %w[default custom].freeze
       AI_MESSAGE_ENTITY_TYPE = "https://schema.org/Message"

data/lib/teams/api/search.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Teams
+  module Api
+    # A single application/search result: title is the display text, value
+    # is submitted when the user selects it.
+    class SearchInvokeResult
+      def initialize(title:, value:)
+        @title = title
+        @value = value
+      end
+
+      def to_h
+        { "title" => @title, "value" => @value }
+      end
+    end
+
+    # Response body for application/search invokes (Adaptive Card dynamic
+    # typeahead Input.ChoiceSet queries). results accepts SearchInvokeResult
+    # objects or {title:, value:} hashes.
+    class SearchResponse
+      def initialize(results, status_code: 200)
+        @results = results
+        @status_code = status_code
+      end
+
+      def to_h
+        {
+          "statusCode" => @status_code,
+          "type" => "application/vnd.microsoft.search.searchResponse",
+          "value" => {
+            "results" => Array(@results).map do |result|
+              body = result.is_a?(Hash) ? result : result.to_h
+              Common::Hashes.deep_stringify_keys(body)
+            end
+          }
+        }
+      end
+    end
+  end
+end

data/lib/teams/app.rb

@@ -5,6 +5,9 @@ require "logger"
 module Teams
   class App
     DEFAULT_MESSAGING_ENDPOINT = "/api/messages"
+    DANGEROUSLY_ALLOW_UNAUTHENTICATED_REQUESTS_ENV_VAR = "DANGEROUSLY_ALLOW_UNAUTHENTICATED_REQUESTS"
+    TRUE_ENV_VALUES = %w[1 true yes on].freeze
+    FALSE_ENV_VALUES = %w[0 false no off].freeze
 
     attr_reader :api, :logger, :storage, :messaging_endpoint, :default_connection_name, :graph
 
@@ -22,7 +25,8 @@ module Teams
       storage: Storage::MemoryStore.new,
       api: nil,
       token_manager: nil,
-      skip_auth: false,
+      dangerously_allow_unauthenticated_requests: nil,
+      skip_auth: nil,
       messaging_endpoint: DEFAULT_MESSAGING_ENDPOINT,
       default_connection_name: "graph"
     )
@@ -33,7 +37,9 @@ module Teams
       @logger = logger
       @storage = storage
       @cloud = cloud
-      @skip_auth = skip_auth
+      @dangerously_allow_unauthenticated_requests = resolve_unauthenticated_requests_option(
+        dangerously_allow_unauthenticated_requests, skip_auth
+      )
       @messaging_endpoint = normalize_messaging_endpoint(messaging_endpoint)
       @router = Router.new
 
@@ -140,6 +146,14 @@ module Teams
       self
     end
 
+    # application/search invokes from Adaptive Card dynamic typeahead
+    # Input.ChoiceSet queries; the handler's return (Api::SearchResponse or
+    # hash) becomes the invoke response body.
+    def on_card_search(&block)
+      @router.on_card_search(&block)
+      self
+    end
+
     # Called with (ctx, token_response) whenever a sign-in completes through
     # the default token-exchange or verify-state handlers.
     def on_sign_in(&block)
@@ -206,6 +220,21 @@ module Teams
       self
     end
 
+    # conversationUpdate activities plus their channel/team lifecycle
+    # sub-events (on_channel_created, on_team_renamed, ...), routed by
+    # channelData.eventType with the Python method names.
+    def on_conversation_update(&block)
+      @router.on_conversation_update(&block)
+      self
+    end
+
+    Router::CONVERSATION_UPDATE_EVENTS.each_key do |method_name|
+      define_method(method_name) do |&block|
+        @router.public_send(method_name, &block)
+        self
+      end
+    end
+
     # Message extension handlers (on_message_ext_query, on_message_ext_submit,
     # on_message_ext_open, ...) route the composeExtension/* invokes with the
     # TypeScript/Python route names. Handler return values (typed responses
@@ -326,7 +355,8 @@ module Teams
     # ending in ctx.post must not leak the SentActivity into the response.
     def invoke_response_body(result)
       case result
-      when Api::TaskModuleResponse, Api::MessagingExtensionResponse, Api::MessagingExtensionActionResponse
+      when Api::TaskModuleResponse, Api::MessagingExtensionResponse, Api::MessagingExtensionActionResponse,
+           Api::SearchResponse
         result.to_h
       when Hash
         Common::Hashes.deep_stringify_keys(result)
@@ -487,28 +517,53 @@ module Teams
       end
     end
 
+    # Resolves the auth-bypass setting like the Python SDK: the explicit
+    # option wins, then the deprecated skip_auth alias, then the env var,
+    # defaulting to false. Passing skip_auth always warns, even when the
+    # new option overrides it.
+    def resolve_unauthenticated_requests_option(explicit, skip_auth)
+      unless skip_auth.nil?
+        warn("skip_auth is deprecated; use dangerously_allow_unauthenticated_requests instead.", uplevel: 2)
+      end
+      return explicit unless explicit.nil?
+      return skip_auth unless skip_auth.nil?
+
+      parse_bool_env_var(DANGEROUSLY_ALLOW_UNAUTHENTICATED_REQUESTS_ENV_VAR) || false
+    end
+
+    def parse_bool_env_var(name)
+      value = ENV[name].to_s.strip.downcase
+      return nil if value.empty?
+      return true if TRUE_ENV_VALUES.include?(value)
+      return false if FALSE_ENV_VALUES.include?(value)
+
+      raise ArgumentError, "#{name} must be a boolean value: true/false, 1/0, yes/no, or on/off."
+    end
+
     # The same two startup warnings the TypeScript, Python, and .NET SDKs
     # log when no credentials are configured. Settled 2026-07-12: exact
-    # upstream branches only; credentials-plus-skip_auth stays silent like
+    # upstream branches only; credentials-plus-bypass stays silent like
     # the other SDKs.
     def warn_missing_credentials
       return if @token_manager.client_id
 
-      if @skip_auth
+      if @dangerously_allow_unauthenticated_requests
         logger&.warn(
           "No credentials configured (CLIENT_ID / CLIENT_SECRET / TENANT_ID), " \
-          "but skip_auth is enabled. Bot will accept unauthenticated requests on #{@messaging_endpoint}."
+          "but dangerously_allow_unauthenticated_requests is enabled. " \
+          "Bot will accept unauthenticated requests on #{@messaging_endpoint}."
         )
       else
         logger&.warn(
-          "No credentials configured and skip_auth is not enabled. All incoming requests will be rejected. " \
-          "Configure client authentication to securely receive messages, or set skip_auth: true for local development."
+          "No credentials configured and dangerously_allow_unauthenticated_requests is not enabled. " \
+          "All incoming requests will be rejected. Configure client authentication to securely receive " \
+          "messages, or set dangerously_allow_unauthenticated_requests: true for local development."
         )
       end
     end
 
     def validate_inbound!(env, activity)
-      return if @skip_auth
+      return if @dangerously_allow_unauthenticated_requests
 
       raise AuthenticationError, "CLIENT_ID is required for inbound validation" unless @jwt_validator
 

data/lib/teams/http_stream.rb

@@ -356,6 +356,9 @@ module Teams
       body = activity.dup
       body["from"] = conversation_reference.bot.to_h if conversation_reference.bot
       body["conversation"] = conversation_reference.conversation.to_h
+      # Every streamed activity replies to the inbound message, restoring
+      # Bot Framework v1 threading behavior.
+      body["replyToId"] = conversation_reference.activity_id if conversation_reference.activity_id
 
       # Stream chunks and the streamed final carry a streaminfo entity and are
       # always created; only the timed-out in-place final routes through update.

data/lib/teams/router.rb

@@ -72,6 +72,12 @@ module Teams
       register("message.submit", invoke_selector("message/submitAction"), &block)
     end
 
+    # application/search invokes - Adaptive Card dynamic typeahead
+    # Input.ChoiceSet queries (choices.data / Data.Query).
+    def on_card_search(&block)
+      register("card.search", invoke_selector("application/search"), &block)
+    end
+
     # message/submitAction invokes whose actionName is "feedback" - the
     # submissions from add_feedback's thumbs up/down UI.
     def on_message_submit_feedback(&block)
@@ -90,6 +96,32 @@ module Teams
       register("meeting_end", event_selector("application/vnd.microsoft.meetingEnd"), &block)
     end
 
+    # conversationUpdate activities and their channel/team lifecycle
+    # sub-events, routed by channelData.eventType with the Python method
+    # names (the eventType literals are shared by all three SDKs).
+    def on_conversation_update(&block)
+      register("conversation_update", ->(activity) { activity.type == "conversationUpdate" }, &block)
+    end
+
+    CONVERSATION_UPDATE_EVENTS = {
+      "on_channel_created" => "channelCreated",
+      "on_channel_deleted" => "channelDeleted",
+      "on_channel_renamed" => "channelRenamed",
+      "on_channel_restored" => "channelRestored",
+      "on_team_archived" => "teamArchived",
+      "on_team_deleted" => "teamDeleted",
+      "on_team_hard_deleted" => "teamHardDeleted",
+      "on_team_renamed" => "teamRenamed",
+      "on_team_restored" => "teamRestored",
+      "on_team_unarchived" => "teamUnarchived"
+    }.freeze
+
+    CONVERSATION_UPDATE_EVENTS.each do |method_name, event_type|
+      define_method(method_name) do |&block|
+        register(event_type, conversation_update_selector(event_type), &block)
+      end
+    end
+
     # Message extension (compose extension) invoke routes, using the same
     # route names as the TypeScript and Python SDKs.
     MESSAGE_EXTENSION_ROUTES = {
@@ -152,6 +184,12 @@ module Teams
       ->(activity) { activity.type == "event" && activity.name == event_name }
     end
 
+    def conversation_update_selector(event_type)
+      lambda do |activity|
+        activity.type == "conversationUpdate" && activity.channel_data.event_type == event_type
+      end
+    end
+
     def dialog_selector(invoke_name, key, expected)
       lambda do |activity|
         next false unless activity.invoke? && activity.name == invoke_name

data/lib/teams/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Teams
-  VERSION = "2.0.1"
+  VERSION = "2.0.2"
 end

data/lib/teams.rb

@@ -12,6 +12,7 @@ require_relative "teams/api/account"
 require_relative "teams/api/conversation_account"
 require_relative "teams/api/conversation_resource"
 require_relative "teams/api/paged_members_result"
+require_relative "teams/api/app_info"
 require_relative "teams/api/tenant_info"
 require_relative "teams/api/team_info"
 require_relative "teams/api/team_details"
@@ -27,6 +28,7 @@ require_relative "teams/api/sent_activity"
 require_relative "teams/api/citation_appearance"
 require_relative "teams/api/task_module"
 require_relative "teams/api/message_extension"
+require_relative "teams/api/search"
 require_relative "teams/activity"
 require_relative "teams/activity_context"
 require_relative "teams/function_context"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: teams_rb
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.0.2
 platform: ruby
 authors:
 - Devran Cosmo Uenal
@@ -138,6 +138,7 @@ files:
 - lib/teams/activity_context.rb
 - lib/teams/api/account.rb
 - lib/teams/api/activity_value.rb
+- lib/teams/api/app_info.rb
 - lib/teams/api/bot_sign_in_client.rb
 - lib/teams/api/channel_data.rb
 - lib/teams/api/channel_info.rb
@@ -158,6 +159,7 @@ files:
 - lib/teams/api/paged_members_result.rb
 - lib/teams/api/quoted_reply_entity.rb
 - lib/teams/api/reaction_client.rb
+- lib/teams/api/search.rb
 - lib/teams/api/sent_activity.rb
 - lib/teams/api/task_module.rb
 - lib/teams/api/team_client.rb