Skip to content

fix: Remove 'agent: BoltAgent' listener argument#1466

Open
WilliamBergamin wants to merge 2 commits intomainfrom
remove-agent-experiment
Open

fix: Remove 'agent: BoltAgent' listener argument#1466
WilliamBergamin wants to merge 2 commits intomainfrom
remove-agent-experiment

Conversation

@WilliamBergamin
Copy link
Contributor

Summary

The agent class was introduced as an experimental feature, the team has decided to remove it in favor of offering better top level Bolt support for "agent" features.

This PR aims to remove the experimental agent class and its references

Testing

Unit tests should be sufficient 🤔

Category

  • slack_bolt.App 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.

@WilliamBergamin WilliamBergamin added this to the 1.28.0 milestone Mar 19, 2026
@WilliamBergamin WilliamBergamin self-assigned this Mar 19, 2026
@WilliamBergamin WilliamBergamin requested a review from a team as a code owner March 19, 2026 20:26
@WilliamBergamin WilliamBergamin added area:async area:sync semver:patch experiment Experimental feature documented with ExperimentalWarning and pydoc Experiment section labels Mar 19, 2026
@codecov
Copy link

codecov bot commented Mar 19, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 91.31%. Comparing base (ba7df02) to head (750ed4b).
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #1466      +/-   ##
==========================================
- Coverage   91.43%   91.31%   -0.12%     
==========================================
  Files         232      229       -3     
  Lines        7340     7266      -74     
==========================================
- Hits         6711     6635      -76     
- Misses        629      631       +2     

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

@WilliamBergamin
Copy link
Contributor Author

@lukegalbraithrussell when this merges then I think we are in the clear to remove the agent experiment form the docs 🙏

@WilliamBergamin WilliamBergamin changed the title fix: remove the agent experiment fix: Remove 'agent: BoltAgent' listener argument Mar 19, 2026
Copy link
Member

@zimeg zimeg left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@WilliamBergamin LGTM and -1435 is cool 🪓 ✨


### Kwargs Injection

Listeners receive arguments by parameter name. The framework inspects function signatures and injects matching args: `body`, `event`, `action`, `command`, `payload`, `context`, `client`, `ack`, `say`, `respond`, `logger`, `complete`, `fail`, `agent`, etc. Defined in `slack_bolt/kwargs_injection/args.py`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 praise: Nice call to update this!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:async area:sync experiment Experimental feature documented with ExperimentalWarning and pydoc Experiment section semver:patch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants