release: 0.1.0-alpha.9 (#10)

* codegen metadata

* chore(ci): only run for pushes and fork pull requests

* chore(client): improve path param validation

* feat(api): add staging environment

* codegen metadata

* chore(internal): codegen related update

* feat(api): add proper pagination

* release: 0.1.0-alpha.9

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.github/workflows/ci.yml

@@ -17,6 +17,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
     steps:
       - uses: actions/checkout@v4
 
@@ -35,6 +36,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
     permissions:
       contents: read
       id-token: write
@@ -70,6 +72,7 @@ jobs:
     timeout-minutes: 10
     name: test
     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
     steps:
       - uses: actions/checkout@v4
 

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.8"
+  ".": "0.1.0-alpha.9"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 17
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/stainless%2Fstainless-v0-0eed0c3c47bb630ed692f2de1c5228e3e1a29f52489851aecc0b9f9f3b5bce61.yml
 openapi_spec_hash: c62aa08b1662b81b6ede9e298e4f1882
-config_hash: e98f7f125d7eb350114b570438cb368c
+config_hash: 90634c69edf6c56b14785217d1b0c0e0

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.1.0-alpha.9 (2025-07-02)
+
+Full Changelog: [v0.1.0-alpha.8...v0.1.0-alpha.9](https://github.com/stainless-api/stainless-api-typescript/compare/v0.1.0-alpha.8...v0.1.0-alpha.9)
+
+### Features
+
+* **api:** add proper pagination ([0cf6809](https://github.com/stainless-api/stainless-api-typescript/commit/0cf680917852d9757f157d38ee608039abff8f50))
+* **api:** add staging environment ([4b6d770](https://github.com/stainless-api/stainless-api-typescript/commit/4b6d77045a3b9c0683fb0fee8cdf900d34f53e27))
+
+
+### Chores
+
+* **ci:** only run for pushes and fork pull requests ([9f9f180](https://github.com/stainless-api/stainless-api-typescript/commit/9f9f180c2fe3919de021486b7602550a085b6388))
+* **client:** improve path param validation ([b9f7c44](https://github.com/stainless-api/stainless-api-typescript/commit/b9f7c446279fa9f216c8d57d82c919f029275321))
+* **internal:** codegen related update ([3e3dc52](https://github.com/stainless-api/stainless-api-typescript/commit/3e3dc5259ed5f54d45635b084b3506d91c6692a2))
+
 ## 0.1.0-alpha.8 (2025-06-27)
 
 Full Changelog: [v0.1.0-alpha.7...v0.1.0-alpha.8](https://github.com/stainless-api/stainless-api-typescript/compare/v0.1.0-alpha.7...v0.1.0-alpha.8)

README.md

@@ -24,6 +24,7 @@ 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 buildObject = await client.builds.create({ project: 'project', revision: 'string' });
@@ -41,6 +42,7 @@ 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: 'project', revision: 'string' };

api.md

@@ -12,7 +12,7 @@ Methods:
 - <code title="post /v0/projects">client.projects.<a href="./src/resources/projects/projects.ts">create</a>({ ...params }) -> ProjectCreateResponse</code>
 - <code title="get /v0/projects/{project}">client.projects.<a href="./src/resources/projects/projects.ts">retrieve</a>({ ...params }) -> ProjectRetrieveResponse</code>
 - <code title="patch /v0/projects/{project}">client.projects.<a href="./src/resources/projects/projects.ts">update</a>({ ...params }) -> ProjectUpdateResponse</code>
-- <code title="get /v0/projects">client.projects.<a href="./src/resources/projects/projects.ts">list</a>({ ...params }) -> ProjectListResponse</code>
+- <code title="get /v0/projects">client.projects.<a href="./src/resources/projects/projects.ts">list</a>({ ...params }) -> ProjectListResponsesList</code>
 
 ## Branches
 
@@ -43,14 +43,13 @@ Types:
 
 - <code><a href="./src/resources/builds/builds.ts">BuildObject</a></code>
 - <code><a href="./src/resources/builds/builds.ts">BuildTarget</a></code>
-- <code><a href="./src/resources/builds/builds.ts">BuildListResponse</a></code>
 - <code><a href="./src/resources/builds/builds.ts">BuildCompareResponse</a></code>
 
 Methods:
 
 - <code title="post /v0/builds">client.builds.<a href="./src/resources/builds/builds.ts">create</a>({ ...params }) -> BuildObject</code>
 - <code title="get /v0/builds/{buildId}">client.builds.<a href="./src/resources/builds/builds.ts">retrieve</a>(buildID) -> BuildObject</code>
-- <code title="get /v0/builds">client.builds.<a href="./src/resources/builds/builds.ts">list</a>({ ...params }) -> BuildListResponse</code>
+- <code title="get /v0/builds">client.builds.<a href="./src/resources/builds/builds.ts">list</a>({ ...params }) -> BuildObjectsList</code>
 - <code title="post /v0/builds/compare">client.builds.<a href="./src/resources/builds/builds.ts">compare</a>({ ...params }) -> BuildCompareResponse</code>
 
 ## Diagnostics
@@ -61,7 +60,7 @@ Types:
 
 Methods:
 
-- <code title="get /v0/builds/{buildId}/diagnostics">client.builds.diagnostics.<a href="./src/resources/builds/diagnostics.ts">list</a>(buildID, { ...params }) -> DiagnosticListResponse</code>
+- <code title="get /v0/builds/{buildId}/diagnostics">client.builds.diagnostics.<a href="./src/resources/builds/diagnostics.ts">list</a>(buildID, { ...params }) -> DiagnosticListResponsesList</code>
 
 ## TargetOutputs
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stainless-api/sdk",
-  "version": "0.1.0-alpha.8",
+  "version": "0.1.0-alpha.9",
   "description": "The official TypeScript library for the Stainless API",
   "author": "Stainless <>",
   "types": "dist/index.d.ts",

packages/mcp-server/README.md

@@ -11,6 +11,7 @@ You can run the MCP Server directly via `npx`:
 ```sh
 export STAINLESS_API_KEY="My API Key"
 export STAINLESS_PROJECT="example-project"
+export STAINLESS_ENVIRONMENT="production"
 npx -y @stainless-api/mcp@latest
 ```
 
@@ -29,7 +30,8 @@ For clients with a configuration JSON, it might look something like this:
       "args": ["-y", "@stainless-api/mcp", "--client=claude", "--tools=all"],
       "env": {
         "STAINLESS_API_KEY": "My API Key",
-        "STAINLESS_PROJECT": "example-project"
+        "STAINLESS_PROJECT": "example-project",
+        "STAINLESS_ENVIRONMENT": "production"
       }
     }
   }

packages/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stainless-api/mcp",
-  "version": "0.1.0-alpha.8",
+  "version": "0.1.0-alpha.9",
   "description": "The official MCP Server for the Stainless API",
   "author": "Stainless <>",
   "types": "dist/index.d.ts",

packages/mcp-server/src/server.ts

@@ -26,7 +26,7 @@ export { endpoints } from './tools';
 export const server = new McpServer(
   {
     name: 'stainless_api_sdk_api',
-    version: '0.1.0-alpha.8',
+    version: '0.1.0-alpha.9',
   },
   {
     capabilities: {
@@ -67,7 +67,11 @@ export function init(params: {
 
   const client =
     params.client ||
-    new Stainless({ project: readEnv('STAINLESS_PROJECT'), defaultHeaders: { 'X-Stainless-MCP': 'true' } });
+    new Stainless({
+      project: readEnv('STAINLESS_PROJECT'),
+      environment: (readEnv('STAINLESS_ENVIRONMENT') || undefined) as any,
+      defaultHeaders: { 'X-Stainless-MCP': 'true' },
+    });
 
   server.setRequestHandler(ListToolsRequestSchema, async () => {
     return {