@composio/client 0.1.0-alpha.66 → 0.1.0-alpha.68

package/resources/mcp/generate.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"generate.mjs","sourceRoot":"","sources":["../../src/resources/mcp/generate.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;OAaG;IACH,GAAG,CAAC,IAAuB,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;CACF"}
+{"version":3,"file":"generate.mjs","sourceRoot":"","sources":["../../src/resources/mcp/generate.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;OAgBG;IACH,GAAG,CAAC,IAAuB,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;CACF"}

package/resources/tool-router/session/files.d.mts

@@ -14,7 +14,7 @@ export declare class Files extends APIResource {
      * ```ts
      * const files = await client.toolRouter.session.files.list(
      *   'files',
-     *   { session_id: 'trs_123456789' },
+     *   { session_id: 'trs_1a2b3c4d5e6f' },
      * );
      * ```
      */
@@ -28,7 +28,7 @@ export declare class Files extends APIResource {
      * const file = await client.toolRouter.session.files.delete(
      *   'files',
      *   {
-     *     session_id: 'trs_123456789',
+     *     session_id: 'trs_1a2b3c4d5e6f',
      *     mount_relative_path: 'report.pdf',
      *   },
      * );
@@ -45,7 +45,7 @@ export declare class Files extends APIResource {
      *   await client.toolRouter.session.files.createDownloadURL(
      *     'files',
      *     {
-     *       session_id: 'trs_123456789',
+     *       session_id: 'trs_1a2b3c4d5e6f',
      *       mount_relative_path: 'report.pdf',
      *     },
      *   );
@@ -62,7 +62,7 @@ export declare class Files extends APIResource {
      *   await client.toolRouter.session.files.createUploadURL(
      *     'files',
      *     {
-     *       session_id: 'trs_123456789',
+     *       session_id: 'trs_1a2b3c4d5e6f',
      *       mount_relative_path: 'report.pdf',
      *     },
      *   );

package/resources/tool-router/session/files.d.ts

@@ -14,7 +14,7 @@ export declare class Files extends APIResource {
      * ```ts
      * const files = await client.toolRouter.session.files.list(
      *   'files',
-     *   { session_id: 'trs_123456789' },
+     *   { session_id: 'trs_1a2b3c4d5e6f' },
      * );
      * ```
      */
@@ -28,7 +28,7 @@ export declare class Files extends APIResource {
      * const file = await client.toolRouter.session.files.delete(
      *   'files',
      *   {
-     *     session_id: 'trs_123456789',
+     *     session_id: 'trs_1a2b3c4d5e6f',
      *     mount_relative_path: 'report.pdf',
      *   },
      * );
@@ -45,7 +45,7 @@ export declare class Files extends APIResource {
      *   await client.toolRouter.session.files.createDownloadURL(
      *     'files',
      *     {
-     *       session_id: 'trs_123456789',
+     *       session_id: 'trs_1a2b3c4d5e6f',
      *       mount_relative_path: 'report.pdf',
      *     },
      *   );
@@ -62,7 +62,7 @@ export declare class Files extends APIResource {
      *   await client.toolRouter.session.files.createUploadURL(
      *     'files',
      *     {
-     *       session_id: 'trs_123456789',
+     *       session_id: 'trs_1a2b3c4d5e6f',
      *       mount_relative_path: 'report.pdf',
      *     },
      *   );

package/resources/tool-router/session/files.js

@@ -17,7 +17,7 @@ class Files extends resource_1.APIResource {
      * ```ts
      * const files = await client.toolRouter.session.files.list(
      *   'files',
-     *   { session_id: 'trs_123456789' },
+     *   { session_id: 'trs_1a2b3c4d5e6f' },
      * );
      * ```
      */
@@ -37,7 +37,7 @@ class Files extends resource_1.APIResource {
      * const file = await client.toolRouter.session.files.delete(
      *   'files',
      *   {
-     *     session_id: 'trs_123456789',
+     *     session_id: 'trs_1a2b3c4d5e6f',
      *     mount_relative_path: 'report.pdf',
      *   },
      * );
@@ -60,7 +60,7 @@ class Files extends resource_1.APIResource {
      *   await client.toolRouter.session.files.createDownloadURL(
      *     'files',
      *     {
-     *       session_id: 'trs_123456789',
+     *       session_id: 'trs_1a2b3c4d5e6f',
      *       mount_relative_path: 'report.pdf',
      *     },
      *   );
@@ -83,7 +83,7 @@ class Files extends resource_1.APIResource {
      *   await client.toolRouter.session.files.createUploadURL(
      *     'files',
      *     {
-     *       session_id: 'trs_123456789',
+     *       session_id: 'trs_1a2b3c4d5e6f',
      *       mount_relative_path: 'report.pdf',
      *     },
      *   );

package/resources/tool-router/session/files.mjs

@@ -14,7 +14,7 @@ export class Files extends APIResource {
      * ```ts
      * const files = await client.toolRouter.session.files.list(
      *   'files',
-     *   { session_id: 'trs_123456789' },
+     *   { session_id: 'trs_1a2b3c4d5e6f' },
      * );
      * ```
      */
@@ -34,7 +34,7 @@ export class Files extends APIResource {
      * const file = await client.toolRouter.session.files.delete(
      *   'files',
      *   {
-     *     session_id: 'trs_123456789',
+     *     session_id: 'trs_1a2b3c4d5e6f',
      *     mount_relative_path: 'report.pdf',
      *   },
      * );
@@ -57,7 +57,7 @@ export class Files extends APIResource {
      *   await client.toolRouter.session.files.createDownloadURL(
      *     'files',
      *     {
-     *       session_id: 'trs_123456789',
+     *       session_id: 'trs_1a2b3c4d5e6f',
      *       mount_relative_path: 'report.pdf',
      *     },
      *   );
@@ -80,7 +80,7 @@ export class Files extends APIResource {
      *   await client.toolRouter.session.files.createUploadURL(
      *     'files',
      *     {
-     *       session_id: 'trs_123456789',
+     *       session_id: 'trs_1a2b3c4d5e6f',
      *       mount_relative_path: 'report.pdf',
      *     },
      *   );

package/resources/tool-router/session/session.d.mts

@@ -29,17 +29,22 @@ export declare class Session extends APIResource {
      * @example
      * ```ts
      * const session = await client.toolRouter.session.retrieve(
-     *   'trs_123456789',
+     *   'trs_1a2b3c4d5e6f',
      * );
      * ```
      */
     retrieve(sessionID: string, options?: RequestOptions): APIPromise<SessionRetrieveResponse>;
     /**
-     * Executes a specific tool within a tool router session. The toolkit is
-     * automatically inferred from the tool slug. The tool must belong to an allowed
-     * toolkit and must not be disabled in the session configuration. This endpoint
-     * validates permissions, resolves connected accounts, and executes the tool with
-     * the session context.
+     * Executes a specific tool within a tool router session. This is the primary
+     * execution endpoint for both meta tools and app tools exposed by the session. The
+     * toolkit is automatically inferred from the tool slug. For app tools, the tool
+     * must belong to an allowed toolkit and must not be disabled in the session
+     * configuration. The endpoint validates permissions, resolves connected accounts
+     * when needed, and executes the tool with the session context. The top-level
+     * account field applies only to direct app tool execution in multi-account
+     * sessions. Meta/helper tools either ignore it or define their own
+     * account-selection fields, for example
+     * COMPOSIO_MULTI_EXECUTE_TOOL.tools[].account.
      *
      * @example
      * ```ts
@@ -51,7 +56,9 @@ export declare class Session extends APIResource {
      */
     execute(sessionID: string, body: SessionExecuteParams, options?: RequestOptions): APIPromise<SessionExecuteResponse>;
     /**
-     * Executes a Composio meta tool (COMPOSIO\_\*) within a tool router session.
+     * Executes a Composio meta tool (COMPOSIO\_\*) within a tool router session. This
+     * endpoint is kept for meta-tool compatibility; clients can also use the primary
+     * /execute endpoint.
      *
      * @example
      * ```ts
@@ -126,15 +133,15 @@ export declare class Session extends APIResource {
      * @example
      * ```ts
      * const response = await client.toolRouter.session.toolkits(
-     *   'trs_123456789',
+     *   'trs_1a2b3c4d5e6f',
      * );
      * ```
      */
     toolkits(sessionID: string, query?: SessionToolkitsParams | null | undefined, options?: RequestOptions): APIPromise<SessionToolkitsResponse>;
     /**
-     * Returns the meta tools available in a tool router session with their complete
-     * schemas. This includes request and response schemas specific to the session
-     * context.
+     * Returns the tools available in a tool router session with their complete
+     * schemas. This includes both meta tools and any preloaded app tools exposed by
+     * the session.
      *
      * @example
      * ```ts
@@ -150,6 +157,11 @@ export interface SessionCreateResponse {
      * The session configuration including user, toolkits, and overrides
      */
     config: SessionCreateResponse.Config;
+    /**
+     * Monotonic version of the config. Incremented on each PATCH. Use for optimistic
+     * concurrency control.
+     */
+    config_version: number;
     mcp: SessionCreateResponse.Mcp;
     /**
      * The identifier of the session
@@ -164,12 +176,25 @@ export interface SessionCreateResponse {
      * session creation, not on GET.
      */
     experimental?: SessionCreateResponse.Experimental;
+    /**
+     * Advisory list — the session exists and is usable, but the listed issues may
+     * warrant attention.
+     */
+    warnings?: Array<SessionCreateResponse.Warning>;
 }
 export declare namespace SessionCreateResponse {
     /**
      * The session configuration including user, toolkits, and overrides
      */
     interface Config {
+        /**
+         * Preload configuration. Controls which tools appear in `session.tools` and the
+         * MCP server tool list, callable directly without going through search. Each
+         * preloaded tool adds to the agent context — roughly ≤20 tools is recommended.
+         * Always present in the response (empty `tools: []` when the session was created
+         * without a preload config).
+         */
+        preload: Config.Preload;
         /**
          * User identifier for this session
          */
@@ -181,7 +206,8 @@ export declare namespace SessionCreateResponse {
             [key: string]: string;
         };
         /**
-         * Connected account overrides per toolkit
+         * Connected account overrides per toolkit. Each connected account must belong to
+         * the same user_id as the session.
          */
         connected_accounts?: {
             [key: string]: string;
@@ -190,6 +216,10 @@ export declare namespace SessionCreateResponse {
          * Manage connections configuration
          */
         manage_connections?: Config.ManageConnections;
+        /**
+         * Multi-account configuration for this session.
+         */
+        multi_account?: Config.MultiAccount;
         /**
          * MCP tool annotation hints for filtering tools with enabled/disabled support.
          * enabled: tags that the tool must have at least one of. disabled: tags that the
@@ -212,6 +242,21 @@ export declare namespace SessionCreateResponse {
         workbench?: Config.Workbench;
     }
     namespace Config {
+        /**
+         * Preload configuration. Controls which tools appear in `session.tools` and the
+         * MCP server tool list, callable directly without going through search. Each
+         * preloaded tool adds to the agent context — roughly ≤20 tools is recommended.
+         * Always present in the response (empty `tools: []` when the session was created
+         * without a preload config).
+         */
+        interface Preload {
+            /**
+             * Tool slugs preloaded for this session. Appear in `session.tools` and the MCP
+             * server tool list, callable directly without going through search. Empty array
+             * when no preload was configured.
+             */
+            tools: Array<string>;
+        }
         /**
          * Manage connections configuration
          */
@@ -234,6 +279,26 @@ export declare namespace SessionCreateResponse {
              */
             enabled?: boolean;
         }
+        /**
+         * Multi-account configuration for this session.
+         */
+        interface MultiAccount {
+            /**
+             * When true, enables multi-account mode for this session. When not set, falls back
+             * to org/project-level configuration.
+             */
+            enable?: boolean;
+            /**
+             * Maximum number of connected accounts allowed per toolkit. Defaults to 5 when
+             * multi-account is enabled.
+             */
+            max_accounts_per_toolkit?: number;
+            /**
+             * When true, require explicit account selection when multiple accounts are
+             * connected. When false (default), use the first/default account.
+             */
+            require_explicit_selection?: boolean;
+        }
         /**
          * MCP tool annotation hints for filtering tools with enabled/disabled support.
          * enabled: tags that the tool must have at least one of. disabled: tags that the
@@ -294,6 +359,11 @@ export declare namespace SessionCreateResponse {
              * Whether proxy execution is enabled in the workbench
              */
             proxy_execution_enabled?: boolean;
+            /**
+             * Sandbox compute tier: standard (1 vCPU / 1 GB), medium (2 vCPU / 2 GB), large (4
+             * vCPU / 4 GB), xlarge (8 vCPU / 8 GB). Defaults to standard.
+             */
+            sandbox_size?: 'standard' | 'medium' | 'large' | 'xlarge';
         }
     }
     interface Mcp {
@@ -371,12 +441,28 @@ export declare namespace SessionCreateResponse {
             };
         }
     }
+    interface Warning {
+        /**
+         * Stable machine code identifying the advisory. Safe to switch on in client code.
+         */
+        code: 'PRELOAD_TOOLS_HIGH_CONTEXT_USAGE';
+        /**
+         * Human-readable description of the advisory. Suitable for logging or surfacing to
+         * end users.
+         */
+        message: string;
+    }
 }
 export interface SessionRetrieveResponse {
     /**
      * The session configuration including user, toolkits, and overrides
      */
     config: SessionRetrieveResponse.Config;
+    /**
+     * Monotonic version of the config. Incremented on each PATCH. Use for optimistic
+     * concurrency control.
+     */
+    config_version: number;
     mcp: SessionRetrieveResponse.Mcp;
     /**
      * The identifier of the session
@@ -390,12 +476,25 @@ export interface SessionRetrieveResponse {
      * Experimental features
      */
     experimental?: SessionRetrieveResponse.Experimental;
+    /**
+     * Advisory list — the session exists and is usable, but the listed issues may
+     * warrant attention.
+     */
+    warnings?: Array<SessionRetrieveResponse.Warning>;
 }
 export declare namespace SessionRetrieveResponse {
     /**
      * The session configuration including user, toolkits, and overrides
      */
     interface Config {
+        /**
+         * Preload configuration. Controls which tools appear in `session.tools` and the
+         * MCP server tool list, callable directly without going through search. Each
+         * preloaded tool adds to the agent context — roughly ≤20 tools is recommended.
+         * Always present in the response (empty `tools: []` when the session was created
+         * without a preload config).
+         */
+        preload: Config.Preload;
         /**
          * User identifier for this session
          */
@@ -407,7 +506,8 @@ export declare namespace SessionRetrieveResponse {
             [key: string]: string;
         };
         /**
-         * Connected account overrides per toolkit
+         * Connected account overrides per toolkit. Each connected account must belong to
+         * the same user_id as the session.
          */
         connected_accounts?: {
             [key: string]: string;
@@ -416,6 +516,10 @@ export declare namespace SessionRetrieveResponse {
          * Manage connections configuration
          */
         manage_connections?: Config.ManageConnections;
+        /**
+         * Multi-account configuration for this session.
+         */
+        multi_account?: Config.MultiAccount;
         /**
          * MCP tool annotation hints for filtering tools with enabled/disabled support.
          * enabled: tags that the tool must have at least one of. disabled: tags that the
@@ -438,6 +542,21 @@ export declare namespace SessionRetrieveResponse {
         workbench?: Config.Workbench;
     }
     namespace Config {
+        /**
+         * Preload configuration. Controls which tools appear in `session.tools` and the
+         * MCP server tool list, callable directly without going through search. Each
+         * preloaded tool adds to the agent context — roughly ≤20 tools is recommended.
+         * Always present in the response (empty `tools: []` when the session was created
+         * without a preload config).
+         */
+        interface Preload {
+            /**
+             * Tool slugs preloaded for this session. Appear in `session.tools` and the MCP
+             * server tool list, callable directly without going through search. Empty array
+             * when no preload was configured.
+             */
+            tools: Array<string>;
+        }
         /**
          * Manage connections configuration
          */
@@ -460,6 +579,26 @@ export declare namespace SessionRetrieveResponse {
              */
             enabled?: boolean;
         }
+        /**
+         * Multi-account configuration for this session.
+         */
+        interface MultiAccount {
+            /**
+             * When true, enables multi-account mode for this session. When not set, falls back
+             * to org/project-level configuration.
+             */
+            enable?: boolean;
+            /**
+             * Maximum number of connected accounts allowed per toolkit. Defaults to 5 when
+             * multi-account is enabled.
+             */
+            max_accounts_per_toolkit?: number;
+            /**
+             * When true, require explicit account selection when multiple accounts are
+             * connected. When false (default), use the first/default account.
+             */
+            require_explicit_selection?: boolean;
+        }
         /**
          * MCP tool annotation hints for filtering tools with enabled/disabled support.
          * enabled: tags that the tool must have at least one of. disabled: tags that the
@@ -520,6 +659,11 @@ export declare namespace SessionRetrieveResponse {
              * Whether proxy execution is enabled in the workbench
              */
             proxy_execution_enabled?: boolean;
+            /**
+             * Sandbox compute tier: standard (1 vCPU / 1 GB), medium (2 vCPU / 2 GB), large (4
+             * vCPU / 4 GB), xlarge (8 vCPU / 8 GB). Defaults to standard.
+             */
+            sandbox_size?: 'standard' | 'medium' | 'large' | 'xlarge';
         }
     }
     interface Mcp {
@@ -596,6 +740,17 @@ export declare namespace SessionRetrieveResponse {
             };
         }
     }
+    interface Warning {
+        /**
+         * Stable machine code identifying the advisory. Safe to switch on in client code.
+         */
+        code: 'PRELOAD_TOOLS_HIGH_CONTEXT_USAGE';
+        /**
+         * Human-readable description of the advisory. Suitable for logging or surfacing to
+         * end users.
+         */
+        message: string;
+    }
 }
 export interface SessionExecuteResponse {
     /**
@@ -1210,7 +1365,9 @@ export interface SessionCreateParams {
     /**
      * The connected accounts to use for the session. This will override the default
      * behaviour and use the given connected account when specific toolkits are being
-     * executed
+     * executed. Each connected account must exist (not deleted or disabled) and belong
+     * to the same `user_id` as the session — otherwise session creation fails with a
+     * clear error explaining which account didn't match.
      */
     connected_accounts?: {
         [key: string]: string;
@@ -1229,6 +1386,17 @@ export interface SessionCreateParams {
      * accounts per toolkit.
      */
     multi_account?: SessionCreateParams.MultiAccount;
+    /**
+     * Preload configuration. Controls which tools appear in `session.tools` and the
+     * MCP server tool list so the agent can call them directly without going through
+     * search first — useful for frequently used tools. Each slug must be allowed by
+     * the session filters (`toolkits`, `tools`, `tags`), otherwise session creation
+     * fails with a 400. Custom tools declared in `custom_tools` / `custom_toolkits`
+     * can also be preloaded. Not supported when multi-account is enabled. Each
+     * preloaded tool adds to the agent context window, so keep the list at or under
+     * ~20 tools.
+     */
+    preload?: SessionCreateParams.Preload;
     /**
      * Global MCP tool annotation hints for filtering. Array format is treated as
      * enabled list. Object format supports both enabled (tool must have at least one)
@@ -1242,8 +1410,11 @@ export interface SessionCreateParams {
      */
     toolkits?: SessionCreateParams.Enable | SessionCreateParams.Disable;
     /**
-     * Tool-level configuration per toolkit - either specify enable tools (whitelist),
-     * disable tools (blacklist), or filter by MCP tags for each toolkit
+     * Tool-level configuration per toolkit. Allows you to enable, disable, or filter
+     * by tags for specific tools within each toolkit. Every slug passed in `enable` /
+     * `disable` must be a valid Composio tool slug for that toolkit — invalid or
+     * typo'd slugs fail session creation with a clear error listing which ones didn't
+     * match.
      */
     tools?: {
         [key: string]: SessionCreateParams.Enable | SessionCreateParams.Disable | SessionCreateParams.Tags;
@@ -1273,6 +1444,11 @@ export declare namespace SessionCreateParams {
          * extends_toolkit inherit the Composio toolkit's connection.
          */
         custom_tools?: Array<Experimental.CustomTool>;
+        /**
+         * Per-tool elicitation permission config. Default behavior + per-tool
+         * always_allow/always_deny overrides. Mutation via PATCH.
+         */
+        permissions?: Experimental.Permissions;
     }
     namespace Experimental {
         /**
@@ -1365,6 +1541,27 @@ export declare namespace SessionCreateParams {
                 [key: string]: unknown;
             };
         }
+        /**
+         * Per-tool elicitation permission config. Default behavior + per-tool
+         * always_allow/always_deny overrides. Mutation via PATCH.
+         */
+        interface Permissions {
+            /**
+             * Default elicitation behavior when no override matches. `allow_all` runs every
+             * tool without prompting; `ask_every_call` prompts on each invocation;
+             * `ask_once_per_session` prompts once and remembers the answer for the rest of the
+             * session.
+             */
+            default: 'allow_all' | 'ask_every_call' | 'ask_once_per_session';
+            /**
+             * Per-tool overrides keyed by `${toolSlug}:${connectedAccountId ?? "__none__"}`.
+             * `always_allow` skips the prompt and runs the tool; `always_deny` blocks the
+             * tool. Overrides take precedence over `default` and the session cache.
+             */
+            overrides?: {
+                [key: string]: 'always_allow' | 'always_deny';
+            };
+        }
     }
     /**
      * Configuration for connection management settings
@@ -1415,14 +1612,27 @@ export declare namespace SessionCreateParams {
          */
         require_explicit_selection?: boolean;
     }
-    interface UnionMember1 {
+    /**
+     * Preload configuration. Controls which tools appear in `session.tools` and the
+     * MCP server tool list so the agent can call them directly without going through
+     * search first — useful for frequently used tools. Each slug must be allowed by
+     * the session filters (`toolkits`, `tools`, `tags`), otherwise session creation
+     * fails with a 400. Custom tools declared in `custom_tools` / `custom_toolkits`
+     * can also be preloaded. Not supported when multi-account is enabled. Each
+     * preloaded tool adds to the agent context window, so keep the list at or under
+     * ~20 tools.
+     */
+    interface Preload {
         /**
-         * Tags that the tool must NOT have any of
+         * Tool slugs to preload. Each slug must be allowed by the session filters
+         * (`toolkits`, `tools`, `tags`) and exist either in the Composio tool catalog or
+         * in `custom_tools` / `custom_toolkits` — unknown or blocked slugs return a 400 at
+         * session creation.
          */
+        tools?: Array<string>;
+    }
+    interface UnionMember1 {
         disable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
-        /**
-         * Tags that the tool must have at least one of
-         */
         enable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
     }
     /**
@@ -1464,13 +1674,7 @@ export declare namespace SessionCreateParams {
     }
     namespace Tags {
         interface UnionMember1 {
-            /**
-             * Tags that the tool must NOT have any of
-             */
             disable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
-            /**
-             * Tags that the tool must have at least one of
-             */
             enable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
         }
     }
@@ -1494,18 +1698,26 @@ export declare namespace SessionCreateParams {
          * APIs directly.
          */
         enable_proxy_execution?: boolean;
+        /**
+         * Sandbox compute tier: standard (1 vCPU / 1 GB), medium (2 vCPU / 2 GB), large (4
+         * vCPU / 4 GB), xlarge (8 vCPU / 8 GB). Defaults to standard.
+         */
+        sandbox_size?: 'standard' | 'medium' | 'large' | 'xlarge';
     }
 }
 export interface SessionExecuteParams {
     /**
-     * The unique slug identifier of the tool to execute
+     * The unique slug identifier of the tool to execute. Supports both meta tools and
+     * app tools exposed by the session.
      */
     tool_slug: string;
     /**
-     * Account identifier to specify which connected account to use. Use the account ID
-     * (e.g. "coup_hurricane_dal_analytical") or an alias. When omitted with a single
-     * account, the default is used. When omitted with multiple accounts, an error
-     * lists available accounts.
+     * Account identifier to specify which connected account to use for direct tool
+     * execution. Use the account ID (e.g. "coup_hurricane_dal_analytical") or an
+     * alias. When omitted with a single account, the default is used. When omitted
+     * with multiple accounts, an error lists available accounts. Meta/helper tools
+     * either ignore this top-level field or define their own account-selection fields,
+     * for example COMPOSIO_MULTI_EXECUTE_TOOL.tools[].account.
      */
     account?: string;
     /**
@@ -1514,6 +1726,14 @@ export interface SessionExecuteParams {
     arguments?: {
         [key: string]: unknown;
     };
+    /**
+     * When true, direct non-meta tool execution may return a workbench offload preview
+     * if the response exceeds the configured threshold and the session workbench is
+     * enabled. When omitted or false, direct tool execution returns the normal inline
+     * response. Meta/helper tools are unaffected, and COMPOSIO_MULTI_EXECUTE_TOOL uses
+     * session.workbench configuration for its own batch-level offload behavior.
+     */
+    enable_auto_workbench_offload?: boolean;
 }
 export interface SessionExecuteMetaParams {
     /**
@@ -2053,12 +2273,12 @@ export declare namespace SessionSearchParams {
     interface Query {
         /**
          * The task or use case to search tools for. Provide a detailed description to get
-         * the best results.
+         * the best results. Max 1024 characters.
          */
         use_case: string;
         /**
          * Known field hints as key:value pairs (e.g., "channel_name:general,
-         * user_email:john@example.com")
+         * user_email:john@example.com"). Max 500 characters.
          */
         known_fields?: string;
     }