slack-ruby-client 0.14.1 → 0.14.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f49c09a3a19a7cabc86a35479cc1e0073b6fb35939379961353cf16b30c8ce5
-  data.tar.gz: 82d9a2b2854adfb3e78a51328dbdbcf298c50acb9eef45a521a3a6a4335f7674
+  metadata.gz: 358de8d699475c86a5e79c8c96e082dd55b9f60fcb44ed806f62758c3e99479e
+  data.tar.gz: ae9bceefa9fef8950b823bcb6f6ff7023ca027a268022500a9e48d8d5aa28f85
 SHA512:
-  metadata.gz: c7840627a1a2b0226599c6d64445fe4f2a1590b6d129211a6659cbe9aef7bb6dc534438fc61ee95e01ea3f518b299ff8a9739165011e361538f6688e8b228b41
-  data.tar.gz: ed84733c510bc3ef05710046b7a6eef36d84b923cfcf76912093386de88d2a47c55bf1e7082c384c9829ba639373d73fa3ebac0f4a1c711fff398ea9be84a230
+  metadata.gz: 03c79a47ba7b75a13ca37bb1a592faca4c3d6c4d1f53b34ba205a8587bb72b26a6d009fb22cb9a57b63e017dac6b05ef344f13b68f045b57679fd950e0ed686a
+  data.tar.gz: 1761adca1f3ab450cb630102ea77f293340815c9a7e6c17b6afcf0f1fd73172f79cef25e4f89905c134a5b171a4f247d4e733f4c551ca90c57c1519e8f851801

data/.gitignore

@@ -4,3 +4,4 @@ Gemfile.lock
 .DS_Store
 .bundle
 .idea
+.rspec_status

data/.rubocop_todo.yml

@@ -1,11 +1,18 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2019-01-19 17:37:31 -0500 using RuboCop version 0.61.1.
+# on 2019-04-09 22:16:03 -0500 using RuboCop version 0.61.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
+# Offense count: 2
+# Configuration parameters: AllowSafeAssignment.
+Lint/AssignmentInCondition:
+  Exclude:
+    - 'lib/slack/real_time/concurrency/async.rb'
+    - 'lib/slack/real_time/socket.rb'
+
 # Offense count: 4
 Lint/HandleExceptions:
   Exclude:
@@ -13,12 +20,15 @@ Lint/HandleExceptions:
     - 'spec/slack/real_time/concurrency/celluloid_spec.rb'
     - 'spec/slack/real_time/concurrency/eventmachine_spec.rb'
 
-# Offense count: 1
+# Offense count: 4
 # Configuration parameters: ExpectMatchingDefinition, Regex, IgnoreExecutableScripts, AllowedAcronyms.
 # AllowedAcronyms: CLI, DSL, ACL, API, ASCII, CPU, CSS, DNS, EOF, GUID, HTML, HTTP, HTTPS, ID, IP, JSON, LHS, QPS, RAM, RHS, RPC, SLA, SMTP, SQL, SSH, TCP, TLS, TTL, UDP, UI, UID, UUID, URI, URL, UTF8, VM, XML, XMPP, XSRF, XSS
 Naming/FileName:
   Exclude:
+    - 'bin/commands/chat_scheduledMessages.rb'
     - 'lib/slack-ruby-client.rb'
+    - 'lib/slack/web/api/endpoints/chat_scheduledMessages.rb'
+    - 'spec/slack/web/api/endpoints/chat_scheduledMessages_spec.rb'
 
 # Offense count: 1
 # Configuration parameters: EnforcedStyleForLeadingUnderscores.
@@ -40,15 +50,16 @@ Style/AccessModifierDeclarations:
     - 'lib/slack/real_time/concurrency/eventmachine.rb'
     - 'lib/slack/real_time/socket.rb'
 
-# Offense count: 153
+# Offense count: 154
 # Configuration parameters: AllowedVariables.
 Style/GlobalVars:
   Enabled: false
 
-# Offense count: 2
+# Offense count: 3
 # Configuration parameters: MinBodyLength.
 Style/GuardClause:
   Exclude:
