chat_sdk 1.0.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ffe997e2fbdfc4703e3a9773078a7e4ca8922cdae4cde900e027218c69b28c17
-  data.tar.gz: 8ad63e88e6e6a5d7a34b1d8b8a7b91c77eb1991f78290656e2d202909a80557b
+  metadata.gz: dc45b8149b772db87ae0793f070a3f068353ef09a177d59c3526eb0ec37d1fb9
+  data.tar.gz: 16eb68d587eb53a43337f22dd2cd7d5b564383d892ecda9b64b77b5ae45a05a0
 SHA512:
-  metadata.gz: 040a24f524747ddd7a85a9ac1c655aca1066eab185f005a64b08c7d3be336570fb822d6f6f29e6a87bf38b14487d52b34e093081fc5121cb4b2b875e878b79d6
-  data.tar.gz: 239851288fb9f1fe6264d8c1c0e21c6db5d3487a90fadad8042c8e077980251d486fccf102e75f5ecda933d5c2a51ed621577a7cf248609b72194d3f847ee4a2
+  metadata.gz: 7a6cb0121846bf8a75b849f0d6bedfc48601c738dba99c3ad838ecdcb3b31fd7b4a27cd16bfa75cee66a4f70e62b62ae1c4730546b22f430e72d1af1bf6219c2
+  data.tar.gz: 602d33c5bba332dac427d61e8566c396f10c057e6b17a3422d1ab4846e4d7e8857ece123b50d2d357e310072f119bee00436db593e6138e46aabc34ba65f777c

data/lib/chat_sdk/adapter/base.rb

@@ -22,6 +22,10 @@ module ChatSDK
         nil
       end
 
+      def webhook_response(_events)
+        nil
+      end
+
       def parse_events(rack_request)
         raise NotImplementedError
       end
@@ -31,12 +35,22 @@ module ChatSDK
         raise NotImplementedError
       end
 
-      def edit_message(channel_id:, message_id:, message:)
+      def reply_message(channel_id:, message_id:, message:, thread_id: nil)
+        require_capability!(:replies)
+        raise NotImplementedError
+      end
+
+      def mark_as_read(channel_id:, message_id:, thread_id: nil, message: nil)
+        require_capability!(:read_receipts)
+        raise NotImplementedError
+      end
+
+      def edit_message(channel_id:, message_id:, message:, thread_id: nil)
         require_capability!(:edit_messages)
         raise NotImplementedError
       end
 
-      def delete_message(channel_id:, message_id:)
+      def delete_message(channel_id:, message_id:, thread_id: nil)
         require_capability!(:delete_messages)
         raise NotImplementedError
       end
@@ -51,12 +65,12 @@ module ChatSDK
         raise NotImplementedError
       end
 
-      def add_reaction(channel_id:, message_id:, emoji:)
+      def add_reaction(channel_id:, message_id:, emoji:, thread_id: nil)
         require_capability!(:reactions)
         raise NotImplementedError
       end
 
-      def remove_reaction(channel_id:, message_id:, emoji:)
+      def remove_reaction(channel_id:, message_id:, emoji:, thread_id: nil)
         require_capability!(:reactions)
         raise NotImplementedError
       end
@@ -71,16 +85,30 @@ module ChatSDK
         raise NotImplementedError
       end
 
+      def fetch_channel_messages(channel_id:, cursor: nil, limit: 50)
+        require_capability!(:message_history)
+        fetch_messages(channel_id: channel_id, cursor: cursor, limit: limit)
+      end
+
+      def list_threads(channel_id:, cursor: nil, limit: 50)
+        require_capability!(:threads)
+        raise NotImplementedError
+      end
+
       def open_modal(trigger_id:, modal:)
         require_capability!(:modals)
         raise NotImplementedError
       end
 
-      def start_typing(channel_id:, thread_id: nil)
+      def start_typing(channel_id:, thread_id: nil, message_id: nil)
         require_capability!(:typing_indicator)
         raise NotImplementedError
       end
 
+      def concurrency_scope(_event)
+        nil
+      end
+
       def mention(user_id)
         raise NotImplementedError
       end

data/lib/chat_sdk/adapter/capabilities.rb

@@ -7,7 +7,7 @@ module ChatSDK
         edit_messages delete_messages ephemeral_messages
         file_uploads reactions modals typing_indicator
         streaming_edit threads direct_messages
