Task Tool Documentation Doesn't Match Current Behavior

[ppodds]

Description

The current documentation for the Task tool in claude-agent-sdk appears to be outdated and doesn't accurately reflect the actual behavior. This is causing confusion when trying to implement subagent functionality using the Task tool.

Problem

When following the existing documentation to work with the Task tool for subagent orchestration, the documented API don't align with the current behavior.

Requested Updates

Please update the Task tool documentation to:

1. Accurate API Reference

   • Document the actual current methods, parameters, and return types for the Task tool
   • Remove or update any deprecated examples that no longer work

2. Working Examples

   • Provide code examples that actually run with the current version
   • Show how to create and manage tasks for subagent delegation
   • Demonstrate the complete workflow from task creation to result handling
   • Resume subagent example (seems already supported after 2.0.62 [BUG] Subagent Resume Missing All User Prompts claude-code#11712)

Impact

This documentation mismatch is blocking developers from effectively using the Task tool and implementing subagent architectures, which appears to be a core feature of the SDK.

Would appreciate updated documentation that matches the current behavior.
Thank you!