release: 0.39.0

.github/workflows/ci.yml

@@ -21,15 +21,15 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/hyperspell-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
         with:
           node-version: '22'
 
       - name: Set up pnpm
-        uses: pnpm/action-setup@v4
+        uses: pnpm/action-setup@b906affcce14559ad1aafd4ab0e942779e9f58b1 # v4.3.0
         with:
           version: '10.30.1'
 
@@ -48,15 +48,15 @@ jobs:
       contents: read
       id-token: write
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
         with:
           node-version: '22'
 
       - name: Set up pnpm
-        uses: pnpm/action-setup@v4
+        uses: pnpm/action-setup@b906affcce14559ad1aafd4ab0e942779e9f58b1 # v4.3.0
         with:
           version: '10.30.1'
 
@@ -71,7 +71,7 @@ jobs:
           github.repository == 'stainless-sdks/hyperspell-typescript' &&
           !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
-        uses: actions/github-script@v8
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
@@ -101,15 +101,15 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/hyperspell-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
         with:
           node-version: '22'
 
       - name: Set up pnpm
-        uses: pnpm/action-setup@v4
+        uses: pnpm/action-setup@b906affcce14559ad1aafd4ab0e942779e9f58b1 # v4.3.0
         with:
           version: '10.30.1'
 

.github/workflows/publish-npm.yml

@@ -18,18 +18,17 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       contents: write
-      id-token: write
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up Node
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@3235b876344d2a9aa001b8d1453c930bba69e610 # v3.9.1
         with:
           node-version: '20'
 
       - name: Set up pnpm
-        uses: pnpm/action-setup@v4
+        uses: pnpm/action-setup@b906affcce14559ad1aafd4ab0e942779e9f58b1 # v4.3.0
 
       - name: Install dependencies
         run: |
@@ -45,6 +44,7 @@ jobs:
           pnpm tsn scripts/publish-packages.ts "{ \"paths_released\": \"$PATHS_RELEASED\" }"
         env:
           INPUT_PATH: ${{ github.event.inputs.path }}
+          NPM_TOKEN: ${{ secrets.HYPERSPELL_NPM_TOKEN || secrets.NPM_TOKEN }}
 
       - name: Upload MCP Server DXT GitHub release asset
         run: |

.github/workflows/release-doctor.yml

@@ -12,9 +12,10 @@ jobs:
     if: github.repository == 'hyperspell/node-sdk' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Check release environment
         run: |
           bash ./bin/check-release-environment
-
+        env:
+          NPM_TOKEN: ${{ secrets.HYPERSPELL_NPM_TOKEN || secrets.NPM_TOKEN }}

.gitignore

@@ -11,4 +11,3 @@ dist-deno
 .eslintcache
 dist-bundle
 *.mcpb
-oidc

.prettierignore

