leave uv.exe in D:

mv uv.exe onto D:
Add tool bin dir to PATH on windows
2025-12-19 11:04:08 +00:00 · 2024-09-18 20:49:20 +02:00 · 2024-09-18 18:17:51 +02:00 · 2024-09-18 18:00:23 +02:00 · 2024-09-18 09:34:56 +00:00 · 2024-09-18 09:29:09 +00:00
14 changed files with 4865 additions and 149 deletions
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -21,6 +21,9 @@ jobs:
          npm install
      - run: |
          npm run all
+      - name: Make sure no changes from linters are detected
+        run: |
+          git diff --exit-code
  test-default-version:
    runs-on: ${{ matrix.os }}
    strategy:
@@ -37,7 +40,7 @@ jobs:
    strategy:
      matrix:
        os: [ubuntu-latest, macos-latest, macos-14, oracle-aarch64]
-        uv-version: ["latest", "0.3.0", "0.3.2"]
+        uv-version: ["latest", "0.3.0", "0.3.2", "0.3", "0.3.x", ">=0.3.0"]
    steps:
      - uses: actions/checkout@v4
      - name: Install version ${{ matrix.uv-version }}
@@ -46,6 +49,25 @@ jobs:
          version: ${{ matrix.uv-version }}
      - run: uv sync
        working-directory: __tests__/fixtures/uv-project
+  test-semver-range:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, oracle-aarch64]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install version 0.3
+        id: setup-uv
+        uses: ./
+        with:
+          version: "0.3"
+      - name: Correct version gets installed
+        run: |
+          if [ "$UV_VERSION" != "0.3.5" ]; then
+            exit 1
+          fi
+        env:
+          UV_VERSION: ${{ steps.setup-uv.outputs.uv-version }}
  test-checksum:
    runs-on: ${{ matrix.os }}
    strategy:
@@ -83,3 +105,14 @@ jobs:
      - name: Install default version
        uses: ./
      - run: uvx ruff --version
+  test-tool-install:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [windows-latest]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install default version
+        uses: ./
+      - run: uv tool install ruff
+      - run: ruff --version
--- a/.github/workflows/update-known-checksums.yml
+++ b/.github/workflows/update-known-checksums.yml
@@ -17,7 +17,7 @@ jobs:
          src/download/checksum/known-checksums.ts ${{ secrets.GITHUB_TOKEN }}
      - run: npm install && npm run all
      - name: Create Pull Request
-        uses: peter-evans/create-pull-request@d121e62763d8cc35b5fb1710e887d6e69a52d3a4 # v7.0.2
+        uses: peter-evans/create-pull-request@6cd32fd93684475c31847837f87bb135d40a2b79 # v7.0.3
        with:
          commit-message: "chore: update known checksums"
          title:
