stainless-api
diff --git a/‎.github/workflows/ci.yml‎
Lines changed: 9 additions & 0 deletions b/‎.github/workflows/ci.yml‎
Lines changed: 9 additions & 0 deletions
diff --git a/‎.github/workflows/publish-npm.yml‎
Lines changed: 5 additions & 0 deletions b/‎.github/workflows/publish-npm.yml‎
Lines changed: 5 additions & 0 deletions
diff --git a/‎.gitignore‎
Lines changed: 2 additions & 1 deletion b/‎.gitignore‎
Lines changed: 2 additions & 1 deletion
diff --git a/‎.release-please-manifest.json‎
Lines changed: 1 addition & 1 deletion b/‎.release-please-manifest.json‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎.stats.yml‎
Lines changed: 3 additions & 3 deletions b/‎.stats.yml‎
Lines changed: 3 additions & 3 deletions
diff --git a/‎CHANGELOG.md‎
Lines changed: 114 additions & 0 deletions b/‎CHANGELOG.md‎
Lines changed: 114 additions & 0 deletions
diff --git a/‎README.md‎
Lines changed: 27 additions & 29 deletions b/‎README.md‎
Lines changed: 27 additions & 29 deletions
diff --git a/‎api.md‎
Lines changed: 4 additions & 4 deletions b/‎api.md‎
Lines changed: 4 additions & 4 deletions
diff --git a/‎package.json‎
Lines changed: 1 addition & 1 deletion b/‎package.json‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎packages/mcp-server/README.md‎
Lines changed: 46 additions & 18 deletions b/‎packages/mcp-server/README.md‎
Lines changed: 46 additions & 18 deletions
@@ -78,6 +78,15 @@ jobs:
           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'
+        env:
+          URL: https://pkg.stainless.com/s?subpackage=mcp-server
+          AUTH: ${{ steps.github-oidc.outputs.github_token }}
+          SHA: ${{ github.sha }}
+          BASE_PATH: packages/mcp-server
+        run: ./scripts/utils/upload-artifact.sh
   test:
     timeout-minutes: 10
     name: test
 
@@ -39,3 +39,8 @@ jobs:
           yarn tsn scripts/publish-packages.ts "{ \"paths_released\": \"$PATHS_RELEASED\" }"
         env:
           NPM_TOKEN: ${{ secrets.STAINLESS_NPM_TOKEN || secrets.NPM_TOKEN }}
