Brief description of the changes.

Why is this change needed?

• ...

• bun run typecheck passes
• bun test src passes
• Manually tested with Claude Code + Codex (if applicable)

• I have read the CONTRIBUTING guide
• My code follows the existing code style
• I have added/updated tests as needed