[DOCS] Agent SDK documents deprecated BashOutput tool (replaced by TaskOutput)

Resolved 💬 2 comments Opened Jan 26, 2026 by coygeek Closed Feb 28, 2026

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: BashOutput Tool 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 KillBashKillShell rename is already covered by issue #20704. This issue focuses on the BashOutputTaskOutput 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 KillBashKillShell rename (8 occurrences)
  • This issue covers BashOutputTaskOutput rename (12 occurrences)

Both should be fixed together as they represent the same category of outdated tool documentation.

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