release: 0.6.0

.github/workflows/ci.yml

@@ -1,12 +1,14 @@
 name: CI
 on:
   push:
-    branches-ignore:
-      - 'generated'
-      - 'codegen/**'
-      - 'integrated/**'
-      - 'stl-preview-head/**'
-      - 'stl-preview-base/**'
+    branches:
+      - '**'
+      - '!integrated/**'
+      - '!stl-preview-head/**'
+      - '!stl-preview-base/**'
+      - '!generated'
+      - '!codegen/**'
+      - 'codegen/stl/**'
   pull_request:
     branches-ignore:
       - 'stl-preview-head/**'
@@ -17,7 +19,7 @@ jobs:
     timeout-minutes: 10
     name: lint
     runs-on: ${{ github.repository == 'stainless-sdks/stainless-v0-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
+    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
 
@@ -41,7 +43,7 @@ jobs:
     timeout-minutes: 5
     name: build
     runs-on: ${{ github.repository == 'stainless-sdks/stainless-v0-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
+    if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     permissions:
       contents: read
       id-token: write
@@ -65,22 +67,28 @@ jobs:
         run: ./scripts/build
 
       - name: Get GitHub OIDC Token
-        if: github.repository == 'stainless-sdks/stainless-v0-typescript'
+        if: |-
+          github.repository == 'stainless-sdks/stainless-v0-typescript' &&
+          !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
         uses: actions/github-script@v8
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
       - name: Upload tarball
-        if: github.repository == 'stainless-sdks/stainless-v0-typescript'
+        if: |-
+          github.repository == 'stainless-sdks/stainless-v0-typescript' &&
+          !startsWith(github.ref, 'refs/heads/stl/')
         env:
           URL: https://pkg.stainless.com/s
           AUTH: ${{ steps.github-oidc.outputs.github_token }}
           SHA: ${{ github.sha }}
         run: ./scripts/utils/upload-artifact.sh
 
       - name: Upload MCP Server tarball
-        if: github.repository == 'stainless-sdks/stainless-v0-typescript'
+        if: |-
+          github.repository == 'stainless-sdks/stainless-v0-typescript' &&
+          !startsWith(github.ref, 'refs/heads/stl/')
         env:
           URL: https://pkg.stainless.com/s?subpackage=mcp-server
           AUTH: ${{ steps.github-oidc.outputs.github_token }}

.github/workflows/publish-npm.yml

@@ -40,12 +40,14 @@ jobs:
 
       - name: Publish to NPM
         run: |
-          if [ -n "${{ github.event.inputs.path }}" ]; then
-            PATHS_RELEASED='[\"${{ github.event.inputs.path }}\"]'
+          if [ -n "$INPUT_PATH" ]; then
+            PATHS_RELEASED="[\"$INPUT_PATH\"]"
           else
             PATHS_RELEASED='[\".\", \"packages/mcp-server\"]'
           fi
           pnpm tsn scripts/publish-packages.ts "{ \"paths_released\": \"$PATHS_RELEASED\" }"
+        env:
+          INPUT_PATH: ${{ github.event.inputs.path }}
 
       - name: Upload MCP Server DXT GitHub release asset
         run: |

.gitignore

@@ -1,4 +1,5 @@
 .prism.log
+.stdy.log
 node_modules
 yarn-error.log
 codegen.log
@@ -10,3 +11,4 @@ dist-deno
 .eslintcache
 dist-bundle
 *.mcpb
+oidc

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.5.0"
+  ".": "0.6.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 22
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/stainless%2Fstainless-v0-1d73a351f5570e4ce6fa4116eeb560acf7d31c32e54aeb86048e80e8ce9a8bce.yml
-openapi_spec_hash: 4e947471253594803217011d177b25ff
-config_hash: 4b44da9496c775d2294758cd233f4ecd
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/stainless%2Fstainless-v0-ef33241ec003fafbf4f2ffe434c3d8c2ac0ba929137942185663ff59974d2138.yml
+openapi_spec_hash: f4a68de1cb28c33de769c08f68f543ab
+config_hash: 63178ec4b1d2ea5636c8619cffcf129b

CHANGELOG.md

@@ -1,5 +1,72 @@
 # Changelog
 
+## 0.6.0 (2026-04-10)
+
+Full Changelog: [v0.5.0...v0.6.0](https://github.com/stainless-api/stainless-api-typescript/compare/v0.5.0...v0.6.0)
+
+### Features
+
+* **api:** add a way to fetch specific files via /v0/build_target_outputs ([47d31df](https://github.com/stainless-api/stainless-api-typescript/commit/47d31df25bf59538cc25f9af45df6798532cb5d9))
+* **api:** add host to v0 build endpoints ([582f2ee](https://github.com/stainless-api/stainless-api-typescript/commit/582f2ee584d2f66726f244c59b5b28557fa28229))
+* **api:** api update ([a39391e](https://github.com/stainless-api/stainless-api-typescript/commit/a39391e98d5301eb1dd20f692dfece0b545ce9f0))
+
+
+### Bug Fixes
+
+* escape MCP `instructions` backticks as necessary ([c0743c2](https://github.com/stainless-api/stainless-api-typescript/commit/c0743c2249a2a00ed4c1d2d97c08a3a9f65c2b28))
+* **internal:** gitignore generated `oidc` dir ([0c48336](https://github.com/stainless-api/stainless-api-typescript/commit/0c4833637b9f8b77d049c3640491e80eeab435e5))
+
+
+### Chores
+
+* **ci:** escape input path in publish-npm workflow ([b2ac0d2](https://github.com/stainless-api/stainless-api-typescript/commit/b2ac0d28f0a05101140977a6c59625321edbe8ee))
+* **ci:** skip lint on metadata-only changes ([ca653c1](https://github.com/stainless-api/stainless-api-typescript/commit/ca653c1fff337672bee70ede60d597f18f0087c2))
+* configure new SDK language ([5c79cfc](https://github.com/stainless-api/stainless-api-typescript/commit/5c79cfc74db9cca61bf0e3f90f3afdc8ab2bcdc3))
+* **internal:** codegen related update ([4d7b8fd](https://github.com/stainless-api/stainless-api-typescript/commit/4d7b8fdf6ed827dc03919db6368e31da639169d1))
+* **internal:** codegen related update ([1a7e654](https://github.com/stainless-api/stainless-api-typescript/commit/1a7e65435142ed6005fcb6d09e47c56943905026))
+* **internal:** codegen related update ([1f6d02c](https://github.com/stainless-api/stainless-api-typescript/commit/1f6d02ce2bd8b3e409c4d9f01c4f453f040ff41f))
+* **internal:** codegen related update ([cdcf59b](https://github.com/stainless-api/stainless-api-typescript/commit/cdcf59bf708df0b1420302c821177f0a33b35c0b))
+* **internal:** codegen related update ([d12219d](https://github.com/stainless-api/stainless-api-typescript/commit/d12219d6d1e0f5738c0ad0130354a9edbf7b9a7d))
+* **internal:** codegen related update ([0dea9de](https://github.com/stainless-api/stainless-api-typescript/commit/0dea9de11c089e830bea82382bac0f7d358c8030))
+* **internal:** codegen related update ([8c4472e](https://github.com/stainless-api/stainless-api-typescript/commit/8c4472ebe25db5c39a031ad1b30128f68acffee7))
+* **internal:** codegen related update ([5b28358](https://github.com/stainless-api/stainless-api-typescript/commit/5b28358f1d6ba6486ae8139e23c7b42584aa75d7))
+* **internal:** codegen related update ([10e4a74](https://github.com/stainless-api/stainless-api-typescript/commit/10e4a7463de222d8233c0819c2872b34149e69f4))
+* **internal:** codegen related update ([418b537](https://github.com/stainless-api/stainless-api-typescript/commit/418b537d3ec57b2099ef0e961aa97307b66bcd59))
+* **internal:** codegen related update ([7488007](https://github.com/stainless-api/stainless-api-typescript/commit/74880071e6313d8184d3f8f0898079e45d4af9c8))
+* **internal:** fix MCP server import ordering ([51ba135](https://github.com/stainless-api/stainless-api-typescript/commit/51ba135c4db3194d080ed739d681df807fba3f7a))
+* **internal:** fix MCP server TS errors that occur with required client options ([953025e](https://github.com/stainless-api/stainless-api-typescript/commit/953025ee34a621464681480b01a318fa18356a96))
+* **internal:** improve local docs search for MCP servers ([7cb39f8](https://github.com/stainless-api/stainless-api-typescript/commit/7cb39f817135cd4a71dd89472754eb3afb67cac7))
+* **internal:** improve local docs search for MCP servers ([d6f4642](https://github.com/stainless-api/stainless-api-typescript/commit/d6f4642f8a56ffb6ca4d1fba27f540715d33b3f9))
+* **internal:** make generated MCP servers compatible with Cloudflare worker environments ([240ce54](https://github.com/stainless-api/stainless-api-typescript/commit/240ce54162d3f6994d335b30d966820017ac1721))
+* **internal:** show error causes in MCP servers when running in local mode ([904e84e](https://github.com/stainless-api/stainless-api-typescript/commit/904e84ee03f53ebafbc98dc33f85d77c025e489a))
+* **internal:** support custom-instructions-path flag in MCP servers ([74a7953](https://github.com/stainless-api/stainless-api-typescript/commit/74a795308d7f1385e12166d692621f55059e545a))
+* **internal:** support local docs search in MCP servers ([4d8f430](https://github.com/stainless-api/stainless-api-typescript/commit/4d8f430aac34cf9540f6bd9471ac44d61ba52aaf))
+* **internal:** support type annotations when running MCP in local execution mode ([bd8940c](https://github.com/stainless-api/stainless-api-typescript/commit/bd8940c7928a38fa38744604886a38a4cce9b538))
+* **internal:** support x-stainless-mcp-client-envs header in MCP servers ([a030429](https://github.com/stainless-api/stainless-api-typescript/commit/a030429bef5a6eb81aaa537697a8eea5eb429f8b))
+* **internal:** support x-stainless-mcp-client-permissions headers in MCP servers ([25afcb0](https://github.com/stainless-api/stainless-api-typescript/commit/25afcb0bd66984f37e13e64b85d57bb80f69f2c3))
+* **internal:** tweak CI branches ([ccf0b9f](https://github.com/stainless-api/stainless-api-typescript/commit/ccf0b9fa50a012c03bc7ae332d3e5a55cae91310))
+* **internal:** update dependencies to address dependabot vulnerabilities ([f542774](https://github.com/stainless-api/stainless-api-typescript/commit/f542774a0fe3b39095be9d760ba0e5737cbaa511))
+* **internal:** update gitignore ([63eab56](https://github.com/stainless-api/stainless-api-typescript/commit/63eab56360c8d36656ff40c7a6abd647d787681a))
+* **internal:** update lock file ([e27afe4](https://github.com/stainless-api/stainless-api-typescript/commit/e27afe4a2c9631f1b74409293476cd3672576c08))
+* **internal:** update lockfile ([2927f0b](https://github.com/stainless-api/stainless-api-typescript/commit/2927f0b624f2d4fe14d01ab3c584d5e5bfc0be3b))
+* **internal:** update multipart form array serialization ([cf0a2fd](https://github.com/stainless-api/stainless-api-typescript/commit/cf0a2fd88c94427f737f4ff679f54b832bc9470d))
+* **mcp-server:** add support for session id, forward client info ([97a77cb](https://github.com/stainless-api/stainless-api-typescript/commit/97a77cb6a4ee65aaac3fa9c596ff7e736a6bbe1f))
+* **mcp-server:** improve instructions ([254552f](https://github.com/stainless-api/stainless-api-typescript/commit/254552f98aaf9b74168e0fa160d0b08cc2fe7596))
+* **mcp-server:** increase local docs search result count from 5 to 10 ([514b997](https://github.com/stainless-api/stainless-api-typescript/commit/514b997e6ea5a63d291b682afc558cb15069601f))
+* **mcp-server:** log client info ([96c130a](https://github.com/stainless-api/stainless-api-typescript/commit/96c130a0ed90dccb7f3e9dc2d56350773e2a025b))
+* **tests:** bump steady to v0.19.4 ([b1d8900](https://github.com/stainless-api/stainless-api-typescript/commit/b1d890082ab881413104094f41b4cdffd2a04a9b))
+* **tests:** bump steady to v0.19.5 ([9a02a5a](https://github.com/stainless-api/stainless-api-typescript/commit/9a02a5aae4908b6d0161ddb794db881a9851b168))
+* **tests:** bump steady to v0.19.6 ([1722669](https://github.com/stainless-api/stainless-api-typescript/commit/1722669260ce7e69fbea51edfcde4c88fd3258e5))
+* **tests:** bump steady to v0.19.7 ([ab4d58b](https://github.com/stainless-api/stainless-api-typescript/commit/ab4d58b29688ed19b00d098673d3839cf2e220f3))
+* **tests:** bump steady to v0.20.1 ([995a1ce](https://github.com/stainless-api/stainless-api-typescript/commit/995a1ceb2de6912839a2114ae0f54bda153797a6))
+* **tests:** bump steady to v0.20.2 ([4dcb408](https://github.com/stainless-api/stainless-api-typescript/commit/4dcb408bbe36e5e2d04a808a835d8e2a7f71ec23))
+* update probot ([6f7c736](https://github.com/stainless-api/stainless-api-typescript/commit/6f7c7368fce7ba79131444da334be12fbdf0c3d6))
+
+
+### Refactors
+
+* **tests:** switch from prism to steady ([848becd](https://github.com/stainless-api/stainless-api-typescript/commit/848becd5669e0cdfb3ee21f7040cf2a0b7afd78a))
+
 ## 0.5.0 (2026-03-02)
 
 Full Changelog: [v0.4.0...v0.5.0](https://github.com/stainless-api/stainless-api-typescript/compare/v0.4.0...v0.5.0)

CONTRIBUTING.md

@@ -65,7 +65,7 @@ $ pnpm link --global @stainless-api/sdk
 
 ## Running tests
 
-Most tests require you to [set up a mock server](https://github.com/stoplightio/prism) against the OpenAPI spec to run the tests.
+Most tests require you to [set up a mock server](https://github.com/dgellow/steady) against the OpenAPI spec to run the tests.
 
 ```sh
 $ ./scripts/mock

README.md

@@ -12,8 +12,8 @@ It is generated with [Stainless](https://www.stainless.com/).
 
 Use the Stainless MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.
 
-[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=%40stainless-api%2Fmcp&config=eyJuYW1lIjoiQHN0YWlubGVzcy1hcGkvbWNwIiwidHJhbnNwb3J0IjoiaHR0cCIsInVybCI6Imh0dHBzOi8vc3RhaW5sZXNzLXYwLnN0bG1jcC5jb20iLCJoZWFkZXJzIjp7Ingtc3RhaW5sZXNzLWFwaS1rZXkiOiJNeSBBUEkgS2V5In19)
-[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22%40stainless-api%2Fmcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fstainless-v0.stlmcp.com%22%2C%22headers%22%3A%7B%22x-stainless-api-key%22%3A%22My%20API%20Key%22%7D%7D)
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=%40stainless-api%2Fsdk-mcp&config=eyJuYW1lIjoiQHN0YWlubGVzcy1hcGkvc2RrLW1jcCIsInRyYW5zcG9ydCI6Imh0dHAiLCJ1cmwiOiJodHRwczovL3N0YWlubGVzcy12MC5zdGxtY3AuY29tIiwiaGVhZGVycyI6eyJ4LXN0YWlubGVzcy1hcGkta2V5IjoiTXkgQVBJIEtleSJ9fQ)
+[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22%40stainless-api%2Fsdk-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fstainless-v0.stlmcp.com%22%2C%22headers%22%3A%7B%22x-stainless-api-key%22%3A%22My%20API%20Key%22%7D%7D)
 
 > Note: You may need to set environment variables in your MCP client.
 
@@ -33,7 +33,6 @@ import Stainless from '@stainless-api/sdk';
 
 const client = new Stainless({
   apiKey: process.env['STAINLESS_API_KEY'], // This is the default and can be omitted
-  environment: 'staging', // defaults to 'production'
 });
 
 const build = await client.builds.create({ project: 'stainless', revision: 'main' });
@@ -51,7 +50,6 @@ import Stainless from '@stainless-api/sdk';
 
 const client = new Stainless({
   apiKey: process.env['STAINLESS_API_KEY'], // This is the default and can be omitted
-  environment: 'staging', // defaults to 'production'
 });
 
 const params: Stainless.BuildCreateParams = { project: 'stainless', revision: 'main' };

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stainless-api/sdk",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "The official TypeScript library for the Stainless API",
   "author": "Stainless <support@stainless.com>",
   "types": "dist/index.d.ts",
@@ -50,6 +50,17 @@
     "typescript": "5.8.3",
     "typescript-eslint": "8.31.1"
   },
+  "overrides": {
+    "minimatch": "^9.0.5"
+  },
+  "pnpm": {
+    "overrides": {
+      "minimatch": "^9.0.5"
+    }
+  },
+  "resolutions": {
+    "minimatch": "^9.0.5"
+  },
   "exports": {
     ".": {
       "import": "./dist/index.mjs",