slack-ruby-client 2.5.2 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a618c19aef053b39b70616b4c2965e367b7c7a9607091501626ca0e8c1112d49
-  data.tar.gz: 0f19c3999ef2b3129c654baa30517c0863fe8b719e14f922d8106a529395e2e5
+  metadata.gz: 47ff28dd66be50f30523812cdd1ab26e1910d68161fc59006e1702636667f0ff
+  data.tar.gz: d2419d167109916aa49308519150e673c1fde0464edd941f0912ba5b14962da4
 SHA512:
-  metadata.gz: dfb4b2f108f3c66a7f8738cccb2a3831f6b8443fec90f14163caa9875febb581eac5771d4dfdde784f3cfc4ae7d8857de873b6b9603136074bf1eb1a5837dbc8
-  data.tar.gz: 3bf0ad65a3fbe56ac30fc304671b17ef982e1b874457ce4721f81c1767c8698e53373a9e38d3a9cdb11a9b600287109dc15f420607bdd38e194b507f416b9845
+  metadata.gz: 33ffb3d98c4e8445757bc1c457df69ddd1e67035dddd51c25f50dbf1c970cce4ec71af655ccc22b4e02e12ee73bbac7d2e5ba09f5795616270b83ec346743a80
+  data.tar.gz: 0cfcfa4746617cccb864c533dd62455d6ce058632b0293febfff7357fbf77610298a008ff52b52caaea2d857c4a162202b8e0a0f1deea0ea29a1232222653a4d

data/.github/workflows/test.yml

@@ -41,6 +41,7 @@ jobs:
           parallel: true
           github-token: ${{ secrets.GITHUB_TOKEN }}
           flag-name: run-${{ matrix.entry.ruby }}${{ matrix.entry.concurrency && '-'}}${{ matrix.entry.concurrency }}
