{"record":{"id":"3b99eb7f1e263102","repo":"deepseek-ai/deepseek-harness","slug":"deepseek-harness-runtime-bin-is-missing-the-node-p","errorCode":null,"errorMessage":"deepseek-harness-runtime-bin is missing the node-pty spawn helper at {helper}. Two ways to get the executable: run `scripts/build-exe-for-python-sdk.ts` (via tsx) in a deepseek-harness checkout, or install the matching `deepseek-harness-runtime-bin` platform wheel retained by the `build-exe-for-python-sdk` CI workflow. For local development against a repo source build, explicitly select the dev-only node carrier with DSH_RUNTIME_MODE=node (or resolve_bundled_launch_args('node')).","messagePattern":"deepseek-harness-runtime-bin is missing the node-pty spawn helper at (.+?)\\. Two ways to get the executable: run `scripts/build-exe-for-python-sdk\\.ts` \\(via tsx\\) in a deepseek-harness checkout, or install the matching `deepseek-harness-runtime-bin` platform wheel retained by the `build-exe-for-python-sdk` CI workflow\\. For local development against a repo source build, explicitly select the dev-only node carrier with DSH_RUNTIME_MODE=node \\(or resolve_bundled_launch_args\\('node'\\)\\)\\.","errorType":"exception","errorClass":"FileNotFoundError","httpStatus":null,"severity":"error","filePath":"python/sdk-runtime/src/deepseek_harness_runtime/__init__.py","lineNumber":96,"sourceCode":"    touching callers).\n    \"\"\"\n    tag = _current_platform_tag()\n    path = bundled_package_dir() / \"runtime\" / f\"dsh-jsonrpc-agent-pkg-{tag}\"\n    if not path.is_file():\n        raise FileNotFoundError(\n            f\"deepseek-harness-runtime-bin is missing the runtime executable at {path}. \"\n            + _EXE_ACQUISITION_HINT\n        )\n    ripgrep = Path(f\"{path}-rg\")\n    if not ripgrep.is_file():\n        raise FileNotFoundError(\n            f\"deepseek-harness-runtime-bin is missing the ripgrep sidecar at {ripgrep}. \"\n            + _EXE_ACQUISITION_HINT\n        )\n    if tag.startswith(\"macos-\"):\n        helper = Path(f\"{path}-spawn-helper\")\n        if not helper.is_file():\n            raise FileNotFoundError(\n                f\"deepseek-harness-runtime-bin is missing the node-pty spawn helper at {helper}. \"\n                + _EXE_ACQUISITION_HINT\n            )\n    return path\n\n\ndef resolve_bundled_launch_args(mode: str | None = None) -> tuple[str, ...]:\n    \"\"\"The argv tuple that launches the bundled runtime.\n\n    Mode selection: the explicit ``mode`` argument wins, then the\n    ``DSH_RUNTIME_MODE`` environment variable (``exe`` | ``node``), then\n    automatic resolution. Automatic resolution finds the production exe ONLY —\n    the dev-only node carrier must be selected explicitly so a production\n    deployment can never silently ride on a source build. Returns\n    ``(exe_path,)`` in exe mode and ``(node_path, bin_js_path)`` in node mode;\n    raises FileNotFoundError when the selected carrier is unavailable and\n    ValueError for an unknown mode value.\n    \"\"\"","sourceCodeStart":78,"sourceCodeEnd":114,"githubUrl":"https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/python/sdk-runtime/src/deepseek_harness_runtime/__init__.py#L78-L114","documentation":"Error \"deepseek-harness-runtime-bin is missing the node-pty spawn helper at {helper}. Two ways to get the executable: run `scripts/build-exe-for-python-sdk.ts` (via tsx) in a deepseek-harness checkout, or install the matching `deepseek-harness-runtime-bin` platform wheel retained by the `build-exe-for-python-sdk` CI workflow. For local development against a repo source build, explicitly select the dev-only node carrier with DSH_RUNTIME_MODE=node (or resolve_bundled_launch_args('node')).\" thrown in deepseek-ai/deepseek-harness.","triggerScenarios":"Thrown at python/sdk-runtime/src/deepseek_harness_runtime/__init__.py:96 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Run scripts/build-exe-for-python-sdk.ts in a deepseek-harness checkout, or install the matching deepseek-harness-runtime-bin platform wheel; for repo-local development set DSH_RUNTIME_MODE=node."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"b150a551b8d465e31e418e1b2eaf5e79bbb7d28e","analyzedAt":"2026-08-24T18:12:29.105Z","schemaVersion":2},"datasetVersion":"2026-08-24T22:17:12.610Z"}