@composio/client 0.1.0-alpha.61 → 0.1.0-alpha.63

package/src/resources/tool-router/session/session.ts

@@ -66,7 +66,7 @@ export class Session extends APIResource {
    * ```ts
    * const response = await client.toolRouter.session.execute(
    *   'trs_LX9uJKBinWWr',
-   *   { tool_slug: 'GITHUB_CREATE_ISSUE' },
+   *   { tool_slug: 'GITHUB_CREATE_AN_ISSUE' },
    * );
    * ```
    */
@@ -122,6 +122,39 @@ export class Session extends APIResource {
     return this._client.post(path`/api/v3/tool_router/session/${sessionID}/link`, { body, ...options });
   }
 
+  /**
+   * Execute any native API call on a toolkit with authentication automatically
+   * injected from Composio. This endpoint proxies HTTP requests to third-party APIs
+   * using connected account credentials resolved from the session context. Provide
+   * the toolkit slug, API endpoint, and HTTP method — Composio handles
+   * authentication injection, abstracting away credential management. Supports all
+   * HTTP methods, custom headers/query parameters, and binary request/response
+   * bodies.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.toolRouter.session.proxyExecute(
+   *     'trs_LX9uJKBinWWr',
+   *     {
+   *       endpoint: '/api/v1/resources',
+   *       method: 'GET',
+   *       toolkit_slug: 'gmail',
+   *     },
+   *   );
+   * ```
+   */
+  proxyExecute(
+    sessionID: string,
+    body: SessionProxyExecuteParams,
+    options?: RequestOptions,
+  ): APIPromise<SessionProxyExecuteResponse> {
+    return this._client.post(path`/api/v3/tool_router/session/${sessionID}/proxy_execute`, {
+      body,
+      ...options,
+    });
+  }
+
   /**
    * Search for tools matching a given use case query within a tool router session.
    * Returns matching tool slugs, full tool schemas, toolkit connection statuses, and
@@ -271,6 +304,11 @@ export namespace SessionCreateResponse {
        */
       callback_url?: string;
 
+      /**
+       * Enable the "remove" action in COMPOSIO_MANAGE_CONNECTIONS. Default true.
+       */
+      enable_connection_removal?: boolean;
+
       /**
        * Enable the COMPOSIO_WAIT_FOR_CONNECTIONS tool for polling connection status.
        * Default false. May not work reliably with GPT models.
@@ -344,6 +382,12 @@ export namespace SessionCreateResponse {
        */
       auto_offload_threshold?: number;
 
+      /**
+       * Whether the workbench (code execution sandbox) is enabled. When false,
+       * COMPOSIO_REMOTE_WORKBENCH and COMPOSIO_REMOTE_BASH_TOOL are not exposed.
+       */
+      enable?: boolean;
+
       /**
        * Whether proxy execution is enabled in the workbench
        */
@@ -369,10 +413,75 @@ export namespace SessionCreateResponse {
    */
   export interface Experimental {
     /**
-     * The assistive system prompt to inject into your agent for optimal tool router
-     * usage
+     * The assistive system prompt for the tool router session
+     */
+    assistive_prompt?: string;
+
+    /**
+     * User-defined custom toolkits with grouped tools (no-auth)
+     */
+    custom_toolkits?: Array<Experimental.CustomToolkit>;
+
+    /**
+     * Custom tools — standalone or extending Composio toolkits
      */
-    assistive_prompt: string;
+    custom_tools?: Array<Experimental.CustomTool>;
+  }
+
+  export namespace Experimental {
+    export interface CustomToolkit {
+      description: string;
+
+      name: string;
+
+      slug: string;
+
+      tools: Array<CustomToolkit.Tool>;
+    }
+
+    export namespace CustomToolkit {
+      export interface Tool {
+        description: string;
+
+        input_schema: { [key: string]: unknown };
+
+        name: string;
+
+        /**
+         * Original tool slug as provided by the user
+         */
+        original_slug: string;
+
+        /**
+         * Prefixed tool slug (e.g. LOCAL_CRM_FIND_CUSTOMER)
+         */
+        slug: string;
+
+        output_schema?: { [key: string]: unknown };
+      }
+    }
+
+    export interface CustomTool {
+      description: string;
+
+      input_schema: { [key: string]: unknown };
+
+      name: string;
+
+      /**
+       * Original tool slug as provided by the user
+       */
+      original_slug: string;
+
+      /**
+       * Prefixed tool slug (e.g. LOCAL_GMAIL_GET_IMPORTANT_EMAILS)
+       */
+      slug: string;
+
+      extends_toolkit?: string;
+
+      output_schema?: { [key: string]: unknown };
+    }
   }
 }
 
@@ -393,6 +502,11 @@ export interface SessionRetrieveResponse {
    * List of available tools in this session
    */
   tool_router_tools: Array<string>;
+
+  /**
+   * Experimental features
+   */
+  experimental?: SessionRetrieveResponse.Experimental;
 }
 
 export namespace SessionRetrieveResponse {
@@ -453,6 +567,11 @@ export namespace SessionRetrieveResponse {
        */
       callback_url?: string;
 
+      /**
+       * Enable the "remove" action in COMPOSIO_MANAGE_CONNECTIONS. Default true.
+       */
+      enable_connection_removal?: boolean;
+
       /**
        * Enable the COMPOSIO_WAIT_FOR_CONNECTIONS tool for polling connection status.
        * Default false. May not work reliably with GPT models.
@@ -526,6 +645,12 @@ export namespace SessionRetrieveResponse {
        */
       auto_offload_threshold?: number;
 
+      /**
+       * Whether the workbench (code execution sandbox) is enabled. When false,
+       * COMPOSIO_REMOTE_WORKBENCH and COMPOSIO_REMOTE_BASH_TOOL are not exposed.
+       */
+      enable?: boolean;
+
       /**
        * Whether proxy execution is enabled in the workbench
        */
@@ -544,6 +669,82 @@ export namespace SessionRetrieveResponse {
      */
     url: string;
   }
+
+  /**
+   * Experimental features
+   */
+  export interface Experimental {
+    /**
+     * The assistive system prompt for the tool router session
+     */
+    assistive_prompt?: string;
+
+    /**
+     * User-defined custom toolkits with grouped tools (no-auth)
+     */
+    custom_toolkits?: Array<Experimental.CustomToolkit>;
+
+    /**
+     * Custom tools — standalone or extending Composio toolkits
+     */
+    custom_tools?: Array<Experimental.CustomTool>;
+  }
+
+  export namespace Experimental {
+    export interface CustomToolkit {
+      description: string;
+
+      name: string;
+
+      slug: string;
+
+      tools: Array<CustomToolkit.Tool>;
+    }
+
+    export namespace CustomToolkit {
+      export interface Tool {
+        description: string;
+
+        input_schema: { [key: string]: unknown };
+
+        name: string;
+
+        /**
+         * Original tool slug as provided by the user
+         */
+        original_slug: string;
+
+        /**
+         * Prefixed tool slug (e.g. LOCAL_CRM_FIND_CUSTOMER)
+         */
+        slug: string;
+
+        output_schema?: { [key: string]: unknown };
+      }
+    }
+
+    export interface CustomTool {
+      description: string;
+
+      input_schema: { [key: string]: unknown };
+
+      name: string;
+
+      /**
+       * Original tool slug as provided by the user
+       */
+      original_slug: string;
+
+      /**
+       * Prefixed tool slug (e.g. LOCAL_GMAIL_GET_IMPORTANT_EMAILS)
+       */
+      slug: string;
+
+      extends_toolkit?: string;
+
+      output_schema?: { [key: string]: unknown };
+    }
+  }
 }
 
 export interface SessionExecuteResponse {
@@ -597,6 +798,55 @@ export interface SessionLinkResponse {
   redirect_url: string;
 }
 
+export interface SessionProxyExecuteResponse {
+  /**
+   * The HTTP status code returned from the proxied API
+   */
+  status: number;
+
+  /**
+   * Binary body response data. Present when the response is a binary file.
+   */
+  binary_data?: SessionProxyExecuteResponse.BinaryData;
+
+  /**
+   * The response data returned from the proxied API
+   */
+  data?: unknown;
+
+  /**
+   * The HTTP headers returned from the proxied API
+   */
+  headers?: { [key: string]: string };
+}
+
+export namespace SessionProxyExecuteResponse {
+  /**
+   * Binary body response data. Present when the response is a binary file.
+   */
+  export interface BinaryData {
+    /**
+     * Content-Type of the binary data
+     */
+    content_type: string;
+
+    /**
+     * File size in bytes
+     */
+    size: number;
+
+    /**
+     * URL to download binary content
+     */
+    url: string;
+
+    /**
+     * ISO 8601 timestamp when the URL expires
+     */
+    expires_at?: string;
+  }
+}
+
 export interface SessionSearchResponse {
   /**
    * Error message if any searches failed, null if all succeeded. Format: "X out of Y
@@ -798,7 +1048,8 @@ export namespace SessionSearchResponse {
     input_schema?: { [key: string]: unknown };
 
     /**
-     * Output/response schema for the tool
+     * Output/response schema for the tool. Only included when include_output_schemas
+     * is true.
      */
     output_schema?: { [key: string]: unknown };
 
@@ -819,14 +1070,14 @@ export namespace SessionSearchResponse {
       args: SchemaRef.Args;
 
       /**
-       * Instruction message for the LLM
+       * Tool to call
        */
-      message: string;
+      tool: 'COMPOSIO_GET_TOOL_SCHEMAS';
 
       /**
-       * Tool to call
+       * Instruction message for the LLM
        */
-      tool: 'COMPOSIO_GET_TOOL_SCHEMAS';
+      message?: string;
     }
 
     export namespace SchemaRef {
@@ -863,6 +1114,18 @@ export namespace SessionSearchResponse {
      */
     toolkit: string;
 
+    /**
+     * When "required", the agent must specify which account to use. Present only when
+     * multiple accounts exist.
+     */
+    account_selection?: 'required';
+
+    /**
+     * List of connected accounts for this toolkit. Present when multi-account is
+     * enabled.
+     */
+    accounts?: Array<ToolkitConnectionStatus.Account>;
+
     /**
      * Connection details including auth config and connected account IDs. Only present
      * when has_active_connection is true.
@@ -874,6 +1137,40 @@ export namespace SessionSearchResponse {
      */
     current_user_info?: { [key: string]: unknown };
   }
+
+  export namespace ToolkitConnectionStatus {
+    export interface Account {
+      /**
+       * Unique identifier for this account
+       */
+      id: string;
+
+      /**
+       * ISO 8601 timestamp of when the account was connected
+       */
+      created_at: string;
+
+      /**
+       * Whether this is the default account for the toolkit
+       */
+      is_default: boolean;
+
+      /**
+       * Connection status (e.g., "active")
+       */
+      status: string;
+
+      /**
+       * User-assigned alias for this account
+       */
+      alias?: string;
+
+      /**
+       * Information about the connected user (email, name, etc.)
+       */
+      user_info?: { [key: string]: unknown };
+    }
+  }
 }
 
 export interface SessionToolkitsResponse {
@@ -1042,6 +1339,12 @@ export namespace SessionToolsResponse {
      */
     output_parameters: { [key: string]: unknown };
 
+    /**
+     * Structured scope requirements for the tool. Null means the tool is legacy and
+     * only exposes flat scopes.
+     */
+    scope_requirements: Item.ScopeRequirements | null;
+
     /**
      * List of scopes associated with the tool
      */
@@ -1104,6 +1407,20 @@ export namespace SessionToolsResponse {
       }
     }
 
+    /**
+     * Structured scope requirements for the tool. Null means the tool is legacy and
+     * only exposes flat scopes.
+     */
+    export interface ScopeRequirements {
+      all_of: Array<string | ScopeRequirements.AnyOf>;
+    }
+
+    export namespace ScopeRequirements {
+      export interface AnyOf {
+        any_of: Array<string>;
+      }
+    }
+
     export interface Toolkit {
       /**
        * URL to the toolkit logo image
@@ -1194,6 +1511,18 @@ export namespace SessionCreateParams {
      * Customize assistive prompt generation (e.g., timezone).
      */
     assistive_prompt_config?: Experimental.AssistivePromptConfig;
+
+    /**
+     * Custom toolkits with grouped tools. Toolkit slugs must not conflict with
+     * existing Composio toolkits. All tools are no-auth.
+     */
+    custom_toolkits?: Array<Experimental.CustomToolkit>;
+
+    /**
+     * Custom tools to include in search. Standalone tools need no auth. Tools with
+     * extends_toolkit inherit the Composio toolkit's connection.
+     */
+    custom_tools?: Array<Experimental.CustomTool>;
   }
 
   export namespace Experimental {
@@ -1207,49 +1536,142 @@ export namespace SessionCreateParams {
        */
       user_timezone?: string;
     }
-  }
 
-  /**
-   * Configuration for connection management settings
-   */
-  export interface ManageConnections {
-    /**
-     * The URL to redirect to after a user completes authentication for a connected
-     * account. This allows you to handle the auth callback in your own application.
-     */
-    callback_url?: string;
+    export interface CustomToolkit {
+      /**
+       * Used for BM25 search matching and shown in toolkit connection statuses.
+       */
+      description: string;
 
-    /**
-     * Whether to enable the connection manager for automatic connection handling. If
-     * true, we will provide a tool your agent can use to initiate connections to
-     * toolkits if it doesnt exist. If set to false, then you have to manage
-     * connections manually.
-     */
-    enable?: boolean | null;
+      /**
+       * Display name shown to the LLM and in search results.
+       */
+      name: string;
 
-    /**
-     * When true, the COMPOSIO_WAIT_FOR_CONNECTIONS tool is available for agents to
-     * poll connection status after sharing auth URLs. Default is false (disabled). May
-     * not work reliably with GPT models.
-     */
-    enable_wait_for_connections?: boolean | null;
-  }
+      /**
+       * Unique slug for the toolkit. Must not conflict with existing Composio toolkit
+       * slugs. Alphanumeric, underscores, and hyphens only.
+       */
+      slug: string;
 
-  export interface UnionMember1 {
-    /**
-     * Tags that the tool must NOT have any of
-     */
-    disable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
+      /**
+       * Tools in this custom toolkit
+       */
+      tools: Array<CustomToolkit.Tool>;
+    }
 
-    /**
-     * Tags that the tool must have at least one of
-     */
-    enable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
-  }
+    export namespace CustomToolkit {
+      export interface Tool {
+        /**
+         * Used for BM25 search matching and shown to the LLM.
+         */
+        description: string;
 
-  /**
-   * Enable only specific toolkits (allowlist)
-   */
+        /**
+         * Must have type: "object" and a properties field.
+         */
+        input_schema: { [key: string]: unknown };
+
+        /**
+         * Human-readable display name
+         */
+        name: string;
+
+        /**
+         * Tool slug. Combined with toolkit slug to form LOCAL*<TOOLKIT>*<TOOL> (max 60
+         * chars total).
+         */
+        slug: string;
+
+        /**
+         * Optional output schema for the tool response.
+         */
+        output_schema?: { [key: string]: unknown };
+      }
+    }
+
+    export interface CustomTool {
+      /**
+       * Used for BM25 search matching and shown to the LLM.
+       */
+      description: string;
+
+      /**
+       * Must have type: "object" and a properties field.
+       */
+      input_schema: { [key: string]: unknown };
+
+      /**
+       * Human-readable display name
+       */
+      name: string;
+
+      /**
+       * Tool slug. Forms LOCAL*<TOOL> (standalone) or LOCAL*<TOOLKIT>\_<TOOL>
+       * (extending). Max 60 chars total.
+       */
+      slug: string;
+
+      /**
+       * If set, must be a valid Composio toolkit slug. The tool inherits that toolkit's
+       * auth/connection status. If omitted, the tool is standalone (no-auth).
+       */
+      extends_toolkit?: string;
+
+      /**
+       * JSON Schema describing tool output (optional)
+       */
+      output_schema?: { [key: string]: unknown };
+    }
+  }
+
+  /**
+   * Configuration for connection management settings
+   */
+  export interface ManageConnections {
+    /**
+     * The URL to redirect to after a user completes authentication for a connected
+     * account. This allows you to handle the auth callback in your own application.
+     */
+    callback_url?: string;
+
+    /**
+     * Whether to enable the connection manager for automatic connection handling. If
+     * true, we will provide a tool your agent can use to initiate connections to
+     * toolkits if it doesnt exist. If set to false, then you have to manage
+     * connections manually.
+     */
+    enable?: boolean | null;
+
+    /**
+     * Enable the "remove" action in COMPOSIO_MANAGE_CONNECTIONS to allow deleting
+     * connected accounts. Default true.
+     */
+    enable_connection_removal?: boolean | null;
+
+    /**
+     * When true, the COMPOSIO_WAIT_FOR_CONNECTIONS tool is available for agents to
+     * poll connection status after sharing auth URLs. Default is false (disabled). May
+     * not work reliably with GPT models.
+     */
+    enable_wait_for_connections?: boolean | null;
+  }
+
+  export 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'>;
+  }
+
+  /**
+   * Enable only specific toolkits (allowlist)
+   */
   export interface Enable {
     /**
      * Only these specific toolkits will be enabled
@@ -1314,6 +1736,12 @@ export namespace SessionCreateParams {
      */
     auto_offload_threshold?: number;
 
+    /**
+     * Set to false to disable the workbench entirely. When disabled, no code execution
+     * tools are available in the session.
+     */
+    enable?: boolean;
+
     /**
      * Whether proxy execution is enabled. When enabled, workbench can call URLs and
      * APIs directly.
@@ -1328,6 +1756,14 @@ export interface SessionExecuteParams {
    */
   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?: string;
+
   /**
    * The arguments required by the tool
    */
@@ -1367,6 +1803,863 @@ export interface SessionLinkParams {
   callback_url?: string;
 }
 
+export interface SessionProxyExecuteParams {
+  /**
+   * The API endpoint to call (absolute URL or path relative to base URL of the
+   * connected account)
+   */
+  endpoint: string;
+
+  /**
+   * The HTTP method to use for the request
+   */
+  method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD';
+
+  /**
+   * The slug of the toolkit to use for the request
+   */
+  toolkit_slug: string;
+
+  /**
+   * Binary body to send. For binary upload via URL: use {url: "https://...",
+   * content_type?: "..."}. For binary upload via base64: use {base64: "...",
+   * content_type?: "..."}.
+   */
+  binary_body?: SessionProxyExecuteParams.UnionMember0 | SessionProxyExecuteParams.UnionMember1;
+
+  /**
+   * The request body (for POST, PUT, and PATCH requests)
+   */
+  body?: unknown;
+
+  custom_connection_data?:
+    | SessionProxyExecuteParams.UnionMember0
+    | SessionProxyExecuteParams.UnionMember1
+    | SessionProxyExecuteParams.UnionMember2
+    | SessionProxyExecuteParams.UnionMember3
+    | SessionProxyExecuteParams.UnionMember4
+    | SessionProxyExecuteParams.UnionMember5
+    | SessionProxyExecuteParams.UnionMember6
+    | SessionProxyExecuteParams.UnionMember7
+    | SessionProxyExecuteParams.UnionMember8
+    | SessionProxyExecuteParams.UnionMember9
+    | SessionProxyExecuteParams.UnionMember10;
+
+  /**
+   * Additional HTTP headers or query parameters to include in the request
+   */
+  parameters?: Array<SessionProxyExecuteParams.Parameter>;
+}
+
+export namespace SessionProxyExecuteParams {
+  export interface UnionMember0 {
+    /**
+     * URL to fetch binary content from
+     */
+    url: string;
+
+    /**
+     * Content-Type header to use for the request
+     */
+    content_type?: string;
+  }
+
+  export interface UnionMember1 {
+    /**
+     * Base64-encoded binary data
+     */
+    base64: string;
+
+    /**
+     * Content-Type header to use for the request
+     */
+    content_type?: string;
+  }
+
+  export interface UnionMember0 {
+    authScheme: 'OAUTH2';
+
+    toolkitSlug: string;
+
+    val: UnionMember0.Val;
+  }
+
+  export namespace UnionMember0 {
+    export interface Val {
+      access_token: string;
+
+      account_id?: string;
+
+      account_url?: string;
+
+      api_url?: string;
+
+      /**
+       * for slack user scopes
+       */
+      authed_user?: Val.AuthedUser;
+
+      base_url?: string;
+
+      borneo_dashboard_url?: string;
+
+      COMPANYDOMAIN?: string;
+
+      dc?: string;
+
+      domain?: string;
+
+      expires_in?: number | string | null;
+
+      extension?: string;
+
+      form_api_base_url?: string;
+
+      id_token?: string;
+
+      instanceEndpoint?: string;
+
+      instanceName?: string;
+
+      /**
+       * Whether to return the redirect url without shortening
+       */
+      long_redirect_url?: boolean;
+
+      proxy_password?: string;
+
+      proxy_username?: string;
+
+      refresh_token?: string | null;
+
+      region?: string;
+
+      scope?: string | Array<string> | null;
+
+      server_location?: string;
+
+      shop?: string;
+
+      site_name?: string;
+
+      /**
+       * The oauth2 state prefix for the connection
+       */
+      state_prefix?: string;
+
+      subdomain?: string;
+
+      token_type?: string;
+
+      version?: string;
+
+      webhook_signature?: string;
+
+      your_server?: string;
+
+      'your-domain'?: string;
+
+      [k: string]: unknown;
+    }
+
+    export namespace Val {
+      /**
+       * for slack user scopes
+       */
+      export interface AuthedUser {
+        access_token?: string;
+
+        scope?: string;
+      }
+    }
+  }
+
+  export interface UnionMember1 {
+    authScheme: 'DCR_OAUTH';
+
+    toolkitSlug: string;
+
+    val: UnionMember1.Val;
+  }
+
+  export namespace UnionMember1 {
+    export interface Val {
+      access_token: string;
+
+      /**
+       * Dynamically registered client ID
+       */
+      client_id: string;
+
+      account_id?: string;
+
+      account_url?: string;
+
+      api_url?: string;
+
+      base_url?: string;
+
+      borneo_dashboard_url?: string;
+
+      client_id_issued_at?: number;
+
+      /**
+       * Dynamically registered client secret
+       */
+      client_secret?: string;
+
+      client_secret_expires_at?: number;
+
+      COMPANYDOMAIN?: string;
+
+      dc?: string;
+
+      domain?: string;
+
+      expires_in?: number | string | null;
+
+      extension?: string;
+
+      form_api_base_url?: string;
+
+      id_token?: string;
+
+      instanceEndpoint?: string;
+
+      instanceName?: string;
+
+      /**
+       * Whether to return the redirect url without shortening
+       */
+      long_redirect_url?: boolean;
+
+      proxy_password?: string;
+
+      proxy_username?: string;
+
+      refresh_token?: string | null;
+
+      region?: string;
+
+      scope?: string | Array<string> | null;
+
+      server_location?: string;
+
+      shop?: string;
+
+      site_name?: string;
+
+      /**
+       * The oauth2 state prefix for the connection
+       */
+      state_prefix?: string;
+
+      subdomain?: string;
+
+      token_type?: string;
+
+      version?: string;
+
+      your_server?: string;
+
+      'your-domain'?: string;
+
+      [k: string]: unknown;
+    }
+  }
+
+  export interface UnionMember2 {
+    authScheme: 'API_KEY';
+
+    toolkitSlug: string;
+
+    val: UnionMember2.Val;
+  }
+
+  export namespace UnionMember2 {
+    export interface Val {
+      account_id?: string;
+
+      account_url?: string;
+
+      api_key?: string;
+
+      api_url?: string;
+
+      base_url?: string;
+
+      basic_encoded?: string;
+
+      bearer_token?: string;
+
+      borneo_dashboard_url?: string;
+
+      COMPANYDOMAIN?: string;
+
+      dc?: string;
+
+      domain?: string;
+
+      extension?: string;
+
+      form_api_base_url?: string;
+
+      generic_api_key?: string;
+
+      instanceEndpoint?: string;
+
+      instanceName?: string;
+
+      proxy_password?: string;
+
+      proxy_username?: string;
+
+      region?: string;
+
+      server_location?: string;
+
+      shop?: string;
+
+      site_name?: string;
+
+      subdomain?: string;
+
+      version?: string;
+
+      your_server?: string;
+
+      'your-domain'?: string;
+
+      [k: string]: unknown;
+    }
+  }
+
+  export interface UnionMember3 {
+    authScheme: 'BASIC_WITH_JWT';
+
+    toolkitSlug: string;
+
+    val: UnionMember3.Val;
+  }
+
+  export namespace UnionMember3 {
+    export interface Val {
+      password: string;
+
+      username: string;
+
+      account_id?: string;
+
+      account_url?: string;
+
+      api_url?: string;
+
+      base_url?: string;
+
+      borneo_dashboard_url?: string;
+
+      COMPANYDOMAIN?: string;
+
+      dc?: string;
+
+      domain?: string;
+
+      extension?: string;
+
+      form_api_base_url?: string;
+
+      instanceEndpoint?: string;
+
+      instanceName?: string;
+
+      proxy_password?: string;
+
+      proxy_username?: string;
+
+      region?: string;
+
+      server_location?: string;
+
+      shop?: string;
+
+      site_name?: string;
+
+      subdomain?: string;
+
+      version?: string;
+
+      your_server?: string;
+
+      'your-domain'?: string;
+
+      [k: string]: unknown;
+    }
+  }
+
+  export interface UnionMember4 {
+    authScheme: 'BASIC';
+
+    toolkitSlug: string;
+
+    val: UnionMember4.Val;
+  }
+
+  export namespace UnionMember4 {
+    export interface Val {
+      username: string;
+
+      account_id?: string;
+
+      account_url?: string;
+
+      api_url?: string;
+
+      base_url?: string;
+
+      borneo_dashboard_url?: string;
+
+      COMPANYDOMAIN?: string;
+
+      dc?: string;
+
+      domain?: string;
+
+      extension?: string;
+
+      form_api_base_url?: string;
+
+      instanceEndpoint?: string;
+
+      instanceName?: string;
+
+      password?: string;
+
+      proxy_password?: string;
+
+      proxy_username?: string;
+
+      region?: string;
+
+      server_location?: string;
+
+      shop?: string;
+
+      site_name?: string;
+
+      subdomain?: string;
+
+      version?: string;
+
+      your_server?: string;
+
+      'your-domain'?: string;
+
+      [k: string]: unknown;
+    }
+  }
+
+  export interface UnionMember5 {
+    authScheme: 'BEARER_TOKEN';
+
+    toolkitSlug: string;
+
+    val: UnionMember5.Val;
+  }
+
+  export namespace UnionMember5 {
+    export interface Val {
+      token: string;
+
+      account_id?: string;
+
+      account_url?: string;
+
+      api_url?: string;
+
+      base_url?: string;
+
+      borneo_dashboard_url?: string;
+
+      COMPANYDOMAIN?: string;
+
+      dc?: string;
+
+      domain?: string;
+
+      extension?: string;
+
+      form_api_base_url?: string;
+
+      instanceEndpoint?: string;
+
+      instanceName?: string;
+
+      proxy_password?: string;
+
+      proxy_username?: string;
+
+      region?: string;
+
+      server_location?: string;
+
+      shop?: string;
+
+      site_name?: string;
+
+      subdomain?: string;
+
+      version?: string;
+
+      your_server?: string;
+
+      'your-domain'?: string;
+
+      [k: string]: unknown;
+    }
+  }
+
+  export interface UnionMember6 {
+    authScheme: 'OAUTH1';
+
+    toolkitSlug: string;
+
+    val: UnionMember6.Val;
+  }
+
+  export namespace UnionMember6 {
+    export interface Val {
+      oauth_token: string;
+
+      oauth_token_secret: string;
+
+      account_id?: string;
+
+      account_url?: string;
+
+      api_url?: string;
+
+      base_url?: string;
+
+      borneo_dashboard_url?: string;
+
+      callback_url?: string;
+
+      COMPANYDOMAIN?: string;
+
+      consumer_key?: string;
+
+      dc?: string;
+
+      domain?: string;
+
+      extension?: string;
+
+      form_api_base_url?: string;
+
+      instanceEndpoint?: string;
+
+      instanceName?: string;
+
+      oauth_verifier?: string;
+
+      proxy_password?: string;
+
+      proxy_username?: string;
+
+      redirectUrl?: string;
+
+      region?: string;
+
+      server_location?: string;
+
+      shop?: string;
+
+      site_name?: string;
+
+      subdomain?: string;
+
+      version?: string;
+
+      your_server?: string;
+
+      'your-domain'?: string;
+
+      [k: string]: unknown;
+    }
+  }
+
+  export interface UnionMember7 {
+    authScheme: 'NO_AUTH';
+
+    toolkitSlug: string;
+
+    val: UnionMember7.Val;
+  }
+
+  export namespace UnionMember7 {
+    export interface Val {
+      account_id?: string;
+
+      account_url?: string;
+
+      api_url?: string;
+
+      base_url?: string;
+
+      borneo_dashboard_url?: string;
+
+      COMPANYDOMAIN?: string;
+
+      dc?: string;
+
+      domain?: string;
+
+      extension?: string;
+
+      form_api_base_url?: string;
+
+      instanceEndpoint?: string;
+
+      instanceName?: string;
+
+      proxy_password?: string;
+
+      proxy_username?: string;
+
+      region?: string;
+
+      server_location?: string;
+
+      shop?: string;
+
+      site_name?: string;
+
+      subdomain?: string;
+
+      version?: string;
+
+      your_server?: string;
+
+      'your-domain'?: string;
+
+      [k: string]: unknown;
+    }
+  }
+
+  export interface UnionMember8 {
+    authScheme: 'SERVICE_ACCOUNT';
+
+    toolkitSlug: string;
+
+    val: UnionMember8.Val;
+  }
+
+  export namespace UnionMember8 {
+    export interface Val {
+      application_id: string;
+
+      installation_id: string;
+
+      private_key: string;
+
+      account_id?: string;
+
+      account_url?: string;
+
+      api_url?: string;
+
+      base_url?: string;
+
+      borneo_dashboard_url?: string;
+
+      COMPANYDOMAIN?: string;
+
+      dc?: string;
+
+      domain?: string;
+
+      extension?: string;
+
+      form_api_base_url?: string;
+
+      instanceEndpoint?: string;
+
+      instanceName?: string;
+
+      proxy_password?: string;
+
+      proxy_username?: string;
+
+      region?: string;
+
+      server_location?: string;
+
+      shop?: string;
+
+      site_name?: string;
+
+      subdomain?: string;
+
+      version?: string;
+
+      your_server?: string;
+
+      'your-domain'?: string;
+
+      [k: string]: unknown;
+    }
+  }
+
+  export interface UnionMember9 {
+    authScheme: 'GOOGLE_SERVICE_ACCOUNT';
+
+    toolkitSlug: string;
+
+    val: UnionMember9.Val;
+  }
+
+  export namespace UnionMember9 {
+    export interface Val {
+      credentials_json: string;
+
+      account_id?: string;
+
+      account_url?: string;
+
+      api_url?: string;
+
+      base_url?: string;
+
+      borneo_dashboard_url?: string;
+
+      COMPANYDOMAIN?: string;
+
+      dc?: string;
+
+      domain?: string;
+
+      extension?: string;
+
+      form_api_base_url?: string;
+
+      instanceEndpoint?: string;
+
+      instanceName?: string;
+
+      proxy_password?: string;
+
+      proxy_username?: string;
+
+      region?: string;
+
+      server_location?: string;
+
+      shop?: string;
+
+      site_name?: string;
+
+      subdomain?: string;
+
+      version?: string;
+
+      your_server?: string;
+
+      'your-domain'?: string;
+
+      [k: string]: unknown;
+    }
+  }
+
+  export interface UnionMember10 {
+    authScheme: 'S2S_OAUTH2';
+
+    toolkitSlug: string;
+
+    val: UnionMember10.Val;
+  }
+
+  export namespace UnionMember10 {
+    export interface Val {
+      access_token: string;
+
+      client_id: string;
+
+      client_secret: string;
+
+      account_id?: string;
+
+      account_url?: string;
+
+      api_url?: string;
+
+      base_url?: string;
+
+      borneo_dashboard_url?: string;
+
+      COMPANYDOMAIN?: string;
+
+      dc?: string;
+
+      domain?: string;
+
+      expires_at?: string;
+
+      expires_in?: number | string | null;
+
+      extension?: string;
+
+      form_api_base_url?: string;
+
+      instanceEndpoint?: string;
+
+      instanceName?: string;
+
+      proxy_password?: string;
+
+      proxy_username?: string;
+
+      region?: string;
+
+      scope?: string | Array<string> | null;
+
+      server_location?: string;
+
+      shop?: string;
+
+      site_name?: string;
+
+      subdomain?: string;
+
+      token_type?: string;
+
+      version?: string;
+
+      your_server?: string;
+
+      'your-domain'?: string;
+
+      [k: string]: unknown;
+    }
+  }
+
+  export interface Parameter {
+    /**
+     * Parameter name
+     */
+    name: string;
+
+    /**
+     * Parameter type (header or query)
+     */
+    type: 'header' | 'query';
+
+    /**
+     * Parameter value
+     */
+    value: string;
+  }
+}
+
 export interface SessionSearchParams {
   /**
    * List of search queries to execute in parallel. Up to 7 queries supported.
@@ -1412,9 +2705,9 @@ export interface SessionToolkitsParams {
   is_connected?: boolean | null;
 
   /**
-   * Number of items per page, max allowed is 1000
+   * Number of items per page, max allowed is 50
    */
-  limit?: number | null;
+  limit?: number;
 
   /**
    * Search query to filter toolkits by name, slug, or description
@@ -1439,6 +2732,7 @@ export declare namespace Session {
     type SessionExecuteResponse as SessionExecuteResponse,
     type SessionExecuteMetaResponse as SessionExecuteMetaResponse,
     type SessionLinkResponse as SessionLinkResponse,
+    type SessionProxyExecuteResponse as SessionProxyExecuteResponse,
     type SessionSearchResponse as SessionSearchResponse,
     type SessionToolkitsResponse as SessionToolkitsResponse,
     type SessionToolsResponse as SessionToolsResponse,
@@ -1446,6 +2740,7 @@ export declare namespace Session {
     type SessionExecuteParams as SessionExecuteParams,
     type SessionExecuteMetaParams as SessionExecuteMetaParams,
     type SessionLinkParams as SessionLinkParams,
+    type SessionProxyExecuteParams as SessionProxyExecuteParams,
     type SessionSearchParams as SessionSearchParams,
     type SessionToolkitsParams as SessionToolkitsParams,
     type SessionToolsParams as SessionToolsParams,