-        scheduled_messages message_history
+        scheduled_messages message_history replies read_receipts
       ].freeze
 
       def self.included(base)

data/lib/chat_sdk/adapter/invocation.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module ChatSDK
+  module Adapter
+    module Invocation
+      private
+
+      def call_adapter(method_name, **kwargs)
+        params = adapter.method(method_name).parameters
+        accepts_thread_id = params.any? do |type, name|
+          type == :keyrest || (%i[key keyreq].include?(type) && name == :thread_id)
+        end
+        kwargs.delete(:thread_id) unless accepts_thread_id
+        adapter.public_send(method_name, **kwargs)
+      end
+    end
+  end
+end

data/lib/chat_sdk/ai/conversation_scope.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module ChatSDK
+  module AI
+    module ConversationScope
+      THREAD_KEY = :chat_sdk_ai_conversation_scope
+      ACTIVE_KEY = :chat_sdk_ai_conversation_scope_active
+
+      class << self
+        def current
+          ::Thread.current[THREAD_KEY]
+        end
+
+        def active?
+          !!::Thread.current[ACTIVE_KEY]
+        end
+
+        def with(thread)
+          previous = current
+          previous_active = active?
+          ::Thread.current[THREAD_KEY] = scope_for(thread)
+          ::Thread.current[ACTIVE_KEY] = true
+          yield
+        ensure
+          ::Thread.current[THREAD_KEY] = previous
+          ::Thread.current[ACTIVE_KEY] = previous_active
+        end
+
+        def scope_for(value)
+          return if value.nil?
+          return value.transform_keys(&:to_sym) if value.is_a?(Hash)
+
+          scope = {
+            adapter_name: value.adapter.name.to_sym,
+            channel_id: value.respond_to?(:channel_id) ? value.channel_id.to_s : value.id.to_s,
+            thread_id: value.is_a?(ChatSDK::Thread) ? value.id.to_s : nil
+          }
+          scope[:message_id] = value.current_message.id if value.respond_to?(:current_message) && value.current_message
+          scope
+        end
+      end
+    end
+  end
+end

data/lib/chat_sdk/ai/converter.rb

@@ -10,7 +10,7 @@ module ChatSDK
         def to_ai_messages(messages, include_names: false, &transform)
           messages
             .sort_by { |m| m.timestamp || m.id }
-            .reject { |m| m.text.nil? || m.text.strip.empty? }
+            .reject { |m| blank_message?(m) }
             .filter_map { |m| convert_message(m, include_names: include_names, &transform) }
         end
 
@@ -19,16 +19,22 @@ module ChatSDK
         def convert_message(message, include_names: false)
           role = message.author&.bot? ? ROLE_ASSISTANT : ROLE_USER
 
-          content = message.text
+          content = message.text.to_s
           if include_names && role == ROLE_USER && message.author
             content = "[#{message.author.name}]: #{content}"
           end
 
           result = {role: role, content: content}
 
-          if message.attachments&.any?
-            parts = [{type: "text", text: content}]
-            message.attachments.each do |att|
+          if message.attachments&.any? || message.links&.any?
+            parts = []
+            parts << {type: "text", text: content} unless content.strip.empty?
+            Array(message.links).each do |link|
+              url = link.is_a?(Hash) ? (link[:url] || link["url"]) : link.to_s
+              title = link.is_a?(Hash) ? (link[:title] || link["title"]) : nil
+              parts << {type: "text", text: title ? "[#{title}](#{url})" : url}
+            end
+            Array(message.attachments).each do |att|
               parts << attachment_to_part(att)
             end
             result[:content] = parts
@@ -38,6 +44,11 @@ module ChatSDK
           result
         end
 
+        def blank_message?(message)
+          text_blank = message.text.nil? || message.text.strip.empty?
+          text_blank && !message.attachments&.any? && !message.links&.any?
+        end
+
         def attachment_to_part(attachment)
           if attachment.is_a?(Hash)
             mime = attachment[:mime_type] || attachment[:content_type] || "application/octet-stream"

data/lib/chat_sdk/ai/tool_builder.rb

