zed-industries/zed · error

the WSL `zed` sandbox helper resolved to {path:?} rather tha

Error message

the WSL `zed` sandbox helper resolved to {path:?} rather than an absolute path

What it means

The provisioning script reported success but the helper result line contained a non-absolute path, violating the result protocol. The helper resolution output is malformed, likely due to a mismatched or damaged install.

Source

Thrown at crates/sandbox/src/windows_wsl.rs:937

            } else {
                format!(": {stderr}")
            }
        )));
    }

    let stdout = String::from_utf8_lossy(&output.stdout);
    let path = stdout
        .lines()
        .rev()
        .find_map(|line| line.strip_prefix(HELPER_RESULT_PREFIX))
        .map(|path| path.trim().to_string())
        .with_context(|| {
            unavailable(format!(
                "no helper result line in sandbox-helper provisioning output from {}: {stdout:?}",
                wsl_distro_label(distro)
            ))
        })?;
    ensure!(
        path.starts_with('/'),
        "the WSL `zed` sandbox helper resolved to {path:?} rather than an absolute path"
    );

    cache
        .lock()
        .unwrap_or_else(|poisoned| poisoned.into_inner())
        .insert(key, path.clone());
    Ok(path)
}

/// Shell script that resolves and existence-checks paths in a single WSL
/// round-trip. Arguments come in triples `(kind, path, fallback)`: kind `W`
/// is a native Windows path to translate with `wslpath -u` (falling back to
/// the precomputed `/mnt/<drive>/...` mapping when translation fails), kind
/// `L` is an already-Linux path with an empty fallback. One result line is
/// printed per triple: `<ok|fallback> <ok|missing> <resolved path>`.
const PATH_RESOLUTION_SCRIPT: &str = "\

View on GitHub (pinned to f4178619ac)

Solutions

  1. Re-run provisioning (failures are not cached) so the helper is re-downloaded and installed
  2. Clear the off-PATH install location if it contains a broken helper
  3. Verify the script's HELPER_RESULT_PREFIX line format matches this Zed version
Defensive patterns

Strategy: retry

When it happens

Trigger: Thrown at crates/sandbox/src/windows_wsl.rs:937 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of zed-industries/zed@f4178619ac (2026-08-20). Data as JSON: /api/errors/9a0c08356716ccfb. Report an issue: GitHub.