Function install_cpp_algo

tools/setup_workspace.py:1202–1429

(
    install_root: Path,
    skip_if_exist: bool = True,
    update_mode: bool = False,
    local_version: str | None = None,
    pr_number: int | None = None,
    run_id: int | None = None,
)

def install_cpp_algo(
    install_root: Path,
    skip_if_exist: bool = True,
    update_mode: bool = False,
    local_version: str | None = None,
    pr_number: int | None = None,
    run_id: int | None = None,
) -> tuple[bool, str | None, bool]:
    real_install_root = install_root.resolve()
    cpp_algo_path = real_install_root / "agent" / CPP_ALGO_DIST_NAME
    cpp_algo_installed = cpp_algo_path.exists()

    # When a specific PR or run is requested, always proceed past the skip
    # check — the user explicitly asked for a particular artifact.
    if skip_if_exist and cpp_algo_installed and pr_number is None and run_id is None:
        print(Console.ok(t("inf_cpp_algo_installed_skip")))
        return True, local_version, False

    # ~~~ CI artifact fast path ~~~
    # Try to grab just the cpp-algo binary from a recent successful workflow run.
    # Default: latest v2 push. Optionally: from a specific PR or run ID.
    auth_headers = _github_auth_headers()
    ci_url, ci_version = _find_cpp_algo_in_ci(
        auth_headers, pr_number=pr_number, run_id=run_id,
    )

    # When a specific PR/run was requested but no artifact was found, fall
    # back to the default CI search (latest v2 push) before trying a release.
    if ci_url is None and (pr_number is not None or run_id is not None):
        print(Console.warn(t("wrn_ci_artifact_pr_run_not_found_fallback")))
        ci_url, ci_version = _find_cpp_algo_in_ci(auth_headers)

    if ci_url:
        ci_should_skip = (
            update_mode
            and cpp_algo_installed
            and _is_git_sha(local_version)
            and _is_git_sha(ci_version)
            and local_version == ci_version
        )
        if ci_should_skip:
            print(Console.ok(t("inf_cpp_algo_latest_version", version=local_version)))
            return True, local_version, False

        cache_dir = ensure_cache_dir()
        ci_download_path = (
            cache_dir / f"cpp-algo-{OS_KEYWORD}-{ARCH_KEYWORD}.zip"
        )
        ci_downloaded = False

        if auth_headers is not None:
            # GitHub artifact API returns a 302 redirect to Azure blob storage.
            # urllib's default redirect handler strips Authorization on cross-origin
            # redirects, causing a 401.  Resolve the redirect with http.client
            # (which does not auto-follow redirects) and then download from the
            # storage URL with auth headers intact.
            storage_url: str | None = None
            try: