release: 2.0.0 by stainless-app[bot] · Pull Request #249 · terminaldotshop/terminal-sdk-js

stainless-app · 2025-12-19T08:16:43Z

Automated Release PR

2.0.0 (2026-04-10)

Full Changelog: v1.23.3...v2.0.0

⚠ BREAKING CHANGES

mcp: remove deprecated tool schemes
mcp: Migration: To migrate, simply modify the command used to invoke the MCP server. Currently, the only supported tool scheme is code mode. Now, starting the server with just node /path/to/mcp/server or npx package-name will invoke code tools: changing your command to one of these is likely all you will need to do.

Features

mcp: add initial server instructions (b96652d)

Bug Fixes

docs: fix mcp installation instructions for remote servers (8cecce3)
mcp: allow falling back for required env variables (b888cc9)
mcp: correct code tool api output types (c5a472c)
mcp: do not fallback on baseUrl if environment env variable is set (7792449)
mcp: fix env parsing (ebe7a45)
mcp: fix options parsing (0a9e105)
mcp: update code tool prompt (2e1e61e)

Chores

break long lines in snippets into multiline (099799b)
ci: upgrade actions/github-script (b03af58)
client: do not parse responses with empty content-length (2dc2d76)
internal: add health check to MCP server when running in HTTP mode (129191b)
internal: allow basic filtering of methods allowed for MCP code mode (e3a8bca)
internal: always generate MCP server dockerfiles and upgrade associated dependencies (2dc70ea)
internal: codegen related update (4c84fbf)
internal: codegen related update (6036e13)
internal: codegen related update (d12215b)
internal: codegen related update (159c7ea)
internal: codegen related update (44f48a8)
internal: codegen related update (c597dec)
internal: codegen related update (3beb9cc)
internal: codegen related update (40d19e2)
internal: codegen related update (e89c6b6)
internal: codegen related update (1fde448)
internal: codegen related update (dc9e9d7)
internal: codegen related update (35ac52b)
internal: codegen related update (6d2422b)
internal: codegen related update (9cb63d6)
internal: codegen related update (b2811ca)
internal: codegen related update (5a66289)
internal: codegen related update (6aedf0f)
internal: codegen related update (0a08718)
internal: codegen related update (2add106)
internal: codegen related update (625f4c5)
internal: codegen related update (eda5110)
internal: codegen related update (ea5101a)
internal: codegen related update (3ee84b3)
internal: codegen related update (b299c03)
internal: codegen related update (21f2996)
internal: codegen related update (4a5dbae)
internal: codegen related update (bf53a63)
internal: codegen related update (1646399)
internal: codegen related update (ee47b3e)
internal: codegen related update (8cd3436)
internal: codegen related update (6ae8b7b)
internal: codegen related update (4f3fe9b)
internal: codegen related update (269f193)
internal: fix MCP Dockerfiles so they can be built without buildkit (0e8d62c)
internal: fix MCP Dockerfiles so they can be built without buildkit (b672e2a)
internal: improve layout of generated MCP server files (5dd32ae)
internal: refactor flag parsing for MCP servers and add debug flag (4fc206d)
internal: support oauth authorization code flow for MCP servers (bd8e9ed)
internal: update actions/checkout version (2959753)
internal: upgrade babel, qs, js-yaml (b2e7cb8)
internal: use x-stainless-mcp-client-envs header for MCP remote code tool calls (ef6ce54)
mcp: add intent param to execute tool (71cd9c9)
mcp: forward STAINLESS_API_KEY to docs search endpoint (b03a4af)
mcp: pass intent param to execute handler (c972807)
mcp: remove deprecated tool schemes (c8d468d)
mcp: up tsconfig lib version to es2022 (6dc632a)
mcp: upgrade dependencies (73b8d6b)

Documentation

prominently feature MCP server setup in root SDK readmes (51611e9)

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

This removes all tool schemes except for "code mode" tools. Specifically, this removes "all tools" and "dynamic tools" schemes. Additionally, this removes support for resource filtering, tags, jq filtering, and compatibility controls in MCP servers, as they are no longer necessary when using code mode. # Migration To migrate, simply modify the command used to invoke the MCP server. Currently, the only supported tool scheme is code mode. Now, starting the server with just `node /path/to/mcp/server` or `npx package-name` will invoke code tools: changing your command to one of these is likely all you will need to do. Specifically, you must remove all flags including things like --resources, --tags, --client, --tools=dynamic, etc from your invocation command. The only supported flags are now `--port`, `--transport`, `--socket`, and `--tools=docs` (specifically for "docs"). These are also the only options available for http servers. migration-effort: small

stainless-app · 2025-12-19T08:17:27Z

🧪 Testing

To try out this version of the SDK, run:

npm install 'https://pkg.stainless.com/s/terminal-node/21f29963d2fca76194778d18920157283fe029a2/dist.tar.gz'

Expires at: Sat, 21 Mar 2026 06:11:24 GMT
Updated at: Thu, 19 Feb 2026 06:11:24 GMT

packages/mcp-server/src/index.ts

  switch (options.transport) {
    case 'stdio':
-      await launchStdioServer(options);
+      await launchStdioServer();


packages/mcp-server/src/index.ts


  switch (options.transport) {
    case 'stdio':
-      await launchStdioServer(options);
+      await launchStdioServer();
      break;
    case 'http':
      await launchStreamableHTTPServer(options, options.port ?? options.socket);


packages/mcp-server/src/code-tool.ts

+        code,
        client_opts: {
          appId: readEnv('TERMINAL_APP_ID'),
          environment: (readEnv('TERMINAL_ENVIRONMENT') || undefined) as any,
        },
-        code,
-      }),
+      } satisfies WorkerInput),
    });


packages/mcp-server/src/code-tool.ts

@@ -59,7 +78,17 @@ export async function codeTool() {
      );


stainless-app · 2026-03-31T14:02:15Z