Repository navigation
v4.0.189.0
First public 4.x release: a major upgrade to Playwright 1.6x, plus security fixes and reliability improvements.
🚀 What's New
- Playwright 1.6x: The browser automation stack is upgraded to the Playwright 1.6x line. Nova Act now requires
playwright>=1.60.0. This ships as the 4.0 major because the browser engine moves from Chromium to Chrome for Testing, which can change page behavior. - Skip SSL Pre-Flight Validation: A new
skip_ssl_precheckparameter on theNovaActconstructor lets you skip the SSL pre-flight check, useful when connecting through environments with custom certificates or proxies.
🔨 Improvements
- Typed Service-Unavailable Error: Transport-level failures now raise
ActServiceUnavailableError, a subclass ofActServerError. CatchActServerErrorto retry on transport faults instead of handling a generic error. - Guardrails Enforced at Navigation Time:
state_guardrailnow runs on the navigation request itself, not only at observation time, so a blocked origin is stopped before the request leaves the browser. The observation-time check stays, and it also covers client-side (single-page app) navigations. - Acts No Longer Hang on a Stalled Renderer: Page reads during an act are now bounded by the page timeout, so
act(timeout=...)ends with an error instead of hanging when a page renderer stalls, including on the first act of a session. - Request Timeout for Backend Calls: Act step requests now carry a request timeout, so a slow backend response fails within your configured
acttimeout instead of hanging. - [CLI] Narrower Workflow Execution Roles: Auto-created workflow execution roles no longer receive CodeBuild permissions (
codebuild:StartBuildandcodebuild:BatchGetBuilds), which they did not need; remote builds are started by the deploying CLI user. When you redeploy a workflow with this version, the CLI removes the unneeded policy from the existing role. If you deployed with an earlier CLI and do not redeploy, remove the permission by hand by deleting the inlineCodeBuildPolicyfrom the affected role, for exampleaws iam delete-role-policy --role-name <workflow-role> --policy-name CodeBuildPolicy. Reported by Mohamed AbdElNafea Hussein through the AWS Vulnerability Reporting Program.
🐛 Bug Fixes
- Filesystem Allowlist Enforcement (Symlinks and Page-Initiated Navigation): The file allowlist (
allowed_file_open_pathsandallowed_file_upload_paths) now resolves symlinks and re-checks that the real target stays inside the allowed directory, so a symlink inside an allowed location cannot point to a file outside it.file://navigations started by page content (redirects,window.location, meta refresh) are now checked against the allowlist and blocked when they fall outside it. - [CLI] Clear Error on Expired Credentials:
act workflowcommands now show a clean, actionable error when AWS credentials are expired, instead of anUnboundLocalError. - [Docs] FAQ Playground Link: The FAQ's playground link now points at the public
nova.amazon.com. - [Docs] Browser Setup Guidance: The README adds a "Using Your Own Browser" section covering Playwright and Chromium setup when you manage the browser yourself, including the extra steps for Amazon Linux 2023.