{"record":{"id":"94e32f56485b1fa9","repo":"tinyhumansai/openhuman","slug":"worker-failed-to-start","errorCode":null,"errorMessage":"{} worker failed to start: {}","messagePattern":"(.+?) worker failed to start: (.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"src/openhuman/runtime/pool/worker.rs","lineNumber":184,"sourceCode":"            )\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        }\n        if ready.protocol_token != expected_token {\n            bail!(\"{} worker protocol authentication failed\", launch.lang.id());\n        }\n        tracing::info!(lang = launch.lang.id(), \"[runtime_pool] worker ready\");\n","sourceCodeStart":166,"sourceCodeEnd":202,"githubUrl":"https://github.com/tinyhumansai/openhuman/blob/749120085864ce16e0f273c7b86fac7740b39c5b/src/openhuman/runtime/pool/worker.rs#L166-L202","documentation":"The worker completed the handshake but reported ready=false with its own error string — a startup failure inside the worker process (failed dependency load, bad config) surfaced verbatim. The message after the colon comes from the worker, not the supervisor.","triggerScenarios":"Thrown at src/openhuman/runtime/pool/worker.rs:184 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Read the worker-supplied error text to identify the failing step","Fix the underlying cause (missing package, bad env) and relaunch the pool"],"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"}