[FEATURE] Allow restoring background task shell access from SDK so the Agent can KillShell for a session id still.

[ItsJustMeChris]

Preflight Checklist

• [x] I have searched existing requests and this feature hasn't been requested yet
• [x] This is a single feature request (not multiple features)

Problem Statement

When the Agent launches a sub process if we terminate and relaunch the application the Agent session restores but we no longer have access to background tasks, resulting in

<tool_use_error>No shell found with ID: bcf8f19</tool_use_error>

errors, since we're restoring a session I believe that the SDK should also be able to recover its background process context.

Proposed Solution

Agents restore Shell environments associated to a SessionID when a thread comes back to life.

Alternative Solutions

Expose an SDK first party background process poller (isTaskAlive, isTaskAvailableToContext) so Agent SDK can properly determine real state for the Session.

Priority

High - Significant impact on productivity

Feature Category

CLI commands and flags

Use Case Example

Ask the agent to launch a program. Close the agent on accident, or from a crash, or anything really. Relaunch Agent regains context of background processes properly. Ask agent to close the program. Program launched properly closes.

---

This avoids runaway background tasks as-well. Improves DX from having to maintain a process list and session map.

Additional Context

https://github.com/user-attachments/assets/0e9f8c88-c30f-4e30-9431-c9899e6c2921

[github-actions[bot]]

Found 3 possible duplicate issues:

1. https://github.com/anthropics/claude-code/issues/7291
2. https://github.com/anthropics/claude-code/issues/12730
3. https://github.com/anthropics/claude-code/issues/7584

This issue will be automatically closed as a duplicate in 3 days.

• If your issue is a duplicate, please close it and 👍 the existing issue instead
• To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

[github-actions[bot]]

This issue has been automatically closed as a duplicate of #7291.

If this is incorrect, please re-open this issue or create a new one.

🤖 Generated with Claude Code