{"version":"2.1.221","anchor":"windows-sandbox-helpers-throw-typed-errors-with-reason-codes","canonical_anchor":"windows-sandbox-helpers-throw-typed-errors-with-reason-codes","heading":"Windows sandbox helpers throw typed errors with reason codes","tier":"internal","area":"Windows","scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.221\/e\/windows-sandbox-helpers-throw-typed-errors-with-reason-codes","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.221","markdown":"### Windows sandbox helpers throw typed errors with reason codes\n\nWindows sandbox failures now carry a reason code, though the message you see is unchanged.\n\n**What**\n\nBare error throws in the Windows sandbox helper were replaced with a dedicated `WindowsSandboxError` carrying a machine-readable code, and for srt-win calls the subcommand as well.\n\n**Details**\n\n- Codes include `acl_grant_failed`, `srt_win_not_found`, `srt_win_timeout`, `srt_win_nonzero`, `spawn_failed`, `bin_shell_invalid`, `srt_win_bad_json`, `wfp_verify_bind_failed`, `wfp_verify_unparseable` and `acl_stamp_failed`. None of these appear in 2.1.220.\n- Message text is unchanged, so what a user sees is the same; only the structure carried alongside it is new.\n- Separately, the helper that rewrites raw sandbox-runtime install advice into Claude Code advice now returns the message untouched when the platform is not Windows.\n\n**Evidence**\n\n`bin_shell_invalid`, `acl_grant_failed`\n\n- Area: Windows\n- Tier: Under the hood\n- Useful: 2\/5\n- Signal: 0\/5"}