@@ -72,6 +72,7 @@ module ChatSDK
             properties: {
               adapter_name: {type: "string", description: "Adapter name"},
               channel_id: {type: "string", description: "Channel ID"},
+              thread_id: {type: "string", description: "Thread ID (optional)"},
               message_id: {type: "string", description: "Message ID to edit"},
               text: {type: "string", description: "New message text"}
             },
@@ -86,6 +87,7 @@ module ChatSDK
             properties: {
               adapter_name: {type: "string", description: "Adapter name"},
               channel_id: {type: "string", description: "Channel ID"},
+              thread_id: {type: "string", description: "Thread ID (optional)"},
               message_id: {type: "string", description: "Message ID to delete"}
             },
             required: %w[adapter_name channel_id message_id]
@@ -99,6 +101,7 @@ module ChatSDK
             properties: {
               adapter_name: {type: "string", description: "Adapter name"},
               channel_id: {type: "string", description: "Channel ID"},
+              thread_id: {type: "string", description: "Thread ID (optional)"},
               message_id: {type: "string", description: "Message ID"},
               emoji: {type: "string", description: "Emoji name (e.g., 'thumbsup')"}
             },
@@ -113,6 +116,7 @@ module ChatSDK
             properties: {
               adapter_name: {type: "string", description: "Adapter name"},
               channel_id: {type: "string", description: "Channel ID"},
+              thread_id: {type: "string", description: "Thread ID (optional)"},
               message_id: {type: "string", description: "Message ID"},
               emoji: {type: "string", description: "Emoji name"}
             },
@@ -127,7 +131,8 @@ module ChatSDK
             properties: {
               adapter_name: {type: "string", description: "Adapter name"},
               channel_id: {type: "string", description: "Channel ID"},
-              thread_id: {type: "string", description: "Thread ID (optional)"}
+              thread_id: {type: "string", description: "Thread ID (optional)"},
+              message_id: {type: "string", description: "Current message ID (optional)"}
             },
             required: %w[adapter_name channel_id]
           },
@@ -145,10 +150,21 @@ module ChatSDK
         tool_names = PRESETS[@preset]
         tool_names.each_with_object({}) do |name, tools|
           defn = TOOL_DEFINITIONS[name].dup
-          defn[:requires_approval] = @require_approval && !defn[:read_only]
+          defn[:requires_approval] = approval_required?(name, defn)
           tools[name] = defn
         end
       end
+
+      private
+
+      def approval_required?(name, definition)
+        return false if definition[:read_only] || @require_approval == false
+        return true unless @require_approval.is_a?(Hash)
+
+        @require_approval.fetch(name) do
+          @require_approval.fetch(name.to_s, true)
+        end
+      end
     end
   end
 end

data/lib/chat_sdk/ai/tool_executor.rb

@@ -3,8 +3,13 @@
 module ChatSDK
   module AI
     class ToolExecutor
-      def initialize(chat:)
+      def initialize(chat:, scope: nil, strict_scope: false)
         @chat = chat
+        @scope = (scope == false) ? false : (ConversationScope.scope_for(scope) || ConversationScope.current&.dup)
+        @created_in_handler = ConversationScope.active?
+        validate_scope!(@scope) if @scope
+        @strict_scope = strict_scope
+        @warned_unscoped = {}
       end
 
       def execute(tool_name, arguments)
@@ -13,6 +18,7 @@ module ChatSDK
 
         args = arguments.transform_keys(&:to_sym)
         adapter_name = args[:adapter_name].to_sym
+        guard_scope!(tool_name, adapter_name, args)
 
         send(:"execute_#{tool_name}", adapter_name, args)
       end
@@ -40,54 +46,102 @@ module ChatSDK
 
       def execute_post_message(adapter_name, args)
         channel = @chat.channel(args[:channel_id], adapter_name: adapter_name)
+        message = ChatSDK::PostableMessage.new(text: args[:text], ai_generated: true)
         if args[:thread_id]
           thread = channel.thread(args[:thread_id])
-          result = thread.post(args[:text])
+          result = thread.post(message)
         else
-          result = channel.post(args[:text])
+          result = channel.post(message)
         end
         {id: result.id, text: args[:text]}
       end
 
       def execute_send_direct_message(adapter_name, args)
         dm_channel = @chat.open_dm(args[:user_id], adapter_name: adapter_name)
