{"record":{"id":"b3a4964396d60216","repo":"tinyhumansai/openhuman","slug":"worker-readiness-handshake-timed-out","errorCode":null,"errorMessage":"{} worker readiness handshake timed out","messagePattern":"(.+?) worker readiness handshake timed out","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"src/openhuman/runtime/pool/worker.rs","lineNumber":179,"sourceCode":"        } else {\n            (\n                Box::new(child_stdin.context(\"worker stdin missing\")?),\n                Box::new(stdout),\n                None,\n            )\n        };\n        let mut lines = BufReader::new(reader).lines();\n\n        let ready_line = match tokio::time::timeout(HANDSHAKE_TIMEOUT, lines.next_line()).await {\n            Ok(Ok(Some(line))) => line,\n            Ok(Ok(None)) => bail!(\n                \"{} worker exited before readiness handshake\",\n                launch.lang.id()\n            ),\n            Ok(Err(error)) => {\n                return Err(error).context(\"reading worker handshake\");\n            }\n            Err(_) => bail!(\"{} worker readiness handshake timed out\", launch.lang.id()),\n        };\n        let ready: PoolReadyLine = serde_json::from_str(&ready_line)\n            .with_context(|| format!(\"parsing worker ready line: {ready_line}\"))?;\n        if !ready.ready {\n            bail!(\n                \"{} worker failed to start: {}\",\n                launch.lang.id(),\n                ready.error.unwrap_or_else(|| \"unknown\".to_string())\n            );\n        }\n        if ready.protocol != Some(PROTOCOL_VERSION) {\n            bail!(\n                \"{} worker protocol mismatch: expected {}, got {:?}\",\n                launch.lang.id(),\n                PROTOCOL_VERSION,\n                ready.protocol\n            );\n        }","sourceCodeStart":161,"sourceCodeEnd":197,"githubUrl":"https://github.com/tinyhumansai/openhuman/blob/749120085864ce16e0f273c7b86fac7740b39c5b/src/openhuman/runtime/pool/worker.rs#L161-L197","documentation":"HANDSHAKE_TIMEOUT elapsed before the worker emitted its first stdout line: the process is alive but slow to start (cold interpreter boot, first-run venv setup) or hung. Distinct from EOF, which would mean the worker exited.","triggerScenarios":"Thrown at src/openhuman/runtime/pool/worker.rs:179 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Retry the launch — cold starts often pass on a second attempt","Check for CPU starvation or a hung dependency import in the worker","Increase the handshake timeout if the environment is consistently slow"],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"749120085864ce16e0f273c7b86fac7740b39c5b","analyzedAt":"2026-08-17T21:21:45.363Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}