@@ -2,6 +2,7 @@ CHANGELOG.md
 /ecosystem-tests/*/**
 /node_modules
 /deno
+/packages/mcp-server/manifest.json
 
 # don't format tsc output, will break source maps
 dist

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.38.0"
+  ".": "0.39.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 30
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/hyperspell%2Fhyperspell-a4bf4f3aaf1509541db646bc9ff7ec58e78cb4d42cf6bf83881b02739ad77b87.yml
-openapi_spec_hash: 89cd02b2290061877e6badcddb7c8eb8
-config_hash: 09bb5ca4418f316f95d2b75ef7399cf0
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/hyperspell/hyperspell-cec6507dd37a73b074fd57ef2cd54479cddf3d5efceab2d36b906485ed36ec86.yml
+openapi_spec_hash: 58ed64e4179f15f76c7ca0cef2e68f03
+config_hash: 597eba5e5eaec83a5f0db3d946af8db5

CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## 0.39.0 (2026-05-29)
+
+Full Changelog: [v0.38.0...v0.39.0](https://github.com/hyperspell/node-sdk/compare/v0.38.0...v0.39.0)
+
+### Features
+
+* **api:** api update ([eb85299](https://github.com/hyperspell/node-sdk/commit/eb852994671e2c39b31ffc1f150be17974a69393))
+* **api:** api update ([7465b15](https://github.com/hyperspell/node-sdk/commit/7465b1580e02e3c06c25d7fe68c0b3a14c0b4ae2))
+* **api:** api update ([898829a](https://github.com/hyperspell/node-sdk/commit/898829a0b4b42f4bd463aa8a4cf63fe6f29e57f2))
+* **api:** api update ([c31c296](https://github.com/hyperspell/node-sdk/commit/c31c29639884d9bb39be2c1a130a188dcab36efb))
+* **api:** api update ([8958b49](https://github.com/hyperspell/node-sdk/commit/8958b49b8d8a5868432f1b932b1aec3b61c5d8c8))
+* **api:** api update ([10386a3](https://github.com/hyperspell/node-sdk/commit/10386a310df2c0c44c953e9f5ecf5e85673b9777))
+* **api:** api update ([e1f12f8](https://github.com/hyperspell/node-sdk/commit/e1f12f8169bd1fbdc92e5ae4e09ce035221ddc5f))
+* **api:** api update ([700d0af](https://github.com/hyperspell/node-sdk/commit/700d0afb46b6e0ad518900eff1bb9ed8c092adea))
+* **api:** api update ([d4b2496](https://github.com/hyperspell/node-sdk/commit/d4b24967ab4c8b0686d69bf7f0780b6b77ab7f58))
+* support setting headers via env ([0e3b514](https://github.com/hyperspell/node-sdk/commit/0e3b514c6f583a21f6e5fde7e0a458a445ac7097))
+
+
+### Bug Fixes
+
+* **typescript:** upgrade tsc-multi so that it works with Node 26 ([bb51450](https://github.com/hyperspell/node-sdk/commit/bb5145072a47a307da3ea5f14aeda4ff9036743e))
+
+
+### Chores
+
+* avoid formatting file that gets changed during releases ([cf52108](https://github.com/hyperspell/node-sdk/commit/cf52108cf3114d0cd27cc613089e3d7f05bfa3fe))
+* **format:** run eslint and prettier separately ([43ec88d](https://github.com/hyperspell/node-sdk/commit/43ec88dc0ac5298ca91a346583c646c9e091cef7))
+* **internal:** codegen related update ([f6cdc59](https://github.com/hyperspell/node-sdk/commit/f6cdc59ea881808e4b574fd45c788e08e1c2b5bb))
+* **internal:** more robust bootstrap script ([dd48b06](https://github.com/hyperspell/node-sdk/commit/dd48b061429585dad8aad6566a46d2d2bd83fbc0))
+* **internal:** update docs ordering ([9ac7b35](https://github.com/hyperspell/node-sdk/commit/9ac7b35b68c4e663653daf544de988f2e5366558))
+* redact api-key headers in debug logs ([9ccb5ff](https://github.com/hyperspell/node-sdk/commit/9ccb5ffbecd2a069fc07153536bc8b0d28b0df7f))
+* restructure docs search code ([8a752b4](https://github.com/hyperspell/node-sdk/commit/8a752b4ab98fb186e56fa4cba6c18bf1b2d2fa9f))
+* **tests:** remove redundant File import ([1f3a018](https://github.com/hyperspell/node-sdk/commit/1f3a0189b23fc56c3986a6041e433ac81833d22f))
+* update SDK settings ([5f5049a](https://github.com/hyperspell/node-sdk/commit/5f5049a7c86a2afed361ddf31cf28df66ec4f769))
+
+
+### Documentation
+
+* update http mcp docs ([6f8f5a6](https://github.com/hyperspell/node-sdk/commit/6f8f5a61525cd0c1e1edefa6cd75c7b2577a0973))
+
 ## 0.38.0 (2026-04-22)
 
 Full Changelog: [v0.37.0...v0.38.0](https://github.com/hyperspell/node-sdk/compare/v0.37.0...v0.38.0)

bin/check-release-environment

@@ -2,6 +2,10 @@
 
 errors=()
 
+if [ -z "${NPM_TOKEN}" ]; then
+  errors+=("The NPM_TOKEN secret has not been set. Please set it in either this repository's secrets or your organization secrets")
+fi
+
 lenErrors=${#errors[@]}
 
 if [[ lenErrors -gt 0 ]]; then

bin/cli

@@ -4,19 +4,26 @@ const { spawnSync } = require('child_process');
 
 const commands = {
   migrate: {
-    description: 'Run migrations to update your code using @hyperspell/hyperspell@0.22.1 to be compatible with @hyperspell/hyperspell@0.24.0',
+    description:
+      'Run migrations to update your code using @hyperspell/hyperspell@0.22.1 to be compatible with @hyperspell/hyperspell@0.24.0',
     fn: () => {
       const result = spawnSync(
         'npx',
-        ['-y', 'https://github.com/stainless-api/migrate-ts/releases/download/0.0.2/stainless-api-migrate-0.0.2-6.tgz', '--migrationConfig', require.resolve('./migration-config.json'), ...process.argv.slice(3)],
+        [
+          '-y',
+          'https://github.com/stainless-api/migrate-ts/releases/download/0.0.2/stainless-api-migrate-0.0.2-6.tgz',
+          '--migrationConfig',
+          require.resolve('./migration-config.json'),
+          ...process.argv.slice(3),
+        ],
         { stdio: 'inherit' },
       );
       if (result.status !== 0) {
         process.exit(result.status);
       }
-    }
-  }
-}
+    },
+  },
+};
 
 function exitWithHelp() {
   console.log(`Usage: hyperspell-hyperspell <subcommand>`);

bin/publish-npm

@@ -2,12 +2,7 @@
 
 set -eux
 
-if [[ ${NPM_TOKEN:-} ]]; then
-  npm config set '//registry.npmjs.org/:_authToken' "$NPM_TOKEN"
-elif [[ ! ${ACTIONS_ID_TOKEN_REQUEST_TOKEN:-} ]]; then
-  echo "ERROR: NPM_TOKEN must be set if not running in a Github Action with id-token permission"
-  exit 1
-fi
+npm config set '//registry.npmjs.org/:_authToken' "$NPM_TOKEN"
 
 pnpm build
 cd dist
@@ -62,8 +57,5 @@ else
   TAG="latest"
 fi
 
-# Install OIDC compatible npm version
-npm install --prefix ../oidc/ npm@11.6.2
-
 # Publish with the appropriate tag
-pnpm publish --npm-path "$(cd ../ && pwd)/oidc/node_modules/.bin/npm" --no-git-checks --tag "$TAG"
+pnpm publish --no-git-checks --tag "$TAG"

eslint.config.mjs

@@ -1,7 +1,6 @@
 // @ts-check
 import tseslint from 'typescript-eslint';
 import unusedImports from 'eslint-plugin-unused-imports';
-import prettier from 'eslint-plugin-prettier';
 
 export default tseslint.config(
   {
@@ -14,11 +13,9 @@ export default tseslint.config(
     plugins: {
       '@typescript-eslint': tseslint.plugin,
       'unused-imports': unusedImports,
-      prettier,
     },
     rules: {
       'no-unused-vars': 'off',
-      'prettier/prettier': 'error',
       'unused-imports/no-unused-imports': 'error',
       'no-restricted-imports': [
         'error',

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperspell/hyperspell",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "description": "The official TypeScript library for the Hyperspell API",
   "author": "Hyperspell <hello@hyperspell.com>",
   "types": "dist/index.d.ts",
@@ -36,15 +36,14 @@
     "@typescript-eslint/eslint-plugin": "8.31.1",
     "@typescript-eslint/parser": "8.31.1",
     "eslint": "^9.39.1",
-    "eslint-plugin-prettier": "^5.4.1",
     "eslint-plugin-unused-imports": "^4.1.4",
     "iconv-lite": "^0.6.3",
     "jest": "^29.4.0",
     "prettier": "^3.0.0",
     "publint": "^0.2.12",
     "ts-jest": "^29.1.0",
     "ts-node": "^10.5.0",
-    "tsc-multi": "https://github.com/stainless-api/tsc-multi/releases/download/v1.1.9/tsc-multi.tgz",
+    "tsc-multi": "https://github.com/stainless-api/tsc-multi/releases/download/v1.1.11/tsc-multi.tgz",
     "tsconfig-paths": "^4.0.0",
     "tslib": "^2.8.1",
     "typescript": "5.8.3",

packages/mcp-server/manifest.json

@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.2",
   "name": "@hyperspell/hyperspell-mcp",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "description": "The official MCP Server for the Hyperspell API",
   "author": {
     "name": "Hyperspell",

packages/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperspell/hyperspell-mcp",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "description": "The official MCP Server for the Hyperspell API",
   "author": "Hyperspell <hello@hyperspell.com>",
   "types": "dist/index.d.ts",
@@ -73,7 +73,7 @@
     "ts-jest": "^29.1.0",
     "ts-morph": "^19.0.0",
     "ts-node": "^10.5.0",
-    "tsc-multi": "https://github.com/stainless-api/tsc-multi/releases/download/v1.1.9/tsc-multi.tgz",
+    "tsc-multi": "https://github.com/stainless-api/tsc-multi/releases/download/v1.1.11/tsc-multi.tgz",
     "tsconfig-paths": "^4.0.0"
   },
   "imports": {