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

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

@@ -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
@@ -344,6 +377,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 +408,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 +497,11 @@ export interface SessionRetrieveResponse {
    * List of available tools in this session
    */
   tool_router_tools: Array<string>;
+
+  /**
+   * Experimental features
+   */
+  experimental?: SessionRetrieveResponse.Experimental;
 }
 
 export namespace SessionRetrieveResponse {
@@ -526,6 +635,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 +659,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 +788,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
@@ -1194,6 +1434,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,6 +1459,93 @@ export namespace SessionCreateParams {
        */
       user_timezone?: string;
     }
+
+    export interface CustomToolkit {
+      /**
+       * Used for BM25 search matching and shown in toolkit connection statuses.
+       */
+      description: string;
+
+      /**
+       * Display name shown to the LLM and in search results.
+       */
+      name: string;
+
+      /**
+       * Unique slug for the toolkit. Must not conflict with existing Composio toolkit
+       * slugs. Alphanumeric, underscores, and hyphens only.
+       */
+      slug: string;
+
+      /**
+       * Tools in this custom toolkit
+       */
+      tools: Array<CustomToolkit.Tool>;
+    }
+
+    export namespace CustomToolkit {
+      export interface Tool {
+        /**
+         * 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. 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 };
+    }
   }
 
   /**
@@ -1314,6 +1653,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.
@@ -1367,6 +1712,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.
@@ -1439,6 +2641,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 +2649,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,