@composio/client 2.0.0-rc.12 → 2.0.0-rc.14

package/README.md

@@ -2,7 +2,7 @@
 
 Composio API client for TypeScript, generated from the [v3.1 OpenAPI spec](https://staging-backend.composio.dev/api/v3.1/openapi.json) with [hey-api](https://heyapi.dev).
 
-This repo is the successor to the Stainless-generated [`@composio/client`](https://www.npmjs.com/package/@composio/client) (Stainless is sunsetting). Current scope: the full `/api/v3.1` surface — all 113 released operations — in **both** languages: TypeScript at the package root, and Python in [`python/`](./python/README.md) (PyPI takeover pending). Migration is tracked on the wayfinder map [UXE-152](https://linear.app/composio/issue/UXE-152).
+This repo is the successor to the Stainless-generated [`@composio/client`](https://www.npmjs.com/package/@composio/client) (Stainless is sunsetting). Current scope: the full `/api/v3.1` surface — all 113 released operations — in **both** languages: TypeScript at the package root, and Python in [`python/`](./python/README.md) (PyPI takeover pending).
 
 ## Usage
 
@@ -404,12 +404,12 @@ milliseconds:
 
 | | Node, modules | Node, bundle | Bun, modules | Bun, bundle |
 | --- | ---: | ---: | ---: | ---: |
-| `./effect`, never decodes | 5.5 / 5.8 | 3.6 / 3.7 | 2.7 / 3.7 | 10.3 / 11.1 |
-| plus importing `schemaLoaders` | −0.2 / 0.4 | 8.6 / 9.3 | −0.1 / −0.6 | 4.7 / 4.7 |
+| `./effect`, never decodes | 4.2 / 4.5 | 4.7 / 4.8 | 3.6 / 2.8 | 11.2 / 11.7 |
+| plus importing `schemaLoaders` | 2.4 / 0.2 | 5.3 / 5.2 | 0.2 / −0.7 | 3.6 / 3.8 |
 
 The published-module lanes are noisy, which is how a difference comes out negative. Effect itself
-is the larger part: 114.8 / 116.4 ms as modules on Node and 21.1 / 22.3 ms bundled, against 9.1 /
-10.0 ms and 3.9 / 4.1 ms for the root client.
+is the larger part: 122.2 / 128.3 ms as modules on Node and 22.0 / 23.8 ms bundled, against 9.6 /
+10.5 ms and 4.0 / 4.4 ms for the root client.
 
 **Bundle size** of a single-file consumer: Effect's HTTP modules alone, then with a client that never
 decodes, then with the loader table and every schema it reaches.

package/dist/{api-key-revocation-DJF8KL2o.mjs → api-key-revocation-BtpYMp2A.mjs}

@@ -1,4 +1,4 @@
-import { b as withOperation, n as generatedOperation } from "./generated-operations-BguuMwpw.mjs";
+import { b as withOperation, n as generatedOperation } from "./generated-operations-D8jOXj9j.mjs";
 
 //#region src/compat/resources/api-key-revocation.ts
 const OP_CREATE = generatedOperation("apiKeyRevocation.create");
@@ -6,7 +6,7 @@ const OP_CREATE = generatedOperation("apiKeyRevocation.create");
 * Spec-surface `client.apiKeyRevocation` resource: the 1-method public
 * leaked-key revocation surface of the v3.1 spec
 * (`POST /api_key_revocation` — POST-on-collection stays `create`), never
-* published by Stainless — wayfinder ticket 32.
+* published by Stainless.
 */
 var ApiKeyRevocation = class {
 	#client;

package/dist/{auth-CHlaMfu-.mjs → auth-DOLhepVW.mjs}

@@ -1,9 +1,9 @@
-import { t as Session } from "./session-BISWW6RD.mjs";
+import { t as Session } from "./session-DkmLw9W7.mjs";
 
 //#region src/compat/resources/auth/auth.ts
 /**
 * Spec-surface `client.auth` resource: a method-less container for the
-* `session` sub-resource — wayfinder ticket 32.
+* `session` sub-resource.
 */
 var Auth = class {
 	session;

package/dist/{auth-configs-sKOQG2Yw.mjs → auth-configs-DwRyrT5R.mjs}

@@ -1,4 +1,4 @@
-import { b as withOperation, d as path, n as generatedOperation } from "./generated-operations-BguuMwpw.mjs";
+import { b as withOperation, d as path, n as generatedOperation } from "./generated-operations-D8jOXj9j.mjs";
 
 //#region src/compat/resources/auth-configs.ts
 const OP_CREATE = generatedOperation("authConfigs.create");

package/dist/{clanker-DyM265dK.mjs → clanker-CKQuvB-f.mjs}

@@ -1,11 +1,11 @@
-import { b as withOperation, n as generatedOperation } from "./generated-operations-BguuMwpw.mjs";
+import { b as withOperation, n as generatedOperation } from "./generated-operations-D8jOXj9j.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
-* Stainless — wayfinder ticket 31.
+* Stainless.
 */
 var Clanker = class {
 	#client;

package/dist/{cli-zrk9Qew1.mjs → cli-r2AP1DQC.mjs}

@@ -1,5 +1,5 @@
-import { M as mergeHeaders, b as withOperation, n as generatedOperation } from "./generated-operations-BguuMwpw.mjs";
-import { t as Realtime } from "./realtime-BY6LAuSf.mjs";
+import { M as mergeHeaders, b as withOperation, n as generatedOperation } from "./generated-operations-D8jOXj9j.mjs";
+import { t as Realtime } from "./realtime-w-jWkaTI.mjs";
 
 //#region src/compat/resources/cli/cli.ts
 const OP_CREATE_CODACT_FAILURE = generatedOperation("cli.createCodactFailure");
@@ -9,7 +9,7 @@ const OP_GET_SESSION = generatedOperation("cli.getSession");
 * Stainless-shaped `client.cli` resource: the 2-method published CLI
 * authentication surface of `@composio/client` (createSession/getSession)
 * plus the spec-surface `createCodactFailure` (`POST /cli/codact_failures`,
-* never published by Stainless — wayfinder ticket 29).
+* never published by Stainless).
 */
 var Cli = class {
 	realtime;

package/dist/{connected-accounts-a6ezLeaq.mjs → connected-accounts-DoC-z2wg.mjs}

@@ -1,4 +1,4 @@
-import { b as withOperation, d as path, n as generatedOperation } from "./generated-operations-BguuMwpw.mjs";
+import { b as withOperation, d as path, n as generatedOperation } from "./generated-operations-D8jOXj9j.mjs";
 
 //#region src/compat/resources/connected-accounts.ts
 const OP_CREATE = generatedOperation("connectedAccounts.create");
@@ -14,8 +14,8 @@ 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/
 * updateStatus) plus the spec-surface `revoke`
-* (`POST /connected_accounts/{nanoid}/revoke`, never published by Stainless —
-* wayfinder ticket 29), dispatched through the handwritten kernel.
+* (`POST /connected_accounts/{nanoid}/revoke`, never published by Stainless),
+* dispatched through the handwritten kernel.
 */
 var ConnectedAccounts = class {
 	#client;

package/dist/{consumer-B0qaosDp.mjs → consumer-qY1RmyT2.mjs}

@@ -1,5 +1,5 @@
-import { M as mergeHeaders, b as withOperation, n as generatedOperation } from "./generated-operations-BguuMwpw.mjs";
-import { t as Project } from "./project-B8d4M3Ut.mjs";
+import { M as mergeHeaders, b as withOperation, n as generatedOperation } from "./generated-operations-D8jOXj9j.mjs";
+import { t as Project } from "./project-VByEH_fg.mjs";
 
 //#region src/compat/resources/org/consumer/consumer.ts
 const OP_LIST_CONNECTED_TOOLKITS = generatedOperation("org.consumer.listConnectedToolkits");
@@ -7,7 +7,7 @@ const OP_LIST_CONNECTED_TOOLKITS = generatedOperation("org.consumer.listConnecte
 * Spec-surface `client.org.consumer` resource: the 1-method consumer surface
 * of the v3.1 spec (listConnectedToolkits over
 * `/org/consumer/connected_toolkits`) plus the `project` sub-resource, never
-* published by Stainless — wayfinder ticket 31.
+* published by Stainless.
 */
 var Consumer = class {
 	project;

package/dist/{custom-99mj4dPN.mjs → custom-0lCWqNaG.mjs}

@@ -1,4 +1,4 @@
-import { b as withOperation, n as generatedOperation } from "./generated-operations-BguuMwpw.mjs";
+import { b as withOperation, n as generatedOperation } from "./generated-operations-D8jOXj9j.mjs";
 
 //#region src/compat/resources/mcp/custom.ts
 const OP_CREATE = generatedOperation("mcp.custom.create");

package/dist/{custom-Ddfc8mtR.mjs → custom-Bnoa7Qsa.mjs}

@@ -1,4 +1,4 @@
-import { b as withOperation, d as path, n as generatedOperation } from "./generated-operations-BguuMwpw.mjs";
+import { b as withOperation, d as path, n as generatedOperation } from "./generated-operations-D8jOXj9j.mjs";
 
 //#region src/compat/legacy-options.ts
 /**

package/dist/effect/schemas/components/session-create-response-config.d.mts

@@ -25,6 +25,7 @@ declare const SessionCreateResponseConfig: Schema.StructWithRest<Schema.Struct<{
       readonly disabled: Schema.$Array<Schema.String>;
     }>]>>>;
     readonly return_instant_charge: Schema.Boolean;
+    readonly return_prices_in_search: Schema.Boolean;
   }>]>;
   readonly manage_connections: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
     readonly enabled: Schema.optionalKey<Schema.Boolean>;
@@ -40,18 +41,18 @@ declare const SessionCreateResponseConfig: Schema.StructWithRest<Schema.Struct<{
     readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.String>>;
   }>, Schema.Struct<{
     readonly tags: Schema.StructWithRest<Schema.Struct<{
-      readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-      readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-      readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+      readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+      readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+      readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
     }>, readonly [Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>]>;
     readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.String>>;
   }>, Schema.Struct<{
     readonly require_approval: Schema.$Array<Schema.String>;
   }>]>>>;
   readonly tags: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
-    readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-    readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-    readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+    readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+    readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+    readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
   }>, readonly [Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>]>>;
   readonly workbench: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
     readonly enable: Schema.optionalKey<Schema.Boolean>;

package/dist/effect/schemas/components/session-create-response-config.mjs

@@ -19,7 +19,8 @@ const SessionCreateResponseConfig = Schema.StructWithRest(Schema.Struct({
 	"instant": Schema.Union([Schema.Literal(false), Schema.Struct({
 		"toolkits": Schema.optionalKey(Schema.Union([Schema.Struct({ "enabled": Schema.Array(Schema.String) }), Schema.Struct({ "disabled": Schema.Array(Schema.String) })]).annotate({ "description": "Toolkits eligible for instant usage, as an enabled or disabled list. If absent, no additional toolkit restriction applies." })),
 		"tools": Schema.optionalKey(Schema.Record(Schema.String, Schema.Union([Schema.Struct({ "enabled": Schema.Array(Schema.String) }), Schema.Struct({ "disabled": Schema.Array(Schema.String) })])).annotate({ "description": "Per-toolkit enabled or disabled lists that restrict instant usage. Toolkits absent from this map have no additional tool restriction." })),
-		"return_instant_charge": Schema.Boolean.annotate({ "description": "Whether session tool responses return a top-level instant_charge when a charge is available. Defaults to false; controls response visibility only." })
+		"return_instant_charge": Schema.Boolean.annotate({ "description": "Whether session tool responses return a top-level instant_charge when a charge is available. Defaults to false; controls response visibility only." }),
+		"return_prices_in_search": Schema.Boolean.annotate({ "description": "Experimental. Whether tool search results show each instant tool's price, under instant_account.prices. Defaults to false." })
 	})]).annotate({ "description": "Instant usage settings. False disables instant usage; an object permits it subject to project permission and session toolkit and tool restrictions." }),
 	"manage_connections": Schema.optionalKey(Schema.StructWithRest(Schema.Struct({
 		"enabled": Schema.optionalKey(Schema.Boolean.annotate({
@@ -52,18 +53,24 @@ const SessionCreateResponseConfig = Schema.StructWithRest(Schema.Struct({
 			"tags": Schema.StructWithRest(Schema.Struct({
 				"enabled": Schema.optionalKey(Schema.Array(Schema.Literals([
 					"readOnlyHint",
+					"createHint",
+					"updateHint",
 					"destructiveHint",
 					"idempotentHint",
 					"openWorldHint"
 				])).annotate({ "description": "Tags that the tool must have at least one of" })),
 				"disabled": Schema.optionalKey(Schema.Array(Schema.Literals([
 					"readOnlyHint",
+					"createHint",
+					"updateHint",
 					"destructiveHint",
 					"idempotentHint",
 					"openWorldHint"
 				])).annotate({ "description": "Tags that the tool must NOT have any of" })),
 				"require_approval": Schema.optionalKey(Schema.Array(Schema.Literals([
 					"readOnlyHint",
+					"createHint",
+					"updateHint",
 					"destructiveHint",
 					"idempotentHint",
 					"openWorldHint"
@@ -76,18 +83,24 @@ const SessionCreateResponseConfig = Schema.StructWithRest(Schema.Struct({
 	"tags": Schema.optionalKey(Schema.StructWithRest(Schema.Struct({
 		"enabled": Schema.optionalKey(Schema.Array(Schema.Literals([
 			"readOnlyHint",
+			"createHint",
+			"updateHint",
 			"destructiveHint",
 			"idempotentHint",
 			"openWorldHint"
 		])).annotate({ "description": "Tags that the tool must have at least one of" })),
 		"disabled": Schema.optionalKey(Schema.Array(Schema.Literals([
 			"readOnlyHint",
+			"createHint",
+			"updateHint",
 			"destructiveHint",
 			"idempotentHint",
 			"openWorldHint"
 		])).annotate({ "description": "Tags that the tool must NOT have any of" })),
 		"require_approval": Schema.optionalKey(Schema.Array(Schema.Literals([
 			"readOnlyHint",
+			"createHint",
+			"updateHint",
 			"destructiveHint",
 			"idempotentHint",
 			"openWorldHint"

package/dist/effect/schemas/components/tool-router-session-v31-config-history-list-response.d.mts

@@ -29,6 +29,7 @@ declare const ToolRouterSessionV31ConfigHistoryListResponse: Schema.StructWithRe
           readonly disabled: Schema.$Array<Schema.String>;
         }>]>>>;
         readonly return_instant_charge: Schema.Boolean;
+        readonly return_prices_in_search: Schema.Boolean;
       }>]>;
       readonly manage_connections: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
         readonly enabled: Schema.optionalKey<Schema.Boolean>;
@@ -44,18 +45,18 @@ declare const ToolRouterSessionV31ConfigHistoryListResponse: Schema.StructWithRe
         readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.String>>;
       }>, Schema.Struct<{
         readonly tags: Schema.StructWithRest<Schema.Struct<{
-          readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-          readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-          readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+          readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+          readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+          readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
         }>, readonly [Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>]>;
         readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.String>>;
       }>, Schema.Struct<{
         readonly require_approval: Schema.$Array<Schema.String>;
       }>]>>>;
       readonly tags: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
-        readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-        readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-        readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
       }>, readonly [Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>]>>;
       readonly workbench: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
         readonly enable: Schema.optionalKey<Schema.Boolean>;

package/dist/effect/schemas/components/tool-router-session-v31-config-history-list-response.mjs

@@ -26,7 +26,8 @@ const ToolRouterSessionV31ConfigHistoryListResponse = Schema.StructWithRest(Sche
 			"instant": Schema.Union([Schema.Literal(false), Schema.Struct({
 				"toolkits": Schema.optionalKey(Schema.Union([Schema.Struct({ "enabled": Schema.Array(Schema.String) }), Schema.Struct({ "disabled": Schema.Array(Schema.String) })]).annotate({ "description": "Toolkits eligible for instant usage, as an enabled or disabled list. If absent, no additional toolkit restriction applies." })),
 				"tools": Schema.optionalKey(Schema.Record(Schema.String, Schema.Union([Schema.Struct({ "enabled": Schema.Array(Schema.String) }), Schema.Struct({ "disabled": Schema.Array(Schema.String) })])).annotate({ "description": "Per-toolkit enabled or disabled lists that restrict instant usage. Toolkits absent from this map have no additional tool restriction." })),
-				"return_instant_charge": Schema.Boolean.annotate({ "description": "Whether session tool responses return a top-level instant_charge when a charge is available. Defaults to false; controls response visibility only." })
+				"return_instant_charge": Schema.Boolean.annotate({ "description": "Whether session tool responses return a top-level instant_charge when a charge is available. Defaults to false; controls response visibility only." }),
+				"return_prices_in_search": Schema.Boolean.annotate({ "description": "Experimental. Whether tool search results show each instant tool's price, under instant_account.prices. Defaults to false." })
 			})]).annotate({ "description": "Instant usage settings. False disables instant usage; an object permits it subject to project permission and session toolkit and tool restrictions." }),
 			"manage_connections": Schema.optionalKey(Schema.StructWithRest(Schema.Struct({
 				"enabled": Schema.optionalKey(Schema.Boolean.annotate({
@@ -59,18 +60,24 @@ const ToolRouterSessionV31ConfigHistoryListResponse = Schema.StructWithRest(Sche
 					"tags": Schema.StructWithRest(Schema.Struct({
 						"enabled": Schema.optionalKey(Schema.Array(Schema.Literals([
 							"readOnlyHint",
+							"createHint",
+							"updateHint",
 							"destructiveHint",
 							"idempotentHint",
 							"openWorldHint"
 						])).annotate({ "description": "Tags that the tool must have at least one of" })),
 						"disabled": Schema.optionalKey(Schema.Array(Schema.Literals([
 							"readOnlyHint",
+							"createHint",
+							"updateHint",
 							"destructiveHint",
 							"idempotentHint",
 							"openWorldHint"
 						])).annotate({ "description": "Tags that the tool must NOT have any of" })),
 						"require_approval": Schema.optionalKey(Schema.Array(Schema.Literals([
 							"readOnlyHint",
+							"createHint",
+							"updateHint",
 							"destructiveHint",
 							"idempotentHint",
 							"openWorldHint"
@@ -83,18 +90,24 @@ const ToolRouterSessionV31ConfigHistoryListResponse = Schema.StructWithRest(Sche
 			"tags": Schema.optionalKey(Schema.StructWithRest(Schema.Struct({
 				"enabled": Schema.optionalKey(Schema.Array(Schema.Literals([
 					"readOnlyHint",
+					"createHint",
+					"updateHint",
 					"destructiveHint",
 					"idempotentHint",
 					"openWorldHint"
 				])).annotate({ "description": "Tags that the tool must have at least one of" })),
 				"disabled": Schema.optionalKey(Schema.Array(Schema.Literals([
 					"readOnlyHint",
+					"createHint",
+					"updateHint",
 					"destructiveHint",
 					"idempotentHint",
 					"openWorldHint"
 				])).annotate({ "description": "Tags that the tool must NOT have any of" })),
 				"require_approval": Schema.optionalKey(Schema.Array(Schema.Literals([
 					"readOnlyHint",
+					"createHint",
+					"updateHint",
 					"destructiveHint",
 					"idempotentHint",
 					"openWorldHint"

package/dist/effect/schemas/mcp/generate/url.mjs

@@ -5,15 +5,15 @@ import * as Schema from "effect/Schema";
 const GenerateURLResponse = Schema.StructWithRest(Schema.Struct({
 	"mcp_url": Schema.String.annotate({
 		"description": "Base MCP URL without any query parameters",
-		"examples": ["https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000"]
+		"examples": ["https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000"]
 	}),
 	"connected_account_urls": Schema.Array(Schema.String).annotate({
-		"description": "List of URLs generated for each connected account ID",
-		"examples": [["https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_id=ca_1a2b3c4d5e6f", "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_id=ca_7g8h9i0j1k2l"]]
+		"description": "List of URLs generated for each connected account ID. URLs may carry the include_composio_helper_actions query parameter. DEPRECATED: The include_composio_helper_actions query parameter will be removed in a future version. Switch to Composio Sessions (POST /api/v3/tool_router/session), whose MCP URL includes connection-management tools.",
+		"examples": [["https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_id=ca_1a2b3c4d5e6f", "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_id=ca_7g8h9i0j1k2l"]]
 	}),
 	"user_ids_url": Schema.Array(Schema.String).annotate({
-		"description": "List of URLs generated for each user ID",
-		"examples": [["https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&user_id=user_123456", "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&user_id=user_789012"]]
+		"description": "List of URLs generated for each user ID. URLs may carry the include_composio_helper_actions query parameter. DEPRECATED: The include_composio_helper_actions query parameter will be removed in a future version. Switch to Composio Sessions (POST /api/v3/tool_router/session), whose MCP URL includes connection-management tools.",
+		"examples": [["https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&user_id=user_123456", "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&user_id=user_789012"]]
 	})
 }), [Schema.Record(Schema.String, Schema.Json.annotate({ "expected": "JSON value" }))]).annotate({ "description": "Response containing the generated MCP URLs" });
 

package/dist/effect/schemas/session-configs/retrieve.d.mts

@@ -18,13 +18,13 @@ declare const SessionConfigsRetrieveResponse: Schema.StructWithRest<Schema.Struc
       readonly disable: Schema.$Array<Schema.String>;
     }>, Schema.Struct<{
       readonly tags: Schema.Struct<{
-        readonly enable: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-        readonly disable: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly enable: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly disable: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
       }>;
     }>]>>>;
     readonly tags: Schema.optionalKey<Schema.Struct<{
-      readonly enable: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-      readonly disable: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+      readonly enable: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+      readonly disable: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
     }>>;
   }>;
   readonly created_at: Schema.String;

package/dist/effect/schemas/session-configs/retrieve.mjs

@@ -18,12 +18,16 @@ const SessionConfigsRetrieveResponse = Schema.StructWithRest(Schema.Struct({
 			Schema.Struct({ "tags": Schema.Struct({
 				"enable": Schema.optionalKey(Schema.Array(Schema.Literals([
 					"readOnlyHint",
+					"createHint",
+					"updateHint",
 					"destructiveHint",
 					"idempotentHint",
 					"openWorldHint"
 				]))),
 				"disable": Schema.optionalKey(Schema.Array(Schema.Literals([
 					"readOnlyHint",
+					"createHint",
+					"updateHint",
 					"destructiveHint",
 					"idempotentHint",
 					"openWorldHint"
@@ -33,12 +37,16 @@ const SessionConfigsRetrieveResponse = Schema.StructWithRest(Schema.Struct({
 		"tags": Schema.optionalKey(Schema.Struct({
 			"enable": Schema.optionalKey(Schema.Array(Schema.Literals([
 				"readOnlyHint",
+				"createHint",
+				"updateHint",
 				"destructiveHint",
 				"idempotentHint",
 				"openWorldHint"
 			]))),
 			"disable": Schema.optionalKey(Schema.Array(Schema.Literals([
 				"readOnlyHint",
+				"createHint",
+				"updateHint",
 				"destructiveHint",
 				"idempotentHint",
 				"openWorldHint"

package/dist/effect/schemas/tool-router/session/attach.d.mts

@@ -32,6 +32,7 @@ declare const SessionAttachResponse: Schema.StructWithRest<Schema.Struct<{
         readonly disabled: Schema.$Array<Schema.String>;
       }>]>>>;
       readonly return_instant_charge: Schema.Boolean;
+      readonly return_prices_in_search: Schema.Boolean;
     }>]>;
     readonly manage_connections: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
       readonly enabled: Schema.optionalKey<Schema.Boolean>;
@@ -47,18 +48,18 @@ declare const SessionAttachResponse: Schema.StructWithRest<Schema.Struct<{
       readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.String>>;
     }>, Schema.Struct<{
       readonly tags: Schema.StructWithRest<Schema.Struct<{
-        readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-        readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-        readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
       }>, readonly [Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>]>;
       readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.String>>;
     }>, Schema.Struct<{
       readonly require_approval: Schema.$Array<Schema.String>;
     }>]>>>;
     readonly tags: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
-      readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-      readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-      readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+      readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+      readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+      readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
     }>, readonly [Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>]>>;
     readonly workbench: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
       readonly enable: Schema.optionalKey<Schema.Boolean>;

package/dist/effect/schemas/tool-router/session/config-history.d.mts

@@ -28,6 +28,7 @@ declare const SessionConfigHistoryResponse: import("effect/Schema").StructWithRe
           readonly disabled: import("effect/Schema").$Array<import("effect/Schema").String>;
         }>]>>>;
         readonly return_instant_charge: import("effect/Schema").Boolean;
+        readonly return_prices_in_search: import("effect/Schema").Boolean;
       }>]>;
       readonly manage_connections: import("effect/Schema").optionalKey<import("effect/Schema").StructWithRest<import("effect/Schema").Struct<{
         readonly enabled: import("effect/Schema").optionalKey<import("effect/Schema").Boolean>;
@@ -43,18 +44,18 @@ declare const SessionConfigHistoryResponse: import("effect/Schema").StructWithRe
         readonly require_approval: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").String>>;
       }>, import("effect/Schema").Struct<{
         readonly tags: import("effect/Schema").StructWithRest<import("effect/Schema").Struct<{
-          readonly enabled: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-          readonly disabled: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-          readonly require_approval: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+          readonly enabled: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+          readonly disabled: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+          readonly require_approval: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
         }>, readonly [import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Codec<import("effect/Schema").Json, import("effect/Schema").Json, never, never>>]>;
         readonly require_approval: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").String>>;
       }>, import("effect/Schema").Struct<{
         readonly require_approval: import("effect/Schema").$Array<import("effect/Schema").String>;
       }>]>>>;
       readonly tags: import("effect/Schema").optionalKey<import("effect/Schema").StructWithRest<import("effect/Schema").Struct<{
-        readonly enabled: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-        readonly disabled: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-        readonly require_approval: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly enabled: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly disabled: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly require_approval: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
       }>, readonly [import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Codec<import("effect/Schema").Json, import("effect/Schema").Json, never, never>>]>>;
       readonly workbench: import("effect/Schema").optionalKey<import("effect/Schema").StructWithRest<import("effect/Schema").Struct<{
         readonly enable: import("effect/Schema").optionalKey<import("effect/Schema").Boolean>;

package/dist/effect/schemas/tool-router/session/create.d.mts

@@ -32,6 +32,7 @@ declare const SessionCreateResponse: Schema.StructWithRest<Schema.Struct<{
         readonly disabled: Schema.$Array<Schema.String>;
       }>]>>>;
       readonly return_instant_charge: Schema.Boolean;
+      readonly return_prices_in_search: Schema.Boolean;
     }>]>;
     readonly manage_connections: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
       readonly enabled: Schema.optionalKey<Schema.Boolean>;
@@ -47,18 +48,18 @@ declare const SessionCreateResponse: Schema.StructWithRest<Schema.Struct<{
       readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.String>>;
     }>, Schema.Struct<{
       readonly tags: Schema.StructWithRest<Schema.Struct<{
-        readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-        readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-        readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
       }>, readonly [Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>]>;
       readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.String>>;
     }>, Schema.Struct<{
       readonly require_approval: Schema.$Array<Schema.String>;
     }>]>>>;
     readonly tags: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
-      readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-      readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-      readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+      readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+      readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+      readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
     }>, readonly [Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>]>>;
     readonly workbench: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
       readonly enable: Schema.optionalKey<Schema.Boolean>;

package/dist/effect/schemas/tool-router/session/patch.d.mts

@@ -32,6 +32,7 @@ declare const SessionPatchResponse: Schema.StructWithRest<Schema.Struct<{
         readonly disabled: Schema.$Array<Schema.String>;
       }>]>>>;
       readonly return_instant_charge: Schema.Boolean;
+      readonly return_prices_in_search: Schema.Boolean;
     }>]>;
     readonly manage_connections: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
       readonly enabled: Schema.optionalKey<Schema.Boolean>;
@@ -47,18 +48,18 @@ declare const SessionPatchResponse: Schema.StructWithRest<Schema.Struct<{
       readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.String>>;
     }>, Schema.Struct<{
       readonly tags: Schema.StructWithRest<Schema.Struct<{
-        readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-        readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-        readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+        readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
       }>, readonly [Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>]>;
       readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.String>>;
     }>, Schema.Struct<{
       readonly require_approval: Schema.$Array<Schema.String>;
     }>]>>>;
     readonly tags: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
-      readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-      readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
-      readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+      readonly enabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+      readonly disabled: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
+      readonly require_approval: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["readOnlyHint", "createHint", "updateHint", "destructiveHint", "idempotentHint", "openWorldHint"]>>>;
     }>, readonly [Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>]>>;
     readonly workbench: Schema.optionalKey<Schema.StructWithRest<Schema.Struct<{
       readonly enable: Schema.optionalKey<Schema.Boolean>;