{"record":{"id":"b8c462aa1f96c942","repo":"deepseek-ai/deepseek-harness","slug":"deepseek-harness-runtime-bin-is-missing-the-ripgre","errorCode":null,"errorMessage":"deepseek-harness-runtime-bin is missing the ripgrep sidecar at {ripgrep}. 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 ripgrep sidecar 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":89,"sourceCode":"    \"\"\"Absolute path of the bundled single-file runtime executable for the current platform.\n\n    Raises FileNotFoundError when the platform is unsupported, the executable\n    has not been placed into this package, the required ripgrep sidecar is\n    missing, or the required macOS spawn helper is missing; the message names\n    the acquisition routes (acquisition strategy is deliberately separate from\n    this lookup interface, so an on-demand download can replace it without\n    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","sourceCodeStart":71,"sourceCodeEnd":107,"githubUrl":"https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/python/sdk-runtime/src/deepseek_harness_runtime/__init__.py#L71-L107","documentation":"Error \"deepseek-harness-runtime-bin is missing the ripgrep sidecar at {ripgrep}. 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:89 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"}