@composio/client 2.0.0-rc.19 → 2.0.0-rc.20

package/README.md

@@ -6,7 +6,7 @@ This repo is the successor to the Stainless-generated [`@composio/client`](https
 
 ## Usage
 
-The package root is the Promise client: `new Composio({ auth })`, the Stainless type names, and throwing `APIPromise` semantics (shipped via UXE-163/UXE-164).
+The package root is the Promise client: `new Composio({ auth })`, the params and response type names, and throwing `APIPromise` semantics (shipped via UXE-163/UXE-164).
 
 ```ts
 import Composio, { Auth } from '@composio/client'
@@ -157,7 +157,7 @@ input. All 113 operations of the spec are there.
 pnpm add @composio/client effect
 ```
 
-`effect` is an optional peer dependency. The root entry and the `./pagination` and `./resources`
+`effect` is an optional peer dependency. The root entry and the `./pagination` and `./resources/*`
 subpaths never import it and load without it.
 
 - **Supported range: `effect >=4.0.3 <4.1.0`.** The manifest declares the peer as `*`, because a
@@ -216,8 +216,7 @@ when `decode: true` is given without `schemas`. A credential provider that fails
 something a header cannot carry, fails the call with a `ConfigurationError` before anything is sent.
 
 The resources are plain objects of functions, not classes, so a method can be passed around without
-binding. One thing on the root client has no counterpart here: the resources that hold no operation
-(`migration`, `project.config`).
+binding. The root client's resources are the same since rc.20.
 
 ### Errors
 
@@ -543,6 +542,20 @@ The opt-in records the resolved scheme, hostname, and port. Mutating `baseURL` c
 and `withOptions({ baseURL: ... })` requires `allowInsecureHTTP: true` again when the origin
 changes. Redirects to another origin remain credential-free.
 
+### Removed in 2.0.0-rc.20
+
+The Stainless structure goes. The two removal classes are declared rule entries in
+`packages/codegen/assignability-ledger.json`; the export spellings are held by `pnpm test:pack`.
+
+| Removed | Migration |
+| --- | --- |
+| Resource classes (`ToolRouter`, `Tools`, `ConnectedAccounts`, ... as values) and `Composio.Tools`-style statics | A resource is a plain object typed by an interface of the same name. `import type { Tools } from '@composio/client/resources/tools'` still works as a type; `Composio['tools']` is the same type. `instanceof` a resource class has no replacement |
+| Namespace-merged nested types (`SessionToolkitsResponse.Item`, `LinkCreateParams.Experimental`) | Indexed access: `SessionToolkitsResponse['items'][number]`, `NonNullable<LinkCreateParams['experimental']>` |
+| The `Composio` namespace (`Composio.RequestOptions`, `Composio.ToolListResponse`, ...) | Import the type: `import type { RequestOptions } from '@composio/client'`, `import type { ToolListResponse } from '@composio/client/resources/tools'` |
+| `@composio/client/resources`, `/resources.js`, `/resources.mjs`, `/resources/index` | The resource's own subpath: `@composio/client/resources/mcp` |
+| `.js` and `.mjs` deep subpaths (`/resources/tool-router/session/session.mjs`), `/pagination.js`, `/pagination.mjs` | The extensionless spelling: `/resources/tool-router/session/session`, `/pagination` |
+| `client.migration`, `client.project.config` | None: neither held an operation |
+
 ### Removed in 2.0.0-rc.19
 
 The two option removals are declared entries in `packages/codegen/assignability-ledger.json`. The
@@ -550,7 +563,7 @@ other rows are class members the type check does not pin, listed so an upgrade c
 
 | Removed | Migration |
 | --- | --- |
-| `environment: 'production' \| 'staging' \| 'local'` (root `ClientOptions`) | `baseURL: 'https://staging-backend.composio.dev'` or `'http://localhost:9900'`; omitting it means production |
+| `environment: 'production' \| 'staging' \| 'local'` (root `ClientOptions`) | `baseURL: ENVIRONMENTS.staging` or `ENVIRONMENTS.local` — the frozen origin table, exported since rc.20; omitting it means production |
 | `Logger` (exported interface) | `logger` takes a `Console`-shaped object (`Pick<Console, 'debug' \| 'info' \| 'warn' \| 'error'>`) and defaults to `console`. An adapter that forwards to another logger is the same four methods |
 | `client.apiKey`, `userApiKey`, `orgApiKey` (read-only since rc.18) | Keep your own copy of the key; `client.authMode` says which mode is configured |
 | `client.logger` | None: the sink is the client's own. Pass a different one to `withOptions({ logger })` |
@@ -621,7 +634,7 @@ pnpm test           # unit tests (MSW mocks) + codegen tests
 pnpm build          # tsdown → dist/ (runs publint + arethetypeswrong)
 pnpm test:pack      # pack the real tarball, typecheck + import every drop-in subpath
 pnpm benchmark:baseline # capture the dist/ a benchmark run compares against
-pnpm benchmark      # score SDK overhead against that baseline and against Stainless
+pnpm benchmark      # score SDK overhead against that baseline
 pnpm benchmark:import # time what importing each entry costs, on Node and Bun
 pnpm test:contract  # live API tests; requires COMPOSIO_API_KEY (copy .env.example to .env)
 pnpm refresh-spec   # re-fetch spec/openapi.json from the live backend