+
+      - name: Upload MCP Server DXT GitHub release asset
+        run: |
+          gh release upload ${{ github.event.release.tag_name }} \
+            packages/mcp-server/stainless_api_sdk_api.dxt
@@ -7,4 +7,5 @@ dist
 dist-deno
 /*.tgz
 .idea/
-
+dist-bundle
+*.dxt
@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.13"
+  ".": "0.1.0-alpha.14"
 }
@@ -1,4 +1,4 @@
 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
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/stainless%2Fstainless-v0-a015455f60c6b613608a0a1fc4918a41593038160a16b09f714f601ab98c84bf.yml
+openapi_spec_hash: 6f4ebb173c63d77efa9addde9b11f69e
+config_hash: 50a257a9f90f8a010873c283e2832095
@@ -27,9 +27,9 @@ const client = new Stainless({
   environment: 'staging', // defaults to 'production'
 });
 
-const buildObject = await client.builds.create({ project: 'project', revision: 'string' });
+const build = await client.builds.create({ project: 'stainless', revision: 'main' });
 
-console.log(buildObject.id);
+console.log(build.id);
 ```
 
 ### Request & Response types
@@ -45,8 +45,8 @@ const client = new Stainless({
   environment: 'staging', // defaults to 'production'
 });
 
-const params: Stainless.BuildCreateParams = { project: 'project', revision: 'string' };
-const buildObject: Stainless.BuildObject = await client.builds.create(params);
+const params: Stainless.BuildCreateParams = { project: 'stainless', revision: 'main' };
+const build: Stainless.Build = await client.builds.create(params);
 ```
 
 Documentation for each method, request param, and response field are available in docstrings and will appear on hover in most modern editors.
@@ -59,17 +59,15 @@ a subclass of `APIError` will be thrown:
 
 <!-- prettier-ignore -->
 ```ts
-const buildObject = await client.builds
-  .create({ project: 'project', revision: 'string' })
-  .catch(async (err) => {
-    if (err instanceof Stainless.APIError) {
-      console.log(err.status); // 400
-      console.log(err.name); // BadRequestError
-      console.log(err.headers); // {server: 'nginx', ...}
-    } else {
-      throw err;
-    }
-  });
+const build = await client.builds.create({ project: 'stainless', revision: 'main' }).catch(async (err) => {
+  if (err instanceof Stainless.APIError) {
+    console.log(err.status); // 400
+    console.log(err.name); // BadRequestError
+    console.log(err.headers); // {server: 'nginx', ...}
+  } else {
+    throw err;
+  }
+});
 ```
 
 Error codes are as follows:
@@ -101,7 +99,7 @@ const client = new Stainless({
 });
 
 // Or, configure per-request:
-await client.builds.create({ project: 'project', revision: 'string' }, {
+await client.builds.create({ project: 'stainless', revision: 'main' }, {
   maxRetries: 5,
 });
 ```
@@ -118,7 +116,7 @@ const client = new Stainless({
 });
 
 // Override per-request:
-await client.builds.create({ project: 'project', revision: 'string' }, {
+await client.builds.create({ project: 'stainless', revision: 'main' }, {
   timeout: 5 * 1000,
 });
 ```
@@ -133,22 +131,22 @@ List methods in the Stainless API are paginated.
 You can use the `for await … of` syntax to iterate through items across all pages:
 
 ```ts
-async function fetchAllBuildObjects(params) {
-  const allBuildObjects = [];
+async function fetchAllBuilds(params) {
+  const allBuilds = [];
   // Automatically fetches more pages as needed.
-  for await (const buildObject of client.builds.list({ project: 'project' })) {
-    allBuildObjects.push(buildObject);
+  for await (const build of client.builds.list({ project: 'stainless' })) {
+    allBuilds.push(build);
   }
-  return allBuildObjects;
+  return allBuilds;
 }
 ```
 
 Alternatively, you can request a single page at a time:
 
 ```ts
-let page = await client.builds.list({ project: 'project' });
-for (const buildObject of page.data) {
-  console.log(buildObject);
+let page = await client.builds.list({ project: 'stainless' });
+for (const build of page.data) {
+  console.log(build);
 }
 
 // Convenience methods are provided for manually paginating:
@@ -172,15 +170,15 @@ Unlike `.asResponse()` this method consumes the body, returning once it is parse
 ```ts
 const client = new Stainless();
 
-const response = await client.builds.create({ project: 'project', revision: 'string' }).asResponse();
+const response = await client.builds.create({ project: 'stainless', revision: 'main' }).asResponse();
 console.log(response.headers.get('X-My-Header'));
 console.log(response.statusText); // access the underlying Response object
 
-const { data: buildObject, response: raw } = await client.builds
-  .create({ project: 'project', revision: 'string' })
+const { data: build, response: raw } = await client.builds
+  .create({ project: 'stainless', revision: 'main' })
   .withResponse();
 console.log(raw.headers.get('X-My-Header'));
-console.log(buildObject.id);
+console.log(build.id);
 ```
 
 ### Logging
 
@@ -50,16 +50,16 @@ Methods:
 
 Types:
 
-- <code><a href="./src/resources/builds/builds.ts">BuildObject</a></code>
+- <code><a href="./src/resources/builds/builds.ts">Build</a></code>
 - <code><a href="./src/resources/builds/builds.ts">BuildTarget</a></code>
 - <code><a href="./src/resources/builds/builds.ts">CheckStep</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 }) -> BuildObjectsPage</code>
+- <code title="post /v0/builds">client.builds.<a href="./src/resources/builds/builds.ts">create</a>({ ...params }) -> Build</code>
+- <code title="get /v0/builds/{buildId}">client.builds.<a href="./src/resources/builds/builds.ts">retrieve</a>(buildID) -> Build</code>
+- <code title="get /v0/builds">client.builds.<a href="./src/resources/builds/builds.ts">list</a>({ ...params }) -> BuildsPage</code>
 - <code title="post /v0/builds/compare">client.builds.<a href="./src/resources/builds/builds.ts">compare</a>({ ...params }) -> BuildCompareResponse</code>
 
 ## Diagnostics
 
@@ -1,6 +1,6 @@
 {
   "name": "@stainless-api/sdk",
-  "version": "0.1.0-alpha.13",
+  "version": "0.1.0-alpha.14",
   "description": "The official TypeScript library for the Stainless API",
   "author": "Stainless <[email protected]>",
   "types": "dist/index.d.ts",
 
@@ -221,39 +221,67 @@ The following tools are available in this MCP server.
 
 ### Resource `projects`:
 
-- `create_projects` (`write`): Create a new project
-- `retrieve_projects` (`read`): Retrieve a project by name
-- `update_projects` (`write`): Update a project's properties
-- `list_projects` (`read`): List projects in an organization, from oldest to newest
+- `create_projects` (`write`): Create a new project.
+- `retrieve_projects` (`read`): Retrieve a project by name.
+- `update_projects` (`write`): Update a project's properties.
+- `list_projects` (`read`): List projects in an organization, from oldest to newest.
 
 ### Resource `projects.branches`:
 
-- `create_projects_branches` (`write`): Create a new branch for a project
-- `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
+- `create_projects_branches` (`write`): Create a new branch for a project.
+
+  The branch inherits the config files from the revision pointed to by the
+  `branch_from` parameter. In addition, if the revision is a branch name,
+  the branch will also inherit custom code changes from that branch.
+
+- `retrieve_projects_branches` (`read`): Retrieve a project branch by name.
+- `list_projects_branches` (`read`): Retrieve a project branch by name.
+- `delete_projects_branches` (`write`): Delete a project branch by name.
+- `rebase_projects_branches` (`write`): Rebase a project branch.
+
+  The branch is rebased onto the `base` branch or commit SHA, inheriting
+  any config and custom code changes.
 
 ### Resource `projects.configs`:
 
-- `retrieve_projects_configs` (`read`): Retrieve configuration files for a project
-- `guess_projects_configs` (`write`): Generate configuration suggestions based on an OpenAPI spec
+- `retrieve_projects_configs` (`read`):
+  Retrieve the configuration files for a given project.
+- `guess_projects_configs` (`write`):
+  Generate suggestions for changes to config files based on an OpenAPI spec.
 
 ### Resource `builds`:
 
-- `create_builds` (`write`): Create a new build
-- `retrieve_builds` (`read`): Retrieve a build by ID
-- `list_builds` (`read`): List builds for a project
+- `create_builds` (`write`): Create a build, on top of a project branch, against a given input revision.
+
+  The project branch will be modified so that its latest set of config files
+  points to the one specified by the input revision.
+
+- `retrieve_builds` (`read`): Retrieve a build by its ID.
+- `list_builds` (`read`): List user-triggered builds for a given project.
+
+  An optional revision can be specified to filter by config commit SHA, or
+  hashes of file contents.
 
 ### Resource `builds.diagnostics`:
 
-- `list_builds_diagnostics` (`read`): Get diagnostics for a build
+- `list_builds_diagnostics` (`read`): Get the list of diagnostics for a given build.
+
+  If no language targets are specified, diagnostics for all languages are returned.
 
 ### Resource `builds.target_outputs`:
 
-- `retrieve_builds_target_outputs` (`read`): Download the output of a build target
+- `retrieve_builds_target_outputs` (`read`): Retrieve a method to download an output for a given build target.
+
+  If the requested type of output is `source`, and the requested output
+  method is `url`, a download link to a tarball of the source files is
+  returned. If the requested output method is `git`, a Git remote, ref,
+  and access token (if necessary) is returned.
+
+  Otherwise, the possible types of outputs are specific to the requested
+  target, and the output method _must_ be `url`. See the documentation for
+  `type` for more information.
 
 ### Resource `orgs`:
 
-- `retrieve_orgs` (`read`): Retrieve an organization by name
-- `list_orgs` (`read`): List organizations the user has access to
+- `retrieve_orgs` (`read`): Retrieve an organization by name.
+- `list_orgs` (`read`): List organizations accessible to the current authentication method.
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "0.1.0-alpha.13"`
	`2`	`+ ".": "0.1.0-alpha.14"`
`3`	`3`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@stainless-api/sdk",`
`3`		`- "version": "0.1.0-alpha.13",`
	`3`	`+ "version": "0.1.0-alpha.14",`
`4`	`4`	`"description": "The official TypeScript library for the Stainless API",`
`5`	`5`	`"author": "Stainless <[email protected]>",`
`6`	`6`	`"types": "dist/index.d.ts",`