-        result = dm_channel.post(args[:text])
+        result = dm_channel.post(ChatSDK::PostableMessage.new(text: args[:text], ai_generated: true))
         {id: result.id, channel_id: dm_channel.id}
       end
 
       def execute_edit_message(adapter_name, args)
-        thread = @chat.channel(args[:channel_id], adapter_name: adapter_name).thread(args[:channel_id])
-        thread.edit(args[:message_id], args[:text])
+        thread = target_thread(adapter_name, args)
+        thread.edit(args[:message_id], ChatSDK::PostableMessage.new(text: args[:text], ai_generated: true))
         {success: true}
       end
 
       def execute_delete_message(adapter_name, args)
-        thread = @chat.channel(args[:channel_id], adapter_name: adapter_name).thread(args[:channel_id])
+        thread = target_thread(adapter_name, args)
         thread.delete(args[:message_id])
         {success: true}
       end
 
       def execute_add_reaction(adapter_name, args)
-        thread = @chat.channel(args[:channel_id], adapter_name: adapter_name).thread(args[:channel_id])
+        thread = target_thread(adapter_name, args)
         thread.react(args[:message_id], args[:emoji])
         {success: true}
       end
 
       def execute_remove_reaction(adapter_name, args)
-        thread = @chat.channel(args[:channel_id], adapter_name: adapter_name).thread(args[:channel_id])
+        thread = target_thread(adapter_name, args)
         thread.unreact(args[:message_id], args[:emoji])
         {success: true}
       end
 
       def execute_start_typing(adapter_name, args)
         adapter = @chat.adapter(adapter_name)
-        adapter.start_typing(channel_id: args[:channel_id], thread_id: args[:thread_id])
+        scoped_message_id = @scope.is_a?(Hash) ? @scope[:message_id] : nil
+        message_id = args[:message_id] || ConversationScope.current&.[](:message_id) || scoped_message_id
+        adapter.start_typing(channel_id: args[:channel_id], thread_id: args[:thread_id], message_id: message_id)
         {success: true}
       end
 
       def serialize_messages(messages)
         messages.map { |m| {id: m.id, text: m.text, author: m.author&.name, timestamp: m.timestamp} }
       end
+
+      def target_thread(adapter_name, args)
+        channel = @chat.channel(args[:channel_id], adapter_name: adapter_name)
+        channel.thread(args[:thread_id] || args[:channel_id])
+      end
+
+      def guard_scope!(tool_name, adapter_name, args)
+        return if @scope == false
+
+        scope = @scope || ConversationScope.current
+        unless scope
+          if ConversationScope.active? || @created_in_handler
+            raise ChatSDK::Error, "AI tool call requires an explicit scope when run inside a handler without a conversation"
+          end
+
+          unless @warned_unscoped[tool_name]
+            ChatSDK::Log.warn("AI tool ran without a conversation scope; pass scope: to create_executor to confine access")
+            @warned_unscoped[tool_name] = true
+          end
+
+          return
+        end
+
+        return if tool_name == :send_direct_message
+
+        target_channel = args[:channel_id].to_s
+        target_thread = args[:thread_id]&.to_s
+        same_channel = adapter_name == scope.fetch(:adapter_name).to_sym && target_channel == scope.fetch(:channel_id).to_s
+        scope_is_channel = scope[:thread_id].nil?
+        in_scope = same_channel && (!@strict_scope || scope_is_channel || target_thread == scope[:thread_id].to_s)
+        return if in_scope
+
+        target = [adapter_name, target_channel, target_thread].compact.join(":")
+        active = [scope[:adapter_name], scope[:channel_id], scope[:thread_id]].compact.join(":")
+        raise ChatSDK::Error, "AI tool call blocked: executor is scoped to #{active.inspect}, but targeted #{target.inspect}"
+      end
+
+      def validate_scope!(scope)
+        %i[channel_id thread_id].each do |key|
+          next if key == :thread_id && scope[key].nil?
+          next unless scope.key?(key) && scope[key].to_s.empty?
+
+          raise ChatSDK::ConfigurationError, "AI tool scope #{key} must not be empty"
+        end
+      end
     end
   end
 end

data/lib/chat_sdk/ai.rb

@@ -11,8 +11,8 @@ module ChatSDK
         ToolBuilder.new(preset: preset, require_approval: require_approval).build
       end
 