+          allow-empty: ${{ matrix.entry.ignore || false }}
 
   finish:
     name: coveralls

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+### 2.6.0 (2025/05/24)
+
+* [#549](https://github.com/slack-ruby/slack-ruby-client/pull/549): Add group ID formatting support for message mentions - [@n0h0](https://github.com/n0h0).
+* [#553](https://github.com/slack-ruby/slack-ruby-client/pull/553): Use `secure_compare` during signature verification - [@hieuk09](https://github.com/hieuk09).
+* [#555](https://github.com/slack-ruby/slack-ruby-client/pull/555): Make page size in resolving IDs configurable - [@eizengan](https://github.com/eizengan).
+* [#547](https://github.com/slack-ruby/slack-ruby-client/pull/547): Update API from [slack-api-ref@1ee282e](https://github.com/slack-ruby/slack-api-ref/commit/1ee282e) - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
+
 ### 2.5.2 (2025/02/19)
 
 * [#548](https://github.com/slack-ruby/slack-ruby-client/pull/548): Fix: `files_upload_v2` with `#channel` - [@dblock](https://github.com/dblock).

data/Gemfile

@@ -14,9 +14,12 @@ end
 
 group :test do
   gem 'activesupport'
+  gem 'base64'
+  gem 'bigdecimal'
   gem 'erubis'
   gem 'faraday-typhoeus'
   gem 'json-schema'
+  gem 'mutex_m'
   gem 'racc'
   gem 'rake', '~> 13'
   gem 'rspec'

data/README.md

@@ -57,6 +57,7 @@ A Ruby client for the Slack [Web](https://api.slack.com/web), [RealTime Messagin
       - [Date and Time Formatting](#date-and-time-formatting)
       - [Channel ID Formatting](#channel-id-formatting)
       - [User ID Formatting](#user-id-formatting)
+      - [Group ID Formatting](#group-id-formatting)
       - [URL Formatting](#url-formatting)
       - [Markdown Formatting](#markdown-formatting)
     - [Parsing Messages](#parsing-messages)
@@ -81,7 +82,7 @@ A Ruby client for the Slack [Web](https://api.slack.com/web), [RealTime Messagin
 
 ## Stable Release
 
-You're reading the documentation for the **stable** release of slack-ruby-client, v2.5.2. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
+You're reading the documentation for the **stable** release of slack-ruby-client. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
 
 ## Installation
 
@@ -178,7 +179,7 @@ client.files_upload_v2(
   # required options
   filename: 'results.pdf', # this is used for the file title, unless a :title option is provided
   content: File.read('/users/me/results.pdf'), # the string contents of the file
-  
+
   # optional options
   channels: ['C000000', 'C000001'], # channel IDs to share the file in (:channel_id, :channel, or :channels are all supported)
   initial_comment: 'Sharing the Q1 results :tada:', # the message that is included with the file share thread
@@ -280,20 +281,22 @@ client = Slack::Web::Client.new(user_agent: 'Slack Ruby Client/1.0')
 
 The following settings are supported.
 
-setting             | description
---------------------|-------------------------------------------------------------------------------------------------
-token               | Slack API token.
-user_agent          | User-agent, defaults to _Slack Ruby Client/version_.
-proxy               | Optional HTTP proxy.
-ca_path             | Optional SSL certificates path.
-ca_file             | Optional SSL certificates file.
-endpoint            | Slack endpoint, default is _https://slack.com/api_.
-logger              | Optional `Logger` instance that logs HTTP requests.
-timeout             | Optional open/read timeout in seconds.
-open_timeout        | Optional connection open timeout in seconds.
-default_page_size   | Optional page size for paginated requests, default is _100_.
-default_max_retries | Optional number of retries for paginated requests, default is _100_.
-adapter             | Optional HTTP adapter to use, defaults to `Faraday.default_adapter`.
+setting                      | description
+-----------------------------|-------------------------------------------------------------------------------------------------
+token                        | Slack API token.
+user_agent                   | User-agent, defaults to _Slack Ruby Client/version_.
+proxy                        | Optional HTTP proxy.
+ca_path                      | Optional SSL certificates path.
+ca_file                      | Optional SSL certificates file.
+endpoint                     | Slack endpoint, default is _https://slack.com/api_.
+logger                       | Optional `Logger` instance that logs HTTP requests.
+timeout                      | Optional open/read timeout in seconds.
+open_timeout                 | Optional connection open timeout in seconds.
+default_page_size            | Optional page size for paginated requests, default is _100_.
+conversations_id_page_size   | Optional page size for conversations_list requests made when calculating conversation id from a conversation name, default is _nil_, which will use the default_page_size.
+users_id_page_size           | Optional page size for users_list requests made when calculating user id from a user name, default is _nil_, which will use the default_page_size.
+default_max_retries          | Optional number of retries for paginated requests, default is _100_.
+adapter                      | Optional HTTP adapter to use, defaults to `Faraday.default_adapter`.
 
 You can also pass request options, including `timeout` and `open_timeout` into individual calls.
 
@@ -665,6 +668,16 @@ Slack::Messages::Formatting.user_link(user_id)
   # => "<@U0000000001>"
 ```
 
+##### Group ID Formatting
+
+If you already know the group name you can just embed it in the message as `@some_group`, but if you only have the ID you can embed it using special syntax which Slack will display as the group name.
+
+```ruby
+group_id = 'S0000000001'
+Slack::Messages::Formatting.group_link(group_id)
+  # => "<!subteam^S0000000001>"
+```
+
 ##### URL Formatting
 
 Slack will automatically parse fully qualified URLs in messages, but you need special formatting to embed a link with different text.

data/bin/commands/admin_conversations.rb

@@ -75,6 +75,17 @@ module Slack
           end
         end
 
+        g.desc 'Create a Salesforce channel for the corresponding object provided.'
+        g.long_desc %( Create a Salesforce channel for the corresponding object provided. )
+        g.command 'createForObjects' do |c|
+          c.flag 'object_id', desc: 'Object / Record ID (15 or 18 digit accepted). See here for how to look up an ID.'
+          c.flag 'salesforce_org_id', desc: 'Salesforce org ID (15 or 18 digit accepted). See here for how to look up Salesforce org ID.'
+          c.flag 'invite_object_team', desc: 'Optional flag to add all team members related to the object to the newly created Salesforce channel. When true, adds a maximum of 100 team members to the channel.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_conversations_createForObjects(options))
+          end
+        end
+
         g.desc 'Delete a public or private channel.'
         g.long_desc %( Delete a public or private channel. )
         g.command 'delete' do |c|
@@ -219,7 +230,7 @@ module Slack
           c.flag 'channel_id', desc: 'The encoded channel_id to add or remove to workspaces.'
           c.flag 'org_channel', desc: 'True if channel has to be converted to an org channel.'
           c.flag 'target_team_ids', desc: 'A comma-separated list of workspaces to which the channel should be shared. Not required if the channel is being shared org-wide.'
-          c.flag 'team_id', desc: 'The workspace to which the channel belongs. Omit this argument if the channel is a cross-workspace shared channel.'
+          c.flag 'team_id', desc: 'The workspace to which the channel belongs if the channel is a local workspace channel. Omit this argument if the channel is a cross-workspace or org-wide shared channel.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_conversations_setTeams(options))
           end

data/bin/commands/admin_users.rb

@@ -44,7 +44,7 @@ module Slack
           c.flag 'include_deactivated_user_workspaces', desc: 'Only applies with org token and no team_id. If true, return workspaces for a user even if they may be deactivated on them. If false, return workspaces for a user only when user is active on them. Default is false.'
           c.flag 'is_active', desc: 'If true, only active users will be returned. If false, only deactivated users will be returned. Default is true.'
           c.flag 'limit', desc: 'Limit for how many users to be retrieved per page.'
-          c.flag 'team_id', desc: 'The ID (T1234) of the workspace. The team_id is required if you use an org-level token.'
+          c.flag 'team_id', desc: 'The ID (T1234) of a workspace. Filters results to just the specified workspace.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_users_list(options))
           end

data/bin/commands/assistant_search.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AssistantSearch methods.'
+      command 'assistant_search' do |g|
+        g.desc 'Searches messages across your Slack organization—perfect for broad, specific, and real-time data retrieval.'
+        g.long_desc %( Searches messages across your Slack organization—perfect for broad, specific, and real-time data retrieval. )
+        g.command 'context' do |c|
+          c.flag 'query', desc: 'User prompt or search query.'
+          c.flag 'action_token', desc: 'Send action_token as received in a message event.'
+          c.flag 'channel_types', desc: 'Mix and match channel types by providing a comma-separated list of any combination of public_channel, private_channel, mpim, im.'
+          c.flag 'content_types', desc: 'Content types to include, a comma-separated list of any combination of messages, files.'
+          c.flag 'context_channel_id', desc: 'Context channel ID to support scoping the search when applicable.'
+          c.flag 'cursor', desc: 'The cursor returned by the API. Leave this blank for the first request, and use this to get the next page of results.'
+          c.flag 'include_bots', desc: 'If you want the results to include bots.'
+          c.flag 'limit', desc: 'Number of results to return, up to a max of 20. Defaults to 20.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.assistant_search_context(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/canvases.rb

@@ -9,6 +9,7 @@ module Slack
         g.desc 'Create canvas for a user'
         g.long_desc %( Create canvas for a user )
         g.command 'create' do |c|
+          c.flag 'channel_id', desc: 'Channel ID of the channel the canvas will be tabbed in. This is a required field for free teams.'
           c.flag 'document_content', desc: 'Structure describing the type and value of the content to create.'
           c.flag 'title', desc: 'Title of the newly created canvas.'
           c.action do |_global_options, options, _args|

data/bin/commands/chat.rb

@@ -87,6 +87,7 @@ module Slack
           c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string.'
           c.flag 'blocks', desc: 'A JSON-based array of structured blocks, presented as a URL-encoded string.'
           c.flag 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
+          c.flag 'agent_message_source_type', desc: 'Identify how the message was posted for agentforce BE logging.'
           c.flag 'as_user', desc: '(Legacy) Pass true to post the message as the authed user instead of as a bot. Defaults to false. Can only be used by classic apps. See legacy as_user parameter below.'
           c.flag 'icon_emoji', desc: 'Emoji to use as the icon for this message. Overrides icon_url.'
           c.flag 'icon_url', desc: 'URL to an image to use as the icon for this message.'

data/bin/commands/conversations_canvases.rb

@@ -11,6 +11,7 @@ module Slack
         g.command 'create' do |c|
           c.flag 'channel_id', desc: 'Channel ID of the channel we create the channel canvas for.'
           c.flag 'document_content', desc: 'Structure describing the type and value of the content to create.'
+          c.flag 'title', desc: 'Title of the newly created canvas.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_canvases_create(options))
           end

data/bin/commands/files.rb

@@ -10,6 +10,7 @@ module Slack
         g.long_desc %( Finishes an upload started with files.getUploadURLExternal )
         g.command 'completeUploadExternal' do |c|
           c.flag 'files', desc: 'Array of file ids and their corresponding (optional) titles.'
+          c.flag 'blocks', desc: 'A JSON-based array of structured rich text blocks, presented as a URL-encoded string. If the initial_comment field is provided, the blocks field is ignored.'
           c.flag 'channel_id', desc: 'Channel ID where the file will be shared. If not specified the file will be private.'
           c.flag 'channels', desc: 'Comma-separated string of channel IDs where the file will be shared.'
           c.flag 'initial_comment', desc: 'The message text introducing the file in specified channels.'

data/bin/commands/functions_distributions_permissions.rb

@@ -18,8 +18,8 @@ module Slack
           end
         end
 
-        g.desc 'List the access type of a custom slack function and include the users with access if its permission_type is set to named_entities'
-        g.long_desc %( List the access type of a custom slack function and include the users with access if its permission_type is set to named_entities )
+        g.desc 'List the access type of a custom slack function and include the users or team or org ids with access if its permission_type is set to named_entities'
+        g.long_desc %( List the access type of a custom slack function and include the users or team or org ids with access if its permission_type is set to named_entities )
         g.command 'list' do |c|
           c.flag 'function_app_id', desc: 'The encoded ID of the app.'
           c.flag 'function_callback_id', desc: "The callback ID defined in the function's definition file."
@@ -41,13 +41,15 @@ module Slack
           end
         end
 
-        g.desc 'Set the access type of a custom slack function and define the users to be granted access if permission_type is set to named_entities'
-        g.long_desc %( Set the access type of a custom slack function and define the users to be granted access if permission_type is set to named_entities )
+        g.desc 'Set the access type of a custom slack function and define the users or team or org ids to be granted access if permission_type is set to named_entities'
+        g.long_desc %( Set the access type of a custom slack function and define the users or team or org ids to be granted access if permission_type is set to named_entities )
         g.command 'set' do |c|
           c.flag 'permission_type', desc: 'The type of permission that defines how the function can be distributed.'
           c.flag 'function_app_id', desc: 'The encoded ID of the app.'
           c.flag 'function_callback_id', desc: "The callback ID defined in the function's definition file."
           c.flag 'function_id', desc: 'The encoded ID of the function.'
+          c.flag 'org_ids', desc: 'List of org IDs to allow for named_entities permission.'
+          c.flag 'team_ids', desc: 'List of team IDs to allow for named_entities permission.'
           c.flag 'user_ids', desc: 'List of encoded user IDs.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.functions_distributions_permissions_set(options))

data/bin/commands/usergroups.rb

@@ -51,7 +51,6 @@ module Slack
           c.flag 'include_disabled', desc: 'Include disabled User Groups.'
           c.flag 'include_users', desc: 'Include the list of users for each User Group.'
           c.flag 'team_id', desc: 'encoded team id to list user groups in, required if org token is used.'
-          c.flag 'usergroup_id', desc: 'The id of the usergroup you would like to filter the results down to.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.usergroups_list(options))
           end

data/lib/slack/events/request.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 module Slack
   module Events
     class Request
@@ -59,7 +60,7 @@ module Slack
         signature_basestring = [version, timestamp, body].join(':')
         hex_hash = OpenSSL::HMAC.hexdigest(digest, signing_secret, signature_basestring)
         computed_signature = [version, hex_hash].join('=')
-        computed_signature == signature
+        Utils::Security.secure_compare(computed_signature, signature)
       end
 
       # Validates the request signature and its expiration.

data/lib/slack/messages/formatting.rb

@@ -61,6 +61,14 @@ module Slack
           "<@#{user_id}>"
         end
 
+        #
+        # Embed a link to a group in a message by group ID
+        # @see https://api.slack.com/reference/surfaces/formatting#mentioning-groups
+        #
+        def group_link(group_id)
+          "<!subteam^#{group_id}>"
+        end
+
         #
         # Embed a URL with custom link text in a message
         # @see https://api.slack.com/reference/surfaces/formatting#linking-urls

data/lib/slack/utils/security.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+# This module is copied from activesupport
+# https://github.com/rails/rails/blob/3235827585d87661942c91bc81f64f56d710f0b2/activesupport/lib/active_support/security_utils.rb
+module Slack
+  module Utils
+    # rubocop:disable Naming/MethodParameterName
+    module Security
+      # Constant time string comparison, for fixed length strings.
+      #
+      # The values compared should be of fixed length, such as strings
+      # that have already been processed by HMAC. Raises in case of length mismatch.
+
+      if defined?(OpenSSL.fixed_length_secure_compare)
+        def fixed_length_secure_compare(a, b)
+          OpenSSL.fixed_length_secure_compare(a, b)
+        end
+      else
+        def fixed_length_secure_compare(a, b)
+          raise ArgumentError, 'inputs must be of equal length' unless a.bytesize == b.bytesize
+
+          l = a.unpack "C#{a.bytesize}"
+
+          res = 0
+          b.each_byte { |byte| res |= byte ^ l.shift }
+          res.zero?
+        end
+      end
+      module_function :fixed_length_secure_compare
+
+      # Secure string comparison for strings of variable length.
+      #
+      # While a timing attack would not be able to discern the content of
+      # a secret compared via secure_compare, it is possible to determine
+      # the secret length. This should be considered when using secure_compare
+      # to compare weak, short secrets to user input.
+      def secure_compare(a, b)
+        a.bytesize == b.bytesize && fixed_length_secure_compare(a, b)
+      end
+      module_function :secure_compare
+    end
+    # rubocop:enable Naming/MethodParameterName
+  end
+end

data/lib/slack/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module Slack
-  VERSION = '2.5.2'
+  VERSION = '2.6.0'
 end

data/lib/slack/web/api/endpoints/admin_conversations.rb

@@ -104,6 +104,23 @@ module Slack
             post('admin.conversations.create', options)
           end
 
+          #
+          # Create a Salesforce channel for the corresponding object provided.
+          #
+          # @option options [string] :object_id
+          #   Object / Record ID (15 or 18 digit accepted). See here for how to look up an ID.
+          # @option options [string] :salesforce_org_id
+          #   Salesforce org ID (15 or 18 digit accepted). See here for how to look up Salesforce org ID.
+          # @option options [boolean] :invite_object_team
+          #   Optional flag to add all team members related to the object to the newly created Salesforce channel. When true, adds a maximum of 100 team members to the channel.
+          # @see https://api.slack.com/methods/admin.conversations.createForObjects
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.conversations/admin.conversations.createForObjects.json
+          def admin_conversations_createForObjects(options = {})
+            raise ArgumentError, 'Required arguments :object_id missing' if options[:object_id].nil?
+            raise ArgumentError, 'Required arguments :salesforce_org_id missing' if options[:salesforce_org_id].nil?
+            post('admin.conversations.createForObjects', options)
+          end
+
           #
           # Delete a public or private channel.
           #
@@ -338,7 +355,7 @@ module Slack
           # @option options [array] :target_team_ids
           #   A comma-separated list of workspaces to which the channel should be shared. Not required if the channel is being shared org-wide.
           # @option options [Object] :team_id
-          #   The workspace to which the channel belongs. Omit this argument if the channel is a cross-workspace shared channel.
+          #   The workspace to which the channel belongs if the channel is a local workspace channel. Omit this argument if the channel is a cross-workspace or org-wide shared channel.
           # @see https://api.slack.com/methods/admin.conversations.setTeams
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.conversations/admin.conversations.setTeams.json
           def admin_conversations_setTeams(options = {})

data/lib/slack/web/api/endpoints/admin_users.rb

@@ -71,7 +71,7 @@ module Slack
           # @option options [integer] :limit
           #   Limit for how many users to be retrieved per page.
           # @option options [Object] :team_id
-          #   The ID (T1234) of the workspace. The team_id is required if you use an org-level token.
+          #   The ID (T1234) of a workspace. Filters results to just the specified workspace.
           # @see https://api.slack.com/methods/admin.users.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users/admin.users.list.json
           def admin_users_list(options = {})

data/lib/slack/web/api/endpoints/assistant_search.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AssistantSearch
+          #
+          # Searches messages across your Slack organization—perfect for broad, specific, and real-time data retrieval.
+          #
+          # @option options [string] :query
+          #   User prompt or search query.
+          # @option options [string] :action_token
+          #   Send action_token as received in a message event.
+          # @option options [array] :channel_types
+          #   Mix and match channel types by providing a comma-separated list of any combination of public_channel, private_channel, mpim, im.
+          # @option options [array] :content_types
+          #   Content types to include, a comma-separated list of any combination of messages, files.
+          # @option options [Object] :context_channel_id
+          #   Context channel ID to support scoping the search when applicable.
+          # @option options [string] :cursor
+          #   The cursor returned by the API. Leave this blank for the first request, and use this to get the next page of results.
+          # @option options [boolean] :include_bots
+          #   If you want the results to include bots.
+          # @option options [integer] :limit
+          #   Number of results to return, up to a max of 20. Defaults to 20.
+          # @see https://api.slack.com/methods/assistant.search.context
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/assistant.search/assistant.search.context.json
+          def assistant_search_context(options = {})
+            raise ArgumentError, 'Required arguments :query missing' if options[:query].nil?
+            if block_given?
+              Pagination::Cursor.new(self, :assistant_search_context, options).each do |page|
+                yield page
+              end
+            else
+              post('assistant.search.context', options)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/slack/web/api/endpoints/canvases.rb

@@ -9,6 +9,8 @@ module Slack
           #
           # Create canvas for a user
           #
+          # @option options [string] :channel_id
+          #   Channel ID of the channel the canvas will be tabbed in. This is a required field for free teams.
           # @option options [Object] :document_content
           #   Structure describing the type and value of the content to create.
           # @option options [string] :title

data/lib/slack/web/api/endpoints/chat.rb

@@ -142,6 +142,8 @@ module Slack
           #   A JSON-based array of structured blocks, presented as a URL-encoded string.
           # @option options [string] :text
           #   How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.
+          # @option options [Object] :agent_message_source_type
+          #   Identify how the message was posted for agentforce BE logging.
           # @option options [boolean] :as_user
           #   (Legacy) Pass true to post the message as the authed user instead of as a bot. Defaults to false. Can only be used by classic apps. See legacy as_user parameter below.
           # @option options [string] :icon_emoji

data/lib/slack/web/api/endpoints/conversations.rb

@@ -207,7 +207,6 @@ module Slack
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.kick.json
           def conversations_kick(options = {})
             raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
-            raise ArgumentError, 'Required arguments :user missing' if options[:user].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
             post('conversations.kick', options)

data/lib/slack/web/api/endpoints/conversations_canvases.rb

@@ -13,6 +13,8 @@ module Slack
           #   Channel ID of the channel we create the channel canvas for.
           # @option options [Object] :document_content
           #   Structure describing the type and value of the content to create.
+          # @option options [string] :title
+          #   Title of the newly created canvas.
           # @see https://api.slack.com/methods/conversations.canvases.create
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations.canvases/conversations.canvases.create.json
           def conversations_canvases_create(options = {})

data/lib/slack/web/api/endpoints/files.rb

@@ -11,6 +11,8 @@ module Slack
           #
           # @option options [array] :files
           #   Array of file ids and their corresponding (optional) titles.
+          # @option options [blocks[] as string] :blocks
+          #   A JSON-based array of structured rich text blocks, presented as a URL-encoded string. If the initial_comment field is provided, the blocks field is ignored.
           # @option options [Object] :channel_id
           #   Channel ID where the file will be shared. If not specified the file will be private.
           # @option options [string] :channels
@@ -23,6 +25,7 @@ module Slack
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.completeUploadExternal.json
           def files_completeUploadExternal(options = {})
             raise ArgumentError, 'Required arguments :files missing' if options[:files].nil?
+            options = encode_options_as_json(options, %i[blocks])
             post('files.completeUploadExternal', options)
           end
 

data/lib/slack/web/api/endpoints/functions_distributions_permissions.rb

@@ -24,7 +24,7 @@ module Slack
           end
 
           #
-          # List the access type of a custom slack function and include the users with access if its permission_type is set to named_entities
+          # List the access type of a custom slack function and include the users or team or org ids with access if its permission_type is set to named_entities
           #
           # @option options [string] :function_app_id
           #   The encoded ID of the app.
@@ -56,7 +56,7 @@ module Slack
           end
 
           #
-          # Set the access type of a custom slack function and define the users to be granted access if permission_type is set to named_entities
+          # Set the access type of a custom slack function and define the users or team or org ids to be granted access if permission_type is set to named_entities
           #
           # @option options [enum] :permission_type
           #   The type of permission that defines how the function can be distributed.
@@ -66,6 +66,10 @@ module Slack
           #   The callback ID defined in the function's definition file.
           # @option options [string] :function_id
           #   The encoded ID of the function.
+          # @option options [array] :org_ids
+          #   List of org IDs to allow for named_entities permission.
+          # @option options [array] :team_ids
+          #   List of team IDs to allow for named_entities permission.
           # @option options [array] :user_ids
           #   List of encoded user IDs.
           # @see https://api.slack.com/methods/functions.distributions.permissions.set

data/lib/slack/web/api/endpoints/usergroups.rb

@@ -75,8 +75,6 @@ module Slack
           #   Include the list of users for each User Group.
           # @option options [string] :team_id
           #   encoded team id to list user groups in, required if org token is used.
-          # @option options [Object] :usergroup_id
-          #   The id of the usergroup you would like to filter the results down to.
           # @see https://api.slack.com/methods/usergroups.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups/usergroups.list.json
           def usergroups_list(options = {})

data/lib/slack/web/api/endpoints.rb

@@ -41,6 +41,7 @@ require_relative 'endpoints/apps_connections'
 require_relative 'endpoints/apps_datastore'
 require_relative 'endpoints/apps_event_authorizations'
 require_relative 'endpoints/apps_manifest'
+require_relative 'endpoints/assistant_search'
 require_relative 'endpoints/assistant_threads'
 require_relative 'endpoints/auth'
 require_relative 'endpoints/auth_teams'
@@ -141,6 +142,7 @@ module Slack
         include AppsDatastore
         include AppsEventAuthorizations
         include AppsManifest
+        include AssistantSearch
         include AssistantThreads
         include Auth
         include AuthTeams

data/lib/slack/web/api/errors.rb

@@ -112,6 +112,7 @@ module Slack
         class CanvasGloballyDisabled < SlackError; end
         class CanvasNotFound < SlackError; end
         class CanvasTabCreationFailed < SlackError; end
+        class ChannelAlreadyExists < SlackError; end
         class ChannelArchived < SlackError; end
         class ChannelCannotBeUnshared < SlackError; end
         class ChannelCanvasAlreadyExists < SlackError; end
@@ -137,6 +138,7 @@ module Slack
         class ConnectedUserDenied < SlackError; end
         class ConnectionLimitExceeded < SlackError; end
         class ConnectionLimitExceededPending < SlackError; end
+        class ContextChannelNotFound < SlackError; end
         class CouldNotArchiveChannel < SlackError; end
         class CouldNotConvertChannel < SlackError; end
         class CouldNotCreateChannel < SlackError; end
@@ -242,6 +244,7 @@ module Slack
         class FeatureNotAvailable < SlackError; end
         class FeatureNotEnabled < SlackError; end
         class FetchMembersFailed < SlackError; end
+        class FileAlreadyAdded < SlackError; end
         class FileCommentNotFound < SlackError; end
         class FileDeleted < SlackError; end
         class FileDeletingDisabled < SlackError; end
@@ -256,7 +259,7 @@ module Slack
         class ForbiddenTeam < SlackError; end
         class FreeTeamCanvasTabAlreadyExists < SlackError; end
         class FreeTeamNotAllowed < SlackError; end
-        class FreeTeamsCannotCreateStandaloneCanvases < SlackError; end
+        class FreeTeamsCannotCreateNonTabbedCanvases < SlackError; end
         class FreeTeamsCannotEditStandaloneCanvases < SlackError; end
         class FunctionExecutionNotFound < SlackError; end
         class FunctionNotFound < SlackError; end
@@ -272,6 +275,7 @@ module Slack
         class InsecureRequest < SlackError; end
         class InternalError < SlackError; end
         class InvalidAction < SlackError; end
+        class InvalidActionToken < SlackError; end
         class InvalidActor < SlackError; end
         class InvalidApp < SlackError; end
         class InvalidAppActionType < SlackError; end
@@ -326,6 +330,8 @@ module Slack
         class InvalidNameRequired < SlackError; end
         class InvalidNameSpecials < SlackError; end
         class InvalidNamedEntities < SlackError; end
+        class InvalidOooMessage < SlackError; end
+        class InvalidOrgId < SlackError; end
         class InvalidOutputs < SlackError; end
         class InvalidParameters < SlackError; end
         class InvalidParentType < SlackError; end
@@ -352,6 +358,7 @@ module Slack
         class InvalidSortDir < SlackError; end
         class InvalidSource < SlackError; end
         class InvalidStartTime < SlackError; end
+        class InvalidStartsWithAt < SlackError; end
         class InvalidStepStatus < SlackError; end
         class InvalidTargetTeam < SlackError; end
         class InvalidTeam < SlackError; end
@@ -402,6 +409,7 @@ module Slack
         class LegacyConnectionLimitExceeded < SlackError; end
         class LimitRequired < SlackError; end
         class LinkNotFound < SlackError; end
+        class ListRecordCommentFetchFailed < SlackError; end
         class MalwareDetected < SlackError; end
         class ManagedChannelNotSupported < SlackError; end
         class MarkdownTextConflict < SlackError; end
@@ -427,6 +435,8 @@ module Slack
         class MissingFileData < SlackError; end
         class MissingPostType < SlackError; end
         class MissingProfileId < SlackError; end
+        class MissingQuery < SlackError; end
+        class MissingRecordChannelConfig < SlackError; end
         class MissingResource < SlackError; end
         class MissingScope < SlackError; end
         class MissingSource < SlackError; end
@@ -451,6 +461,7 @@ module Slack
         class NameTakenInOrg < SlackError; end
         class NameTooLong < SlackError; end
         class NamedEntitiesCannotBeEmpty < SlackError; end
+        class NoAccess < SlackError; end
         class NoActiveSessions < SlackError; end
         class NoAliasSelected < SlackError; end
         class NoBotUserForApp < SlackError; end
@@ -502,6 +513,7 @@ module Slack
         class NotInTeam < SlackError; end
         class NotOwner < SlackError; end
         class NotPaid < SlackError; end
+        class NotPermitted < SlackError; end
         class NotPinnable < SlackError; end
         class NotPinned < SlackError; end
         class NotReactable < SlackError; end
@@ -536,9 +548,11 @@ module Slack
         class PrimaryUsergroupNotFound < SlackError; end
         class ProfileSetFailed < SlackError; end
         class ProvidersNotFound < SlackError; end
+        class PublicFileTypeNotAllowed < SlackError; end
         class PublicVideoNotAllowed < SlackError; end
         class PublishedAppOnly < SlackError; end
         class PushLimitReached < SlackError; end
+        class QueryTooLong < SlackError; end
         class RateLimited < SlackError; end
         class Ratelimit < SlackError; end
         class Ratelimited < SlackError; end
@@ -618,6 +632,7 @@ module Slack
         class TooManyNamedEntities < SlackError; end
         class TooManyPins < SlackError; end
         class TooManyReactions < SlackError; end
+        class TooManyTabs < SlackError; end
         class TooManyTargetTeams < SlackError; end
         class TooManyTeams < SlackError; end
         class TooManyTeamsProvided < SlackError; end
@@ -674,6 +689,7 @@ module Slack
         class UsergroupNotFound < SlackError; end
         class UsergroupNotLinkedToTeam < SlackError; end
         class UsergroupTeamNotProvisioned < SlackError; end
+        class UsernameSame < SlackError; end
         class UsersListNotSupplied < SlackError; end
         class UsersNotFound < SlackError; end
         class ValidationErrors < SlackError; end
@@ -789,6 +805,7 @@ module Slack
           'canvas_globally_disabled' => CanvasGloballyDisabled,
           'canvas_not_found' => CanvasNotFound,
           'canvas_tab_creation_failed' => CanvasTabCreationFailed,
+          'channel_already_exists' => ChannelAlreadyExists,
           'channel_archived' => ChannelArchived,
           'channel_cannot_be_unshared' => ChannelCannotBeUnshared,
           'channel_canvas_already_exists' => ChannelCanvasAlreadyExists,
@@ -814,6 +831,7 @@ module Slack
           'connected_user_denied' => ConnectedUserDenied,
           'connection_limit_exceeded' => ConnectionLimitExceeded,
           'connection_limit_exceeded_pending' => ConnectionLimitExceededPending,
+          'context_channel_not_found' => ContextChannelNotFound,
           'could_not_archive_channel' => CouldNotArchiveChannel,
           'could_not_convert_channel' => CouldNotConvertChannel,
           'could_not_create_channel' => CouldNotCreateChannel,
@@ -919,6 +937,7 @@ module Slack
           'feature_not_available' => FeatureNotAvailable,
           'feature_not_enabled' => FeatureNotEnabled,
           'fetch_members_failed' => FetchMembersFailed,
+          'file_already_added' => FileAlreadyAdded,
           'file_comment_not_found' => FileCommentNotFound,
           'file_deleted' => FileDeleted,
           'file_deleting_disabled' => FileDeletingDisabled,
@@ -933,7 +952,7 @@ module Slack
           'forbidden_team' => ForbiddenTeam,
           'free_team_canvas_tab_already_exists' => FreeTeamCanvasTabAlreadyExists,
           'free_team_not_allowed' => FreeTeamNotAllowed,
-          'free_teams_cannot_create_standalone_canvases' => FreeTeamsCannotCreateStandaloneCanvases,
+          'free_teams_cannot_create_non_tabbed_canvases' => FreeTeamsCannotCreateNonTabbedCanvases,
           'free_teams_cannot_edit_standalone_canvases' => FreeTeamsCannotEditStandaloneCanvases,
           'function_execution_not_found' => FunctionExecutionNotFound,
           'function_not_found' => FunctionNotFound,
@@ -949,6 +968,7 @@ module Slack
           'insecure_request' => InsecureRequest,
           'internal_error' => InternalError,
           'invalid_action' => InvalidAction,
+          'invalid_action_token' => InvalidActionToken,
           'invalid_actor' => InvalidActor,
           'invalid_app' => InvalidApp,
           'invalid_app_action_type' => InvalidAppActionType,
@@ -1003,6 +1023,8 @@ module Slack
           'invalid_name_required' => InvalidNameRequired,
           'invalid_name_specials' => InvalidNameSpecials,
           'invalid_named_entities' => InvalidNamedEntities,
+          'invalid_ooo_message' => InvalidOooMessage,
+          'invalid_org_id' => InvalidOrgId,
           'invalid_outputs' => InvalidOutputs,
           'invalid_parameters' => InvalidParameters,
           'invalid_parent_type' => InvalidParentType,
@@ -1029,6 +1051,7 @@ module Slack
           'invalid_sort_dir' => InvalidSortDir,
           'invalid_source' => InvalidSource,
           'invalid_start_time' => InvalidStartTime,
+          'invalid_starts_with_at' => InvalidStartsWithAt,
           'invalid_step_status' => InvalidStepStatus,
           'invalid_target_team' => InvalidTargetTeam,
           'invalid_team' => InvalidTeam,
@@ -1079,6 +1102,7 @@ module Slack
           'legacy_connection_limit_exceeded' => LegacyConnectionLimitExceeded,
           'limit_required' => LimitRequired,
           'link_not_found' => LinkNotFound,
+          'list_record_comment_fetch_failed' => ListRecordCommentFetchFailed,
           'malware_detected' => MalwareDetected,
           'managed_channel_not_supported' => ManagedChannelNotSupported,
           'markdown_text_conflict' => MarkdownTextConflict,
@@ -1104,6 +1128,8 @@ module Slack
           'missing_file_data' => MissingFileData,
           'missing_post_type' => MissingPostType,
           'missing_profile_id' => MissingProfileId,
+          'missing_query' => MissingQuery,
+          'missing_record_channel_config' => MissingRecordChannelConfig,
           'missing_resource' => MissingResource,
           'missing_scope' => MissingScope,
           'missing_source' => MissingSource,
@@ -1128,6 +1154,7 @@ module Slack
           'name_taken_in_org' => NameTakenInOrg,
           'name_too_long' => NameTooLong,
           'named_entities_cannot_be_empty' => NamedEntitiesCannotBeEmpty,
+          'no_access' => NoAccess,
           'no_active_sessions' => NoActiveSessions,
           'no_alias_selected' => NoAliasSelected,
           'no_bot_user_for_app' => NoBotUserForApp,
@@ -1179,6 +1206,7 @@ module Slack
           'not_in_team' => NotInTeam,
           'not_owner' => NotOwner,
           'not_paid' => NotPaid,
+          'not_permitted' => NotPermitted,
           'not_pinnable' => NotPinnable,
           'not_pinned' => NotPinned,
           'not_reactable' => NotReactable,
@@ -1213,9 +1241,11 @@ module Slack
           'primary_usergroup_not_found' => PrimaryUsergroupNotFound,
           'profile_set_failed' => ProfileSetFailed,
           'providers_not_found' => ProvidersNotFound,
+          'public_file_type_not_allowed' => PublicFileTypeNotAllowed,
           'public_video_not_allowed' => PublicVideoNotAllowed,
           'published_app_only' => PublishedAppOnly,
           'push_limit_reached' => PushLimitReached,
+          'query_too_long' => QueryTooLong,
           'rate_limited' => RateLimited,
           'ratelimit' => Ratelimit,
           'ratelimited' => Ratelimited,
@@ -1295,6 +1325,7 @@ module Slack
           'too_many_named_entities' => TooManyNamedEntities,
           'too_many_pins' => TooManyPins,
           'too_many_reactions' => TooManyReactions,
+          'too_many_tabs' => TooManyTabs,
           'too_many_target_teams' => TooManyTargetTeams,
           'too_many_teams' => TooManyTeams,
           'too_many_teams_provided' => TooManyTeamsProvided,
@@ -1351,6 +1382,7 @@ module Slack
           'usergroup_not_found' => UsergroupNotFound,
           'usergroup_not_linked_to_team' => UsergroupNotLinkedToTeam,
           'usergroup_team_not_provisioned' => UsergroupTeamNotProvisioned,
+          'username_same' => UsernameSame,
           'users_list_not_supplied' => UsersListNotSupplied,
           'users_not_found' => UsersNotFound,
           'validation_errors' => ValidationErrors,

data/lib/slack/web/api/mixins/conversations.id.rb

@@ -12,11 +12,22 @@ module Slack
           #
           # @option options [channel] :channel
           #   Channel to get ID for, prefixed with #.
+          # @option options [integer] :id_limit
+          #   The page size used for conversations_list calls required to find the channel's ID
           def conversations_id(options = {})
             name = options[:channel]
+            limit = options.fetch(:id_limit, Slack::Web.config.conversations_id_page_size)
+
             raise ArgumentError, 'Required arguments :channel missing' if name.nil?
 
-            id_for :channel, name, '#', :conversations_list, :channels, 'channel_not_found'
+            id_for(
+              key: :channel,
+              name: name,
+              prefix: '#',
+              enum_method: :conversations_list,
+              list_method: :channels,
+              options: { limit: limit }.compact
+            )
           end
         end
       end

data/lib/slack/web/api/mixins/ids.id.rb

@@ -6,16 +6,16 @@ module Slack
         module Ids
           private
 
-          def id_for(key, name, prefix, enum_method, list_method, not_found_error)
+          def id_for(key:, name:, prefix:, enum_method:, list_method:, options: {})
             return { 'ok' => true, key.to_s => { 'id' => name } } unless name[0] == prefix
 
-            public_send enum_method do |list|
+            public_send(enum_method, **options) do |list|
               list.public_send(list_method).each do |li|
                 return Slack::Messages::Message.new('ok' => true, key.to_s => { 'id' => li.id }) if li.name == name[1..-1]
               end
             end
 
-            raise Slack::Web::Api::Errors::SlackError, not_found_error
+            raise Slack::Web::Api::Errors::SlackError, "#{key}_not_found"
           end
         end
       end

data/lib/slack/web/api/mixins/users.id.rb

@@ -12,11 +12,22 @@ module Slack
           #
           # @option options [user] :user
           #   User to get ID for, prefixed with '@'.
+          # @option options [integer] :id_limit
+          #   The page size used for users_list calls required to find the user's ID
           def users_id(options = {})
             name = options[:user]
+            limit = options.fetch(:id_limit, Slack::Web.config.users_id_page_size)
+
             raise ArgumentError, 'Required arguments :user missing' if name.nil?
 
-            id_for :user, name, '@', :users_list, :members, 'user_not_found'
+            id_for(
+              key: :user,
+              name: name,
+              prefix: '@',
+              enum_method: :users_list,
+              list_method: :members,
+              options: { limit: limit }.compact
+            )
           end
         end
       end

data/lib/slack/web/config.rb

@@ -15,6 +15,8 @@ module Slack
         timeout
         open_timeout
         default_page_size
+        conversations_id_page_size
+        users_id_page_size
         default_max_retries
         adapter
       ].freeze
@@ -32,6 +34,8 @@ module Slack
         self.timeout = nil
         self.open_timeout = nil
         self.default_page_size = 100
+        self.conversations_id_page_size = nil
+        self.users_id_page_size = nil
         self.default_max_retries = 100
         self.adapter = ::Faraday.default_adapter
       end

data/lib/slack-ruby-client.rb

@@ -22,7 +22,7 @@ end
 begin
   require 'openssl'
 rescue LoadError # rubocop:disable Lint/SuppressedException
-  # Used in slack/web/config
+  # Used in slack/web/config and slack/utils/security
 end
 require_relative 'slack/web/config'
 require_relative 'slack/web/api/errors/slack_error'
@@ -57,3 +57,5 @@ require_relative 'slack/real_time/client'
 # Events API
 require_relative 'slack/events/config'
 require_relative 'slack/events/request'
+
+require_relative 'slack/utils/security'

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: slack-ruby-client
 version: !ruby/object:Gem::Version
-  version: 2.5.2
+  version: 2.6.0
 platform: ruby
 authors:
 - Daniel Doubrovkine
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-19 00:00:00.000000000 Z
+date: 2025-05-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -94,7 +93,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description:
 email: dblock@dblock.org
 executables:
 - slack
@@ -166,6 +164,7 @@ files:
 - bin/commands/apps_datastore.rb
 - bin/commands/apps_event_authorizations.rb
 - bin/commands/apps_manifest.rb
+- bin/commands/assistant_search.rb
 - bin/commands/assistant_threads.rb
 - bin/commands/auth.rb
 - bin/commands/auth_teams.rb
@@ -269,6 +268,7 @@ files:
 - lib/slack/real_time/stores/base.rb
 - lib/slack/real_time/stores/starter.rb
 - lib/slack/real_time/stores/store.rb
+- lib/slack/utils/security.rb
 - lib/slack/version.rb
 - lib/slack/web/api/endpoints.rb
 - lib/slack/web/api/endpoints/admin_analytics.rb
@@ -311,6 +311,7 @@ files:
 - lib/slack/web/api/endpoints/apps_datastore.rb
 - lib/slack/web/api/endpoints/apps_event_authorizations.rb
 - lib/slack/web/api/endpoints/apps_manifest.rb
+- lib/slack/web/api/endpoints/assistant_search.rb
 - lib/slack/web/api/endpoints/assistant_threads.rb
 - lib/slack/web/api/endpoints/auth.rb
 - lib/slack/web/api/endpoints/auth_teams.rb
@@ -407,7 +408,6 @@ licenses:
 metadata:
   rubygems_mfa_required: 'true'
   changelog_uri: https://github.com/slack-ruby/slack-ruby-client/blob/master/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -422,8 +422,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.6
 requirements: []
-rubygems_version: 3.5.16
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Slack Web and RealTime API client.
 test_files: []