{"record":{"id":"8aebed3b22ad31ed","repo":"deepseek-ai/deepseek-harness","slug":"no-bundled-dsh-jsonrpc-agent-executable-exists-for","errorCode":null,"errorMessage":"no bundled dsh-jsonrpc-agent executable exists for this platform (sys.platform={sys.platform!r}, machine={platform.machine()!r}); supported: linux/macos on x64/arm64. 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":"no bundled dsh-jsonrpc-agent executable exists for this platform \\(sys\\.platform=\\{sys\\.platform!r\\}, machine=\\{platform\\.machine\\(\\)!r\\}\\); supported: linux/macos on x64/arm64\\. 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":130,"sourceCode":"    raises FileNotFoundError when the selected carrier is unavailable and\n    ValueError for an unknown mode value.\n    \"\"\"\n    selected = mode if mode is not None else os.environ.get(RUNTIME_MODE_ENV_VAR)\n    if selected is None or selected == \"exe\":\n        return (str(bundled_runtime_path()),)\n    if selected == \"node\":\n        return _node_launch_args()\n    raise ValueError(\n        f\"unsupported DeepSeek Harness runtime mode {selected!r}: expected 'exe' or 'node' \"\n        f\"(explicit argument or ${RUNTIME_MODE_ENV_VAR})\"\n    )\n\n\ndef _current_platform_tag() -> str:\n    plat = _PLATFORM_TAGS.get(sys.platform)\n    arch = _ARCH_TAGS.get(platform.machine().lower())\n    if plat is None or arch is None:\n        raise FileNotFoundError(\n            \"no bundled dsh-jsonrpc-agent executable exists for this platform \"\n            f\"(sys.platform={sys.platform!r}, machine={platform.machine()!r}); supported: \"\n            \"linux/macos on x64/arm64. \" + _EXE_ACQUISITION_HINT\n        )\n    return f\"{plat}-{arch}\"\n\n\ndef _node_launch_args() -> tuple[str, str]:\n    node_root = bundled_package_dir() / \"runtime\" / \"node\"\n    bin_js = (\n        node_root\n        / \"node_modules\"\n        / \"@deepseek-ai\"\n        / \"dsh-sdk-jsonrpc-demo\"\n        / \"lib\"\n        / \"packaged-bin.js\"\n    )\n    if not bin_js.is_file():","sourceCodeStart":112,"sourceCodeEnd":148,"githubUrl":"https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/python/sdk-runtime/src/deepseek_harness_runtime/__init__.py#L112-L148","documentation":"Error \"no bundled dsh-jsonrpc-agent executable exists for this platform (sys.platform={sys.platform!r}, machine={platform.machine()!r}); supported: linux/macos on x64/arm64. 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:130 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Build the executable with scripts/build-exe-for-python-sdk.ts or install the matching platform wheel; on unsupported platforms use 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"}