-      def create_executor(chat:)
-        ToolExecutor.new(chat: chat)
+      def create_executor(chat:, scope: nil, strict_scope: false)
+        ToolExecutor.new(chat: chat, scope: scope, strict_scope: strict_scope)
       end
     end
   end

data/lib/chat_sdk/author.rb

@@ -2,14 +2,17 @@
 
 module ChatSDK
   class Author
-    attr_reader :id, :name, :platform, :locale, :raw
+    attr_reader :id, :name, :platform, :locale, :email, :raw
 
-    def initialize(id:, name:, platform:, bot: false, locale: nil, raw: nil)
+    def initialize(id:, name:, platform:, bot: false, me: false, system: false, locale: nil, email: nil, raw: nil)
       @id = id
       @name = name
       @platform = platform
       @bot = bot
+      @me = !!me
+      @system = system
       @locale = locale
+      @email = email
       @raw = raw
     end
 
@@ -17,6 +20,14 @@ module ChatSDK
       @bot
     end
 
+    def me?
+      @me
+    end
+
+    def system?
+      @system
+    end
+
     def ==(other)
       other.is_a?(Author) && id == other.id && platform == other.platform
     end

data/lib/chat_sdk/cards/actions_context.rb

@@ -9,15 +9,21 @@ module ChatSDK
         @nodes = []
       end
 
-      def button(text, id:, style: nil, value: nil)
+      def button(text, id:, style: nil, value: nil, tooltip: nil, visible_to: nil)
         attrs = {text: text, id: id}
         attrs[:style] = style if style
         attrs[:value] = value if value
+        attrs[:tooltip] = tooltip if tooltip
+        attrs[:visible_to] = visible_to if visible_to
         @nodes << Node.new(:button, attributes: attrs)
       end
 
-      def link_button(text, url:)
-        @nodes << Node.new(:link_button, attributes: {text: text, url: url})
+      def link_button(text, url:, id: nil, tooltip: nil, visible_to: nil)
+        attrs = {text: text, url: url}
+        attrs[:id] = id if id
+        attrs[:tooltip] = tooltip if tooltip
+        attrs[:visible_to] = visible_to if visible_to
+        @nodes << Node.new(:link_button, attributes: attrs)
       end
 
       def select(id:, placeholder: nil, &block)

data/lib/chat_sdk/cards/builder.rb

@@ -3,9 +3,12 @@
 module ChatSDK
   module Cards
     class Builder
-      def initialize(title: nil, subtitle: nil, &block)
+      RESERVED_TEXT_INPUT_IDS = %w[actionId value msteams].freeze
+
+      def initialize(title: nil, subtitle: nil, width: nil, &block)
         @title = title
         @subtitle = subtitle
+        @width = width
         @children = []
         instance_eval(&block) if block
       end
@@ -14,6 +17,7 @@ module ChatSDK
         attrs = {}
         attrs[:title] = @title if @title
         attrs[:subtitle] = @subtitle if @subtitle
+        attrs[:width] = @width if @width
         Node.new(:card, attributes: attrs, children: @children)
       end
 
@@ -29,6 +33,17 @@ module ChatSDK
         @children << Node.new(:image, attributes: {url: url, alt: alt})
       end
 
+      def text_input(id:, label:, placeholder: nil, multiline: false, optional: false, value: nil)
+        if RESERVED_TEXT_INPUT_IDS.include?(id.to_s)
+          raise ArgumentError, "Text input id #{id.inspect} is reserved"
+        end
+
+        attrs = {id: id, label: label, multiline: multiline, optional: optional}
+        attrs[:placeholder] = placeholder if placeholder
+        attrs[:value] = value unless value.nil?
+        @children << Node.new(:text_input, attributes: attrs)
+      end
+
       def fields(&block)
         ctx = FieldsContext.new
         ctx.instance_eval(&block)
@@ -47,6 +62,28 @@ module ChatSDK
         ctx.instance_eval(&block)
         @children << Node.new(:actions, children: ctx.nodes)
       end
