Merge branch 'main' into mwbrooks-hardcoded-casey-mention

Author: mwbrooks

README.md

@@ -18,11 +18,12 @@ All implementations share the same Slack listener layer, the same five simulated
 
 ## What Casey Can Do
 
-Casey gives your team instant IT support through three entry points:
+Casey gives your team instant IT support through four entry points:
 
 * **App Home** — Choose from common issue categories. A modal collects details, then Casey starts a DM thread with a resolution.
 * **Direct Messages** — Describe any IT issue and Casey responds in-thread, maintaining context across follow-ups.
 * **Channel @mentions** — Mention `@Casey` in any channel to get help without leaving the conversation.
+* **Assistant Panel** — Users click _Add Agent_ in Slack, select Casey, and pick from suggested prompts or describe an issue.
 
 Behind the scenes, Casey has access to five simulated tools: knowledge base search, support ticket creation, password reset, system status checks, and user permissions lookup.
 
@@ -32,6 +33,17 @@ Behind the scenes, Casey has access to five simulated tools: knowledge base sear
 
 Casey also works with the [Slack MCP Server](https://docs.slack.dev/agents-ai/model-context-protocol), giving it the ability to search messages and files, read channel history and threads, send messages, schedule messages, and create or update Slack canvases. When deployed with OAuth (HTTP mode), Casey automatically connects to the Slack MCP Server using the user's token, unlocking these capabilities on top of the built-in IT tools.
 
+## Using the App
+
+Once Casey is running, there are several ways to interact:
+
+* **App Home** — Open Casey in Slack and click the _Home_ tab. Choose from common issue categories, describe your issue in the modal, and Casey starts a DM thread with a resolution.
+* **Direct Messages** — Open a DM with Casey. Pick a suggested prompt or describe your issue, and Casey will reply in a thread.
+* **Channel @mentions** — Invite Casey to a channel by typing `/invite @Casey`, then type `@Casey` followed by your issue. Casey responds in a thread so the channel stays clean.
+* **Assistant Panel** — Click _Add Agent_ in the top-right corner of Slack, select Casey, and choose a suggested prompt like _Reset Password_, _Request Access_, or _Network Issues_.
+
+For full setup instructions, pick a framework above and follow the README in that directory.
+
 ## Local Development
 
 This repo uses [`slack-bolt`](https://pypi.org/project/slack-bolt/) from PyPI.

claude-agent-sdk/README.md

@@ -6,11 +6,12 @@ Built with [Bolt for Python](https://docs.slack.dev/tools/bolt-python/) and the
 
 ## App Overview
 
-Casey gives your team instant IT support through three entry points:
+Casey gives your team instant IT support through four entry points:
 
 * **App Home** — Users open Casey's Home tab and choose from common issue categories (Password Reset, Access Request, Software Help, Network Issues, Something Else). A modal collects details, then Casey starts a DM thread with a resolution.
 * **Direct Messages** — Users message Casey directly to describe any IT issue. Casey responds in-thread, maintaining context across follow-ups.
 * **Channel @mentions** — Users mention `@Casey` in any channel to get help without leaving the conversation.
+* **Assistant Panel** — Users click _Add Agent_ in Slack, select Casey, and pick from suggested prompts or describe an issue.
 
 Casey uses five simulated tools to assist users:
 
@@ -241,13 +242,15 @@ python3 app_oauth.py
 
 ### Using the App
 
-Once Casey is running, there are three ways to interact:
+Once Casey is running, there are several ways to interact:
 
 **App Home** — Open Casey in Slack and click the _Home_ tab. You'll see five category buttons. Click one to open a modal, describe your issue, and submit. Casey will start a DM thread with you containing a diagnosis and next steps.
 
-**Direct Messages** — Open a DM with Casey and describe your issue. Casey will react with :eyes: while processing, then reply in a thread. Send follow-up messages in the same thread and Casey will maintain the full conversation context.
+**Direct Messages** — Open a DM with Casey. You'll see suggested prompts like _Reset Password_, _Request Access_, and _Network Issues_ — pick one or describe your own issue. Casey will react with :eyes: while processing, then reply in a thread. Send follow-up messages in the same thread and Casey will maintain the full conversation context.
 
-**Channel @mentions** — In any channel where Casey has been added, type `@Casey` followed by your issue. Casey responds in a thread so the channel stays clean.
+**Channel @mentions** — Invite Casey to a channel by typing `/invite @Casey` in the message box, then type `@Casey` followed by your issue. Casey responds in a thread so the channel stays clean.
+
+**Assistant Panel** — Click _Add Agent_ in the top-right corner of Slack, select Casey from the list, then pick a suggested prompt or type a message.
 
 Casey will add a :white_check_mark: reaction when it believes an issue has been resolved, and occasionally adds a contextual emoji reaction to keep things friendly.
 

claude-agent-sdk/app_oauth.py

@@ -2,6 +2,7 @@
 import logging
 import os
 from pathlib import Path
+from urllib.parse import urljoin
 
 from dotenv import load_dotenv
 from slack_bolt.async_app import AsyncApp
@@ -120,4 +121,8 @@ async def _authorize_with_fallback_bot_token(
 
 if __name__ == "__main__":
     port = int(os.environ.get("PORT", 3000))
+    redirect_uri = os.environ.get("SLACK_REDIRECT_URI", "")
+    if redirect_uri:
+        install_url = urljoin(redirect_uri, "/slack/install")
+        logger.info("Connect the Slack MCP Server: %s", install_url)
     app.start(port=port)

claude-agent-sdk/listeners/views/app_home_builder.py

@@ -132,6 +132,27 @@ def build_app_home_view(
                 ],
             }
         )
+    else:
+        blocks.append(
+            {
+                "type": "section",
+                "text": {
+                    "type": "mrkdwn",
+                    "text": "\U0001f534 *Slack MCP Server is disconnected.* <https://github.com/slack-samples/bolt-python-support-agent/blob/main/claude-agent-sdk/README.md#slack-mcp-server|Learn how to enable the Slack MCP Server.>",
+                },
+            }
+        )
+        blocks.append(
+            {
+                "type": "context",
+                "elements": [
+                    {
+                        "type": "mrkdwn",
+                        "text": "The Slack MCP Server enables Casey to search messages, read channels, and more.",
+                    }
+                ],
+            }
+        )
 
     return {
         "type": "home",

claude-agent-sdk/pyproject.toml

@@ -6,8 +6,8 @@ dependencies = [
     "slack-sdk==3.41.0",
     "slack-bolt>=1.28.0",
     "slack-cli-hooks<1.0.0",
-    "claude-agent-sdk>=0.1.36",
-    "aiohttp>=3.13.3",
+    "claude-agent-sdk>=0.1.61",
+    "aiohttp>=3.13.5",
     "python-dotenv==1.2.2",
 ]
 
@@ -18,7 +18,7 @@ test = [
 ]
 dev = [
     "bolt-python-support-agent-claude[test]",
-    "ruff==0.15.10",
+    "ruff==0.15.11",
 ]
 
 [tool.setuptools.packages.find]

claude-agent-sdk/requirements.txt

@@ -6,4 +6,4 @@ aiohttp>=3.13.3
 python-dotenv==1.2.2
 
 pytest
-ruff==0.15.10
+ruff==0.15.11

claude-agent-sdk/tests/test_view_builders.py

@@ -26,7 +26,7 @@ def test_build_feedback_blocks():
 
 
 def test_build_app_home_view_default():
-    """Default args (app.py mode) — no MCP status section."""
+    """Default args (Socket Mode) — shows disconnected status with learn-more link."""
     view = build_app_home_view()
 
     assert view["type"] == "home"
@@ -35,11 +35,13 @@ def test_build_app_home_view_default():
     actions_block = next(b for b in view["blocks"] if b["type"] == "actions")
     assert len(actions_block["elements"]) == len(CATEGORIES)
 
-    # No MCP status section
+    # Shows MCP status as disconnected with learn-more link
     section_texts = [
         b["text"]["text"] for b in view["blocks"] if b["type"] == "section"
     ]
-    assert not any("Slack MCP Server" in t for t in section_texts)
+    mcp_section = next(t for t in section_texts if "Slack MCP Server" in t)
+    assert "disconnected" in mcp_section
+    assert "Learn how to enable" in mcp_section
 
 
 def test_build_app_home_view_connect():

openai-agents-sdk/README.md

@@ -6,11 +6,12 @@ Built with [Bolt for Python](https://docs.slack.dev/tools/bolt-python/) and [Ope
 
 ## App Overview
 
-Casey gives your team instant IT support through three entry points:
+Casey gives your team instant IT support through four entry points:
 
 * **App Home** — Users open Casey's Home tab and choose from common issue categories (Password Reset, Access Request, Software Help, Network Issues, Something Else). A modal collects details, then Casey starts a DM thread with a resolution.
 * **Direct Messages** — Users message Casey directly to describe any IT issue. Casey responds in-thread, maintaining context across follow-ups.
 * **Channel @mentions** — Users mention `@Casey` in any channel to get help without leaving the conversation.
+* **Assistant Panel** — Users click _Add Agent_ in Slack, select Casey, and pick from suggested prompts or describe an issue.
 
 Casey uses five simulated tools to assist users:
 
@@ -241,13 +242,15 @@ python3 app_oauth.py
 
 ### Using the App
 
-Once Casey is running, there are three ways to interact:
+Once Casey is running, there are several ways to interact:
 
 **App Home** — Open Casey in Slack and click the _Home_ tab. You'll see five category buttons. Click one to open a modal, describe your issue, and submit. Casey will start a DM thread with you containing a diagnosis and next steps.
 
-**Direct Messages** — Open a DM with Casey and describe your issue. Casey will react with :eyes: while processing, then reply in a thread. Send follow-up messages in the same thread and Casey will maintain the full conversation context.
+**Direct Messages** — Open a DM with Casey. You'll see suggested prompts like _Reset Password_, _Request Access_, and _Network Issues_ — pick one or describe your own issue. Casey will react with :eyes: while processing, then reply in a thread. Send follow-up messages in the same thread and Casey will maintain the full conversation context.
 
-**Channel @mentions** — In any channel where Casey has been added, type `@Casey` followed by your issue. Casey responds in a thread so the channel stays clean.
+**Channel @mentions** — Invite Casey to a channel by typing `/invite @Casey` in the message box, then type `@Casey` followed by your issue. Casey responds in a thread so the channel stays clean.
+
+**Assistant Panel** — Click _Add Agent_ in the top-right corner of Slack, select Casey from the list, then pick a suggested prompt or type a message.
 
 Casey will add a :white_check_mark: reaction when it believes an issue has been resolved, and occasionally adds a contextual emoji reaction to keep things friendly.
 

openai-agents-sdk/app_oauth.py

@@ -2,6 +2,7 @@
 import logging
 import os
 from pathlib import Path
+from urllib.parse import urljoin
 
 from dotenv import load_dotenv
 from slack_bolt import App
@@ -120,4 +121,8 @@ def _authorize_with_fallback_bot_token(
 
 if __name__ == "__main__":
     port = int(os.environ.get("PORT", 3000))
+    redirect_uri = os.environ.get("SLACK_REDIRECT_URI", "")
+    if redirect_uri:
+        install_url = urljoin(redirect_uri, "/slack/install")
+        logger.info("Connect the Slack MCP Server: %s", install_url)
     app.start(port=port)

openai-agents-sdk/listeners/views/app_home_builder.py

@@ -132,6 +132,27 @@ def build_app_home_view(
                 ],
             }
         )
+    else:
+        blocks.append(
+            {
+                "type": "section",
+                "text": {
+                    "type": "mrkdwn",
+                    "text": "\U0001f534 *Slack MCP Server is disconnected.* <https://github.com/slack-samples/bolt-python-support-agent/blob/main/openai-agents-sdk/README.md#slack-mcp-server|Learn how to enable the Slack MCP Server.>",
+                },
+            }
+        )
+        blocks.append(
+            {
+                "type": "context",
+                "elements": [
+                    {
+                        "type": "mrkdwn",
+                        "text": "The Slack MCP Server enables Casey to search messages, read channels, and more.",
+                    }
+                ],
+            }
+        )
 
     return {
         "type": "home",