Merge branch 'main' into feat/block-kit-data-table-example

Author: zimeg

.github/dependabot.yml

@@ -4,19 +4,45 @@ updates:
     directory: "/"
     schedule:
       interval: "daily"
+    cooldown:
+      default-days: 7
   - package-ecosystem: "pip"
     directory: "ai/slackbot-mcp-client/no-auth"
     schedule:
       interval: "daily"
+    cooldown:
+      default-days: 7
+      exclude:
+        - "slack*"
   - package-ecosystem: "pip"
     directory: "ai/slackbot-mcp-client/rich-responses/mcp-apps"
     schedule:
       interval: "daily"
+    cooldown:
+      default-days: 7
+      exclude:
+        - "slack*"
   - package-ecosystem: "pip"
     directory: "ai/slackbot-mcp-client/slack-identity"
     schedule:
       interval: "daily"
+    cooldown:
+      default-days: 7
+      exclude:
+        - "slack*"
   - package-ecosystem: "pip"
     directory: "block-kit"
     schedule:
       interval: "daily"
+    cooldown:
+      default-days: 7
+      exclude:
+        - "slack*"
+  - package-ecosystem: "pip"
+    directory: "methods"
+    schedule:
+      interval: "daily"
+    cooldown:
+      default-days: 7
+      exclude:
+        - "slack*"

.github/workflows/test.yml

@@ -8,6 +8,8 @@ jobs:
   test:
     name: "pytest@python3.14"
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
     strategy:
       fail-fast: false
       matrix:
@@ -16,11 +18,14 @@ jobs:
           - "ai/slackbot-mcp-client/rich-responses/mcp-apps"
           - "ai/slackbot-mcp-client/slack-identity"
           - "block-kit"
+          - "methods"
     steps:
       - name: Checkout code
-        uses: actions/checkout@v7
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
       - name: Install Python
-        uses: actions/setup-python@v7
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
         with:
           python-version: "3.14"
       - name: Run tests
@@ -30,4 +35,4 @@ jobs:
           ruff check
           ruff format --diff --check
           mypy .
-          pytest -v
+          if [ -d tests ]; then pytest -v; fi

README.md

@@ -6,3 +6,4 @@ This collections of examples highlights features of a Slack app in the language
 
 - **[AI in Slack](./ai)**: Agent experiences and MCP features in an interactive conversation interface.
 - **[Block Kit](./block-kit)**: The framework of visual components arranged to create app layouts.
+- **[Methods](./methods)**: An interface for querying information from and enacting change in a Slack workspace.

ai/slackbot-mcp-client/no-auth/requirements.txt

@@ -1,10 +1,10 @@
-httpx2==2.9.1
-mcp==2.0.0
-mypy==2.3.0
+httpx2==2.13.1
+mcp==2.2.0
+mypy==2.3.1
 pytest==9.1.1
-ruff==0.16.1
+ruff==0.16.9
 slack_bolt==1.30.0
 slack_cli_hooks==0.3.0
-slack_sdk==3.43.0
-starlette==1.3.1
-uvicorn==0.52.0
+slack_sdk==3.45.0
+starlette==1.7.0
+uvicorn==0.54.0

ai/slackbot-mcp-client/rich-responses/mcp-apps/requirements.txt

@@ -1,10 +1,10 @@
-httpx2==2.9.1
-mcp==2.0.0
-mypy==2.3.0
+httpx2==2.13.1
+mcp==2.2.0
+mypy==2.3.1
 pytest==9.1.1
-ruff==0.16.1
+ruff==0.16.9
 slack_bolt==1.30.0
 slack_cli_hooks==0.3.0
-slack_sdk==3.43.0
-starlette==1.3.1
-uvicorn==0.52.0
+slack_sdk==3.45.0
+starlette==1.7.0
+uvicorn==0.54.0

ai/slackbot-mcp-client/slack-identity/requirements.txt

