{"record":{"id":"7c4dace9587fc854","repo":"openai/codex","slug":"runner-handshake-task-failed-err","errorCode":null,"errorMessage":"runner handshake task failed: {err}","messagePattern":"runner handshake task failed: (.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"codex-rs/windows-sandbox-rs/src/unified_exec/backends/elevated.rs","lineNumber":107,"sourceCode":"            )\n        },\n    )\n}\n\nasync fn spawn_runner_transport_task(\n    sandbox_creds: SandboxCreds,\n    request: RunnerTransportRequest,\n) -> Result<RunnerTransport> {\n    tokio::task::spawn_blocking(move || -> Result<_> {\n        spawn_runner_transport_with_retry(\n            sandbox_creds,\n            &request,\n            spawn_runner_transport,\n            refresh_logon_sandbox_creds,\n        )\n    })\n    .await\n    .map_err(|err| anyhow::anyhow!(\"runner handshake task failed: {err}\"))?\n}\n\n#[allow(clippy::too_many_arguments)]\npub(crate) async fn spawn_windows_sandbox_session_elevated_for_permission_profile(\n    permission_profile: &PermissionProfile,\n    workspace_roots: &[AbsolutePathBuf],\n    codex_home: &Path,\n    command: Vec<String>,\n    cwd: &Path,\n    mut env_map: HashMap<String, String>,\n    proxy_enforced: bool,\n    network_proxy_restricting_sid: Option<String>,\n    proxy_settings_mode: crate::WindowsSandboxProxySettingsMode,\n    timeout_ms: Option<u64>,\n    read_roots_override: Option<&[PathBuf]>,\n    read_roots_include_platform_defaults: bool,\n    write_roots_override: Option<&[PathBuf]>,\n    deny_read_paths_override: &[AbsolutePathBuf],","sourceCodeStart":89,"sourceCodeEnd":125,"githubUrl":"https://github.com/openai/codex/blob/339751715c64496cb86246bfb3935f40e309dd3d/codex-rs/windows-sandbox-rs/src/unified_exec/backends/elevated.rs#L89-L125","documentation":"Error \"runner handshake task failed: {err}\" thrown in openai/codex.","triggerScenarios":"Thrown at codex-rs/windows-sandbox-rs/src/unified_exec/backends/elevated.rs:107 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Check the inner error for the handshake failure cause, verify the elevated runner binary matches the client version, and restart the runner process."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"339751715c64496cb86246bfb3935f40e309dd3d","analyzedAt":"2026-08-25T05:35:09.876Z","schemaVersion":2},"datasetVersion":"2026-08-25T06:17:31.827Z"}