@composio/client 2.0.0-rc.2 → 2.0.0-rc.3

package/README.md

@@ -17,6 +17,32 @@ const session = await composio.toolRouter.session.create({ user_id: 'user_123' }
 console.log(session.session_id, session.mcp.url)
 ```
 
+Use `fromEnv` when configuration must come from a specific environment snapshot instead of the
+host process. Explicit options replace mapped values, so this is safe for tests, workers, and
+applications that load configuration themselves:
+
+```ts
+const composio = Composio.fromEnv(config, { environment: 'staging' })
+```
+
+`fromEnv` recognizes `COMPOSIO_API_KEY`, `COMPOSIO_USER_API_KEY`, `COMPOSIO_ORG_API_KEY`,
+`COMPOSIO_BASE_URL`, `COMPOSIO_CUSTOM_HEADERS`, and `COMPOSIO_LOG`. Derived clients created with
+`withOptions()` keep using the resolved snapshot and do not fall back to ambient values.
+
+Inject a `Transport` when an application or test needs to own HTTP dispatch. The transport receives
+a complete `Request`; retries, credential-safe redirects, timeouts, and response parsing stay in the
+client:
+
+```ts
+import Composio, { createFetchTransport } from '@composio/client'
+
+const transport = createFetchTransport({ fetch: instrumentedFetch })
+const composio = new Composio({ apiKey, transport })
+```
+
+Existing `fetch` and `fetchOptions` constructor options remain supported. They cannot be combined
+with `transport` because a request can have only one HTTP dispatcher.
+
 ## Development
 
 Toolchain is pinned via [mise](https://mise.jdx.dev) (`mise install`): Node 24, pnpm 11, Python 3.13, uv. ESM-only, TypeScript 7 (native compiler for typechecking, `typescript@6` retained for tooling until 7.1 restores the compiler API).
@@ -31,6 +57,8 @@ pnpm codegen:check  # verify committed src/compat/resources matches the generato
 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 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
 ```
@@ -49,3 +77,7 @@ uv run ruff check
 uv run mypy src scripts
 uv run pytest
 ```
+
+Client-overhead measurements use a deterministic in-memory transport and are documented in
+[`docs/benchmarks/client-overhead.md`](./docs/benchmarks/client-overhead.md). They do not measure API
+latency.

package/dist/{api-key-revocation-BqiqlJh6.mjs → api-key-revocation-Cbokr5zZ.mjs}

@@ -1,6 +1,7 @@
-import { r as path } from "./request-zLX87M09.mjs";
+import { c as withOperation, n as generatedOperation } from "./generated-operations-WtSYnmW0.mjs";
 
 //#region src/compat/resources/api-key-revocation.ts
+const OP_CREATE = generatedOperation("apiKeyRevocation.create");
 /**
 * Spec-surface `client.apiKeyRevocation` resource: the 1-method public
 * leaked-key revocation surface of the v3.1 spec
@@ -13,10 +14,10 @@ var ApiKeyRevocation = class {
 		this.#client = client;
 	}
 	create(body, options) {
-		return this.#client.post(path`/api/v3.1/api_key_revocation`, {
+		return this.#client.post("/api/v3.1/api_key_revocation", withOperation(OP_CREATE, {
 			body,
 			...options
-		});
+		}));
 	}
 };
 

package/dist/{auth-ClFXmN5T.mjs → auth-CNDyZgjw.mjs}

@@ -1,4 +1,4 @@
-import { t as Session } from "./session-Ci0MoTTn.mjs";
+import { t as Session } from "./session-EJK1YmKD.mjs";
 
 //#region src/compat/resources/auth/auth.ts
 /**

package/dist/{auth-configs-COkEdwlP.mjs → auth-configs-4u-8I2K7.mjs}

@@ -1,6 +1,12 @@
-import { r as path } from "./request-zLX87M09.mjs";
+import { a as path, c as withOperation, n as generatedOperation } from "./generated-operations-WtSYnmW0.mjs";
 
 //#region src/compat/resources/auth-configs.ts
+const OP_CREATE = generatedOperation("authConfigs.create");
+const OP_RETRIEVE = generatedOperation("authConfigs.retrieve");
+const OP_UPDATE = generatedOperation("authConfigs.update");
+const OP_LIST = generatedOperation("authConfigs.list");
+const OP_DELETE = generatedOperation("authConfigs.delete");
+const OP_UPDATE_STATUS = generatedOperation("authConfigs.updateStatus");
 /**
 * Stainless-shaped `client.authConfigs` resource: the exact 6-method surface of
 * `@composio/client` (create/retrieve/update/list/delete/updateStatus),
@@ -12,35 +18,35 @@ var AuthConfigs = class {
 		this.#client = client;
 	}
 	create(body, options) {
-		return this.#client.post(path`/api/v3.1/auth_configs`, {
+		return this.#client.post("/api/v3.1/auth_configs", withOperation(OP_CREATE, {
 			body,
 			...options
-		});
+		}));
 	}
 	retrieve(nanoid, options) {
-		return this.#client.get(path`/api/v3.1/auth_configs/${nanoid}`, { ...options });
+		return this.#client.get(path`/api/v3.1/auth_configs/${nanoid}`, withOperation(OP_RETRIEVE, { ...options }));
 	}
 	update(nanoid, body, options) {
-		return this.#client.patch(path`/api/v3.1/auth_configs/${nanoid}`, {
+		return this.#client.patch(path`/api/v3.1/auth_configs/${nanoid}`, withOperation(OP_UPDATE, {
 			body,
 			...options
-		});
+		}));
 	}
 	list(query = {}, options) {
-		return this.#client.get(path`/api/v3.1/auth_configs`, {
+		return this.#client.get("/api/v3.1/auth_configs", withOperation(OP_LIST, {
 			query,
 			...options
-		});
+		}));
 	}
 	delete(nanoid, query = {}, options) {
-		return this.#client.delete(path`/api/v3.1/auth_configs/${nanoid}`, {
+		return this.#client.delete(path`/api/v3.1/auth_configs/${nanoid}`, withOperation(OP_DELETE, {
 			query,
 			...options
-		});
+		}));
 	}
 	updateStatus(status, params, options) {
 		const { nanoid } = params;
-		return this.#client.patch(path`/api/v3.1/auth_configs/${nanoid}/${status}`, { ...options });
+		return this.#client.patch(path`/api/v3.1/auth_configs/${nanoid}/${status}`, withOperation(OP_UPDATE_STATUS, { ...options }));
 	}
 };
 

package/dist/{clanker-1ptspWLR.mjs → clanker-D6FjS8Lj.mjs}

@@ -1,6 +1,7 @@
-import { r as path } from "./request-zLX87M09.mjs";
+import { c as withOperation, n as generatedOperation } from "./generated-operations-WtSYnmW0.mjs";
 
 //#region src/compat/resources/org/clanker.ts
+const OP_CREATE_CLAIM = generatedOperation("org.clanker.createClaim");
 /**
 * Spec-surface `client.org.clanker` resource: the 1-method claim surface of
 * the v3.1 spec (`POST /org/clanker/create_claim`), never published by
@@ -12,10 +13,10 @@ var Clanker = class {
 		this.#client = client;
 	}
 	createClaim(body, options) {
-		return this.#client.post(path`/api/v3.1/org/clanker/create_claim`, {
+		return this.#client.post("/api/v3.1/org/clanker/create_claim", withOperation(OP_CREATE_CLAIM, {
 			body,
 			...options
-		});
+		}));
 	}
 };
 

package/dist/{cli-BWTXVRT4.mjs → cli-LIRIGe7k.mjs}

@@ -1,7 +1,10 @@
-import { c as mergeHeaders, r as path } from "./request-zLX87M09.mjs";
-import { t as Realtime } from "./realtime-DHJnO2Ye.mjs";
+import { c as withOperation, f as mergeHeaders, n as generatedOperation } from "./generated-operations-WtSYnmW0.mjs";
+import { t as Realtime } from "./realtime-C8DEUgai.mjs";
 
 //#region src/compat/resources/cli/cli.ts
+const OP_CREATE_CODACT_FAILURE = generatedOperation("cli.createCodactFailure");
+const OP_CREATE_SESSION = generatedOperation("cli.createSession");
+const OP_GET_SESSION = generatedOperation("cli.getSession");
 /**
 * Stainless-shaped `client.cli` resource: the 2-method published CLI
 * authentication surface of `@composio/client` (createSession/getSession)
@@ -17,23 +20,23 @@ var Cli = class {
 	}
 	createCodactFailure(params, options) {
 		const { "x-user-api-key": xUserApiKey, ...body } = params;
-		return this.#client.post(path`/api/v3.1/cli/codact_failures`, {
+		return this.#client.post("/api/v3.1/cli/codact_failures", withOperation(OP_CREATE_CODACT_FAILURE, {
 			body,
 			...options,
 			headers: mergeHeaders([{ ...xUserApiKey != null ? { "x-user-api-key": xUserApiKey } : void 0 }, options?.headers])
-		});
+		}));
 	}
 	createSession(body = {}, options) {
-		return this.#client.post(path`/api/v3.1/cli/create-session`, {
+		return this.#client.post("/api/v3.1/cli/create-session", withOperation(OP_CREATE_SESSION, {
 			body,
 			...options
-		});
+		}));
 	}
 	getSession(query, options) {
-		return this.#client.get(path`/api/v3.1/cli/get-session`, {
+		return this.#client.get("/api/v3.1/cli/get-session", withOperation(OP_GET_SESSION, {
 			query,
 			...options
-		});
+		}));
 	}
 };
 Cli.Realtime = Realtime;

package/dist/{client-D5v0_f-k.d.mts → client-ByIYmMzt.d.mts}

@@ -20891,6 +20891,21 @@ type GetApiV31ToolkitsChangelogResponses = {
   };
 };
 //#endregion
+//#region src/compat/transport.d.ts
+/** Sends one prepared HTTP request without retries or redirect handling. */
+interface Transport {
+  send(request: Request): Promise<Response>;
+}
+type KernelOwnedRequestInitKey = 'method' | 'headers' | 'body' | 'signal' | 'redirect';
+/** Fetch defaults that cannot replace fields owned by the request kernel. */
+type FetchTransportDefaults<Extra extends object = object> = Omit<RequestInit & Extra, KernelOwnedRequestInitKey>;
+type FetchImplementation<Extra extends object> = (input: RequestInfo | URL, init?: FetchTransportDefaults<Extra>) => Promise<Response>;
+/** Creates a transport backed by the supplied or global fetch function. */
+declare const createFetchTransport: <Extra extends object = object>(options?: {
+  fetch?: FetchImplementation<Extra> | undefined;
+  defaults?: FetchTransportDefaults<Extra> | undefined;
+}) => Transport;
+//#endregion
 //#region src/compat/request.d.ts
 /**
  * Per-request options bag — the Stainless last-positional-argument contract.
@@ -22643,6 +22658,8 @@ declare const environments: {
   local: string;
 };
 type Environment = keyof typeof environments;
+/** Environment values consumed by {@link Composio.fromEnv}. */
+type EnvironmentMap = Readonly<Record<string, string | undefined>>;
 type LogLevel = 'off' | 'error' | 'warn' | 'info' | 'debug';
 interface Logger {
   error: (...args: unknown[]) => void;
@@ -22696,6 +22713,8 @@ interface ClientOptions {
   fetchOptions?: RequestInit | undefined;
   /** Custom `fetch` implementation; defaults to the global `fetch`. */
   fetch?: typeof globalThis.fetch | undefined;
+  /** Sends fully prepared requests. Mutually exclusive with `fetch` and `fetchOptions`. */
+  transport?: Transport | undefined;
   /** Maximum retries for temporary failures. Defaults to 2. */
   maxRetries?: number | undefined;
   /** Headers sent on every request; per-request headers win, `null` deletes. */
@@ -22724,7 +22743,16 @@ declare class Composio {
   logger: Logger;
   logLevel: LogLevel | undefined;
   fetchOptions: RequestInit | undefined;
-  constructor({ baseURL, apiKey, userApiKey, orgApiKey, ...opts }?: ClientOptions);
+  constructor(input?: ClientOptions);
+  /**
+   * Constructs a client from a caller-supplied environment snapshot.
+   *
+   * Unlike the compatibility constructor, this method never reads ambient
+   * process or Deno state. Explicit options replace values from `environment`;
+   * in particular, an explicit named environment replaces
+   * `COMPOSIO_BASE_URL`, and `apiKey: null` disables a mapped API key.
+   */
+  static fromEnv<T extends typeof Composio>(this: T, environment: EnvironmentMap, options?: ClientOptions): InstanceType<T>;
   /** Returns a new client reusing the current options with `options` merged over them. */
   withOptions(options: Partial<ClientOptions>): this;
   get<Rsp>(path: string, opts?: RequestOptions & {
@@ -22787,4 +22815,4 @@ declare namespace Composio {
   export { ApiKeyRevocation, type ApiKeyRevocationCreateResponse, type ApiKeyRevocationCreateParams };
 }
 //#endregion
-export { WebhookSubscriptionDeleteResponse as $, ConnectedAccountRetrieveResponse as $n, FileListResponse$1 as $r, McpUpdateParams as $t, ProjectResolveResponse as A, AuthConfigUpdateResponse as An, SessionExecuteMetaResponse as Ar, CliCreateSessionParams as At, ProjectRetrieveResponse as B, Link as Bn, SessionSearchParams as Br, McpCreateInstanceResponse as Bt, ProjectListParams as C, AuthConfigCreateResponse as Cn, SessionAttachResponse as Cr, TriggerListParams as Ct, ConsumerListConnectedToolkitsResponse as D, AuthConfigListResponse as Dn, SessionCreateResponse as Dr, Cli as Dt, ConsumerListConnectedToolkitsParams as E, AuthConfigListParams as En, SessionCreateParams as Er, Triggers as Et, ProjectDeleteParams as F, ToolkitListResponse as Fn, SessionPatchParams as Fr, RealtimeAuthParams as Ft, WebhookEndpointReplaceParams as G, ConnectedAccountDeleteParams as Gn, SessionToolsResponse as Gr, McpDeleteResponse as Gt, WebhookEndpointCreateResponse as H, LinkCreateResponse as Hn, SessionToolkitsParams as Hr, McpCreateResponse as Ht, ProjectDeleteResponse as I, ToolkitRetrieveCategoriesResponse as In, SessionPatchResponse as Ir, RealtimeAuthResponse as It, WebhookEndpointUpdateParams as J, ConnectedAccountListResponse as Jn, FileCreateUploadURLParams as Jr, McpListParams as Jt, WebhookEndpointReplaceResponse as K, ConnectedAccountDeleteResponse as Kn, FileCreateDownloadURLParams as Kr, McpListInstancesParams as Kt, ProjectListParams$1 as L, ToolkitRetrieveParams as Ln, SessionProxyExecuteParams as Lr, RealtimeCredentialsResponse as Lt, Project$3 as M, AuthConfigUpdateStatusResponse as Mn, SessionExecuteResponse as Mr, CliGetSessionParams as Mt, ProjectCreateParams as N, AuthConfigs as Nn, SessionLinkParams as Nr, CliGetSessionResponse as Nt, Project$2 as O, AuthConfigRetrieveResponse as On, SessionDeleteResponse as Or, CliCreateCodactFailureParams as Ot, ProjectCreateResponse as P, ToolkitListParams as Pn, SessionLinkResponse as Pr, Realtime as Pt, WebhookSubscriptionCreateResponse as Q, ConnectedAccountRefreshResponse as Qn, FileListParams$1 as Qr, McpRetrieveResponse as Qt, ProjectListResponse$1 as R, ToolkitRetrieveResponse as Rn, SessionProxyExecuteResponse as Rr, Mcp as Rt, Project$1 as S, AuthConfigCreateParams as Sn, SessionAttachParams as Sr, Tools as St, Consumer as T, AuthConfigDeleteResponse as Tn, SessionConfigHistoryResponse as Tr, TriggerRetrieveResponse as Tt, WebhookEndpointListParams as U, ConnectedAccountCreateParams as Un, SessionToolkitsResponse as Ur, McpDeleteInstanceParams as Ut, WebhookEndpointCreateParams as V, LinkCreateParams as Vn, SessionSearchResponse as Vr, McpCreateParams as Vt, WebhookEndpointListResponse as W, ConnectedAccountCreateResponse as Wn, SessionToolsParams as Wr, McpDeleteInstanceResponse as Wt, WebhookEndpoints as X, ConnectedAccountPatchResponse as Xn, FileDeleteParams as Xr, McpRetrieveAppParams as Xt, WebhookEndpointUpdateResponse as Y, ConnectedAccountPatchParams as Yn, FileCreateUploadURLResponse as Yr, McpListResponse as Yt, WebhookSubscriptionCreateParams as Z, ConnectedAccountRefreshParams as Zn, FileDeleteResponse as Zr, McpRetrieveAppResponse as Zt, Usage as _, TriggersTypeListResponse as _n, ToolRetrieveParams as _r, Logs as _t, ApiKeyRevocation as a, APIUserAbortError as ai, CustomCreateParams as an, FileListParams as ar, WebhookSubscriptionUpdateParams as at, UsageRetrieveSummaryParams as b, TriggersTypeRetrieveResponse as bn, ToolRouter as br, ToolListResponse as bt, Auth as c, ComposioError as ci, TriggerInstanceListActiveResponse as cn, ToolExecuteParams as cr, Project$4 as ct, Org as d, NotFoundError as di, TriggerInstances as dn, ToolGetInputResponse as dr, UsageRetrieveResponse$1 as dt, Files$1 as ei, McpUpdateResponse as en, ConnectedAccountUpdateStatusParams as er, WebhookSubscriptionListEventTypesResponse as et, OrgListParams as f, PermissionDeniedError as fi, Manage as fn, ToolListParams$1 as fr, UsageRetrieveSummaryParams$1 as ft, ClankerCreateClaimResponse as g, TriggersTypeListParams as gn, ToolRetrieveEnumResponse as gr, LogRetrieveToolExecutionResponse as gt, ClankerCreateClaimParams as h, APIPromise as hi, ManageUpdateResponse as hn, ToolProxyResponse as hr, LogCreateToolExecutionResponse as ht, Logger as i, APIError as ii, Custom as in, FileCreatePresignedURLResponse as ir, WebhookSubscriptionRotateSecretResponse as it, Owner as j, AuthConfigUpdateStatusParams as jn, SessionExecuteParams as jr, CliCreateSessionResponse as jt, ProjectResolveParams as k, AuthConfigUpdateParams as kn, SessionExecuteMetaParams as kr, CliCreateCodactFailureResponse as kt, Session as l, ConflictError as li, TriggerInstanceUpsertParams as ln, ToolExecuteResponse as lr, Usage$1 as lt, Clanker as m, UnprocessableEntityError as mi, ManageUpdateParams as mn, ToolProxyParams as mr, LogCreateToolExecutionParams as mt, Composio as n, APIConnectionError as ni, GenerateURLParams as nn, ConnectedAccounts as nr, WebhookSubscriptionListResponse as nt, ApiKeyRevocationCreateParams as o, AuthenticationError as oi, CustomCreateResponse as on, FileListResponse as or, WebhookSubscriptionUpdateResponse as ot, OrgListResponse as p, RateLimitError as pi, ManageDeleteResponse as pn, ToolListResponse$1 as pr, UsageRetrieveSummaryResponse$1 as pt, WebhookEndpointRetrieveResponse as q, ConnectedAccountListParams as qn, FileCreateDownloadURLResponse as qr, McpListInstancesResponse as qt, LogLevel as r, APIConnectionTimeoutError as ri, GenerateURLResponse as rn, FileCreatePresignedURLParams as rr, WebhookSubscriptionRetrieveResponse as rt, ApiKeyRevocationCreateResponse as s, BadRequestError as si, TriggerInstanceListActiveParams as sn, Files as sr, WebhookSubscriptions as st, ClientOptions as t, RequestOptions as ti, Generate as tn, ConnectedAccountUpdateStatusResponse as tr, WebhookSubscriptionListParams as tt, SessionRetrieveInfoResponse as u, InternalServerError as ui, TriggerInstanceUpsertResponse as un, ToolGetInputParams as ur, UsageRetrieveParams$1 as ut, UsageRetrieveParams as v, TriggersTypeRetrieveEnumResponse as vn, ToolRetrieveResponse$1 as vr, ToolListFieldsResponse as vt, ProjectListResponse as w, AuthConfigDeleteParams as wn, SessionConfigHistoryParams as wr, TriggerListResponse as wt, UsageRetrieveSummaryResponse as x, TriggersTypes as xn, Session$1 as xr, ToolRetrieveResponse as xt, UsageRetrieveResponse as y, TriggersTypeRetrieveParams as yn, Tools$1 as yr, ToolListParams as yt, ProjectRegenerateAPIKeyResponse as z, Toolkits as zn, SessionRetrieveResponse as zr, McpCreateInstanceParams as zt };
+export { WebhookSubscriptionCreateResponse as $, ConnectedAccountRefreshResponse as $n, FileListParams$1 as $r, McpRetrieveResponse as $t, ProjectResolveParams as A, AuthConfigUpdateParams as An, SessionExecuteMetaParams as Ar, CliCreateCodactFailureResponse as At, ProjectRegenerateAPIKeyResponse as B, Toolkits as Bn, SessionRetrieveResponse as Br, McpCreateInstanceParams as Bt, Project$1 as C, AuthConfigCreateParams as Cn, SessionAttachParams as Cr, Tools as Ct, ConsumerListConnectedToolkitsParams as D, AuthConfigListParams as Dn, SessionCreateParams as Dr, Triggers as Dt, Consumer as E, AuthConfigDeleteResponse as En, SessionConfigHistoryResponse as Er, TriggerRetrieveResponse as Et, ProjectCreateResponse as F, ToolkitListParams as Fn, SessionLinkResponse as Fr, Realtime as Ft, WebhookEndpointListResponse as G, ConnectedAccountCreateResponse as Gn, SessionToolsParams as Gr, McpDeleteInstanceResponse as Gt, WebhookEndpointCreateParams as H, LinkCreateParams as Hn, SessionSearchResponse as Hr, McpCreateParams as Ht, ProjectDeleteParams as I, ToolkitListResponse as In, SessionPatchParams as Ir, RealtimeAuthParams as It, WebhookEndpointRetrieveResponse as J, ConnectedAccountListParams as Jn, FileCreateDownloadURLResponse as Jr, McpListInstancesResponse as Jt, WebhookEndpointReplaceParams as K, ConnectedAccountDeleteParams as Kn, SessionToolsResponse as Kr, McpDeleteResponse as Kt, ProjectDeleteResponse as L, ToolkitRetrieveCategoriesResponse as Ln, SessionPatchResponse as Lr, RealtimeAuthResponse as Lt, Owner as M, AuthConfigUpdateStatusParams as Mn, SessionExecuteParams as Mr, CliCreateSessionResponse as Mt, Project$3 as N, AuthConfigUpdateStatusResponse as Nn, SessionExecuteResponse as Nr, CliGetSessionParams as Nt, ConsumerListConnectedToolkitsResponse as O, AuthConfigListResponse as On, SessionCreateResponse as Or, Cli as Ot, ProjectCreateParams as P, AuthConfigs as Pn, SessionLinkParams as Pr, CliGetSessionResponse as Pt, WebhookSubscriptionCreateParams as Q, ConnectedAccountRefreshParams as Qn, FileDeleteResponse as Qr, McpRetrieveAppResponse as Qt, ProjectListParams$1 as R, ToolkitRetrieveParams as Rn, SessionProxyExecuteParams as Rr, RealtimeCredentialsResponse as Rt, UsageRetrieveSummaryResponse as S, TriggersTypes as Sn, Session$1 as Sr, ToolRetrieveResponse as St, ProjectListResponse as T, AuthConfigDeleteParams as Tn, SessionConfigHistoryParams as Tr, TriggerListResponse as Tt, WebhookEndpointCreateResponse as U, LinkCreateResponse as Un, SessionToolkitsParams as Ur, McpCreateResponse as Ut, ProjectRetrieveResponse as V, Link as Vn, SessionSearchParams as Vr, McpCreateInstanceResponse as Vt, WebhookEndpointListParams as W, ConnectedAccountCreateParams as Wn, SessionToolkitsResponse as Wr, McpDeleteInstanceParams as Wt, WebhookEndpointUpdateResponse as X, ConnectedAccountPatchParams as Xn, FileCreateUploadURLResponse as Xr, McpListResponse as Xt, WebhookEndpointUpdateParams as Y, ConnectedAccountListResponse as Yn, FileCreateUploadURLParams as Yr, McpListParams as Yt, WebhookEndpoints as Z, ConnectedAccountPatchResponse as Zn, FileDeleteParams as Zr, McpRetrieveAppParams as Zt, ClankerCreateClaimResponse as _, RateLimitError as _i, TriggersTypeListParams as _n, ToolRetrieveEnumResponse as _r, LogRetrieveToolExecutionResponse as _t, Logger as a, createFetchTransport as ai, Custom as an, FileCreatePresignedURLResponse as ar, WebhookSubscriptionRotateSecretResponse as at, UsageRetrieveResponse as b, TriggersTypeRetrieveParams as bn, Tools$1 as br, ToolListParams as bt, ApiKeyRevocationCreateResponse as c, APIError as ci, TriggerInstanceListActiveParams as cn, Files as cr, WebhookSubscriptions as ct, SessionRetrieveInfoResponse as d, BadRequestError as di, TriggerInstanceUpsertResponse as dn, ToolGetInputParams as dr, UsageRetrieveParams$1 as dt, FileListResponse$1 as ei, McpUpdateParams as en, ConnectedAccountRetrieveResponse as er, WebhookSubscriptionDeleteResponse as et, Org as f, ComposioError as fi, TriggerInstances as fn, ToolGetInputResponse as fr, UsageRetrieveResponse$1 as ft, ClankerCreateClaimParams as g, PermissionDeniedError as gi, ManageUpdateResponse as gn, ToolProxyResponse as gr, LogCreateToolExecutionResponse as gt, Clanker as h, NotFoundError as hi, ManageUpdateParams as hn, ToolProxyParams as hr, LogCreateToolExecutionParams as ht, LogLevel as i, Transport as ii, GenerateURLResponse as in, FileCreatePresignedURLParams as ir, WebhookSubscriptionRetrieveResponse as it, ProjectResolveResponse as j, AuthConfigUpdateResponse as jn, SessionExecuteMetaResponse as jr, CliCreateSessionParams as jt, Project$2 as k, AuthConfigRetrieveResponse as kn, SessionDeleteResponse as kr, CliCreateCodactFailureParams as kt, Auth as l, APIUserAbortError as li, TriggerInstanceListActiveResponse as ln, ToolExecuteParams as lr, Project$4 as lt, OrgListResponse as m, InternalServerError as mi, ManageDeleteResponse as mn, ToolListResponse$1 as mr, UsageRetrieveSummaryResponse$1 as mt, Composio as n, RequestOptions as ni, Generate as nn, ConnectedAccountUpdateStatusResponse as nr, WebhookSubscriptionListParams as nt, ApiKeyRevocation as o, APIConnectionError as oi, CustomCreateParams as on, FileListParams as or, WebhookSubscriptionUpdateParams as ot, OrgListParams as p, ConflictError as pi, Manage as pn, ToolListParams$1 as pr, UsageRetrieveSummaryParams$1 as pt, WebhookEndpointReplaceResponse as q, ConnectedAccountDeleteResponse as qn, FileCreateDownloadURLParams as qr, McpListInstancesParams as qt, EnvironmentMap as r, FetchTransportDefaults as ri, GenerateURLParams as rn, ConnectedAccounts as rr, WebhookSubscriptionListResponse as rt, ApiKeyRevocationCreateParams as s, APIConnectionTimeoutError as si, CustomCreateResponse as sn, FileListResponse as sr, WebhookSubscriptionUpdateResponse as st, ClientOptions as t, Files$1 as ti, McpUpdateResponse as tn, ConnectedAccountUpdateStatusParams as tr, WebhookSubscriptionListEventTypesResponse as tt, Session as u, AuthenticationError as ui, TriggerInstanceUpsertParams as un, ToolExecuteResponse as ur, Usage$1 as ut, Usage as v, UnprocessableEntityError as vi, TriggersTypeListResponse as vn, ToolRetrieveParams as vr, Logs as vt, ProjectListParams as w, AuthConfigCreateResponse as wn, SessionAttachResponse as wr, TriggerListParams as wt, UsageRetrieveSummaryParams as x, TriggersTypeRetrieveResponse as xn, ToolRouter as xr, ToolListResponse as xt, UsageRetrieveParams as y, APIPromise as yi, TriggersTypeRetrieveEnumResponse as yn, ToolRetrieveResponse$1 as yr, ToolListFieldsResponse as yt, ProjectListResponse$1 as z, ToolkitRetrieveResponse as zn, SessionProxyExecuteResponse as zr, Mcp as zt };

package/dist/{connected-accounts-DK24qYIM.mjs → connected-accounts-Bqtl42g0.mjs}

@@ -1,6 +1,14 @@
-import { r as path } from "./request-zLX87M09.mjs";
+import { a as path, c as withOperation, n as generatedOperation } from "./generated-operations-WtSYnmW0.mjs";
 
 //#region src/compat/resources/connected-accounts.ts
+const OP_CREATE = generatedOperation("connectedAccounts.create");
+const OP_RETRIEVE = generatedOperation("connectedAccounts.retrieve");
+const OP_LIST = generatedOperation("connectedAccounts.list");
+const OP_DELETE = generatedOperation("connectedAccounts.delete");
+const OP_PATCH = generatedOperation("connectedAccounts.patch");
+const OP_REFRESH = generatedOperation("connectedAccounts.refresh");
+const OP_REVOKE = generatedOperation("connectedAccounts.revoke");
+const OP_UPDATE_STATUS = generatedOperation("connectedAccounts.updateStatus");
 /**
 * Stainless-shaped `client.connectedAccounts` resource: the 7-method published
 * surface of `@composio/client` (create/retrieve/list/delete/patch/refresh/
@@ -14,52 +22,52 @@ var ConnectedAccounts = class {
 		this.#client = client;
 	}
 	create(body, options) {
-		return this.#client.post(path`/api/v3.1/connected_accounts`, {
+		return this.#client.post("/api/v3.1/connected_accounts", withOperation(OP_CREATE, {
 			body,
 			...options
-		});
+		}));
 	}
 	retrieve(nanoid, options) {
-		return this.#client.get(path`/api/v3.1/connected_accounts/${nanoid}`, { ...options });
+		return this.#client.get(path`/api/v3.1/connected_accounts/${nanoid}`, withOperation(OP_RETRIEVE, { ...options }));
 	}
 	list(query = {}, options) {
-		return this.#client.get(path`/api/v3.1/connected_accounts`, {
+		return this.#client.get("/api/v3.1/connected_accounts", withOperation(OP_LIST, {
 			query,
 			...options
-		});
+		}));
 	}
 	delete(nanoid, query = {}, options) {
-		return this.#client.delete(path`/api/v3.1/connected_accounts/${nanoid}`, {
+		return this.#client.delete(path`/api/v3.1/connected_accounts/${nanoid}`, withOperation(OP_DELETE, {
 			query,
 			...options
-		});
+		}));
 	}
 	patch(nanoid, body = {}, options) {
-		return this.#client.patch(path`/api/v3.1/connected_accounts/${nanoid}`, {
+		return this.#client.patch(path`/api/v3.1/connected_accounts/${nanoid}`, withOperation(OP_PATCH, {
 			body,
 			...options
-		});
+		}));
 	}
 	/** @deprecated Deprecated in the input OpenAPI schema. */
 	refresh(nanoid, params = {}, options) {
 		const { query_redirect_url, body_redirect_url, ...body } = params ?? {};
-		return this.#client.post(path`/api/v3.1/connected_accounts/${nanoid}/refresh`, {
+		return this.#client.post(path`/api/v3.1/connected_accounts/${nanoid}/refresh`, withOperation(OP_REFRESH, {
 			query: { redirect_url: query_redirect_url },
 			body: {
 				...body,
 				redirect_url: body_redirect_url
 			},
 			...options
-		});
+		}));
 	}
 	revoke(nanoid, options) {
-		return this.#client.post(path`/api/v3.1/connected_accounts/${nanoid}/revoke`, { ...options });
+		return this.#client.post(path`/api/v3.1/connected_accounts/${nanoid}/revoke`, withOperation(OP_REVOKE, { ...options }));
 	}
 	updateStatus(nanoID, body, options) {
-		return this.#client.patch(path`/api/v3.1/connected_accounts/${nanoID}/status`, {
+		return this.#client.patch(path`/api/v3.1/connected_accounts/${nanoID}/status`, withOperation(OP_UPDATE_STATUS, {
 			body,
 			...options
-		});
+		}));
 	}
 };
 

package/dist/{consumer-Do3lg_vI.mjs → consumer-BauHsJXO.mjs}

@@ -1,7 +1,8 @@
-import { c as mergeHeaders, r as path } from "./request-zLX87M09.mjs";
-import { t as Project } from "./project-By-OBe-4.mjs";
+import { c as withOperation, f as mergeHeaders, n as generatedOperation } from "./generated-operations-WtSYnmW0.mjs";
+import { t as Project } from "./project-4Ol46ZwD.mjs";
 
 //#region src/compat/resources/org/consumer/consumer.ts
+const OP_LIST_CONNECTED_TOOLKITS = generatedOperation("org.consumer.listConnectedToolkits");
 /**
 * Spec-surface `client.org.consumer` resource: the 1-method consumer surface
 * of the v3.1 spec (listConnectedToolkits over
@@ -17,14 +18,14 @@ var Consumer = class {
 	}
 	listConnectedToolkits(params, options) {
 		const { "x-user-api-key": xUserApiKey, "x-org-id": xOrgId, ...query } = params;
-		return this.#client.get(path`/api/v3.1/org/consumer/connected_toolkits`, {
+		return this.#client.get("/api/v3.1/org/consumer/connected_toolkits", withOperation(OP_LIST_CONNECTED_TOOLKITS, {
 			query,
 			...options,
 			headers: mergeHeaders([{
 				...xUserApiKey != null ? { "x-user-api-key": xUserApiKey } : void 0,
 				...xOrgId != null ? { "x-org-id": xOrgId } : void 0
 			}, options?.headers])
-		});
+		}));
 	}
 };
 Consumer.Project = Project;

package/dist/{custom-CH7n4Dyd.mjs → custom-CGqEBUWj.mjs}

@@ -1,6 +1,7 @@
-import { r as path } from "./request-zLX87M09.mjs";
+import { c as withOperation, n as generatedOperation } from "./generated-operations-WtSYnmW0.mjs";
 
 //#region src/compat/resources/mcp/custom.ts
+const OP_CREATE = generatedOperation("mcp.custom.create");
 /**
 * Stainless-shaped `client.mcp.custom` resource: the 1-method custom MCP
 * server sub-surface of `@composio/client` (`POST /mcp/servers/custom`).
@@ -11,10 +12,10 @@ var Custom = class {
 		this.#client = client;
 	}
 	create(body, options) {
-		return this.#client.post(path`/api/v3.1/mcp/servers/custom`, {
+		return this.#client.post("/api/v3.1/mcp/servers/custom", withOperation(OP_CREATE, {
 			body,
 			...options
-		});
+		}));
 	}
 };
 

package/dist/{files-DoNtYu2Q.mjs → files-BYEsIET1.mjs}

@@ -1,6 +1,8 @@
-import { r as path } from "./request-zLX87M09.mjs";
+import { c as withOperation, n as generatedOperation } from "./generated-operations-WtSYnmW0.mjs";
 
 //#region src/compat/resources/files.ts
+const OP_LIST = generatedOperation("files.list");
+const OP_CREATE_PRESIGNED_URL = generatedOperation("files.createPresignedURL");
 /**
 * Stainless-shaped `client.files` resource: the 2-method project file surface
 * of `@composio/client` (list, createPresignedURL).
@@ -12,16 +14,16 @@ var Files = class {
 	}
 	/** @deprecated Deprecated in the input OpenAPI schema. */
 	list(query = {}, options) {
-		return this.#client.get(path`/api/v3.1/files/list`, {
+		return this.#client.get("/api/v3.1/files/list", withOperation(OP_LIST, {
 			query,
 			...options
-		});
+		}));
 	}
 	createPresignedURL(body, options) {
-		return this.#client.post(path`/api/v3.1/files/upload/request`, {
+		return this.#client.post("/api/v3.1/files/upload/request", withOperation(OP_CREATE_PRESIGNED_URL, {
 			body,
 			...options
-		});
+		}));
 	}
 };
 

package/dist/{files-lfGzAnJ_.mjs → files-DkH2-irQ.mjs}

@@ -1,6 +1,10 @@
-import { r as path } from "./request-zLX87M09.mjs";
+import { a as path, c as withOperation, n as generatedOperation } from "./generated-operations-WtSYnmW0.mjs";
 
 //#region src/compat/resources/tool-router/session/files.ts
+const OP_LIST = generatedOperation("toolRouter.session.files.list");
+const OP_DELETE = generatedOperation("toolRouter.session.files.delete");
+const OP_CREATE_DOWNLOAD_URL = generatedOperation("toolRouter.session.files.createDownloadURL");
+const OP_CREATE_UPLOAD_URL = generatedOperation("toolRouter.session.files.createUploadURL");
 /**
 * Stainless-shaped `client.toolRouter.session.files` resource — the 4-method
 * mounts/files sub-surface, `(mountID, params, options?)` with `session_id`
@@ -13,31 +17,31 @@ var Files = class {
 	}
 	list(mountID, params, options) {
 		const { session_id, ...query } = params;
-		return this.#client.get(path`/api/v3.1/tool_router/session/${session_id}/mounts/${mountID}/items`, {
+		return this.#client.get(path`/api/v3.1/tool_router/session/${session_id}/mounts/${mountID}/items`, withOperation(OP_LIST, {
 			query,
 			...options
-		});
+		}));
 	}
 	delete(mountID, params, options) {
 		const { session_id, ...body } = params;
-		return this.#client.post(path`/api/v3.1/tool_router/session/${session_id}/mounts/${mountID}/delete`, {
+		return this.#client.post(path`/api/v3.1/tool_router/session/${session_id}/mounts/${mountID}/delete`, withOperation(OP_DELETE, {
 			body,
 			...options
-		});
+		}));
 	}
 	createDownloadURL(mountID, params, options) {
 		const { session_id, ...body } = params;
-		return this.#client.post(path`/api/v3.1/tool_router/session/${session_id}/mounts/${mountID}/download_url`, {
+		return this.#client.post(path`/api/v3.1/tool_router/session/${session_id}/mounts/${mountID}/download_url`, withOperation(OP_CREATE_DOWNLOAD_URL, {
 			body,
 			...options
-		});
+		}));
 	}
 	createUploadURL(mountID, params, options) {
 		const { session_id, ...body } = params;
-		return this.#client.post(path`/api/v3.1/tool_router/session/${session_id}/mounts/${mountID}/upload_url`, {
+		return this.#client.post(path`/api/v3.1/tool_router/session/${session_id}/mounts/${mountID}/upload_url`, withOperation(OP_CREATE_UPLOAD_URL, {
 			body,
 			...options
-		});
+		}));
 	}
 };
 

package/dist/{generate-B7ClqhN0.mjs → generate-DTodgjHD.mjs}

@@ -1,6 +1,7 @@
-import { r as path } from "./request-zLX87M09.mjs";
+import { c as withOperation, n as generatedOperation } from "./generated-operations-WtSYnmW0.mjs";
 
 //#region src/compat/resources/mcp/generate.ts
+const OP_URL = generatedOperation("mcp.generate.url");
 /**
 * Stainless-shaped `client.mcp.generate` resource: the 1-method MCP URL
 * generation sub-surface of `@composio/client` (`POST /mcp/servers/generate`).
@@ -11,10 +12,10 @@ var Generate = class {
 		this.#client = client;
 	}
 	url(body, options) {
-		return this.#client.post(path`/api/v3.1/mcp/servers/generate`, {
+		return this.#client.post("/api/v3.1/mcp/servers/generate", withOperation(OP_URL, {
 			body,
 			...options
-		});
+		}));
 	}
 };