@@ -1,10 +1,10 @@
-httpx2==2.9.1
-mcp==2.0.0
-mypy==2.3.0
+httpx2==2.13.1
+mcp==2.2.0
+mypy==2.3.1
 pytest==9.1.1
-ruff==0.16.1
+ruff==0.16.9
 slack_bolt==1.30.0
 slack_cli_hooks==0.3.0
-slack_sdk==3.43.0
-starlette==1.3.1
-uvicorn==0.52.0
+slack_sdk==3.45.0
+starlette==1.7.0
+uvicorn==0.54.0

block-kit/AGENTS.md

@@ -0,0 +1,83 @@
+# Adding a Block Example
+
+A block example is **code-complete** when all four of these are present:
+
+1. Example file
+2. Test file
+3. README entry
+4. Correct docstring
+
+## Example file
+
+Create `src/blocks/{type}.py`:
+
+```python
+from slack_sdk.models.blocks import {Type}Block
+from slack_sdk.models.blocks.basic_components import MarkdownTextObject, PlainTextObject
+from slack_sdk.models.blocks.block_elements import ButtonElement, ImageElement
+
+
+def example01() -> {Type}Block:
+    """
+    {Description from docs page — must match exactly}.
+    https://docs.slack.dev/reference/block-kit/blocks/{type}-block/
+
+    {Brief description of this specific example}.
+    """
+    block = {Type}Block(
+        # fields here
+    )
+    return block
+```
+
+Rules:
+- One file per block type in `src/blocks/`
+- Each example is a module-level function returning the block type
+- Functions named `example01()`, `example02()`, etc. with return type annotation
+- Import blocks from `slack_sdk.models.blocks`
+- Import text objects from `slack_sdk.models.blocks.basic_components`
+- Import elements from `slack_sdk.models.blocks.block_elements`
+- The docstring first line must match the docs page `description` field exactly (found in the page's YAML frontmatter)
+
+## Test file
+
+Create `tests/blocks/test_{type}.py`:
+
+```python
+import json
+
+from src.blocks import {type}
+
+
+def test_example01():
+    block = {type}.example01()
+    actual = block.to_dict()
+    expected = {
+        "type": "{type}",
+        # fields matching the docs JSON example
+    }
+    assert json.dumps(actual, sort_keys=True) == json.dumps(expected, sort_keys=True)
+```
+
+The expected dict must match the docs page JSON example exactly (minus the outer `"blocks": [...]` wrapper).
+
+## README entry
+
+Add an entry to `block-kit/README.md` in alphabetical order under `### Blocks`:
+
+```markdown
+- **[{Name}](https://docs.slack.dev/reference/block-kit/blocks/{type}-block)**: {Description matching docs}. [Implementation](./src/blocks/{type}.py).
+```
+
+The description must match the docs page `description` field exactly.
+
+## Lint and verify
+
+```bash
+cd block-kit
+ruff check src/blocks/{type}.py tests/blocks/test_{type}.py
+ruff format --check src/blocks/{type}.py tests/blocks/test_{type}.py
+pytest tests/blocks/test_{type}.py
+```
+
+All must pass. Use `ruff format` (without `--check`) to auto-fix formatting.

block-kit/README.md

@@ -9,6 +9,10 @@ Read the [docs](https://docs.slack.dev/block-kit/) to learn concepts behind thes
 ### Blocks
 
 - **[Actions](https://docs.slack.dev/reference/block-kit/blocks/actions-block)**: Holds multiple interactive elements. [Implementation](./src/blocks/actions.py).
+- **[Alert](https://docs.slack.dev/reference/block-kit/blocks/alert-block)**: Displays alerts, warnings, and informational messages. [Implementation](./src/blocks/alert.py).
+- **[Card](https://docs.slack.dev/reference/block-kit/blocks/card-block)**: Displays content in a card. [Implementation](./src/blocks/card.py).
+- **[Carousel](https://docs.slack.dev/reference/block-kit/blocks/carousel-block)**: Displays related card blocks in a horizontally-scrolling container. [Implementation](./src/blocks/carousel.py).
+- **[Container](https://docs.slack.dev/reference/block-kit/blocks/container-block)**: A general-purpose wrapper for grouping child blocks together, with a configurable size. [Implementation](./src/blocks/container.py).
 - **[Context](https://docs.slack.dev/reference/block-kit/blocks/context-block)**: Provides contextual info, which can include both images and text. [Implementation](./src/blocks/context.py).
 - **[Context actions](https://docs.slack.dev/reference/block-kit/blocks/context-actions-block)**: Displays actions as contextual info, which can include both feedback buttons and icon buttons. [Implementation](./src/blocks/context_actions.py).
 - **[Data table](https://docs.slack.dev/reference/block-kit/blocks/data-table-block)**: Displays rich tables that support pagination, sorting, filtering, and interactivity. [Implementation](./src/blocks/data_table.py).
@@ -19,7 +23,56 @@ Read the [docs](https://docs.slack.dev/block-kit/) to learn concepts behind thes
 - **[Input](https://docs.slack.dev/reference/block-kit/blocks/input-block)**: Collects information from users via elements. [Implementation](./src/blocks/input.py).
 - **[Markdown](https://docs.slack.dev/reference/block-kit/blocks/markdown-block)**: Displays formatted markdown. [Implementation](./src/blocks/markdown.py).
 - **[Plan](https://docs.slack.dev/reference/block-kit/blocks/plan-block)**: Displays a collection of related tasks. [Implementation](./src/blocks/plan.py).
-- **[Rich text](https://docs.slack.dev/reference/block-kit/blocks/rich-text-block)**: Displays formatted, structured representation of text. [Implementation](./src/blocks/rich_text.py).
 - **[Section](https://docs.slack.dev/reference/block-kit/blocks/section-block)**: Displays text, possibly alongside elements. [Implementation](./src/blocks/section.py).
+- **[Table](https://docs.slack.dev/reference/block-kit/blocks/table-block)**: Displays structured information in a table. [Implementation](./src/blocks/table.py).
 - **[Task card](https://docs.slack.dev/reference/block-kit/blocks/task-card-block)**: Displays a single task, representing a single action. [Implementation](./src/blocks/task_card.py).
 - **[Video](https://docs.slack.dev/reference/block-kit/blocks/video-block)**: Displays an embedded video player. [Implementation](./src/blocks/video.py).
+
+### Block elements
+
+- **[Broadcast](https://docs.slack.dev/reference/block-kit/block-elements/broadcast-element)**: Displays a broadcast mention such as here, channel, or everyone. [Implementation](./src/elements/broadcast.py).
+- **[Button](https://docs.slack.dev/reference/block-kit/block-elements/button-element)**: Allows users a direct path to performing basic actions. [Implementation](./src/elements/button.py).
+- **[Channel](https://docs.slack.dev/reference/block-kit/block-elements/channel-element)**: Renders as a mention of a channel. [Implementation](./src/elements/channel.py).
+- **[Checkboxes](https://docs.slack.dev/reference/block-kit/block-elements/checkboxes-element)**: Allows users to choose multiple items from a list of options. [Implementation](./src/elements/checkboxes.py).
+- **[Color](https://docs.slack.dev/reference/block-kit/block-elements/color-element)**: Displays a color swatch from a hex value. [Implementation](./src/elements/color.py).
+- **[Date](https://docs.slack.dev/reference/block-kit/block-elements/date-element)**: Displays a formatted, localized date. [Implementation](./src/elements/date.py).
+- **[Date picker](https://docs.slack.dev/reference/block-kit/block-elements/date-picker-element)**: Allows users to select a date from a calendar style UI. [Implementation](./src/elements/date_picker.py).
+- **[Datetime picker](https://docs.slack.dev/reference/block-kit/block-elements/datetime-picker-element)**: Allows users to select both a date and a time of day. [Implementation](./src/elements/datetime_picker.py).
+- **[Email input](https://docs.slack.dev/reference/block-kit/block-elements/email-input-element)**: Allows user to enter an email into a single-line field. [Implementation](./src/elements/email_input.py).
+- **[Emoji](https://docs.slack.dev/reference/block-kit/block-elements/emoji-element)**: Displays an emoji. [Implementation](./src/elements/emoji.py).
+- **[Feedback buttons](https://docs.slack.dev/reference/block-kit/block-elements/feedback-buttons-element)**: Buttons to indicate positive or negative feedback. [Implementation](./src/elements/feedback_buttons.py).
+- **[File input](https://docs.slack.dev/reference/block-kit/block-elements/file-input-element)**: Allows user to upload files. [Implementation](./src/elements/file_input.py).
+- **[Icon button](https://docs.slack.dev/reference/block-kit/block-elements/icon-button-element)**: An icon button to perform actions. [Implementation](./src/elements/icon_button.py).
+- **[Image](https://docs.slack.dev/reference/block-kit/block-elements/image-element)**: Displays an image as part of a larger block of content. [Implementation](./src/elements/image.py).
+- **[Link](https://docs.slack.dev/reference/block-kit/block-elements/link-element)**: Displays a hyperlink. [Implementation](./src/elements/link.py).
+- **[Multi-select menu](https://docs.slack.dev/reference/block-kit/block-elements/multi-select-menu-element)**: Allows users to select multiple items from a list of options. [Implementation](./src/elements/multi_select_menu.py).
+- **[Number input](https://docs.slack.dev/reference/block-kit/block-elements/number-input-element)**: Allows user to enter a number into a single-line field. [Implementation](./src/elements/number_input.py).
+- **[Overflow menu](https://docs.slack.dev/reference/block-kit/block-elements/overflow-menu-element)**: Allows users to press a button to view a list of options. [Implementation](./src/elements/overflow_menu.py).
+- **[Plain-text input](https://docs.slack.dev/reference/block-kit/block-elements/plain-text-input-element)**: Allows users to enter freeform text data into a single-line or multi-line field. [Implementation](./src/elements/plain_text_input.py).
+- **[Radio button group](https://docs.slack.dev/reference/block-kit/block-elements/radio-button-group-element)**: Allows users to choose one item from a list of possible options. [Implementation](./src/elements/radio_buttons.py).
+- **[Rich text input](https://docs.slack.dev/reference/block-kit/block-elements/rich-text-input-element)**: Allows users to enter formatted text in a WYSIWYG composer, offering the same messaging writing experience as in Slack. [Implementation](./src/elements/rich_text_input.py).
+- **[Rich text list](https://docs.slack.dev/reference/block-kit/block-elements/rich-text-list-element)**: Displays a list of rich text items. [Implementation](./src/elements/rich_text_list.py).
+- **[Rich text preformatted](https://docs.slack.dev/reference/block-kit/block-elements/rich-text-preformatted-element)**: Displays a preformatted rich text element. [Implementation](./src/elements/rich_text_preformatted.py).
+- **[Rich text quote](https://docs.slack.dev/reference/block-kit/block-elements/rich-text-quote-element)**: Displays a rich text quote block. [Implementation](./src/elements/rich_text_quote.py).
+- **[Rich text section](https://docs.slack.dev/reference/block-kit/block-elements/rich-text-section-element)**: A section element that holds rich text elements. [Implementation](./src/elements/rich_text_section.py).
+- **[Select menu](https://docs.slack.dev/reference/block-kit/block-elements/select-menu-element)**: Allows users to choose an option from a drop down menu. [Implementation](./src/elements/select_menu.py).
+- **[Team](https://docs.slack.dev/reference/block-kit/block-elements/team-element)**: Renders as a mention of a workspace or team. [Implementation](./src/elements/team.py).
+- **[Text](https://docs.slack.dev/reference/block-kit/block-elements/text-element)**: Displays text, optionally with styling. [Implementation](./src/elements/text.py).
+- **[Time picker](https://docs.slack.dev/reference/block-kit/block-elements/time-picker-element)**: Allows users to enter numerical data into a single-line field. [Implementation](./src/elements/time_picker.py).
+- **[URL input](https://docs.slack.dev/reference/block-kit/block-elements/url-input-element)**: Allows user to enter a URL into a single-line field. [Implementation](./src/elements/url_input.py).
+- **[URL source](https://docs.slack.dev/reference/block-kit/block-elements/url-source-element)**: Displays a URL source for referencing within a task card block. [Implementation](./src/elements/url_source.py).
+- **[User](https://docs.slack.dev/reference/block-kit/block-elements/user-element)**: Renders as a mention of a user. [Implementation](./src/elements/user.py).
+- **[Usergroup](https://docs.slack.dev/reference/block-kit/block-elements/usergroup-element)**: Renders as a mention of a user group. [Implementation](./src/elements/usergroup.py).
+- **[Workflow button](https://docs.slack.dev/reference/block-kit/block-elements/workflow-button-element)**: Allows users to run a link trigger with customizable inputs. [Implementation](./src/elements/workflow_button.py).
+
+### Composition objects
+
+- **[Confirmation dialog](https://docs.slack.dev/reference/block-kit/composition-objects/confirmation-dialog-object)**: Defines a dialog that adds a confirmation step to interactive elements. [Implementation](./src/compositions/confirmation_dialog.py).
+- **[Conversation filter](https://docs.slack.dev/reference/block-kit/composition-objects/conversation-filter-object)**: Defines a filter for the list of options in a conversation selector menu. [Implementation](./src/compositions/conversation_filter.py).
+- **[Dispatch action configuration](https://docs.slack.dev/reference/block-kit/composition-objects/dispatch-action-configuration-object)**: Defines when a plain-text input element will return a `block_actions` interaction payload. [Implementation](./src/compositions/dispatch_action_configuration.py).
+- **[Option group](https://docs.slack.dev/reference/block-kit/composition-objects/option-group-object)**: Defines a way to group options in a menu. [Implementation](./src/compositions/option_group.py).
+- **[Option](https://docs.slack.dev/reference/block-kit/composition-objects/option-object)**: Defines a single item in a number of item selection elements. [Implementation](./src/compositions/option.py).
+- **[Slack file](https://docs.slack.dev/reference/block-kit/composition-objects/slack-file-object)**: Defines an object containing Slack file information to be used in an image block or image element. [Implementation](./src/compositions/slack_file.py).
+- **[Text](https://docs.slack.dev/reference/block-kit/composition-objects/text-object)**: Defines an object containing some text. [Implementation](./src/compositions/text.py).
+- **[Trigger](https://docs.slack.dev/reference/block-kit/composition-objects/trigger-object)**: Defines an object containing trigger information. [Implementation](./src/compositions/trigger.py).
+- **[Workflow](https://docs.slack.dev/reference/block-kit/composition-objects/workflow-object)**: Defines an object containing workflow information. [Implementation](./src/compositions/workflow.py).

block-kit/requirements.txt

@@ -1,4 +1,4 @@
-mypy==2.3.0
+mypy==2.3.1
 pytest==9.1.1
-ruff==0.16.1
-slack_sdk==3.43.0
+ruff==0.16.9
+slack_sdk==3.45.0

block-kit/src/blocks/alert.py

@@ -0,0 +1,16 @@
+from slack_sdk.models.blocks import AlertBlock
+from slack_sdk.models.blocks.basic_components import MarkdownTextObject
+
+
+def example01() -> AlertBlock:
+    """
+    Displays alerts, warnings, and informational messages.
+    https://docs.slack.dev/reference/block-kit/blocks/alert-block/
+
+    An informational alert.
+    """
+    block = AlertBlock(
+        text=MarkdownTextObject(text="The work is mysterious and important."),
+        level="info",
+    )
+    return block