Summary
Agent Guardrails v0.20.0 ships the Rust native runtime as the default path when a matching packaged binary is available, while keeping the existing Node runtime as a safe rollback path.
This release is most relevant for users running Agent Guardrails through npm on Windows, Linux, or macOS who want faster startup, stronger installed-package validation, and a cleaner path for future native UI/Workbench surfaces.
Highlights
- Adds packaged Rust native runtimes for Windows x64, Linux x64, macOS x64, and macOS arm64.
- Keeps
AGENT_GUARDRAILS_RUNTIME=nodeas the compatibility escape hatch. - Adds full native matrix CI plus installed-package smoke checks after package assembly.
- Adds native runtime support for core OSS commands, including
check,init,setup,plan,doctor,enforce,unenforce,generate-agents,mcp,serve,start,stop, andstatus. - Adds
workbench-panelrendering for saved Pro Workbench panel models without requiring browser HTML or raw JSON parsing. - Adds native artifact manifests and release readiness checks that block stale or incomplete native binaries before release.
Fixes
- Hardened npm CLI discovery across Windows, macOS, Linux, and WSL layouts.
- Fixed Windows installed daemon startup readiness so a just-started worker is not treated as stale.
- Fixed path identity edge cases on Windows short paths and macOS
/varversus/private/vartemp roots. - Preserved executable permissions for Linux and macOS native binaries in the released package.
Upgrade Notes
No migration is required for existing OSS users.
If the packaged native binary is available for your platform, auto runtime uses Rust by default. To force the previous Node runtime, set:
AGENT_GUARDRAILS_RUNTIME=nodeInstall or update with:
npm install -g agent-guardrails@0.20.0