feat: add agent set status to BoltAgent

[srtaalej]

Summary

Add set_status() to BoltAgent and AsyncBoltAgent for setting assistant thread status directly from the agent listener argument

Testing

fromslack_boltimportApp, BoltAgentapp=App(token=os.environ["SLACK_BOT_TOKEN"])
@app.event("app_mention")defhandle_mention(agent: BoltAgent):
agent.set_status(status="Thinking...")
# ... do work ...stream=agent.chat_stream()
stream.append(markdown_text="Hello!")
stream.stop()

Category

• slack_bolt.App and/or its core components
• slack_bolt.Agent and/or its core components
• slack_bolt.async_app.AsyncApp and/or its core components
• Adapters in slack_bolt.adapter
• Document pages under /docs
• Others

Requirements

Please read the Contributing guidelines and Code of Conduct before creating this issue or pull request. By submitting, you are agreeing to those rules.

• I've read and understood the Contributing Guidelines and have done my best effort to follow them.
• I've read and agree to the Code of Conduct.
• I've run ./scripts/install_all_and_run_tests.sh after making the changes.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.64%. Comparing base (1ad642e) to head (d9937dc).
⚠️ Report is 1 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@ Coverage Diff @@## main #1441 +/- ##
=======================================
Coverage 90.64% 90.64% =======================================
Files 226 226 Lines 7182 7187 +5 =======================================
+ Hits 6510 6515 +5 
Misses 672 672 

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[zimeg]

@srtaalej LGTM! A few changes needed for async typecheckings but this is awesome to find 🤖 ✨

[zimeg]

@srtaalej I also changed the semver tag to be patch! For "experiments" we're planning to release these all under patch versions to avoid signaling more meaningful or stable updates 🐭

[srtaalej]

tyty @zimeg for speedy reviews and semver updates 🌠 excited to get this one merged 😁

[mwbrooks]

✅ Great work @srtaalej!

🧪 I haven't manually tested this. Just want to check that one of you have already done it before we merge?

✏️ I left a minor suggestion, I think it's worth a discussion, but we can do it in a 2nd PR!

[mwbrooks]

suggestion(non-blocking): This can be a follow-up PR (probably better if it is). I think it would be really nice if Bolt provided sensible defaults.

• status: "Thinking..." when no status is provided
• loading_messages:: a list of 5 fun, witty loading messages that are used when no loading messages are provided

This function is called a lot. So, it'll be nice if developers can start with agent.set_status() and have a solid experience out of the box. Then customize it later.

[srtaalej]

i like this idea ⭐ working on it 🫡

[srtaalej]

oh and yes i tested using the bolt-python-assistant-template 🚀

[zimeg]

@mwbrooks@srtaalej IIRC the backend has a few default loading messages if none are provided:

• Processing...
• Finding answers...
• Generating responses...
• Analyzing...
• Putting it al together...
• Searching...
• Evaluating...
• Summarizing findings...
• Organizing...
• Gathering information...