--- a/.gitignore
+++ b/.gitignore
@@ -96,4 +96,7 @@ Thumbs.db

 # Ignore built ts files
 __tests__/runner/*
-lib/**/*
+lib/**/*
+
+# Idea IDEs (PyCharm, WebStorm, IntelliJ, etc)
+.idea/
--- a/README.md
+++ b/README.md
@@ -11,13 +11,15 @@ Set up your GitHub Actions workflow with a specific version of [uv](https://docs
 ## Contents

 - [Usage](#usage)
-  - [Install specific version](#install-specific-version)
-  - [Install latest version](#install-latest-version)
+  - [Install the latest version (default)](#install-the-latest-version-default)
+  - [Install a specific version](#install-a-specific-version)
+  - [Install a version by supplying a semver range](#install-a-version-by-supplying-a-semver-range)
  - [Validate checksum](#validate-checksum)
  - [Enable Caching](#enable-caching)
-    - [Local cache path](#local-cache-path)
    - [Cache dependency glob](#cache-dependency-glob)
+  - [Local cache path](#local-cache-path)
  - [GitHub authentication token](#github-authentication-token)
+  - [UV_TOOL_BIN_DIR](#uv_tool_bin_dir)
 - [How it works](#how-it-works)
 - [FAQ](#faq)

@@ -27,7 +29,7 @@ Set up your GitHub Actions workflow with a specific version of [uv](https://docs

 ```yaml
 - name: Install the latest version of uv
-  uses: astral-sh/setup-uv@v2
+  uses: astral-sh/setup-uv@v3
  with:
    version: "latest"
 ```
@@ -45,11 +47,30 @@ For an example workflow, see

 ```yaml
 - name: Install a specific version of uv
-  uses: astral-sh/setup-uv@v2
+  uses: astral-sh/setup-uv@v3
  with:
    version: "0.4.4"
 ```

+### Install a version by supplying a semver range
+
+You can also specify a [semver range](https://github.com/npm/node-semver?tab=readme-ov-file#ranges)
+to install the latest version that satisfies the range.
+
+```yaml
+- name: Install a semver range of uv
+  uses: astral-sh/setup-uv@v3
+  with:
+    version: ">=0.3.0"
+```
+
+```yaml
+- name: Pinning a minor version of uv
+  uses: astral-sh/setup-uv@v3
+  with:
+    version: "0.3.x"
+```
+
 ### Validate checksum

 You can also specify a checksum to validate the downloaded file. Checksums up to the default version
@@ -58,7 +79,7 @@ are automatically verified by this action. The sha265 hashes can be found on the

 ```yaml
 - name: Install a specific version and validate the checksum
-  uses: astral-sh/setup-uv@v2
+  uses: astral-sh/setup-uv@v3
  with:
    version: "0.3.1"
    checksum: "e11b01402ab645392c7ad6044db63d37e4fd1e745e015306993b07695ea5f9f8"
@@ -67,15 +88,19 @@ are automatically verified by this action. The sha265 hashes can be found on the
 ### Enable caching

 If you enable caching, the [uv cache](https://docs.astral.sh/uv/concepts/cache/) will be cached to
-the GitHub Actions Cache. This can speed up runs that reuse the cache by several minutes. The cache
-will always be reused on self-hosted runners.
+the GitHub Actions Cache. This can speed up runs that reuse the cache by several minutes.
+
+> [!TIP]
+>
+> On self-hosted runners this is usually not needed since the cache generated by uv on the runner's
+> filesystem is not removed after a run. For more details see [Local cache path](#local-cache-path).

 You can optionally define a custom cache key suffix.

 ```yaml
 - name: Enable caching and define a custom cache key suffix
  id: setup-uv
-  uses: astral-sh/setup-uv@v2
+  uses: astral-sh/setup-uv@v3
  with:
    enable-cache: true
    cache-suffix: "optional-suffix"
@@ -90,54 +115,57 @@ use it in subsequent steps. For example, to use the cache in the above case:
  run: echo "Cache was restored"
 ```

-#### Local cache path
-
-If you want to save the cache to a local path other than the default path (`/tmp/setup-uv-cache`),
-specify the path with the `cache-local-path` input.
-
-```yaml
- name: Define a custom uv cache path
-  uses: astral-sh/setup-uv@v2
-  with:
-    enable-cache: true
-    cache-local-path: "/path/to/cache"
-```
-
 #### Cache dependency glob

 If you want to control when the cache is invalidated, specify a glob pattern with the
 `cache-dependency-glob` input. The cache will be invalidated if any file matching the glob pattern
 changes. The glob matches files relative to the repository root.

-```yaml
- name: Define a cache dependency glob
-  uses: astral-sh/setup-uv@v2
-  with:
-    enable-cache: true
-    cache-dependency-glob: "uv.lock"
-```
+> [!NOTE]
+>
+> The default is `**/uv.lock`.

 ```yaml
 - name: Define a cache dependency glob
-  uses: astral-sh/setup-uv@v2
+  uses: astral-sh/setup-uv@v3
  with:
    enable-cache: true
-    cache-dependency-glob: "**requirements*.txt"
+    cache-dependency-glob: "**/requirements*.txt"
 ```

 ```yaml
 - name: Define a list of cache dependency globs
-  uses: astral-sh/setup-uv@v2
+  uses: astral-sh/setup-uv@v3
  with:
    enable-cache: true
    cache-dependency-glob: |
-      **requirements*.txt
-      **pyproject.toml
+      **/requirements*.txt
+      **/pyproject.toml
+```
+
+```yaml
+- name: Never invalidate the cache
+  uses: astral-sh/setup-uv@v3
+  with:
+    enable-cache: true
+    cache-dependency-glob: ""
+```
+
+### Local cache path
+
+This action controls where uv stores its cache on the runner's filesystem. You can change the
+default (`/tmp/setup-uv-cache`) by specifying the path with the `cache-local-path` input.
+
+```yaml
+- name: Define a custom uv cache path
+  uses: astral-sh/setup-uv@v3
+  with:
+    cache-local-path: "/path/to/cache"
 ```

 ### GitHub authentication token

-This action uses the GitHub API to fetch the `uv` release artifacts. To avoid hitting the GitHub API
+This action uses the GitHub API to fetch the uv release artifacts. To avoid hitting the GitHub API
 rate limit too quickly, an authentication token can be provided via the `github-token` input. By
 default, the `GITHUB_TOKEN` secret is used, which is automatically provided by GitHub Actions.

@@ -147,11 +175,29 @@ are not sufficient, you can provide a custom GitHub token with the necessary per

 ```yaml
 - name: Install the latest version of uv with a custom GitHub token
-  uses: astral-sh/setup-uv@v2
+  uses: astral-sh/setup-uv@v3
  with:
    github-token: ${{ secrets.CUSTOM_GITHUB_TOKEN }}
 ```

+### UV_TOOL_BIN_DIR
+
+On Windows `UV_TOOL_BIN_DIR` is set to the `TMP` dir. On GitHub hosted runners this is on the much
+faster `D:` drive. This path is also automatically added to the PATH.
+
+On all other platforms the tool binaries get installed to the
+[default location](https://docs.astral.sh/uv/concepts/tools/#the-bin-directory).
+
+If you want to change this behaviour (especially on self-hosted runners) you can use the
+`tool-bin-dir` input:
+
+```yaml
+- name: Install the latest version of uv with a custom tool bin dir
+  uses: astral-sh/setup-uv@v3
+  with:
+    tool-bin-dir: "/path/to/tool/bin"
+```
+
 ## How it works

 This action downloads uv from the uv repo's official
@@ -176,7 +222,7 @@ For example:
 - name: Checkout the repository
  uses: actions/checkout@main
 - name: Install the latest version of uv
-  uses: astral-sh/setup-uv@v2
+  uses: astral-sh/setup-uv@v3
  with:
    enable-cache: true
 - name: Test
@@ -188,7 +234,7 @@ To install a specific version of Python, use

 ```yaml
 - name: Install the latest version of uv
-  uses: astral-sh/setup-uv@v2
+  uses: astral-sh/setup-uv@v3
  with:
    enable-cache: true
 - name: Install Python 3.12
@@ -207,7 +253,7 @@ output:
  uses: actions/checkout@main
 - name: Install the default version of uv
  id: setup-uv
-  uses: astral-sh/setup-uv@v2
+  uses: astral-sh/setup-uv@v3
 - name: Print the installed version
  run: echo "Installed uv version is ${{ steps.setup-uv.outputs.uv-version }}"
 ```
--- a/action.yml
+++ b/action.yml
@@ -1,6 +1,7 @@
-name: "Python setup uv"
-description: "Set up your GitHub Actions workflow with a specific version of uv"
-author: "eifinger"
+name: "astral-sh/setup-uv"
+description:
+  "Set up your GitHub Actions workflow with a specific version of uv."
+author: "astral-sh"
 inputs:
  version:
    description: "The version of uv to install"
@@ -19,15 +20,18 @@ inputs:
    default: "false"
  cache-dependency-glob:
    description:
-      'Glob pattern to match files relative to the repository root to control
-      the cache. e.g. "uv.lock"'
-    required: false
+      "Glob pattern to match files relative to the repository root to control
+      the cache."
+    default: "**/uv.lock"
  cache-suffix:
    description: "Suffix for the cache key"
    required: false
  cache-local-path:
    description: "Local path to store the cache."
    default: ""
+  tool-bin-dir:
+    description: "Custom path to set UV_TOOL_BIN_DIR to."
+    required: false
 outputs:
  uv-version:
    description: "The installed uv version. Useful when using latest."
@@ -40,4 +44,4 @@ runs:
  post-if: success()
 branding:
  icon: "package"
-  color: "blue"
+  color: "black"
--- a/dist/save-cache/index.js
+++ b/dist/save-cache/index.js
@@ -83008,7 +83008,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
    return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.cacheDependencyGlob = exports.githubToken = exports.cacheLocalPath = exports.cacheSuffix = exports.enableCache = exports.checkSum = exports.version = void 0;
+exports.githubToken = exports.toolBinDir = exports.cacheDependencyGlob = exports.cacheLocalPath = exports.cacheSuffix = exports.enableCache = exports.checkSum = exports.version = void 0;
 const core = __importStar(__nccwpck_require__(2186));
 const path_1 = __importDefault(__nccwpck_require__(1017));
 exports.version = core.getInput("version");
@@ -83016,8 +83016,19 @@ exports.checkSum = core.getInput("checksum");
 exports.enableCache = core.getInput("enable-cache") === "true";
 exports.cacheSuffix = core.getInput("cache-suffix") || "";
 exports.cacheLocalPath = getCacheLocalPath();
-exports.githubToken = core.getInput("github-token");
 exports.cacheDependencyGlob = core.getInput("cache-dependency-glob");
+exports.toolBinDir = getToolBinDir();
+exports.githubToken = core.getInput("github-token");
+function getToolBinDir() {
+    const toolBinDirInput = core.getInput("tool-bin-dir");
+    if (toolBinDirInput !== "") {
+        return toolBinDirInput;
+    }
+    if (process.platform === "win32") {
+        return "D:\\a\\_temp\\uv-tool-bin-dir";
+    }
+    return undefined;
+}
 function getCacheLocalPath() {
    const cacheLocalPathInput = core.getInput("cache-local-path");
    if (cacheLocalPathInput !== "") {
--- a/dist/setup/index.js
+++ b/dist/setup/index.js
--- a/package-lock.json
+++ b/package-lock.json
@@ -19,13 +19,13 @@
        "@octokit/rest": "^21.0.2"
      },
      "devDependencies": {
-        "@types/node": "^22.5.4",
+        "@types/node": "^22.5.5",
        "@types/semver": "^7.5.8",
        "@typescript-eslint/eslint-plugin": "^7.15.0",
        "@typescript-eslint/parser": "^7.18.0",
        "@vercel/ncc": "^0.38.1",
-        "eslint": "^8.57.0",
-        "eslint-plugin-github": "^5.0.1",
+        "eslint": "^8.57.1",
+        "eslint-plugin-github": "^5.0.2",
        "eslint-plugin-import": "^2.30.0",
        "eslint-plugin-jest": "^28.8.3",
        "eslint-plugin-prettier": "^5.2.1",
@@ -33,7 +33,7 @@
        "js-yaml": "^4.1.0",
        "prettier": "^3.3.3",
        "ts-jest": "^29.2.5",
-        "typescript": "^5.5.4"
+        "typescript": "^5.6.2"
      }
    },
    "node_modules/@aashutoshrathi/word-wrap": {
@@ -1062,9 +1062,9 @@
      }
    },
    "node_modules/@eslint/js": {
-      "version": "8.57.0",
-      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-8.57.0.tgz",
-      "integrity": "sha512-Ys+3g2TaW7gADOJzPt83SJtCDhMjndcDMFVQ/Tj9iA1BfJzFKD9mAUXT3OenpuPHbI6P/myECxRJrofUsDx/5g==",
+      "version": "8.57.1",
+      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-8.57.1.tgz",
+      "integrity": "sha512-d9zaMRSTIKDLhctzH12MtXvJKSSUhaHcjV+2Z+GK+EEY7XKpP5yR4x+N3TAcHTcu963nIr+TMcCb4DBCYX1z6Q==",
      "dev": true,
      "engines": {
        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
@@ -1085,12 +1085,13 @@
      "dev": true
    },
    "node_modules/@humanwhocodes/config-array": {
-      "version": "0.11.14",
-      "resolved": "https://registry.npmjs.org/@humanwhocodes/config-array/-/config-array-0.11.14.tgz",
-      "integrity": "sha512-3T8LkOmg45BV5FICb15QQMsyUSWrQ8AygVfC7ZG32zOalnqrilm018ZVCw0eapXux8FtA33q8PSRSstjee3jSg==",
+      "version": "0.13.0",
+      "resolved": "https://registry.npmjs.org/@humanwhocodes/config-array/-/config-array-0.13.0.tgz",
+      "integrity": "sha512-DZLEEqFWQFiyK6h5YIeynKx7JlvCYWL0cImfSRXZ9l4Sg2efkFGTuFf6vzXjK1cq6IYkU+Eg/JizXw+TD2vRNw==",
+      "deprecated": "Use @eslint/config-array instead",
      "dev": true,
      "dependencies": {
-        "@humanwhocodes/object-schema": "^2.0.2",
+        "@humanwhocodes/object-schema": "^2.0.3",
        "debug": "^4.3.1",
        "minimatch": "^3.0.5"
      },
@@ -1115,6 +1116,7 @@
      "version": "2.0.3",
      "resolved": "https://registry.npmjs.org/@humanwhocodes/object-schema/-/object-schema-2.0.3.tgz",
      "integrity": "sha512-93zYdMES/c1D69yZiKDBj0V24vqNzB/koF26KPaagAfd3P/4gUlh3Dys5ogAK+Exi9QyzlD8x/08Zt7wIKcDcA==",
+      "deprecated": "Use @eslint/object-schema instead",
      "dev": true
    },
    "node_modules/@istanbuljs/load-nyc-config": {
@@ -2099,9 +2101,9 @@
      "dev": true
    },
    "node_modules/@types/node": {
-      "version": "22.5.4",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.5.4.tgz",
-      "integrity": "sha512-FDuKUJQm/ju9fT/SeX/6+gBzoPzlVCzfzmGkwKvRHQVxi4BntVbyIwf6a4Xn62mrvndLiml6z/UBXIdEVjQLXg==",
+      "version": "22.5.5",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.5.5.tgz",
+      "integrity": "sha512-Xjs4y5UPO/CLdzpgR6GirZJx36yScjh73+2NlLlkFRSoQN8B0DpfXPdZGnvVmLRLOsqDpOfTNv7D9trgGhmOIA==",
      "dependencies": {
        "undici-types": "~6.19.2"
      }
@@ -3621,16 +3623,16 @@
      }
    },
    "node_modules/eslint": {
-      "version": "8.57.0",
-      "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.57.0.tgz",
-      "integrity": "sha512-dZ6+mexnaTIbSBZWgou51U6OmzIhYM2VcNdtiTtI7qPNZm35Akpr0f6vtw3w1Kmn5PYo+tZVfh13WrhpS6oLqQ==",
+      "version": "8.57.1",
+      "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.57.1.tgz",
+      "integrity": "sha512-ypowyDxpVSYpkXr9WPv2PAZCtNip1Mv5KTW0SCurXv/9iOpcrH9PaqUElksqEB6pChqHGDRCFTyrZlGhnLNGiA==",
      "dev": true,
      "dependencies": {
        "@eslint-community/eslint-utils": "^4.2.0",
        "@eslint-community/regexpp": "^4.6.1",
        "@eslint/eslintrc": "^2.1.4",
-        "@eslint/js": "8.57.0",
-        "@humanwhocodes/config-array": "^0.11.14",
+        "@eslint/js": "8.57.1",
+        "@humanwhocodes/config-array": "^0.13.0",
        "@humanwhocodes/module-importer": "^1.0.1",
        "@nodelib/fs.walk": "^1.2.8",
        "@ungap/structured-clone": "^1.2.0",
@@ -3780,14 +3782,14 @@
      }
    },
    "node_modules/eslint-plugin-github": {
-      "version": "5.0.1",
-      "resolved": "https://registry.npmjs.org/eslint-plugin-github/-/eslint-plugin-github-5.0.1.tgz",
-      "integrity": "sha512-qbXG3wL5Uh2JB92EKeX2hPtO9c/t75qVxQjVLYuTFfhHifLZzv9CBvLCvoaBhLrAC/xTMVht7DK/NofYK8X4Dg==",
+      "version": "5.0.2",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-github/-/eslint-plugin-github-5.0.2.tgz",
+      "integrity": "sha512-nMdzWJQ5CimjQDY6SFeJ0KIXuNFf0dgDWEd4eP3UWfuTuP/dXcZJDg7MQRvAFt743T1zUi4+/HdOihfu8xJkLA==",
      "dev": true,
      "dependencies": {
        "@github/browserslist-config": "^1.0.0",
-        "@typescript-eslint/eslint-plugin": "^7.0.1",
-        "@typescript-eslint/parser": "^7.0.1",
+        "@typescript-eslint/eslint-plugin": "^8.0.0",
+        "@typescript-eslint/parser": "^8.0.0",
        "aria-query": "^5.3.0",
        "eslint-config-prettier": ">=8.0.0",
        "eslint-plugin-escompat": "^3.3.3",
@@ -3810,6 +3812,197 @@
        "eslint": "^8.0.1"
      }
    },
+    "node_modules/eslint-plugin-github/node_modules/@typescript-eslint/eslint-plugin": {
+      "version": "8.5.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.5.0.tgz",
+      "integrity": "sha512-lHS5hvz33iUFQKuPFGheAB84LwcJ60G8vKnEhnfcK1l8kGVLro2SFYW6K0/tj8FUhRJ0VHyg1oAfg50QGbPPHw==",
+      "dev": true,
+      "dependencies": {
+        "@eslint-community/regexpp": "^4.10.0",
+        "@typescript-eslint/scope-manager": "8.5.0",
+        "@typescript-eslint/type-utils": "8.5.0",
+        "@typescript-eslint/utils": "8.5.0",
+        "@typescript-eslint/visitor-keys": "8.5.0",
+        "graphemer": "^1.4.0",
+        "ignore": "^5.3.1",
+        "natural-compare": "^1.4.0",
+        "ts-api-utils": "^1.3.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "@typescript-eslint/parser": "^8.0.0 || ^8.0.0-alpha.0",
+        "eslint": "^8.57.0 || ^9.0.0"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/eslint-plugin-github/node_modules/@typescript-eslint/parser": {
+      "version": "8.5.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.5.0.tgz",
+      "integrity": "sha512-gF77eNv0Xz2UJg/NbpWJ0kqAm35UMsvZf1GHj8D9MRFTj/V3tAciIWXfmPLsAAF/vUlpWPvUDyH1jjsr0cMVWw==",
+      "dev": true,
+      "dependencies": {
+        "@typescript-eslint/scope-manager": "8.5.0",
+        "@typescript-eslint/types": "8.5.0",
+        "@typescript-eslint/typescript-estree": "8.5.0",
+        "@typescript-eslint/visitor-keys": "8.5.0",
+        "debug": "^4.3.4"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "eslint": "^8.57.0 || ^9.0.0"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/eslint-plugin-github/node_modules/@typescript-eslint/scope-manager": {
+      "version": "8.5.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.5.0.tgz",
+      "integrity": "sha512-06JOQ9Qgj33yvBEx6tpC8ecP9o860rsR22hWMEd12WcTRrfaFgHr2RB/CA/B+7BMhHkXT4chg2MyboGdFGawYg==",
+      "dev": true,
+      "dependencies": {
+        "@typescript-eslint/types": "8.5.0",
+        "@typescript-eslint/visitor-keys": "8.5.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      }
+    },
+    "node_modules/eslint-plugin-github/node_modules/@typescript-eslint/type-utils": {
+      "version": "8.5.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.5.0.tgz",
+      "integrity": "sha512-N1K8Ix+lUM+cIDhL2uekVn/ZD7TZW+9/rwz8DclQpcQ9rk4sIL5CAlBC0CugWKREmDjBzI/kQqU4wkg46jWLYA==",
+      "dev": true,
+      "dependencies": {
+        "@typescript-eslint/typescript-estree": "8.5.0",
+        "@typescript-eslint/utils": "8.5.0",
+        "debug": "^4.3.4",
+        "ts-api-utils": "^1.3.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/eslint-plugin-github/node_modules/@typescript-eslint/types": {
+      "version": "8.5.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.5.0.tgz",
+      "integrity": "sha512-qjkormnQS5wF9pjSi6q60bKUHH44j2APxfh9TQRXK8wbYVeDYYdYJGIROL87LGZZ2gz3Rbmjc736qyL8deVtdw==",
+      "dev": true,
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      }
+    },
+    "node_modules/eslint-plugin-github/node_modules/@typescript-eslint/typescript-estree": {
+      "version": "8.5.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.5.0.tgz",
+      "integrity": "sha512-vEG2Sf9P8BPQ+d0pxdfndw3xIXaoSjliG0/Ejk7UggByZPKXmJmw3GW5jV2gHNQNawBUyfahoSiCFVov0Ruf7Q==",
+      "dev": true,
+      "dependencies": {
+        "@typescript-eslint/types": "8.5.0",
+        "@typescript-eslint/visitor-keys": "8.5.0",
+        "debug": "^4.3.4",
+        "fast-glob": "^3.3.2",
+        "is-glob": "^4.0.3",
+        "minimatch": "^9.0.4",
+        "semver": "^7.6.0",
+        "ts-api-utils": "^1.3.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/eslint-plugin-github/node_modules/@typescript-eslint/utils": {
+      "version": "8.5.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.5.0.tgz",
+      "integrity": "sha512-6yyGYVL0e+VzGYp60wvkBHiqDWOpT63pdMV2CVG4LVDd5uR6q1qQN/7LafBZtAtNIn/mqXjsSeS5ggv/P0iECw==",
+      "dev": true,
+      "dependencies": {
+        "@eslint-community/eslint-utils": "^4.4.0",
+        "@typescript-eslint/scope-manager": "8.5.0",
+        "@typescript-eslint/types": "8.5.0",
+        "@typescript-eslint/typescript-estree": "8.5.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "eslint": "^8.57.0 || ^9.0.0"
+      }
+    },
+    "node_modules/eslint-plugin-github/node_modules/@typescript-eslint/visitor-keys": {
+      "version": "8.5.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.5.0.tgz",
+      "integrity": "sha512-yTPqMnbAZJNy2Xq2XU8AdtOW9tJIr+UQb64aXB9f3B1498Zx9JorVgFJcZpEc9UBuCCrdzKID2RGAMkYcDtZOw==",
+      "dev": true,
+      "dependencies": {
+        "@typescript-eslint/types": "8.5.0",
+        "eslint-visitor-keys": "^3.4.3"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      }
+    },
+    "node_modules/eslint-plugin-github/node_modules/brace-expansion": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz",
+      "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==",
+      "dev": true,
+      "dependencies": {
+        "balanced-match": "^1.0.0"
+      }
+    },
    "node_modules/eslint-plugin-github/node_modules/emoji-regex": {
      "version": "9.2.2",
      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
@@ -3868,6 +4061,33 @@
        "node": "*"
      }
    },
+    "node_modules/eslint-plugin-github/node_modules/minimatch": {
+      "version": "9.0.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz",
+      "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==",
+      "dev": true,
+      "dependencies": {
+        "brace-expansion": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=16 || 14 >=14.17"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/eslint-plugin-github/node_modules/semver": {
+      "version": "7.6.3",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz",
+      "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==",
+      "dev": true,
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
    "node_modules/eslint-plugin-i18n-text": {
      "version": "1.0.1",
      "resolved": "https://registry.npmjs.org/eslint-plugin-i18n-text/-/eslint-plugin-i18n-text-1.0.1.tgz",
@@ -7558,9 +7778,9 @@
      }
    },
    "node_modules/typescript": {
-      "version": "5.5.4",
-      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.5.4.tgz",
-      "integrity": "sha512-Mtq29sKDAEYP7aljRgtPOpTvOfbwRWlS6dPRzwjdE+C0R4brX/GUyhHSecbHMFLNBLcJIPt9nl9yG5TZ1weH+Q==",
+      "version": "5.6.2",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.6.2.tgz",
+      "integrity": "sha512-NW8ByodCSNCwZeghjN3o+JX5OFH0Ojg6sadjEKY4huZ52TqbJTJnDo5+Tw98lSy63NZvi4n+ez5m2u5d4PkZyw==",
      "dev": true,
      "bin": {
        "tsc": "bin/tsc",
@@ -8725,9 +8945,9 @@
      }
    },
    "@eslint/js": {
-      "version": "8.57.0",
-      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-8.57.0.tgz",
-      "integrity": "sha512-Ys+3g2TaW7gADOJzPt83SJtCDhMjndcDMFVQ/Tj9iA1BfJzFKD9mAUXT3OenpuPHbI6P/myECxRJrofUsDx/5g==",
+      "version": "8.57.1",
+      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-8.57.1.tgz",
+      "integrity": "sha512-d9zaMRSTIKDLhctzH12MtXvJKSSUhaHcjV+2Z+GK+EEY7XKpP5yR4x+N3TAcHTcu963nIr+TMcCb4DBCYX1z6Q==",
      "dev": true
    },
    "@fastify/busboy": {
@@ -8742,12 +8962,12 @@
      "dev": true
    },
    "@humanwhocodes/config-array": {
-      "version": "0.11.14",
-      "resolved": "https://registry.npmjs.org/@humanwhocodes/config-array/-/config-array-0.11.14.tgz",
-      "integrity": "sha512-3T8LkOmg45BV5FICb15QQMsyUSWrQ8AygVfC7ZG32zOalnqrilm018ZVCw0eapXux8FtA33q8PSRSstjee3jSg==",
+      "version": "0.13.0",
+      "resolved": "https://registry.npmjs.org/@humanwhocodes/config-array/-/config-array-0.13.0.tgz",
+      "integrity": "sha512-DZLEEqFWQFiyK6h5YIeynKx7JlvCYWL0cImfSRXZ9l4Sg2efkFGTuFf6vzXjK1cq6IYkU+Eg/JizXw+TD2vRNw==",
      "dev": true,
      "requires": {
-        "@humanwhocodes/object-schema": "^2.0.2",
+        "@humanwhocodes/object-schema": "^2.0.3",
        "debug": "^4.3.1",
        "minimatch": "^3.0.5"
      }
@@ -9567,9 +9787,9 @@
      "dev": true
    },
    "@types/node": {
-      "version": "22.5.4",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.5.4.tgz",
-      "integrity": "sha512-FDuKUJQm/ju9fT/SeX/6+gBzoPzlVCzfzmGkwKvRHQVxi4BntVbyIwf6a4Xn62mrvndLiml6z/UBXIdEVjQLXg==",
+      "version": "22.5.5",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.5.5.tgz",
+      "integrity": "sha512-Xjs4y5UPO/CLdzpgR6GirZJx36yScjh73+2NlLlkFRSoQN8B0DpfXPdZGnvVmLRLOsqDpOfTNv7D9trgGhmOIA==",
      "requires": {
        "undici-types": "~6.19.2"
      }
@@ -10638,16 +10858,16 @@
      "dev": true
    },
    "eslint": {
-      "version": "8.57.0",
-      "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.57.0.tgz",
-      "integrity": "sha512-dZ6+mexnaTIbSBZWgou51U6OmzIhYM2VcNdtiTtI7qPNZm35Akpr0f6vtw3w1Kmn5PYo+tZVfh13WrhpS6oLqQ==",
+      "version": "8.57.1",
+      "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.57.1.tgz",
+      "integrity": "sha512-ypowyDxpVSYpkXr9WPv2PAZCtNip1Mv5KTW0SCurXv/9iOpcrH9PaqUElksqEB6pChqHGDRCFTyrZlGhnLNGiA==",
      "dev": true,
      "requires": {
        "@eslint-community/eslint-utils": "^4.2.0",
        "@eslint-community/regexpp": "^4.6.1",
        "@eslint/eslintrc": "^2.1.4",
-        "@eslint/js": "8.57.0",
-        "@humanwhocodes/config-array": "^0.11.14",
+        "@eslint/js": "8.57.1",
+        "@humanwhocodes/config-array": "^0.13.0",
        "@humanwhocodes/module-importer": "^1.0.1",
        "@nodelib/fs.walk": "^1.2.8",
        "@ungap/structured-clone": "^1.2.0",
@@ -10842,14 +11062,14 @@
      }
    },
    "eslint-plugin-github": {
-      "version": "5.0.1",
-      "resolved": "https://registry.npmjs.org/eslint-plugin-github/-/eslint-plugin-github-5.0.1.tgz",
-      "integrity": "sha512-qbXG3wL5Uh2JB92EKeX2hPtO9c/t75qVxQjVLYuTFfhHifLZzv9CBvLCvoaBhLrAC/xTMVht7DK/NofYK8X4Dg==",
+      "version": "5.0.2",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-github/-/eslint-plugin-github-5.0.2.tgz",
+      "integrity": "sha512-nMdzWJQ5CimjQDY6SFeJ0KIXuNFf0dgDWEd4eP3UWfuTuP/dXcZJDg7MQRvAFt743T1zUi4+/HdOihfu8xJkLA==",
      "dev": true,
      "requires": {
        "@github/browserslist-config": "^1.0.0",
-        "@typescript-eslint/eslint-plugin": "^7.0.1",
-        "@typescript-eslint/parser": "^7.0.1",
+        "@typescript-eslint/eslint-plugin": "^8.0.0",
+        "@typescript-eslint/parser": "^8.0.0",
        "aria-query": "^5.3.0",
        "eslint-config-prettier": ">=8.0.0",
        "eslint-plugin-escompat": "^3.3.3",
@@ -10866,6 +11086,111 @@
        "svg-element-attributes": "^1.3.1"
      },
      "dependencies": {
+        "@typescript-eslint/eslint-plugin": {
+          "version": "8.5.0",
+          "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.5.0.tgz",
+          "integrity": "sha512-lHS5hvz33iUFQKuPFGheAB84LwcJ60G8vKnEhnfcK1l8kGVLro2SFYW6K0/tj8FUhRJ0VHyg1oAfg50QGbPPHw==",
+          "dev": true,
+          "requires": {
+            "@eslint-community/regexpp": "^4.10.0",
+            "@typescript-eslint/scope-manager": "8.5.0",
+            "@typescript-eslint/type-utils": "8.5.0",
+            "@typescript-eslint/utils": "8.5.0",
+            "@typescript-eslint/visitor-keys": "8.5.0",
+            "graphemer": "^1.4.0",
+            "ignore": "^5.3.1",
+            "natural-compare": "^1.4.0",
+            "ts-api-utils": "^1.3.0"
+          }
+        },
+        "@typescript-eslint/parser": {
+          "version": "8.5.0",
+          "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.5.0.tgz",
+          "integrity": "sha512-gF77eNv0Xz2UJg/NbpWJ0kqAm35UMsvZf1GHj8D9MRFTj/V3tAciIWXfmPLsAAF/vUlpWPvUDyH1jjsr0cMVWw==",
+          "dev": true,
+          "requires": {
+            "@typescript-eslint/scope-manager": "8.5.0",
+            "@typescript-eslint/types": "8.5.0",
+            "@typescript-eslint/typescript-estree": "8.5.0",
+            "@typescript-eslint/visitor-keys": "8.5.0",
+            "debug": "^4.3.4"
+          }
+        },
+        "@typescript-eslint/scope-manager": {
+          "version": "8.5.0",
+          "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.5.0.tgz",
+          "integrity": "sha512-06JOQ9Qgj33yvBEx6tpC8ecP9o860rsR22hWMEd12WcTRrfaFgHr2RB/CA/B+7BMhHkXT4chg2MyboGdFGawYg==",
+          "dev": true,
+          "requires": {
+            "@typescript-eslint/types": "8.5.0",
+            "@typescript-eslint/visitor-keys": "8.5.0"
+          }
+        },
+        "@typescript-eslint/type-utils": {
+          "version": "8.5.0",
+          "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.5.0.tgz",
+          "integrity": "sha512-N1K8Ix+lUM+cIDhL2uekVn/ZD7TZW+9/rwz8DclQpcQ9rk4sIL5CAlBC0CugWKREmDjBzI/kQqU4wkg46jWLYA==",
+          "dev": true,
+          "requires": {
+            "@typescript-eslint/typescript-estree": "8.5.0",
+            "@typescript-eslint/utils": "8.5.0",
+            "debug": "^4.3.4",
+            "ts-api-utils": "^1.3.0"
+          }
+        },
+        "@typescript-eslint/types": {
+          "version": "8.5.0",
+          "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.5.0.tgz",
+          "integrity": "sha512-qjkormnQS5wF9pjSi6q60bKUHH44j2APxfh9TQRXK8wbYVeDYYdYJGIROL87LGZZ2gz3Rbmjc736qyL8deVtdw==",
+          "dev": true
+        },
+        "@typescript-eslint/typescript-estree": {
+          "version": "8.5.0",
+          "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.5.0.tgz",
+          "integrity": "sha512-vEG2Sf9P8BPQ+d0pxdfndw3xIXaoSjliG0/Ejk7UggByZPKXmJmw3GW5jV2gHNQNawBUyfahoSiCFVov0Ruf7Q==",
+          "dev": true,
+          "requires": {
+            "@typescript-eslint/types": "8.5.0",
+            "@typescript-eslint/visitor-keys": "8.5.0",
+            "debug": "^4.3.4",
+            "fast-glob": "^3.3.2",
+            "is-glob": "^4.0.3",
+            "minimatch": "^9.0.4",
+            "semver": "^7.6.0",
+            "ts-api-utils": "^1.3.0"
+          }
+        },
+        "@typescript-eslint/utils": {
+          "version": "8.5.0",
+          "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.5.0.tgz",
+          "integrity": "sha512-6yyGYVL0e+VzGYp60wvkBHiqDWOpT63pdMV2CVG4LVDd5uR6q1qQN/7LafBZtAtNIn/mqXjsSeS5ggv/P0iECw==",
+          "dev": true,
+          "requires": {
+            "@eslint-community/eslint-utils": "^4.4.0",
+            "@typescript-eslint/scope-manager": "8.5.0",
+            "@typescript-eslint/types": "8.5.0",
+            "@typescript-eslint/typescript-estree": "8.5.0"
+          }
+        },
+        "@typescript-eslint/visitor-keys": {
+          "version": "8.5.0",
+          "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.5.0.tgz",
+          "integrity": "sha512-yTPqMnbAZJNy2Xq2XU8AdtOW9tJIr+UQb64aXB9f3B1498Zx9JorVgFJcZpEc9UBuCCrdzKID2RGAMkYcDtZOw==",
+          "dev": true,
+          "requires": {
+            "@typescript-eslint/types": "8.5.0",
+            "eslint-visitor-keys": "^3.4.3"
+          }
+        },
+        "brace-expansion": {
+          "version": "2.0.1",
+          "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz",
+          "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==",
+          "dev": true,
+          "requires": {
+            "balanced-match": "^1.0.0"
+          }
+        },
        "emoji-regex": {
          "version": "9.2.2",
          "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
@@ -10916,6 +11241,21 @@
              }
            }
          }
+        },
+        "minimatch": {
+          "version": "9.0.5",
+          "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz",
+          "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==",
+          "dev": true,
+          "requires": {
+            "brace-expansion": "^2.0.1"
+          }
+        },
+        "semver": {
+          "version": "7.6.3",
+          "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz",
+          "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==",
+          "dev": true
        }
      }
    },
@@ -13472,9 +13812,9 @@
      }
    },
    "typescript": {
-      "version": "5.5.4",
-      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.5.4.tgz",
-      "integrity": "sha512-Mtq29sKDAEYP7aljRgtPOpTvOfbwRWlS6dPRzwjdE+C0R4brX/GUyhHSecbHMFLNBLcJIPt9nl9yG5TZ1weH+Q==",
+      "version": "5.6.2",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.6.2.tgz",
+      "integrity": "sha512-NW8ByodCSNCwZeghjN3o+JX5OFH0Ojg6sadjEKY4huZ52TqbJTJnDo5+Tw98lSy63NZvi4n+ez5m2u5d4PkZyw==",
      "dev": true
    },
    "unbox-primitive": {
--- a/package.json
+++ b/package.json
@@ -38,13 +38,13 @@
    "@octokit/rest": "^21.0.2"
  },
  "devDependencies": {
-    "@types/node": "^22.5.4",
+    "@types/node": "^22.5.5",
    "@types/semver": "^7.5.8",
    "@typescript-eslint/eslint-plugin": "^7.15.0",
    "@typescript-eslint/parser": "^7.18.0",
    "@vercel/ncc": "^0.38.1",
-    "eslint": "^8.57.0",
-    "eslint-plugin-github": "^5.0.1",
+    "eslint": "^8.57.1",
+    "eslint-plugin-github": "^5.0.2",
    "eslint-plugin-import": "^2.30.0",
    "eslint-plugin-jest": "^28.8.3",
    "eslint-plugin-prettier": "^5.2.1",
@@ -52,6 +52,6 @@
    "js-yaml": "^4.1.0",
    "prettier": "^3.3.3",
    "ts-jest": "^29.2.5",
-    "typescript": "^5.5.4"
+    "typescript": "^5.6.2"
  }
 }
--- a/src/download/checksum/known-checksums.ts
+++ b/src/download/checksum/known-checksums.ts
@@ -1,5 +1,41 @@
 // AUTOGENERATED_DO_NOT_EDIT
 export const KNOWN_CHECKSUMS: { [key: string]: string } = {
+  "undefined-0.4.11":
+    "e6e38118aaa7436d31d3aed0f4b0beb188c273c137bd3185e8b4ebdb301682aa",
+  "aarch64-apple-darwin-0.4.11":
+    "b988bce29ca19fa229f088f982b66ef9dbf8571cc45eb98b00370a817cfe383a",
+  "aarch64-unknown-linux-gnu-0.4.11":
+    "865feeea66be67497506b76925949f97eb1f6da7dda2583a6558bed972f5de13",
+  "aarch64-unknown-linux-musl-0.4.11":
+    "db1b16b5e8d943a296667d176e474739c652660cbf56ee5e9157aa7e267442fb",
+  "arm-unknown-linux-musleabihf-0.4.11":
+    "9a141516deb4c966d4ae5a4d14dfef0f3c7880817823645760c09fb4cc580ce3",
+  "armv7-unknown-linux-gnueabihf-0.4.11":
+    "4748f81c391e0040eb489056677f6caee5886e5c15ef85448db51f11ea9b90df",
+  "armv7-unknown-linux-musleabihf-0.4.11":
+    "b564fb4631b6b668d891ec2ce91af10fda1f4374bd846eab24a85abb6fd77b25",
+  "i686-pc-windows-msvc-0.4.11":
+    "f1c0c12a40097949aa793f870f811ac8ffcc349228f0d3cae246bd93108e62da",
+  "i686-unknown-linux-gnu-0.4.11":
+    "c894193d37fa6cedb3b6c76d85bcca6031a5ef051adb046d583b7f078edc3872",
+  "i686-unknown-linux-musl-0.4.11":
+    "c80a63db7be49971b91417fdd5b9327803c38e23998d88d2a3489a2d9fa32de2",
+  "powerpc64-unknown-linux-gnu-0.4.11":
+    "f5ecc0461d1b9a8f56804abf5b2200aa22c08b89f404845a9f684817d0824521",
+  "powerpc64le-unknown-linux-gnu-0.4.11":
+    "862c8cdc587d435e09aaa0645440d1a8d72e23c68050cd978d4e5d11aede6a6b",
+  "powerpc64le-unknown-linux-musl-0.4.11":
+    "82bfb567ab6f2412706f157a998925fd49a491a4eaffb2bf8c09ca512be51a2f",
+  "s390x-unknown-linux-gnu-0.4.11":
+    "4b3cacd593aaecbaf193633f3105851ba7fe6627ed567bc3133e48a398e7c947",
+  "x86_64-apple-darwin-0.4.11":
+    "1db522b0eebb16cc08094b558f76048834a4d25878d74e07c5b4b7320239a5ab",
+  "x86_64-pc-windows-msvc-0.4.11":
+    "b9d43ddca9affbf03c048e34112c470a37af8d8e04c3ff2b79933a073f48e34d",
+  "x86_64-unknown-linux-gnu-0.4.11":
+    "3fc34d56857f24c7065309593a5df05ce953f1736f0cf32965b91f69adb66c46",
+  "x86_64-unknown-linux-musl-0.4.11":
+    "c3c6eb97198a29c6ca51bed673941ffbe7d97d481e74eec034fd8ad8d59b187c",
  "undefined-0.4.10":
    "53751ecdbad6aa09b13986e73e1ba1990b348b1793f313fdecaf3bd464311d28",
  "aarch64-apple-darwin-0.4.10":
--- a/src/download/download-latest.ts
+++ b/src/download/download-latest.ts
@@ -4,7 +4,7 @@ import * as exec from "@actions/exec";
 import * as path from "path";
 import { Architecture, Platform } from "../utils/platforms";
 import { validateChecksum } from "./checksum/checksum";
-import { OWNER, REPO, TOOL_CACHE_NAME } from "../utils/constants";
+import { OWNER, REPO } from "../utils/constants";

 export async function downloadLatest(
  platform: Platform,
@@ -39,14 +39,8 @@ export async function downloadLatest(
  }
  const version = await getVersion(uvExecutablePath);
  await validateChecksum(checkSum, downloadPath, arch, platform, version);
-  const cachedToolDir = await tc.cacheDir(
-    uvDir,
-    TOOL_CACHE_NAME,
-    version,
-    arch,
-  );

-  return { cachedToolDir, version };
+  return { cachedToolDir: uvDir, version };
 }

 async function getVersion(uvExecutablePath: string): Promise<string> {
--- a/src/download/download-version.ts
+++ b/src/download/download-version.ts
@@ -4,15 +4,21 @@ import * as path from "path";
 import { OWNER, REPO, TOOL_CACHE_NAME } from "../utils/constants";
 import { Architecture, Platform } from "../utils/platforms";
 import { validateChecksum } from "./checksum/checksum";
+import * as github from "@actions/github";

 export function tryGetFromToolCache(
  arch: Architecture,
  version: string,
-): string | undefined {
+): { version: string; installedPath: string | undefined } {
  core.debug(`Trying to get uv from tool cache for ${version}...`);
  const cachedVersions = tc.findAllVersions(TOOL_CACHE_NAME, arch);
  core.debug(`Cached versions: ${cachedVersions}`);
-  return tc.find(TOOL_CACHE_NAME, version, arch);
+  let resolvedVersion = tc.evaluateVersions(cachedVersions, version);
+  if (resolvedVersion === "") {
+    resolvedVersion = version;
+  }
+  const installedPath = tc.find(TOOL_CACHE_NAME, resolvedVersion, arch);
+  return { version: resolvedVersion, installedPath };
 }

 export async function downloadVersion(
@@ -20,10 +26,11 @@ export async function downloadVersion(
  arch: Architecture,
  version: string,
  checkSum: string | undefined,
-  githubToken: string | undefined,
-): Promise<string> {
+  githubToken: string,
+): Promise<{ version: string; cachedToolDir: string }> {
+  const resolvedVersion = await resolveVersion(version, githubToken);
  const artifact = `uv-${arch}-${platform}`;
-  let downloadUrl = `https://github.com/${OWNER}/${REPO}/releases/download/${version}/${artifact}`;
+  let downloadUrl = `https://github.com/${OWNER}/${REPO}/releases/download/${resolvedVersion}/${artifact}`;
  if (platform === "pc-windows-msvc") {
    downloadUrl += ".zip";
  } else {
@@ -36,7 +43,13 @@ export async function downloadVersion(
    undefined,
    githubToken,
  );
-  await validateChecksum(checkSum, downloadPath, arch, platform, version);
+  await validateChecksum(
+    checkSum,
+    downloadPath,
+    arch,
+    platform,
+    resolvedVersion,
+  );

  let uvDir: string;
  if (platform === "pc-windows-msvc") {
@@ -46,6 +59,37 @@ export async function downloadVersion(
    const extractedDir = await tc.extractTar(downloadPath);
    uvDir = path.join(extractedDir, artifact);
  }
-
-  return await tc.cacheDir(uvDir, TOOL_CACHE_NAME, version, arch);
+  const cachedToolDir = await tc.cacheDir(
+    uvDir,
+    TOOL_CACHE_NAME,
+    resolvedVersion,
+    arch,
+  );
+  return { version: resolvedVersion, cachedToolDir };
+}
+
+async function resolveVersion(
+  version: string,
+  githubToken: string,
+): Promise<string> {
+  if (tc.isExplicitVersion(version)) {
+    core.debug(`Version ${version} is an explicit version.`);
+    return version;
+  }
+  const availableVersions = await getAvailableVersions(githubToken);
+  const resolvedVersion = tc.evaluateVersions(availableVersions, version);
+  if (resolvedVersion === "") {
+    throw new Error(`No version found for ${version}`);
+  }
+  return resolvedVersion;
+}
+
+async function getAvailableVersions(githubToken: string): Promise<string[]> {
+  const octokit = github.getOctokit(githubToken);
+
+  const response = await octokit.paginate(octokit.rest.repos.listReleases, {
+    owner: OWNER,
+    repo: REPO,
+  });
+  return response.map((release) => release.tag_name);
 }
--- a/src/setup-uv.ts
+++ b/src/setup-uv.ts
@@ -18,6 +18,7 @@ import {
  checkSum,
  enableCache,
  githubToken,
+  toolBinDir,
  version,
 } from "./utils/inputs";

@@ -41,8 +42,9 @@ async function run(): Promise<void> {
    );

    addUvToPath(setupResult.uvDir);
-    core.setOutput("uv-version", version);
-    core.info(`Successfully installed uv version ${version}`);
+    addToolBinToPath();
+    core.setOutput("uv-version", setupResult.version);
+    core.info(`Successfully installed uv version ${setupResult.version}`);

    addMatchers();
    setCacheDir(cacheLocalPath);
@@ -50,10 +52,10 @@ async function run(): Promise<void> {
    if (enableCache) {
      await restoreCache(setupResult.version);
    }
+    process.exit(0);
  } catch (err) {
    core.setFailed((err as Error).message);
  }
-  process.exit(0);
 }

 async function setupUv(
@@ -61,29 +63,37 @@ async function setupUv(
  arch: Architecture,
  versionInput: string,
  checkSum: string | undefined,
-  githubToken: string | undefined,
+  githubToken: string,
 ): Promise<{ uvDir: string; version: string }> {
  let installedPath: string | undefined;
  let cachedToolDir: string;
  let version: string;
  if (versionInput === "latest") {
-    const result = await downloadLatest(platform, arch, checkSum, githubToken);
-    version = result.version;
-    cachedToolDir = result.cachedToolDir;
+    const latestResult = await downloadLatest(
+      platform,
+      arch,
+      checkSum,
+      githubToken,
+    );
+    version = latestResult.version;
+    cachedToolDir = latestResult.cachedToolDir;
  } else {
-    version = versionInput;
-    installedPath = tryGetFromToolCache(arch, versionInput);
+    const toolCacheResult = tryGetFromToolCache(arch, versionInput);
+    version = toolCacheResult.version;
+    installedPath = toolCacheResult.installedPath;
    if (installedPath) {
      core.info(`Found uv in tool-cache for ${versionInput}`);
      return { uvDir: installedPath, version };
    }
-    cachedToolDir = await downloadVersion(
+    const versionResult = await downloadVersion(
      platform,
      arch,
      versionInput,
      checkSum,
      githubToken,
    );
+    cachedToolDir = versionResult.cachedToolDir;
+    version = versionResult.version;
  }

  return { uvDir: cachedToolDir, version };
@@ -94,6 +104,15 @@ function addUvToPath(cachedPath: string): void {
  core.info(`Added ${cachedPath} to the path`);
 }

+function addToolBinToPath(): void {
+  if (toolBinDir !== undefined) {
+    core.exportVariable("UV_TOOL_BIN_DIR", toolBinDir);
+    core.info(`Set UV_TOOL_BIN_DIR to ${toolBinDir}`);
+    core.addPath(toolBinDir);
+    core.info(`Added ${toolBinDir} to the path`);
+  }
+}
+
 function setCacheDir(cacheLocalPath: string): void {
  core.exportVariable("UV_CACHE_DIR", cacheLocalPath);
  core.info(`Set UV_CACHE_DIR to ${cacheLocalPath}`);
--- a/src/utils/inputs.ts
+++ b/src/utils/inputs.ts
@@ -6,8 +6,20 @@ export const checkSum = core.getInput("checksum");
 export const enableCache = core.getInput("enable-cache") === "true";
 export const cacheSuffix = core.getInput("cache-suffix") || "";
 export const cacheLocalPath = getCacheLocalPath();
-export const githubToken = core.getInput("github-token");
 export const cacheDependencyGlob = core.getInput("cache-dependency-glob");
+export const toolBinDir = getToolBinDir();
+export const githubToken = core.getInput("github-token");
+
+function getToolBinDir(): string | undefined {
+  const toolBinDirInput = core.getInput("tool-bin-dir");
+  if (toolBinDirInput !== "") {
+    return toolBinDirInput;
+  }
+  if (process.platform === "win32") {
+    return "D:\\a\\_temp\\uv-tool-bin-dir";
+  }
+  return undefined;
+}

 function getCacheLocalPath(): string {
  const cacheLocalPathInput = core.getInput("cache-local-path");