fix: require io and better type checking

[jaronoff97]

No description provided.

[macroscopeapp]

Approvability

Verdict: Needs human review

This PR contains breaking API changes (making io required) and modifies runtime validation behavior (stricter type checking, regex metacharacter escaping). While well-tested, these semantic changes warrant human review.

^{You can customize Macroscope's approvability policy. Learn more.}