feat(api): manual updates

Author: stainless-app[bot]

.github/workflows/publish-npm.yml

@@ -0,0 +1,41 @@
+# This workflow is triggered when a GitHub release is created.
+# It can also be run manually to re-publish to NPM in case it failed for some reason.
+# You can run this workflow by navigating to https://www.github.com/stainless-api/stainless-api-typescript/actions/workflows/publish-npm.yml
+name: Publish NPM
+on:
+  workflow_dispatch:
+    inputs:
+      path:
+        description: The path to run the release in, e.g. '.' or 'packages/mcp-server'
+        required: true
+
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    name: publish
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node
+        uses: actions/setup-node@v3
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: |
+          yarn install
+
+      - name: Publish to NPM
+        run: |
+          if [ -n "${{ github.event.inputs.path }}" ]; then
+            PATHS_RELEASED='[\"${{ github.event.inputs.path }}\"]'
+          else
+            PATHS_RELEASED='[\".\", \"packages/mcp-server\"]'
+          fi
+          yarn tsn scripts/publish-packages.ts "{ \"paths_released\": \"$PATHS_RELEASED\" }"
+        env:
+          NPM_TOKEN: ${{ secrets.STAINLESS_NPM_TOKEN || secrets.NPM_TOKEN }}

.github/workflows/release-doctor.yml

@@ -18,3 +18,4 @@ jobs:
         run: |
           bash ./bin/check-release-environment
         env:
+          NPM_TOKEN: ${{ secrets.STAINLESS_NPM_TOKEN || secrets.NPM_TOKEN }}

.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: 8a921dfc8d183e865a02718de6783412
+config_hash: 2161cb69f5b32b6423d993cc6746ecce

CONTRIBUTING.md

@@ -55,12 +55,12 @@ $ cd stainless-api-typescript
 # With yarn
 $ yarn link
 $ cd ../my-package
-$ yarn link stainless-v0
+$ yarn link @stainless-api/sdk
 
 # With pnpm
 $ pnpm link --global
 $ cd ../my-package
-$ pnpm link -—global stainless-v0
+$ pnpm link -—global @stainless-api/sdk
 ```
 
 ## Running tests
@@ -91,3 +91,17 @@ To format and fix all lint issues automatically:
 ```sh
 $ yarn fix
 ```
+
+## Publishing and releases
+
+Changes made to this repository via the automated release PR pipeline should publish to npm automatically. If
+the changes aren't made through the automated pipeline, you may want to make releases manually.
+
+### Publish with a GitHub workflow
+
+You can release to package managers by using [the `Publish NPM` GitHub action](https://www.github.com/stainless-api/stainless-api-typescript/actions/workflows/publish-npm.yml). This requires a setup organization or repository secret to be set up.
+
+### Publish manually
+
+If you need to manually release a package, you can run the `bin/publish-npm` script with an `NPM_TOKEN` set on
+the environment.

README.md

@@ -1,6 +1,6 @@
 # Stainless TypeScript API Library
 
-[![NPM version](<https://img.shields.io/npm/v/stainless-v0.svg?label=npm%20(stable)>)](https://npmjs.org/package/stainless-v0) ![npm bundle size](https://img.shields.io/bundlephobia/minzip/stainless-v0)
+[![NPM version](<https://img.shields.io/npm/v/@stainless-api/sdk.svg?label=npm%20(stable)>)](https://npmjs.org/package/@stainless-api/sdk) ![npm bundle size](https://img.shields.io/bundlephobia/minzip/@stainless-api/sdk)
 
 This library provides convenient access to the Stainless REST API from server-side TypeScript or JavaScript.
 
@@ -11,19 +11,16 @@ It is generated with [Stainless](https://www.stainless.com/).
 ## Installation
 
 ```sh
-npm install git+ssh://[email protected]:stainless-api/stainless-api-typescript.git
+npm install @stainless-api/sdk
 ```
 
-> [!NOTE]
-> Once this package is [published to npm](https://www.stainless.com/docs/guides/publish), this will become: `npm install stainless-v0`
-
 ## Usage
 
 The full API of this library can be found in [api.md](api.md).
 
 <!-- prettier-ignore -->
 ```js
