Documentation / VFX-E-1901

VFX-E-1901

Title

ValidationWorkerFailed

Explanation

The isolated validation worker could not be started, crashed, or produced unusable output. Distinct from VFX-E-1150 (a known-and-handled wall-clock bound being hit): this code is the worker doing something it should not have. retryable: true, because a failed process start or a one-off crash may well not recur — unlike a permission error, there is no persistent external state making a retry pointless.

Common causes

  • The worker subprocess (a re-invocation of this same vouchfx-mcp executable in a hidden worker mode) failed to start — a corrupted install, a missing runtime, or resource exhaustion (process/handle limits).
  • The worker process crashed unexpectedly while validating (an unhandled exception, or worse).
  • The worker's stdout exceeded its 50 MB cap and was treated as misbehaving, or produced output that could not be parsed as a validation result.

Fixes

  • Retry the call — a one-off process start failure or crash is often transient.
  • Check system resource limits (available memory, process/handle count) if this recurs consistently.
  • Reinstall the Vouchfx.Mcp dotnet tool if the failure is persistent — the installation itself may be corrupted.