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

package/dist/{request-zLX87M09.mjs → generated-operations-WtSYnmW0.mjs}

@@ -115,6 +115,7 @@ const mergeHeaders = (sources) => {
 	const values = new Headers();
 	const nulls = /* @__PURE__ */ new Set();
 	for (const source of sources) {
+		if (!source) continue;
 		const seen = /* @__PURE__ */ new Set();
 		for (const [name, value] of iterateHeaders(source)) {
 			const lowerName = name.toLowerCase();
@@ -417,6 +418,7 @@ const FOREIGN_CREDENTIAL_HEADERS = ["x-user-api-key", "x-org-api-key"];
 * may carry `null` to delete what an earlier one set (`buildHeaders`).
 */
 const callerPlacedCredential = (sources) => {
+	if (!sources.some(Boolean)) return false;
 	const headers = buildHeaders(sources);
 	return FOREIGN_CREDENTIAL_HEADERS.some((name) => headers.has(name));
 };
@@ -803,17 +805,20 @@ const isTemplateParam = (segment) => segment.startsWith("{") && segment.endsWith
 * (`/toolkits/{slug}` against `/toolkits/categories`) the literal wins, which
 * is the same most-specific-first rule the server routes by.
 *
-* **Known limit of recovering identity from the path.** Two accessors can emit
-* byte-identical requests — `client.toolkits.retrieve('categories')` and
+* **Known limit of recovering identity from the path**, and who still pays
+* it. Two accessors can emit byte-identical requests —
+* `client.toolkits.retrieve('categories')` and
 * `client.toolkits.retrieveCategories()` both dispatch
 * `GET /api/v3.1/toolkits/categories` — so nothing observable distinguishes
-* them here and the literal sibling is always the one named. The warning text
-* can therefore name the sibling rather than the accessor the caller wrote,
-* and the warn-once record is charged to that same sibling. This is
-* inherent to reverse-matching, not a bug in the matcher: the only fix is to
-* thread operation identity through dispatch, which this design deliberately
-* declined (wayfinder ticket 34). The affected pairs are few and the
-* consequence is a misnamed advisory, never a wrong call.
+* them here and the literal sibling is always the one named. That is inherent
+* to reverse-matching, not a bug in the matcher.
+*
+* Generated calls no longer reach this function at all: each one carries its
+* own descriptor through dispatch (`withOperation` in `request.ts`), so
+* `toolkits.retrieve('categories')` is now named as itself. What is left here
+* is the escape hatch — `client.get('/api/v3.1/toolkits/categories')` — whose
+* identity genuinely is not knowable before runtime, and for which naming the
+* literal sibling remains the honest answer.
 */
 const matchOperation = (method, path, operations) => {
 	const segments = pathSegments(path);
@@ -896,10 +901,10 @@ const noticeKey = (notice) => [
 * same `Response` to `asResponse()`, `withResponse()` and the parsed path
 * alike.
 */
-const inspectDeprecation = ({ response, method, path, baseURL, operations, seen, warn }) => {
+const inspectDeprecation = ({ response, method, path, operation: known, baseURL, operations, seen, warn }) => {
 	const notice = parseDeprecation(response.headers, response.url || baseURL, baseURL);
 	if (notice === null) return;
-	const operation = matchOperation(method, path, operations);
+	const operation = known ?? matchOperation(method, path, operations);
 	const key = `${operation === null ? `${method} ${pathSegments(path).join("/")}` : operation.chain.join(".")}${KEY_SEPARATOR}${noticeKey(notice)}`;
 	if (seen.has(key)) return;
 	if (seen.size >= MAX_TRACKED_NOTICES) return;
@@ -962,6 +967,46 @@ const inspectDeprecatedInputs = ({ operation, query, body, headers, table, seen,
 
 //#endregion
 //#region src/compat/request.ts
+/**
+* Where a generated call records *which operation it is*.
+*
+* A resource method knows its own identity at code-generation time, and until
+* now threw it away: dispatch carried only a method and a substituted path, so
+* the kernel recovered the operation by matching that path back against all
+* 104 templates on every single request (`matchOperation`). Recovery is still
+* the right answer for an escape-hatch `client.get('/api/v3.1/…')`, whose
+* identity genuinely is not knowable until runtime — but for a generated call
+* it re-derives a fact the call site already had.
+*
+* The channel is a module-private symbol rather than a `RequestOptions`
+* property, because `RequestOptions` is the Stainless options bag and its
+* shape is the product (`test/types/*.test-d.ts` pins it structurally). A
+* symbol key is invisible to that pinning, to `Object.keys`, to
+* `JSON.stringify`, and to every serializer in this file — the descriptor
+* reaches the kernel without becoming part of any public type or any byte on
+* the wire.
+*
+* It is deliberately *enumerable*: `client.get()` re-spreads the options bag
+* into `request()`, and object spread copies enumerable own symbols. A
+* non-enumerable definition would silently drop the descriptor there and
+* degrade every generated call back to matching, which is exactly the kind of
+* regression that measures fine and reports nothing.
+*/
+const OPERATION = Symbol("composio.operation");
+/**
+* Attach a generated call's operation to the options bag it dispatches with.
+*
+* Called with the freshly built literal — never with the caller's own object —
+* and *after* the caller's options have been spread into it, so a caller
+* cannot pre-empt the descriptor: the write happens last, and the key it
+* writes to is not one a caller can name.
+*/
+const withOperation = (operation, options) => {
+	options[OPERATION] = operation;
+	return options;
+};
+/** The operation a generated call recorded, or `undefined` for a raw one. */
+const readOperation = (options) => options[OPERATION];
 /** A request label safe to print: dynamic path values and URL secrets are excluded. */
 const printableURL = (url, operation) => `${new URL(url).origin}${operation?.path ?? "/<custom>"}`;
 const emitLog = (config, level, message, metadata) => {
@@ -1208,6 +1253,14 @@ const kernelInternals = { sleep };
 */
 const buildRequestHeaders = (config, options, requestURL, bodyHeaders, withdrawn, scheme, callerPlaced) => {
 	const credential = withdrawn || callerPlaced ? null : credentialForRequest(config.baseURL, scheme, config.credentials, requestURL);
+	if (!withdrawn && bodyHeaders === void 0 && !config.defaultHeaders && !options.headers) {
+		const direct = new Headers({
+			accept: "application/json",
+			"user-agent": config.userAgent
+		});
+		if (credential !== null) direct.set(credential.name, credential.value);
+		return direct;
+	}
 	const headers = buildHeaders([
 		{
 			accept: "application/json",
@@ -1271,7 +1324,7 @@ const dispatchWithRedirects = async (config, options, initialURL, initialBody, i
 	for (let hop = 0;; hop++) {
 		const headers = buildRequestHeaders(config, options, url, bodyHeaders, withdrawn, scheme, callerPlaced);
 		const delegated = hop === 0 && !carriesCredentials(headers);
-		const response = await config.fetch.call(void 0, url, {
+		const init = {
 			method,
 			headers,
 			...body !== void 0 ? { body } : {},
@@ -1279,7 +1332,8 @@ const dispatchWithRedirects = async (config, options, initialURL, initialBody, i
 			...options.fetchOptions,
 			redirect: delegated ? "follow" : "manual",
 			signal
-		});
+		};
+		const response = config.transport === void 0 ? await config.fetch.call(void 0, url, init) : await config.transport.send(new Request(url, init));
 		if (delegated) return response;
 		if (isOpaqueRedirect(response)) throw new APIConnectionError({ message: OPAQUE_REDIRECT });
 		if (!REDIRECT_STATUSES.has(response.status)) return response;
@@ -1322,14 +1376,15 @@ async function makeRequest(config, options) {
 	const { body, bodyHeaders } = buildBody(options);
 	const userSignal = options.signal ?? void 0;
 	const method = options.method.toUpperCase();
-	const operation = matchOperation(options.method, options.path, config.operations ?? []);
+	const threaded = readOperation(options);
+	const operation = threaded ?? matchOperation(options.method, options.path, config.operations ?? []);
 	const requestLog = config.onLog === void 0 ? void 0 : {
 		method,
 		url: printableURL(url, operation),
 		maxAttempts: maxRetries + 1
 	};
 	const scheme = schemeForRequest(config, operation);
-	config.onRequest?.(operation, query, options.body, buildHeaders([config.defaultHeaders, options.headers]));
+	if (config.onRequest !== void 0 && (threaded === void 0 || threaded.hasDeprecatedInputs === true)) config.onRequest(operation, query, options.body, buildHeaders([config.defaultHeaders, options.headers]));
 	for (let numRetries = 0;; numRetries++) {
 		if (userSignal?.aborted) throw new APIUserAbortError();
 		const attempt = numRetries + 1;
@@ -1420,4 +1475,776 @@ async function makeRequest(config, options) {
 }
 
 //#endregion
-export { InternalServerError as _, inspectDeprecatedInputs as a, RateLimitError as b, mergeHeaders as c, APIError as d, APIUserAbortError as f, ConflictError as g, ComposioError as h, safeJSON as i, APIConnectionError as l, BadRequestError as m, makeRequest as n, inspectDeprecation as o, AuthenticationError as p, path as r, assertCredentialTransport as s, castToError as t, APIConnectionTimeoutError as u, NotFoundError as v, UnprocessableEntityError as x, PermissionDeniedError as y };
+//#region src/compat/generated-operations.ts
+const GENERATED_OPERATIONS = [
+	{
+		method: "delete",
+		path: "/api/v3.1/auth_configs/{nanoid}",
+		chain: ["authConfigs", "delete"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "delete",
+		path: "/api/v3.1/connected_accounts/{nanoid}",
+		chain: ["connectedAccounts", "delete"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "delete",
+		path: "/api/v3.1/mcp/servers/{serverId}/instances/{instanceId}",
+		chain: ["mcp", "deleteInstance"]
+	},
+	{
+		method: "delete",
+		path: "/api/v3.1/mcp/{id}",
+		chain: ["mcp", "delete"]
+	},
+	{
+		method: "delete",
+		path: "/api/v3.1/org/owner/project/{nano_id}",
+		chain: [
+			"org",
+			"owner",
+			"project",
+			"delete"
+		],
+		schemes: ["OrgApiKeyAuth"]
+	},
+	{
+		method: "delete",
+		path: "/api/v3.1/tool_router/session/{session_id}",
+		chain: [
+			"toolRouter",
+			"session",
+			"delete"
+		]
+	},
+	{
+		method: "delete",
+		path: "/api/v3.1/trigger_instances/manage/{triggerId}",
+		chain: [
+			"triggerInstances",
+			"manage",
+			"delete"
+		],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "delete",
+		path: "/api/v3.1/webhook_subscriptions/{id}",
+		chain: ["webhookSubscriptions", "delete"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/auth/session/info",
+		chain: [
+			"auth",
+			"session",
+			"retrieveInfo"
+		],
+		schemes: ["UserApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/auth_configs",
+		chain: ["authConfigs", "list"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"],
+		hasDeprecatedInputs: true
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/auth_configs/{nanoid}",
+		chain: ["authConfigs", "retrieve"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/cli/get-session",
+		chain: ["cli", "getSession"],
+		schemes: ["no_auth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/cli/realtime/credentials",
+		chain: [
+			"cli",
+			"realtime",
+			"credentials"
+		],
+		schemes: ["UserApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/connected_accounts",
+		chain: ["connectedAccounts", "list"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/connected_accounts/{nanoid}",
+		chain: ["connectedAccounts", "retrieve"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/files/list",
+		chain: ["files", "list"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/internal/action_execution/fields",
+		chain: [
+			"logs",
+			"tools",
+			"listFields"
+		]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/internal/action_execution/log/{id}",
+		chain: [
+			"logs",
+			"tools",
+			"retrieve"
+		]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/internal/trigger/log/{id}",
+		chain: [
+			"logs",
+			"triggers",
+			"retrieve"
+		]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/logs/tool_execution/{id}",
+		chain: ["logs", "retrieveToolExecution"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/mcp/app/{appKey}",
+		chain: ["mcp", "retrieveApp"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/mcp/servers",
+		chain: ["mcp", "list"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/mcp/servers/{serverId}/instances",
+		chain: ["mcp", "listInstances"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/mcp/{id}",
+		chain: ["mcp", "retrieve"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/org/consumer/connected_toolkits",
+		chain: [
+			"org",
+			"consumer",
+			"listConnectedToolkits"
+		],
+		schemes: ["UserApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/org/list",
+		chain: ["org", "list"],
+		schemes: ["UserApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/org/owner/project/list",
+		chain: [
+			"org",
+			"owner",
+			"project",
+			"list"
+		],
+		schemes: ["OrgApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/org/owner/project/{nano_id}",
+		chain: [
+			"org",
+			"owner",
+			"project",
+			"retrieve"
+		],
+		schemes: ["OrgApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/org/project/list",
+		chain: [
+			"org",
+			"project",
+			"list"
+		],
+		schemes: ["UserApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/tool_router/session/{session_id}",
+		chain: [
+			"toolRouter",
+			"session",
+			"retrieve"
+		]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/tool_router/session/{session_id}/config_history",
+		chain: [
+			"toolRouter",
+			"session",
+			"configHistory"
+		]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/items",
+		chain: [
+			"toolRouter",
+			"session",
+			"files",
+			"list"
+		]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/tool_router/session/{session_id}/toolkits",
+		chain: [
+			"toolRouter",
+			"session",
+			"toolkits"
+		]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/tool_router/session/{session_id}/tools",
+		chain: [
+			"toolRouter",
+			"session",
+			"tools"
+		]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/toolkits",
+		chain: ["toolkits", "list"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/toolkits/categories",
+		chain: ["toolkits", "retrieveCategories"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/toolkits/changelog",
+		chain: ["toolkits", "retrieveChangelog"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/toolkits/{slug}",
+		chain: ["toolkits", "retrieve"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/tools",
+		chain: ["tools", "list"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"],
+		hasDeprecatedInputs: true
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/tools/enum",
+		chain: ["tools", "retrieveEnum"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/tools/{tool_slug}",
+		chain: ["tools", "retrieve"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/trigger_instances/active",
+		chain: ["triggerInstances", "listActive"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"],
+		hasDeprecatedInputs: true
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/triggers_types",
+		chain: ["triggersTypes", "list"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/triggers_types/list/enum",
+		chain: ["triggersTypes", "retrieveEnum"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/triggers_types/{slug}",
+		chain: ["triggersTypes", "retrieve"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/webhook_endpoints",
+		chain: ["webhookEndpoints", "list"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/webhook_endpoints/{nano_id}",
+		chain: ["webhookEndpoints", "retrieve"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/webhook_subscriptions",
+		chain: ["webhookSubscriptions", "list"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/webhook_subscriptions/event_types",
+		chain: ["webhookSubscriptions", "listEventTypes"]
+	},
+	{
+		method: "get",
+		path: "/api/v3.1/webhook_subscriptions/{id}",
+		chain: ["webhookSubscriptions", "retrieve"]
+	},
+	{
+		method: "patch",
+		path: "/api/v3.1/auth_configs/{nanoid}",
+		chain: ["authConfigs", "update"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"],
+		hasDeprecatedInputs: true
+	},
+	{
+		method: "patch",
+		path: "/api/v3.1/auth_configs/{nanoid}/{status}",
+		chain: ["authConfigs", "updateStatus"]
+	},
+	{
+		method: "patch",
+		path: "/api/v3.1/connected_accounts/{nanoId}/status",
+		chain: ["connectedAccounts", "updateStatus"]
+	},
+	{
+		method: "patch",
+		path: "/api/v3.1/connected_accounts/{nanoid}",
+		chain: ["connectedAccounts", "patch"]
+	},
+	{
+		method: "patch",
+		path: "/api/v3.1/mcp/{id}",
+		chain: ["mcp", "update"]
+	},
+	{
+		method: "patch",
+		path: "/api/v3.1/tool_router/session/{session_id}",
+		chain: [
+			"toolRouter",
+			"session",
+			"patch"
+		]
+	},
+	{
+		method: "patch",
+		path: "/api/v3.1/trigger_instances/manage/{triggerId}",
+		chain: [
+			"triggerInstances",
+			"manage",
+			"update"
+		],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "patch",
+		path: "/api/v3.1/webhook_endpoints/{nano_id}",
+		chain: ["webhookEndpoints", "update"]
+	},
+	{
+		method: "patch",
+		path: "/api/v3.1/webhook_subscriptions/{id}",
+		chain: ["webhookSubscriptions", "update"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/api_key_revocation",
+		chain: ["apiKeyRevocation", "create"],
+		schemes: ["no_auth"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/auth_configs",
+		chain: ["authConfigs", "create"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/cli/codact_failures",
+		chain: ["cli", "createCodactFailure"],
+		schemes: ["UserApiKeyAuth"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/cli/create-session",
+		chain: ["cli", "createSession"],
+		schemes: ["no_auth"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/cli/realtime/auth",
+		chain: [
+			"cli",
+			"realtime",
+			"auth"
+		],
+		schemes: ["UserApiKeyAuth"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/connected_accounts",
+		chain: ["connectedAccounts", "create"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/connected_accounts/link",
+		chain: ["link", "create"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/connected_accounts/{nanoid}/refresh",
+		chain: ["connectedAccounts", "refresh"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/connected_accounts/{nanoid}/revoke",
+		chain: ["connectedAccounts", "revoke"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/files/upload/request",
+		chain: ["files", "createPresignedURL"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/internal/action_execution/logs",
+		chain: [
+			"logs",
+			"tools",
+			"list"
+		]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/internal/trigger/logs",
+		chain: [
+			"logs",
+			"triggers",
+			"list"
+		]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/logs/tool_execution",
+		chain: ["logs", "createToolExecution"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/mcp/servers",
+		chain: ["mcp", "create"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/mcp/servers/custom",
+		chain: [
+			"mcp",
+			"custom",
+			"create"
+		]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/mcp/servers/generate",
+		chain: [
+			"mcp",
+			"generate",
+			"url"
+		]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/mcp/servers/{serverId}/instances",
+		chain: ["mcp", "createInstance"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/org/clanker/create_claim",
+		chain: [
+			"org",
+			"clanker",
+			"createClaim"
+		],
+		schemes: ["OrgApiKeyAuth"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/org/consumer/project/resolve",
+		chain: [
+			"org",
+			"consumer",
+			"project",
+			"resolve"
+		],
+		schemes: ["UserApiKeyAuth"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/org/owner/project/new",
+		chain: [
+			"org",
+			"owner",
+			"project",
+			"create"
+		],
+		schemes: ["OrgApiKeyAuth"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/org/owner/project/{nano_id}/regenerate_api_key",
+		chain: [
+			"org",
+			"owner",
+			"project",
+			"regenerateAPIKey"
+		],
+		schemes: ["OrgApiKeyAuth"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/org/usage/summary",
+		chain: [
+			"org",
+			"usage",
+			"retrieveSummary"
+		],
+		schemes: ["OrgApiKeyAuth"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/org/usage/{entity_type}",
+		chain: [
+			"org",
+			"usage",
+			"retrieve"
+		],
+		schemes: ["OrgApiKeyAuth"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/project/usage/summary",
+		chain: [
+			"project",
+			"usage",
+			"retrieveSummary"
+		]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/project/usage/{entity_type}",
+		chain: [
+			"project",
+			"usage",
+			"retrieve"
+		]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/tool_router/session",
+		chain: [
+			"toolRouter",
+			"session",
+			"create"
+		]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/tool_router/session/{session_id}/attach",
+		chain: [
+			"toolRouter",
+			"session",
+			"attach"
+		]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/tool_router/session/{session_id}/execute",
+		chain: [
+			"toolRouter",
+			"session",
+			"execute"
+		],
+		schemes: ["ApiKeyAuth", "workbench_access_key"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/tool_router/session/{session_id}/execute_meta",
+		chain: [
+			"toolRouter",
+			"session",
+			"executeMeta"
+		]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/tool_router/session/{session_id}/link",
+		chain: [
+			"toolRouter",
+			"session",
+			"link"
+		]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/delete",
+		chain: [
+			"toolRouter",
+			"session",
+			"files",
+			"delete"
+		]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/download_url",
+		chain: [
+			"toolRouter",
+			"session",
+			"files",
+			"createDownloadURL"
+		]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/upload_url",
+		chain: [
+			"toolRouter",
+			"session",
+			"files",
+			"createUploadURL"
+		]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/tool_router/session/{session_id}/proxy_execute",
+		chain: [
+			"toolRouter",
+			"session",
+			"proxyExecute"
+		],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/tool_router/session/{session_id}/search",
+		chain: [
+			"toolRouter",
+			"session",
+			"search"
+		]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/toolkits/multi",
+		chain: ["toolkits", "retrieveMulti"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/tools/execute/proxy",
+		chain: ["tools", "proxy"],
+		hasDeprecatedInputs: true
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/tools/execute/{tool_slug}",
+		chain: ["tools", "execute"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"],
+		hasDeprecatedInputs: true
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/tools/execute/{tool_slug}/input",
+		chain: ["tools", "getInput"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/tools/scopes/required",
+		chain: ["tools", "retrieveRequiredScopes"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/trigger_instances/{slug}/upsert",
+		chain: ["triggerInstances", "upsert"],
+		schemes: ["ApiKeyAuth", "UserApiKeyAuth"],
+		hasDeprecatedInputs: true
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/webhook_endpoints",
+		chain: ["webhookEndpoints", "create"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/webhook_endpoints/{nano_id}",
+		chain: ["webhookEndpoints", "replace"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/webhook_subscriptions",
+		chain: ["webhookSubscriptions", "create"]
+	},
+	{
+		method: "post",
+		path: "/api/v3.1/webhook_subscriptions/{id}/rotate_secret",
+		chain: ["webhookSubscriptions", "rotateSecret"]
+	}
+];
+/**
+* The same descriptors, indexed by public chain — what a generated resource
+* resolves its own operation from at module load, so the kernel reads
+* identity off the call instead of recovering it from the URL.
+*
+* Built from the array rather than emitted a second time, so the two indexes
+* hold the *same objects* and cannot drift apart.
+*/
+const GENERATED_OPERATIONS_BY_KEY = new Map(GENERATED_OPERATIONS.map((operation) => [operation.chain.join("."), operation]));
+/**
+* The descriptor a generated method dispatches with. A miss is a generator
+* defect, not a runtime condition, so it fails at import time rather than
+* silently degrading that method back to path matching.
+*/
+const generatedOperation = (chainKey) => {
+	const operation = GENERATED_OPERATIONS_BY_KEY.get(chainKey);
+	if (operation === void 0) throw new Error(`generated-operations: no operation for chain '${chainKey}'`);
+	return operation;
+};
+
+//#endregion
+export { PermissionDeniedError as C, NotFoundError as S, UnprocessableEntityError as T, AuthenticationError as _, path as a, ConflictError as b, withOperation as c, assertCredentialTransport as d, mergeHeaders as f, APIUserAbortError as g, APIError as h, makeRequest as i, inspectDeprecatedInputs as l, APIConnectionTimeoutError as m, generatedOperation as n, readOperation as o, APIConnectionError as p, castToError as r, safeJSON as s, GENERATED_OPERATIONS as t, inspectDeprecation as u, BadRequestError as v, RateLimitError as w, InternalServerError as x, ComposioError as y };