-import Stainless from 'stainless-v0';
+import Stainless from '@stainless-api/sdk';
 
 const client = new Stainless({
   apiKey: process.env['STAINLESS_API_KEY'], // This is the default and can be omitted
@@ -40,7 +37,7 @@ This library includes TypeScript definitions for all request params and response
 
 <!-- prettier-ignore -->
 ```ts
-import Stainless from 'stainless-v0';
+import Stainless from '@stainless-api/sdk';
 
 const client = new Stainless({
   apiKey: process.env['STAINLESS_API_KEY'], // This is the default and can be omitted
@@ -167,7 +164,7 @@ The log level can be configured in two ways:
 2. Using the `logLevel` client option (overrides the environment variable if set)
 
 ```ts
-import Stainless from 'stainless-v0';
+import Stainless from '@stainless-api/sdk';
 
 const client = new Stainless({
   logLevel: 'debug', // Show all log messages
@@ -195,7 +192,7 @@ When providing a custom logger, the `logLevel` option still controls which messa
 below the configured level will not be sent to your logger.
 
 ```ts
-import Stainless from 'stainless-v0';
+import Stainless from '@stainless-api/sdk';
 import pino from 'pino';
 
 const logger = pino();
@@ -264,7 +261,7 @@ globalThis.fetch = fetch;
 Or pass it to the client:
 
 ```ts
-import Stainless from 'stainless-v0';
+import Stainless from '@stainless-api/sdk';
 import fetch from 'my-fetch';
 
 const client = new Stainless({ fetch });
@@ -275,7 +272,7 @@ const client = new Stainless({ fetch });
 If you want to set custom `fetch` options without overriding the `fetch` function, you can provide a `fetchOptions` object when instantiating the client or making a request. (Request-specific options override client options.)
 
 ```ts
-import Stainless from 'stainless-v0';
+import Stainless from '@stainless-api/sdk';
 
 const client = new Stainless({
   fetchOptions: {
@@ -292,7 +289,7 @@ options to requests:
 <img src="https://raw.githubusercontent.com/stainless-api/sdk-assets/refs/heads/main/node.svg" align="top" width="18" height="21"> **Node** <sup>[[docs](https://github.com/nodejs/undici/blob/main/docs/docs/api/ProxyAgent.md#example---proxyagent-with-fetch)]</sup>
 
 ```ts
-import Stainless from 'stainless-v0';
+import Stainless from '@stainless-api/sdk';
 import * as undici from 'undici';
 
 const proxyAgent = new undici.ProxyAgent('http://localhost:8888');
@@ -306,7 +303,7 @@ const client = new Stainless({
 <img src="https://raw.githubusercontent.com/stainless-api/sdk-assets/refs/heads/main/bun.svg" align="top" width="18" height="21"> **Bun** <sup>[[docs](https://bun.sh/guides/http/proxy)]</sup>
 
 ```ts
-import Stainless from 'stainless-v0';
+import Stainless from '@stainless-api/sdk';
 
 const client = new Stainless({
   fetchOptions: {
@@ -318,7 +315,7 @@ const client = new Stainless({
 <img src="https://raw.githubusercontent.com/stainless-api/sdk-assets/refs/heads/main/deno.svg" align="top" width="18" height="21"> **Deno** <sup>[[docs](https://docs.deno.com/api/deno/~/Deno.createHttpClient)]</sup>
 
 ```ts
-import Stainless from 'npm:stainless-v0';
+import Stainless from 'npm:@stainless-api/sdk';
 
 const httpClient = Deno.createHttpClient({ proxy: { url: 'http://localhost:8888' } });
 const client = new Stainless({

bin/check-release-environment

@@ -2,6 +2,10 @@
 
 errors=()
 
+if [ -z "${NPM_TOKEN}" ]; then
+  errors+=("The STAINLESS_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

eslint.config.mjs

@@ -25,7 +25,7 @@ export default tseslint.config(
         {
           patterns: [
             {
-              regex: '^stainless-v0(/.*)?',
+              regex: '^@stainless-api/sdk(/.*)?',
               message: 'Use a relative import, not a package import.',
             },
           ],

jest.config.ts

@@ -7,8 +7,8 @@ const config: JestConfigWithTsJest = {
     '^.+\\.(t|j)sx?$': ['@swc/jest', { sourceMaps: 'inline' }],
   },
   moduleNameMapper: {
-    '^stainless-v0$': '<rootDir>/src/index.ts',
-    '^stainless-v0/(.*)$': '<rootDir>/src/$1',
+    '^@stainless-api/sdk$': '<rootDir>/src/index.ts',
+    '^@stainless-api/sdk/(.*)$': '<rootDir>/src/$1',
   },
   modulePathIgnorePatterns: [
     '<rootDir>/ecosystem-tests/',

package.json

@@ -1,5 +1,5 @@
 {
-  "name": "stainless-v0",
+  "name": "@stainless-api/sdk",
   "version": "0.1.0-alpha.5",
   "description": "The official TypeScript library for the Stainless API",
   "author": "Stainless <>",
@@ -47,8 +47,8 @@
     "typescript": "5.8.3"
   },
   "imports": {
-    "stainless-v0": ".",
-    "stainless-v0/*": "./src/*"
+    "@stainless-api/sdk": ".",
+    "@stainless-api/sdk/*": "./src/*"
   },
   "exports": {
     ".": {

packages/mcp-server/README.md

@@ -4,33 +4,18 @@ It is generated with [Stainless](https://www.stainless.com/).
 
 ## Installation
 
-### Building
+### Direct invocation
 
-Because it's not published yet, clone the repo and build it:
+You can run the MCP Server directly via `npx`:
 
 ```sh
-git clone [email protected]:stainless-api/stainless-api-typescript.git
-cd stainless-api-typescript
-./scripts/bootstrap
-./scripts/build
-```
-
-### Running
-
-```sh
-# set env vars as needed
 export STAINLESS_API_KEY="My API Key"
 export STAINLESS_PROJECT="example-project"
-node ./packages/mcp-server/dist/index.js
+npx -y @stainless-api/mcp@latest
 ```
 
-> [!NOTE]
-> Once this package is [published to npm](https://www.stainless.com/docs/guides/publish), this will become: `npx -y stainless-v0-mcp`
-
 ### Via MCP Client
 
-[Build the project](#building) as mentioned above.
-
 There is a partial list of existing clients at [modelcontextprotocol.io](https://modelcontextprotocol.io/clients). If you already
 have a client, consult their documentation to install the MCP server.
 
@@ -39,13 +24,9 @@ For clients with a configuration JSON, it might look something like this:
 ```json
 {
   "mcpServers": {
-    "stainless_v0_api": {
-      "command": "node",
-      "args": [
-        "/path/to/local/stainless-api-typescript/packages/mcp-server",
-        "--client=claude",
-        "--tools=all"
-      ],
+    "stainless_api_sdk_api": {
+      "command": "npx",
+      "args": ["-y", "@stainless-api/mcp", "--client=claude", "--tools=all"],
       "env": {
         "STAINLESS_API_KEY": "My API Key",
         "STAINLESS_PROJECT": "example-project"
@@ -151,10 +132,10 @@ over time, you can manually enable or disable certain capabilities:
 
 ```js
 // Import the server, generated endpoints, or the init function
-import { server, endpoints, init } from "stainless-v0-mcp/server";
+import { server, endpoints, init } from "@stainless-api/mcp/server";
 
 // import a specific tool
-import createProjects from "stainless-v0-mcp/tools/projects/create-projects";
+import createProjects from "@stainless-api/mcp/tools/projects/create-projects";
 
 // initialize the server and all endpoints
 init({ server, endpoints });