[BUG] Deprecation messages reference bash, which no longer exists as a public name (should be shell)

[anacunha]

Checks

• I have updated to the lastest minor and patch version of Strands
• I have checked the documentation and this is not expected behavior
• I have searched ./issues and there are no duplicates of my issue

Strands Version

1.53.0

Tools Package Version

0.8.6

Tools used

1. Calculator

Python Version

3.14.7

Operating System

macOS 26.6.2

Installation Method

pip

Steps to Reproduce

1. pip install strands-agents strands-agents-tools
2. Build an agent using the calculator tool:

from strands import Agent
from strands_tools import calculator

agent = Agent(tools=[calculator])
agent("What is 42 + 58?")

3. Run it. The console prints:

DEPRECATION WARNING: calculator is deprecated. This warning becomes an error log in v0.9.0. To achieve similar functionality, use the bash tool vended by strands-agents (from strands.vended_tools import bash). This does change the security boundary: calculator only ever evaluated an expression checked against an AST allowlist, while bash executes arbitrary commands, so review it against your threat model before switching.

4. Follow that instruction:

from strands import Agent
from strands.vended_tools import bash

agent = Agent(tools=[bash])
agent("What is 42 + 58?")

5. Run it again. This prints a second warning:

DeprecationWarning: bash is deprecated and will be removed in v2.0.0. Use shell instead. The tool routes commands through the sandbox, which runs sh or the remote login shell rather than bash specifically.
  from strands.vended_tools import bash

Expected Behavior

The deprecation warning names strands.vended_tools.shell (the current API), as the replacement, not strands.vended_tools.bash, which is itself deprecated.

Actual Behavior

The deprecation warning names strands.vended_tools.bash, which is itself deprecated and emits its own warning telling the user to use shell instead.

Additional Context

#566

Possible Solution

No response

Related Issues

No response