+
+      def table(headers:, rows:, align: nil, caption: nil, page_size: nil, widths: nil, grid_lines: nil, grid_style: nil, vertical_align: nil)
+        attrs = {headers: headers, rows: rows}
+        attrs[:align] = align if align
+        attrs[:caption] = caption if caption
+        attrs[:page_size] = page_size if page_size
+        attrs[:widths] = widths if widths
+        attrs[:grid_lines] = grid_lines unless grid_lines.nil?
+        attrs[:grid_style] = grid_style if grid_style
+        attrs[:vertical_align] = vertical_align if vertical_align
+        @children << Node.new(:table, attributes: attrs)
+      end
+
+      def chart(title:, type:, segments: nil, categories: nil, series: nil, x_label: nil, y_label: nil)
+        attrs = {title: title, chart_type: type}
+        attrs[:segments] = segments if segments
+        attrs[:categories] = categories if categories
+        attrs[:series] = series if series
+        attrs[:x_label] = x_label if x_label
+        attrs[:y_label] = y_label if y_label
+        @children << Node.new(:chart, attributes: attrs)
+      end
     end
   end
 end

data/lib/chat_sdk/cards/node.rb

@@ -31,11 +31,47 @@ module ChatSDK
             ["#{node.attributes[:label]}: #{node.attributes[:value]}"]
           when :button, :link_button
             [node.attributes[:text]]
+          when :text_input
+            [node.attributes[:label]]
+          when :table
+            table_text(node)
+          when :chart
+            chart_text(node)
           else
             collect_text(node.children)
           end
         end
       end
+
+      def table_text(node)
+        headers = Array(node.attributes[:headers]).map(&:to_s)
+        rows = Array(node.attributes[:rows]).map { |row| Array(row).map(&:to_s) }
+        lines = []
+        lines << node.attributes[:caption].to_s if node.attributes[:caption]
+        lines << headers.join(" | ") unless headers.empty?
+        lines.concat(rows.map { |row| row.join(" | ") })
+        lines
+      end
+
+      def chart_text(node)
+        lines = [node.attributes[:title].to_s]
+        if node.attributes[:chart_type].to_sym == :pie
+          lines.concat(Array(node.attributes[:segments]).map do |segment|
+            "#{value_for(segment, :label)}: #{value_for(segment, :value)}"
+          end)
+        else
+          Array(node.attributes[:series]).each do |series|
+            data = value_for(series, :data) || []
+            points = data.map { |point| "#{value_for(point, :label)}=#{value_for(point, :value)}" }
+            lines << "#{value_for(series, :name)}: #{points.join(", ")}"
+          end
+        end
+        lines
+      end
+
+      def value_for(hash, key)
+        hash[key] || hash[key.to_s]
+      end
     end
   end
 end

data/lib/chat_sdk/cards/renderer.rb

@@ -15,7 +15,10 @@ module ChatSDK
         when :actions then render_actions(node)
         when :button then "[#{node.attributes[:text]}]"
         when :link_button then "[#{node.attributes[:text]}](#{node.attributes[:url]})"
+        when :text_input then node.attributes[:label]
         when :select then "_#{node.attributes[:placeholder] || "Select"}_"
+        when :table then render_table(node)
+        when :chart then render_chart(node)
         else ""
         end
       end
@@ -44,6 +47,23 @@ module ChatSDK
       def render_actions(node)
         node.children.map { |c| render(c) }.join(" | ")
       end
+
+      def render_table(node)
+        headers = Array(node.attributes[:headers]).map(&:to_s)
+        rows = Array(node.attributes[:rows]).map { |row| Array(row).map(&:to_s) }
+        parts = []
+        parts << node.attributes[:caption].to_s if node.attributes[:caption]
+        unless headers.empty?
+          parts << "| #{headers.join(" | ")} |"
+          parts << "| #{headers.map { "---" }.join(" | ")} |"
+        end
+        parts.concat(rows.map { |row| "| #{row.join(" | ")} |" })
+        parts.join("\n")
+      end
+
+      def render_chart(node)
+        node.fallback_text
+      end
     end
   end
 end

data/lib/chat_sdk/channel.rb

@@ -19,6 +19,14 @@ module ChatSDK
       ChatSDK::Thread.new(id: thread_id, channel_id: id, adapter: adapter, chat: chat)
     end
 
+    def messages(cursor: nil, limit: 50)
+      adapter.fetch_channel_messages(channel_id: id, cursor: cursor, limit: limit)
+    end
+
+    def threads(cursor: nil, limit: 50)
+      adapter.list_threads(channel_id: id, cursor: cursor, limit: limit)
+    end
+
     def ==(other)
       other.is_a?(Channel) && id == other.id
     end