feat: shell_attach and shell_detach for recording existing terminals

[dwmkerr]

Summary

• Adds shell_attach tool to connect Shellwright to an existing terminal session (requires tmux)
• Adds shell_detach tool to disconnect from attached sessions
• Enables recording/screenshots of user's own interactive sessions

Current State (WIP)

• Basic implementation complete
• Changed to require explicit tty parameter (more reliable than auto-detection)
• Documentation added in docs/shell-attach.md
• Needs testing in real-world usage scenarios

Usage

# Attach to current terminal
shell_attach {"tty": "$(tty)"}

# Take screenshots, record, etc.
shell_screenshot {"session_id": "..."}

# Detach when done
shell_detach {"session_id": "..."}

[guardrails]

⚠️ We detected 3 security issues in this pull request:

Vulnerable Libraries (3)

Severity	Details
Low	pkg:npm/typescript-eslint@8.50.0 (t) upgrade to: > 8.50.0
Low	pkg:npm/@typescript-eslint/parser@8.50.0 (t) upgrade to: > 8.50.0
Low	pkg:npm/@typescript-eslint/eslint-plugin@8.50.0 (t) upgrade to: > 8.50.0

More info on how to fix Vulnerable Libraries in JavaScript.

---

👉 Go to the dashboard for detailed results.

📥 Happy? Share your feedback with us.

[github-actions]

Recording Evaluation

🎬 View recording comparisons