Merge pull request #14 from stainless-api/release-please--branches--main--changes--next--components--sdk

release: 0.1.0-alpha.13

Author: meorphis

.github/workflows/ci.yml

@@ -24,7 +24,12 @@ jobs:
       - name: Set up Node
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '22'
+
+      - name: Set up pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: '10.14.0'
 
       - name: Bootstrap
         run: ./scripts/bootstrap
@@ -46,7 +51,12 @@ jobs:
       - name: Set up Node
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '22'
+
+      - name: Set up pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: '10.14.0'
 
       - name: Bootstrap
         run: ./scripts/bootstrap
@@ -81,6 +91,11 @@ jobs:
         with:
           node-version: '22'
 
+      - name: Set up pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: '10.14.0'
+
       - name: Bootstrap
         run: ./scripts/bootstrap
 

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.12"
+  ".": "0.1.0-alpha.13"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 18
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/stainless%2Fstainless-v0-c9dbcee416d3ce938a657e6fa1883ea8c40202b0bfb46d7dd5617cf2e844786c.yml
-openapi_spec_hash: 4bf38db5a15196d74647490ceebfbb9b
-config_hash: e968e8b5403abb8f4faa0b9753db713e
+configured_endpoints: 19
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/stainless%2Fstainless-v0-a3a29065ad8fdc320ffaa9b130843b1d0dc3670a045795fc624936bded3bfe0f.yml
+openapi_spec_hash: e1b7059453520913dc4a07ccc9114ed8
+config_hash: bebf53e09f502c558eb86ebe727c58dd

CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## 0.1.0-alpha.13 (2025-08-22)
+
+Full Changelog: [v0.1.0-alpha.12...v0.1.0-alpha.13](https://github.com/stainless-api/stainless-api-typescript/compare/v0.1.0-alpha.12...v0.1.0-alpha.13)
+
+### Features
+
+* [WIP] add branch rebasing to the API ([1e4eba9](https://github.com/stainless-api/stainless-api-typescript/commit/1e4eba93445900f3d56b30114e7d005d847ea50c))
+* **api:** remove compare mcp tool ([7b5370a](https://github.com/stainless-api/stainless-api-typescript/commit/7b5370afa1392b4f5af6fea319f15f781a49c085))
+* **mcp:** add code execution tool ([5fc3df8](https://github.com/stainless-api/stainless-api-typescript/commit/5fc3df86d33af1d2916146b7552ba2361f453cfb))
+* **mcp:** add option to infer mcp client ([d07e1bd](https://github.com/stainless-api/stainless-api-typescript/commit/d07e1bdc66f1d31615b118d6686d4f61ac036979))
+* **mcp:** parse query string as mcp client options in mcp server ([1aca1db](https://github.com/stainless-api/stainless-api-typescript/commit/1aca1dbe54d20f272156abe1026ffe916d91db46))
+
+
+### Bug Fixes
+
+* **mcp:** generate additionalProperties=true for map schemas to avoid validation issues ([5984cdd](https://github.com/stainless-api/stainless-api-typescript/commit/5984cddec5aac6c4cbd38ef64ed6d00c6c26bf2d))
+* **mcp:** oauth metadata ([9f07302](https://github.com/stainless-api/stainless-api-typescript/commit/9f07302d005e59c97aea7e521e8222f151b37779))
+
+
+### Chores
+
+* add package to package.json ([1f2e338](https://github.com/stainless-api/stainless-api-typescript/commit/1f2e33849ccac49559f2903fdb95aac1c3c316cc))
+* **client:** qualify global Blob ([feffee8](https://github.com/stainless-api/stainless-api-typescript/commit/feffee84b55d706db862861be0f0c01126005c47))
+* **deps:** update dependency @types/node to v20.17.58 ([969dd97](https://github.com/stainless-api/stainless-api-typescript/commit/969dd972409b6de717f063b931bfce13b3207ed1))
+* **internal:** codegen related update ([0e0e358](https://github.com/stainless-api/stainless-api-typescript/commit/0e0e358a179630d418132a799dbdcc66e5e102bb))
+* **internal:** codegen related update ([b0383ec](https://github.com/stainless-api/stainless-api-typescript/commit/b0383ec92ffc1a36e062fab102ea5e3de33ca5a3))
+* **internal:** codegen related update ([2293405](https://github.com/stainless-api/stainless-api-typescript/commit/229340561b261a4a9e3afd2ab4b408b7fa5affe7))
+* **internal:** codegen related update ([d573489](https://github.com/stainless-api/stainless-api-typescript/commit/d57348912f858042f89fba22a53090f087e63d3f))
+* **internal:** formatting change ([1f6025f](https://github.com/stainless-api/stainless-api-typescript/commit/1f6025fa6f984dd07336dcb77c8f028dce4a0161))
+* **internal:** make mcp-server publishing public by defaut ([246940f](https://github.com/stainless-api/stainless-api-typescript/commit/246940f200219056a9e1315bc87288e343a00a7d))
+* **internal:** refactor array check ([ca0ed80](https://github.com/stainless-api/stainless-api-typescript/commit/ca0ed80b9ac1f751a17cd4ddd94aa6350f352ec3))
+* **mcp:** add cors to oauth metadata route ([39f28d9](https://github.com/stainless-api/stainless-api-typescript/commit/39f28d9da323d908f9b67ba084fb7838eccea0a6))
+* **mcp:** document remote server in README.md ([354ec27](https://github.com/stainless-api/stainless-api-typescript/commit/354ec272f8841448d581562f9e247ce2f6009bfe))
+* **mcp:** minor cleanup of types and package.json ([21ba881](https://github.com/stainless-api/stainless-api-typescript/commit/21ba8813b6780307fc81af852f7dd57b4e4878b7))
+* **mcp:** update package.json ([2e6f228](https://github.com/stainless-api/stainless-api-typescript/commit/2e6f2283323ae7779d567186418070ed4a45c478))
+* **mcp:** update README ([c3fb351](https://github.com/stainless-api/stainless-api-typescript/commit/c3fb351ba59d1e498e89a7d175e6d81b16a8f18c))
+* **mcp:** update types ([2df004c](https://github.com/stainless-api/stainless-api-typescript/commit/2df004c43a4feae95788b42dd0e738a87d0eff82))
+* revert to yarn ([67dfcec](https://github.com/stainless-api/stainless-api-typescript/commit/67dfcecf94a9a77b492944f7bac6f5048b90f7e5))
+* unrevert yarn ([2174526](https://github.com/stainless-api/stainless-api-typescript/commit/2174526b17c574c85cec785f3cb3bf91a7f4a6b9))
+
+
+### Documentation
+
+* add contact email and link to docs ([707d851](https://github.com/stainless-api/stainless-api-typescript/commit/707d85194bc368374d3146fb360597667ec30402))
+
 ## 0.1.0-alpha.12 (2025-08-12)
 
 Full Changelog: [v0.1.0-alpha.11...v0.1.0-alpha.12](https://github.com/stainless-api/stainless-api-typescript/compare/v0.1.0-alpha.11...v0.1.0-alpha.12)

README.md

@@ -4,7 +4,7 @@
 
 This library provides convenient access to the Stainless REST API from server-side TypeScript or JavaScript.
 
-The full API of this library can be found in [api.md](api.md).
+The REST API documentation can be found on [www.stainless.com](https://www.stainless.com/docs/getting-started/quickstart-cli). The full API of this library can be found in [api.md](api.md).
 
 It is generated with [Stainless](https://www.stainless.com/).
 

SECURITY.md

@@ -18,6 +18,10 @@ before making any information public.
 If you encounter security issues that are not directly related to SDKs but pertain to the services
 or products provided by Stainless, please follow the respective company's security reporting guidelines.
 
+### Stainless Terms and Policies
+
+Please contact [email protected] for any questions or concerns regarding the security of our services.
+
 ---
 
 Thank you for helping us keep the SDKs and systems they interact with secure.

api.md

@@ -32,6 +32,7 @@ Methods:
 - <code title="get /v0/projects/{project}/branches/{branch}">client.projects.branches.<a href="./src/resources/projects/branches.ts">retrieve</a>(branch, { ...params }) -> ProjectBranch</code>
 - <code title="get /v0/projects/{project}/branches">client.projects.branches.<a href="./src/resources/projects/branches.ts">list</a>({ ...params }) -> BranchListResponsesPage</code>
 - <code title="delete /v0/projects/{project}/branches/{branch}">client.projects.branches.<a href="./src/resources/projects/branches.ts">delete</a>(branch, { ...params }) -> unknown</code>
+- <code title="put /v0/projects/{project}/branches/{branch}/rebase">client.projects.branches.<a href="./src/resources/projects/branches.ts">rebase</a>(branch, { ...params }) -> ProjectBranch</code>
 
 ## Configs
 

package.json

@@ -1,14 +1,14 @@
 {
   "name": "@stainless-api/sdk",
-  "version": "0.1.0-alpha.12",
+  "version": "0.1.0-alpha.13",
   "description": "The official TypeScript library for the Stainless API",
-  "author": "Stainless <>",
+  "author": "Stainless <[email protected]>",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "type": "commonjs",
   "repository": "github:stainless-api/stainless-api-typescript",
   "license": "Apache-2.0",
-  "packageManager": "[email protected]",
+  "packageManager": "[email protected]",
   "files": [
     "**/*"
   ],
@@ -19,7 +19,7 @@
   "scripts": {
     "test": "./scripts/test",
     "build": "./scripts/build",
-    "prepublishOnly": "echo 'to publish, run yarn build && (cd dist; yarn publish)' && exit 1",
+    "prepublishOnly": "echo 'to publish, run pnpm build && (cd dist; pnpm publish)' && exit 1",
     "format": "./scripts/format",
     "prepare": "if ./scripts/utils/check-is-in-git-install.sh; then ./scripts/build && ./scripts/utils/git-swap.sh; fi",
     "tsn": "ts-node -r tsconfig-paths/register",
@@ -44,8 +44,9 @@
     "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.8/tsc-multi.tgz",
+    "tsc-multi": "https://github.com/stainless-api/tsc-multi/releases/download/v1.1.9/tsc-multi.tgz",
     "tsconfig-paths": "^4.0.0",
+    "tslib": "^2.8.1",
     "typescript": "5.8.3",
     "typescript-eslint": "8.31.1"
   },

packages/mcp-server/README.md

@@ -141,6 +141,45 @@ over time, you can manually enable or disable certain capabilities:
 --resource=cards,accounts --operation=read --tag=kyc --no-tool=create_cards
 ```
 
+## Running remotely
+
+Launching the client with `--transport=http` launches the server as a remote server using Streamable HTTP transport. The `--port` setting can choose the port it will run on, and the `--socket` setting allows it to run on a Unix socket.
+
+Authorization can be provided via the `Authorization` header using the Bearer scheme.
+
+Additionally, authorization can be provided via the following headers:
+| Header | Equivalent client option | Security scheme |
+| --------------------- | ------------------------ | --------------- |
+| `x-stainless-api-key` | `apiKey` | bearerAuth |
+
+A configuration JSON for this server might look like this, assuming the server is hosted at `http://localhost:3000`:
+
+```json
+{
+  "mcpServers": {
+    "stainless_api_sdk_api": {
+      "url": "http://localhost:3000",
+      "headers": {
+        "Authorization": "Bearer <auth value>"
+      }
+    }
+  }
+}
+```
+
+The command-line arguments for filtering tools and specifying clients can also be used as query parameters in the URL.
+For example, to exclude specific tools while including others, use the URL:
+
+```
+http://localhost:3000?resource=cards&resource=accounts&no_tool=create_cards
+```
+
+Or, to configure for the Cursor client, with a custom max tool name length, use the URL:
+
+```
+http://localhost:3000?client=cursor&capability=tool-name-length%3D40
+```
+
 ## Importing the tools and server individually
 
 ```js
@@ -193,6 +232,7 @@ The following tools are available in this MCP server.
 - `retrieve_projects_branches` (`read`): Retrieve a project branch
 - `list_projects_branches` (`read`): List project branches
 - `delete_projects_branches` (`write`): Delete a project branch
+- `rebase_projects_branches` (`write`): Rebase a project branch
 
 ### Resource `projects.configs`:
 
@@ -204,7 +244,6 @@ The following tools are available in this MCP server.
 - `create_builds` (`write`): Create a new build
 - `retrieve_builds` (`read`): Retrieve a build by ID
 - `list_builds` (`read`): List builds for a project
-- `compare_builds` (`write`): Creates two builds whose outputs can be compared directly
 
 ### Resource `builds.diagnostics`:
 

packages/mcp-server/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stainless-api/sdk-mcp",
-  "version": "0.1.0-alpha.12",
+  "version": "0.1.0-alpha.13",
   "description": "The official MCP Server for the Stainless API",
-  "author": "Stainless <>",
+  "author": "Stainless <[email protected]>",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "type": "commonjs",
@@ -13,35 +13,44 @@
   },
   "homepage": "https://github.com/stainless-api/stainless-api-typescript/tree/main/packages/mcp-server#readme",
   "license": "Apache-2.0",
-  "packageManager": "[email protected]",
+  "packageManager": "[email protected]",
   "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "test": "jest",
     "build": "bash ./build",
-    "prepack": "echo 'to pack, run yarn build && (cd dist; yarn pack)' && exit 1",
-    "prepublishOnly": "echo 'to publish, run yarn build && (cd dist; yarn publish)' && exit 1",
+    "prepack": "echo 'to pack, run pnpm build && (cd dist; pnpm pack)' && exit 1",
+    "prepublishOnly": "echo 'to publish, run pnpm build && (cd dist; pnpm publish)' && exit 1",
     "format": "prettier --write --cache --cache-strategy metadata . !dist",
-    "prepare": "npm run build",
     "tsn": "ts-node -r tsconfig-paths/register",
     "lint": "eslint --ext ts,js .",
     "fix": "eslint --fix --ext ts,js ."
   },
   "dependencies": {
-    "@stainless-api/sdk": "file:../../dist/",
+    "@stainless-api/sdk": "workspace:*",
+    "@cloudflare/cabidela": "^0.2.4",
     "@modelcontextprotocol/sdk": "^1.11.5",
+    "@valtown/deno-http-worker": "^0.0.21",
+    "cors": "^2.8.5",
     "express": "^5.1.0",
     "jq-web": "https://github.com/stainless-api/jq-web/releases/download/v0.8.6/jq-web.tar.gz",
+    "qs": "^6.14.0",
     "yargs": "^17.7.2",
-    "@cloudflare/cabidela": "^0.2.4",
     "zod": "^3.25.20",
-    "zod-to-json-schema": "^3.24.5"
+    "zod-to-json-schema": "^3.24.5",
+    "zod-validation-error": "^4.0.1"
   },
   "bin": {
     "mcp-server": "dist/index.js"
   },
   "devDependencies": {
-    "@types/jest": "^29.4.0",
+    "@types/cors": "^2.8.19",
     "@types/express": "^5.0.3",
+    "@types/jest": "^29.4.0",
+    "@types/qs": "^6.14.0",
+    "@types/yargs": "^17.0.8",
     "@typescript-eslint/eslint-plugin": "8.31.1",
     "@typescript-eslint/parser": "8.31.1",
     "eslint": "^8.49.0",
@@ -52,7 +61,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.8/tsc-multi.tgz",
+    "tsc-multi": "https://github.com/stainless-api/tsc-multi/releases/download/v1.1.9/tsc-multi.tgz",
     "tsconfig-paths": "^4.0.0",
     "typescript": "5.8.3"
   },