+    - 'lib/slack/real_time/socket.rb'
     - 'lib/slack/real_time/stores/store.rb'
     - 'lib/slack/web/faraday/response/raise_error.rb'
 

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+### 0.14.2 (2019/4/12)
+
+* [#256](https://github.com/slack-ruby/slack-ruby-client/pull/256): Added support for specifying signing secrets on a per-request basis via optional parameters to the `Slack::Events::Request` constructor - [@gabrielmdeal](https://github.com/gabrielmdeal).
+* [#257](https://github.com/slack-ruby/slack-ruby-client/pull/257), [#262](https://github.com/slack-ruby/slack-ruby-client/pull/262): Fixed occasional failures to reconnect - [@ioquatix](https://github.com/ioquatix), [@dblock](https://github.com/dblock).
+* [#264](https://github.com/slack-ruby/slack-ruby-client/pull/264): Added `chat_scheduleMessage`, `chat_deleteScheduledMessage` and `chat_scheduledMessages_list` - [@dblock](https://github.com/dblock).
+* [#264](https://github.com/slack-ruby/slack-ruby-client/pull/264): Removed `files_comments_add` and `files_comments_edit` - [@dblock](https://github.com/dblock).
+
 ### 0.14.1 (2019/2/26)
 
 * [#254](https://github.com/slack-ruby/slack-ruby-client/issues/254): Fix: celluloid infinite reconnect loop - [@dblock](https://github.com/dblock).

data/README.md

@@ -66,7 +66,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, v0.14.1. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
+You're reading the documentation for the **stable** release of slack-ruby-client, 0.14.2. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
 
 ## Installation
 
@@ -506,6 +506,13 @@ slack_request = Slack::Events::Request.new(http_request)
 slack_request.verify!
 ```
 
+To specify secrets on a per-request basis:
+```ruby
+Slack::Events::Request.new(http_request,
+                           signing_secret: signing_secret,
+                           signature_expires_in: signature_expires_in)
+```
+
 The `verify!` call may raise `Slack::Events::MissingSigningSecret`, `Slack::Events::InvalidSignature` or `Slack::Events::TimestampExpired` errors.
 
 ### Message Parsing

data/Rakefile

@@ -14,7 +14,7 @@ end
 require 'rubocop/rake_task'
 RuboCop::RakeTask.new
 
-task default: %i[rubocop spec]
+task default: %i[spec rubocop]
 
 load 'tasks/git.rake'
 load 'tasks/web.rake'

data/bin/commands.rb

@@ -10,6 +10,7 @@ require 'commands/auth'
 require 'commands/bots'
 require 'commands/channels'
 require 'commands/chat'
+require 'commands/chat_scheduledMessages'
 require 'commands/conversations'
 require 'commands/dialog'
 require 'commands/dnd'

data/bin/commands/api.rb

@@ -2,8 +2,8 @@
 
 desc 'Api methods.'
 command 'api' do |g|
-  g.desc 'Checks API calling code.'
-  g.long_desc %( Checks API calling code. )
+  g.desc 'This method helps you test your calling code.'
+  g.long_desc %( This method helps you test your calling code. )
   g.command 'test' do |c|
     c.flag 'error', desc: 'Error response to return.'
     c.flag 'foo', desc: 'example property to return.'

data/bin/commands/apps.rb

@@ -2,8 +2,8 @@
 
 desc 'Apps methods.'
 command 'apps' do |g|
-  g.desc 'Uninstalls your app from a workspace.'
-  g.long_desc %( Uninstalls your app from a workspace. )
+  g.desc 'This method uninstalls a workspace app. Unlike auth.revoke, which revokes a single token, this method revokes all tokens associated with a single installation of a workspace app.'
+  g.long_desc %( This method uninstalls a workspace app. Unlike auth.revoke, which revokes a single token, this method revokes all tokens associated with a single installation of a workspace app. )
   g.command 'uninstall' do |c|
     c.flag 'client_id', desc: 'Issued when you created your application.'
     c.flag 'client_secret', desc: 'Issued when you created your application.'

data/bin/commands/apps_permissions.rb

@@ -2,16 +2,16 @@
 
 desc 'AppsPermissions methods.'
 command 'apps_permissions' do |g|
-  g.desc 'Returns list of permissions this app has on a team.'
-  g.long_desc %( Returns list of permissions this app has on a team. )
+  g.desc 'This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.'
+  g.long_desc %( This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months. )
   g.command 'info' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.apps_permissions_info(options))
     end
   end
 
-  g.desc 'Allows an app to request additional scopes'
-  g.long_desc %( Allows an app to request additional scopes )
+  g.desc 'This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.'
+  g.long_desc %( This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months. )
   g.command 'request' do |c|
     c.flag 'scopes', desc: 'A comma separated list of scopes to request for.'
     c.flag 'trigger_id', desc: 'Token used to trigger the permissions API.'

data/bin/commands/apps_permissions_resources.rb

@@ -2,8 +2,8 @@
 
 desc 'AppsPermissionsResources methods.'
 command 'apps_permissions_resources' do |g|
-  g.desc 'Returns list of resource grants this app has on a team.'
-  g.long_desc %( Returns list of resource grants this app has on a team. )
+  g.desc 'This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.'
+  g.long_desc %( This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months. )
   g.command 'list' do |c|
     c.flag 'cursor', desc: "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection. See pagination for more detail."
     c.flag 'limit', desc: 'The maximum number of items to return.'

data/bin/commands/apps_permissions_scopes.rb

@@ -2,8 +2,8 @@
 
 desc 'AppsPermissionsScopes methods.'
 command 'apps_permissions_scopes' do |g|
-  g.desc 'Returns list of scopes this app has on a team.'
-  g.long_desc %( Returns list of scopes this app has on a team. )
+  g.desc 'This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.'
+  g.long_desc %( This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months. )
   g.command 'list' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.apps_permissions_scopes_list(options))

data/bin/commands/apps_permissions_users.rb

@@ -2,8 +2,8 @@
 
 desc 'AppsPermissionsUsers methods.'
 command 'apps_permissions_users' do |g|
-  g.desc 'Returns list of user grants and corresponding scopes this app has on a team.'
-  g.long_desc %( Returns list of user grants and corresponding scopes this app has on a team. )
+  g.desc 'This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.'
+  g.long_desc %( This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months. )
   g.command 'list' do |c|
     c.flag 'cursor', desc: "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection. See pagination for more detail."
     c.flag 'limit', desc: 'The maximum number of items to return.'
@@ -12,8 +12,8 @@ command 'apps_permissions_users' do |g|
     end
   end
 
-  g.desc 'Enables an app to trigger a permissions modal to grant an app access to a user access scope.'
-  g.long_desc %( Enables an app to trigger a permissions modal to grant an app access to a user access scope. )
+  g.desc 'This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.'
+  g.long_desc %( This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months. )
   g.command 'request' do |c|
     c.flag 'scopes', desc: 'A comma separated list of user scopes to request for.'
     c.flag 'trigger_id', desc: 'Token used to trigger the request.'

data/bin/commands/auth.rb

@@ -2,8 +2,8 @@
 
 desc 'Auth methods.'
 command 'auth' do |g|
-  g.desc 'Revokes a token.'
-  g.long_desc %( Revokes a token. )
+  g.desc 'This method revokes an access token. Use it when you no longer need a token. For example, with a Sign In With Slack app, call this to log a user out.'
+  g.long_desc %( This method revokes an access token. Use it when you no longer need a token. For example, with a Sign In With Slack app, call this to log a user out. )
   g.command 'revoke' do |c|
     c.flag 'test', desc: 'Setting this parameter to 1 triggers a testing mode where the specified token will not actually be revoked.'
     c.action do |_global_options, options, _args|
@@ -11,8 +11,8 @@ command 'auth' do |g|
     end
   end
 
-  g.desc 'Checks authentication & identity.'
-  g.long_desc %( Checks authentication & identity. )
+  g.desc 'This method checks authentication and tells "you" who you are, even if you might be a bot.'
+  g.long_desc %( This method checks authentication and tells "you" who you are, even if you might be a bot. )
   g.command 'test' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.auth_test(options))

data/bin/commands/bots.rb

@@ -2,8 +2,8 @@
 
 desc 'Bots methods.'
 command 'bots' do |g|
-  g.desc 'Gets information about a bot user.'
-  g.long_desc %( Gets information about a bot user. )
+  g.desc 'This method returns extended information about a bot user.'
+  g.long_desc %( This method returns extended information about a bot user. )
   g.command 'info' do |c|
     c.flag 'bot', desc: 'Bot user to get info on.'
     c.action do |_global_options, options, _args|

data/bin/commands/channels.rb

@@ -1,9 +1,9 @@
 # This file was auto-generated by lib/tasks/web.rake
 
-desc "Get info on your team's Slack channels, create or archive channels, invite users, set the topic and purpose, and mark a channel as read."
+desc 'Channels methods.'
 command 'channels' do |g|
-  g.desc 'Archives a channel.'
-  g.long_desc %( Archives a channel. )
+  g.desc 'This method archives a channel.'
+  g.long_desc %( This method archives a channel. )
   g.command 'archive' do |c|
     c.flag 'channel', desc: 'Channel to archive.'
     c.action do |_global_options, options, _args|
@@ -11,8 +11,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'Creates a channel.'
-  g.long_desc %( Creates a channel. )
+  g.desc 'This method is used to create a channel.'
+  g.long_desc %( This method is used to create a channel. )
   g.command 'create' do |c|
     c.flag 'name', desc: 'Name of channel to create.'
     c.flag 'validate', desc: 'Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.'
@@ -30,8 +30,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'Fetches history of messages and events from a channel.'
-  g.long_desc %( Fetches history of messages and events from a channel. )
+  g.desc 'This method returns a portion of message events from the specified public channel.'
+  g.long_desc %( This method returns a portion of message events from the specified public channel. )
   g.command 'history' do |c|
     c.flag 'channel', desc: 'Channel to fetch history for.'
     c.flag 'inclusive', desc: 'Include messages with latest or oldest timestamp in results.'
@@ -52,8 +52,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'Gets information about a channel.'
-  g.long_desc %( Gets information about a channel. )
+  g.desc 'This method returns information about a team channel.'
+  g.long_desc %( This method returns information about a team channel. )
   g.command 'info' do |c|
     c.flag 'channel', desc: 'Channel to get info on.'
     c.flag 'include_locale', desc: 'Set this to true to receive the locale for this channel. Defaults to false.'
@@ -62,8 +62,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'Invites a user to a channel.'
-  g.long_desc %( Invites a user to a channel. )
+  g.desc 'This method is used to invite a user to a channel. The calling user must be a member of the channel.'
+  g.long_desc %( This method is used to invite a user to a channel. The calling user must be a member of the channel. )
   g.command 'invite' do |c|
     c.flag 'channel', desc: 'Channel to invite user to.'
     c.flag 'user', desc: 'User to invite to channel.'
@@ -72,8 +72,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'Joins a channel, creating it if needed.'
-  g.long_desc %( Joins a channel, creating it if needed. )
+  g.desc 'This method is used to join a channel. If the channel does not exist, it is'
+  g.long_desc %( This method is used to join a channel. If the channel does not exist, it is created. )
   g.command 'join' do |c|
     c.flag 'name', desc: 'Name of channel to join.'
     c.flag 'validate', desc: 'Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.'
@@ -82,8 +82,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'Removes a user from a channel.'
-  g.long_desc %( Removes a user from a channel. )
+  g.desc 'This method allows a user to remove another member from a team channel.'
+  g.long_desc %( This method allows a user to remove another member from a team channel. )
   g.command 'kick' do |c|
     c.flag 'channel', desc: 'Channel to remove user from.'
     c.flag 'user', desc: 'User to remove from channel.'
@@ -92,8 +92,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'Leaves a channel.'
-  g.long_desc %( Leaves a channel. )
+  g.desc 'This method is used to leave a channel.'
+  g.long_desc %( This method is used to leave a channel. )
   g.command 'leave' do |c|
     c.flag 'channel', desc: 'Channel to leave.'
     c.action do |_global_options, options, _args|
@@ -101,8 +101,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'Lists all channels in a Slack team.'
-  g.long_desc %( Lists all channels in a Slack team. )
+  g.desc "Don't use this method. Use conversations.list instead."
+  g.long_desc %( Don't use this method. Use conversations.list instead. )
   g.command 'list' do |c|
     c.flag 'cursor', desc: "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection. See pagination for more detail."
     c.flag 'exclude_archived', desc: 'Exclude archived channels from the list.'
@@ -113,8 +113,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'Sets the read cursor in a channel.'
-  g.long_desc %( Sets the read cursor in a channel. )
+  g.desc 'This method moves the read cursor in a channel.'
+  g.long_desc %( This method moves the read cursor in a channel. )
   g.command 'mark' do |c|
     c.flag 'channel', desc: 'Channel to set reading cursor in.'
     c.flag 'ts', desc: 'Timestamp of the most recently seen message.'
@@ -123,8 +123,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'Renames a channel.'
-  g.long_desc %( Renames a channel. )
+  g.desc 'This method renames a team channel.'
+  g.long_desc %( This method renames a team channel. )
   g.command 'rename' do |c|
     c.flag 'channel', desc: 'Channel to rename.'
     c.flag 'name', desc: 'New name for channel.'
@@ -134,8 +134,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'Retrieve a thread of messages posted to a channel'
-  g.long_desc %( Retrieve a thread of messages posted to a channel )
+  g.desc 'This method returns an entire thread (a message plus all the messages in reply to it).'
+  g.long_desc %( This method returns an entire thread (a message plus all the messages in reply to it). )
   g.command 'replies' do |c|
     c.flag 'channel', desc: 'Channel to fetch thread from.'
     c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."
@@ -144,18 +144,19 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'Sets the purpose for a channel.'
-  g.long_desc %( Sets the purpose for a channel. )
+  g.desc 'This method is used to change the purpose of a channel. The calling user must be a member of the channel.'
+  g.long_desc %( This method is used to change the purpose of a channel. The calling user must be a member of the channel. )
   g.command 'setPurpose' do |c|
     c.flag 'channel', desc: 'Channel to set the purpose of.'
     c.flag 'purpose', desc: 'The new purpose.'
+    c.flag 'name_tagging', desc: 'if it is true, treat this like a message and not an unescaped thing.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.channels_setPurpose(options))
     end
   end
 
-  g.desc 'Sets the topic for a channel.'
-  g.long_desc %( Sets the topic for a channel. )
+  g.desc 'This method is used to change the topic of a channel. The calling user must be a member of the channel.'
+  g.long_desc %( This method is used to change the topic of a channel. The calling user must be a member of the channel. )
   g.command 'setTopic' do |c|
     c.flag 'channel', desc: 'Channel to set the topic of.'
     c.flag 'topic', desc: 'The new topic.'
@@ -164,8 +165,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'Unarchives a channel.'
-  g.long_desc %( Unarchives a channel. )
+  g.desc 'This method unarchives a channel. The calling user is added to the channel.'
+  g.long_desc %( This method unarchives a channel. The calling user is added to the channel. )
   g.command 'unarchive' do |c|
     c.flag 'channel', desc: 'Channel to unarchive.'
     c.action do |_global_options, options, _args|

data/bin/commands/chat.rb

@@ -1,6 +1,6 @@
 # This file was auto-generated by lib/tasks/web.rake
 
-desc 'Post chat messages to Slack.'
+desc 'Chat methods.'
 command 'chat' do |g|
   g.desc 'Execute a slash command in a public channel (undocumented)'
   g.long_desc %( Execute a slash command in a public channel )
@@ -13,8 +13,8 @@ command 'chat' do |g|
     end
   end
 
-  g.desc 'Deletes a message.'
-  g.long_desc %( Deletes a message. )
+  g.desc 'This method deletes a message from a channel.'
+  g.long_desc %( This method deletes a message from a channel. )
   g.command 'delete' do |c|
     c.flag 'channel', desc: 'Channel containing the message to be deleted.'
     c.flag 'ts', desc: 'Timestamp of the message to be deleted.'
@@ -24,8 +24,19 @@ command 'chat' do |g|
     end
   end
 
-  g.desc 'Retrieve a permalink URL for a specific extant message'
-  g.long_desc %( Retrieve a permalink URL for a specific extant message )
+  g.desc 'This method deletes a pending scheduled message before it is sent.'
+  g.long_desc %( This method deletes a pending scheduled message before it is sent. )
+  g.command 'deleteScheduledMessage' do |c|
+    c.flag 'channel', desc: 'The channel the scheduled_message is posting to.'
+    c.flag 'scheduled_message_id', desc: 'scheduled_message_id returned from call to chat.scheduleMessage.'
+    c.flag 'as_user', desc: 'Pass true to delete the message as the authed user with chat:write:user scope. Bot users in this context are considered authed users. If unused or false, the message will be deleted with chat:write:bot scope.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.chat_deleteScheduledMessage(options))
+    end
+  end
+
+  g.desc 'Easily exchange a message timestamp and a channel ID for a friendly HTTP-based permalink to that message. Handles message threads and all conversation types.'
+  g.long_desc %( Easily exchange a message timestamp and a channel ID for a friendly HTTP-based permalink to that message. Handles message threads and all conversation types. )
   g.command 'getPermalink' do |c|
     c.flag 'channel', desc: 'The ID of the conversation or channel containing the message.'
     c.flag 'message_ts', desc: "A message's ts value, uniquely identifying it within a channel."
@@ -34,8 +45,8 @@ command 'chat' do |g|
     end
   end
 
-  g.desc 'Share a me message into a channel.'
-  g.long_desc %( Share a me message into a channel. )
+  g.desc 'This method sends a me message to a channel from the calling user.'
+  g.long_desc %( This method sends a me message to a channel from the calling user. )
   g.command 'meMessage' do |c|
     c.flag 'channel', desc: 'Channel to send message to. Can be a public channel, private group or IM channel. Can be an encoded ID, or a name.'
     c.flag 'text', desc: 'Text of the message to send.'
@@ -44,8 +55,8 @@ command 'chat' do |g|
     end
   end
 
-  g.desc 'Sends an ephemeral message to a user in a channel.'
-  g.long_desc %( Sends an ephemeral message to a user in a channel. )
+  g.desc 'This method posts an ephemeral message, which is visible only to the assigned user in a specific public channel, private channel, or private conversation.'
+  g.long_desc %( This method posts an ephemeral message, which is visible only to the assigned user in a specific public channel, private channel, or private conversation. )
   g.command 'postEphemeral' do |c|
     c.flag 'channel', desc: 'Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name.'
     c.flag 'text', desc: "Text of the message to send. See below for an explanation of formatting. This field is usually required, unless you're providing only attachments instead."
@@ -55,14 +66,14 @@ command 'chat' do |g|
     c.flag 'blocks', desc: 'A JSON-based array of structured blocks, presented as a URL-encoded string.'
     c.flag 'link_names', desc: 'Find and link channel names and usernames.'
     c.flag 'parse', desc: 'Change how messages are treated. Defaults to none. See below.'
-    c.flag 'thread_ts', desc: "Provide another message's ts value to make this message a reply. Avoid using a reply's ts value; use its parent instead."
+    c.flag 'thread_ts', desc: "Provide another message's ts value to post this message in a thread. Avoid using a reply's ts value; use its parent's value instead. Ephemeral messages in threads are only shown if there is already an active thread."
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.chat_postEphemeral(options))
     end
   end
 
-  g.desc 'Sends a message to a channel.'
-  g.long_desc %( Sends a message to a channel. )
+  g.desc 'This method posts a message to a public channel, private channel, or direct message/IM channel.'
+  g.long_desc %( This method posts a message to a public channel, private channel, or direct message/IM channel. )
   g.command 'postMessage' do |c|
     c.flag 'channel', desc: 'Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name. See below for more details.'
     c.flag 'text', desc: "Text of the message to send. See below for an explanation of formatting. This field is usually required, unless you're providing only attachments instead. Provide no more than 40,000 characters or risk truncation."
@@ -84,12 +95,32 @@ command 'chat' do |g|
     end
   end
 
-  g.desc 'Provide custom unfurl behavior for user-posted URLs'
-  g.long_desc %( Provide custom unfurl behavior for user-posted URLs )
+  g.desc 'This method schedules a message for delivery to a public channel, private channel, or direct message/IM channel at a specified time in the future.'
+  g.long_desc %( This method schedules a message for delivery to a public channel, private channel, or direct message/IM channel at a specified time in the future. )
+  g.command 'scheduleMessage' do |c|
+    c.flag 'channel', desc: 'Channel, private group, or DM channel to send message to. Can be an encoded ID, or a name. See below for more details.'
+    c.flag 'post_at', desc: 'Unix EPOCH timestamp of time in future to send the message.'
+    c.flag 'text', desc: "Text of the message to send. See below for an explanation of formatting. This field is usually required, unless you're providing only attachments instead. Provide no more than 40,000 characters or risk truncation."
+    c.flag 'as_user', desc: 'Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See authorship below.'
+    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 'link_names', desc: 'Find and link channel names and usernames.'
+    c.flag 'parse', desc: 'Change how messages are treated. Defaults to none. See below.'
+    c.flag 'reply_broadcast', desc: 'Used in conjunction with thread_ts and indicates whether reply should be made visible to everyone in the channel or conversation. Defaults to false.'
+    c.flag 'thread_ts', desc: "Provide another message's ts value to make this message a reply. Avoid using a reply's ts value; use its parent instead."
+    c.flag 'unfurl_links', desc: 'Pass true to enable unfurling of primarily text-based content.'
+    c.flag 'unfurl_media', desc: 'Pass false to disable unfurling of media content.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.chat_scheduleMessage(options))
+    end
+  end
+
+  g.desc 'This method attaches Slack app unfurl behavior to a specified and relevant message. A user token is required as this method does not support bot user tokens.'
+  g.long_desc %( This method attaches Slack app unfurl behavior to a specified and relevant message. A user token is required as this method does not support bot user tokens. )
   g.command 'unfurl' do |c|
     c.flag 'channel', desc: 'Channel ID of the message.'
     c.flag 'ts', desc: 'Timestamp of the message to add unfurl behavior to.'
-    c.flag 'unfurls', desc: 'URL-encoded JSON map with keys set to URLs featured in the the message, pointing to their unfurl message attachments.'
+    c.flag 'unfurls', desc: 'URL-encoded JSON map with keys set to URLs featured in the the message, pointing to their unfurl blocks or message attachments.'
     c.flag 'user_auth_message', desc: 'Provide a simply-formatted string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior.'
     c.flag 'user_auth_required', desc: 'Set to true or 1 to indicate the user must install your Slack app to trigger unfurls for this domain.'
     c.flag 'user_auth_url', desc: 'Send users to this custom URL where they will complete authentication in your app to fully trigger unfurling. Value should be properly URL-encoded.'
@@ -98,8 +129,8 @@ command 'chat' do |g|
     end
   end
 
-  g.desc 'Updates a message.'
-  g.long_desc %( Updates a message. )
+  g.desc 'This method updates a message in a channel. Though related to chat.postMessage, some parameters of chat.update are handled differently.'
+  g.long_desc %( This method updates a message in a channel. Though related to chat.postMessage, some parameters of chat.update are handled differently. )
   g.command 'update' do |c|
     c.flag 'channel', desc: 'Channel containing the message to be updated.'
     c.flag 'text', desc: "New text for the message, using the default formatting rules. It's not required when presenting attachments."