[DOCS] Agent SDK documents deprecated BashOutput tool (replaced by TaskOutput)
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://platform.claude.com/docs/en/agent-sdk/python
https://platform.claude.com/docs/en/agent-sdk/typescript
Section/Topic
"Tool Input/Output Types" section in both Python and TypeScript SDK references
Current Documentation
The SDK documentation lists the following tools:
Tool name:BashOutputTool name:KillBash
What's Wrong or Missing?
According to the Changelog (v2.0.64):
"Unshipped AgentOutputTool and BashOutputTool, in favor of a new unified TaskOutputTool"
The SDK documentation references tools that have been renamed or removed:
| Documented Tool | Current Tool | Source |
|-----------------|--------------|--------|
| BashOutput | TaskOutput | Changelog v2.0.64 |
| KillBash | KillShell | settings.md |
Developers relying on these definitions for hooking, mocking, or building integrations will encounter errors.
Note: The KillBash → KillShell rename is already covered by issue #20704. This issue focuses on the BashOutput → TaskOutput change which affects more code (12 occurrences vs 8).
Suggested Improvement
Update the SDK reference documentation:
Before:
### BashOutput
**Tool name:** `BashOutput`
interface BashOutputInput {
shell_id: string;
...
}
After:
### TaskOutput
**Tool name:** `TaskOutput`
interface TaskOutputInput {
task_id: string;
...
}
Impact
High - Prevents users from using a feature
Additional Context
Affected Pages:
| Page | Line(s) | Occurrences |
|------|---------|-------------|
| https://platform.claude.com/docs/en/agent-sdk/typescript | 832, 948-953, 1291-1292, 1374, 1396-1401 | 10 |
| https://platform.claude.com/docs/en/agent-sdk/python | 1751-1755 | 2 |
Total scope: 2 pages, 12 occurrences of BashOutput
Related Issues:
- #20704 covers
KillBash→KillShellrename (8 occurrences) - This issue covers
BashOutput→TaskOutputrename (12 occurrences)
Both should be fixed together as they represent the same category of outdated tool documentation.
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