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

package/src/resources/tools.ts

@@ -2,14 +2,42 @@
 
 import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
+import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
+/**
+ * Tool execution endpoints
+ */
 export class Tools extends APIResource {
-  retrieve(toolSlug: string, options?: RequestOptions): APIPromise<ToolRetrieveResponse> {
-    return this._client.get(path`/api/v3/tools/${toolSlug}`, options);
+  /**
+   * Retrieve detailed information about a specific tool using its slug identifier.
+   * This endpoint returns full metadata about a tool including input/output
+   * parameters, versions, and toolkit information.
+   *
+   * @example
+   * ```ts
+   * const tool = await client.tools.retrieve('tool_slug');
+   * ```
+   */
+  retrieve(
+    toolSlug: string,
+    query: ToolRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ToolRetrieveResponse> {
+    return this._client.get(path`/api/v3/tools/${toolSlug}`, { query, ...options });
   }
 
+  /**
+   * Retrieve a paginated list of available tools with comprehensive filtering,
+   * sorting and search capabilities. Use query parameters to narrow down results by
+   * toolkit, tags, or search terms.
+   *
+   * @example
+   * ```ts
+   * const tools = await client.tools.list();
+   * ```
+   */
   list(
     query: ToolListParams | null | undefined = {},
     options?: RequestOptions,
@@ -17,113 +45,330 @@ export class Tools extends APIResource {
     return this._client.get('/api/v3/tools', { query, ...options });
   }
 
+  /**
+   * Execute a specific tool operation with provided arguments and authentication.
+   * This is the primary endpoint for integrating with third-party services and
+   * executing tools. You can provide structured arguments or use natural language
+   * processing by providing a text description of what you want to accomplish.
+   *
+   * @example
+   * ```ts
+   * const response = await client.tools.execute('tool_slug');
+   * ```
+   */
   execute(
-    action: string,
-    body: ToolExecuteParams | null | undefined = {},
+    toolSlug: string,
+    params: ToolExecuteParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<ToolExecuteResponse> {
-    return this._client.post(path`/api/v3/tools/execute/${action}`, { body, ...options });
+    const { 'x-llm-gateway-headers': xLlmGatewayHeaders, ...body } = params ?? {};
+    return this._client.post(path`/api/v3/tools/execute/${toolSlug}`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { ...(xLlmGatewayHeaders != null ? { 'x-llm-gateway-headers': xLlmGatewayHeaders } : undefined) },
+        options?.headers,
+      ]),
+    });
   }
 
+  /**
+   * Uses AI to translate a natural language description into structured arguments
+   * for a specific tool. This endpoint is useful when you want to let users describe
+   * what they want to do in plain language instead of providing structured
+   * parameters.
+   *
+   * @example
+   * ```ts
+   * const response = await client.tools.getInput('tool_slug', {
+   *   text: 'I need to trigger the main workflow in the octocat/Hello-World repository to deploy to production',
+   * });
+   * ```
+   */
   getInput(
-    actionName: string,
+    toolSlug: string,
     body: ToolGetInputParams,
     options?: RequestOptions,
   ): APIPromise<ToolGetInputResponse> {
-    return this._client.post(path`/api/v3/tools/execute/${actionName}/input`, { body, ...options });
+    return this._client.post(path`/api/v3/tools/execute/${toolSlug}/input`, { body, ...options });
   }
 
+  /**
+   * Proxy an HTTP request to a third-party API using connected account credentials.
+   * This endpoint allows making authenticated API calls to external services while
+   * abstracting away authentication details.
+   *
+   * @example
+   * ```ts
+   * const response = await client.tools.proxy({
+   *   endpoint: '/api/v1/resources',
+   *   method: 'GET',
+   * });
+   * ```
+   */
   proxy(body: ToolProxyParams, options?: RequestOptions): APIPromise<ToolProxyResponse> {
     return this._client.post('/api/v3/tools/execute/proxy', { body, ...options });
   }
 
-  retrieveEnum(options?: RequestOptions): APIPromise<string> {
+  /**
+   * Retrieve a list of all available tool enumeration values (tool slugs) from
+   * latest version of each toolkit. This endpoint returns a comma-separated string
+   * of tool slugs that can be used in other API calls.
+   *
+   * @example
+   * ```ts
+   * const response = await client.tools.retrieveEnum();
+   * ```
+   */
+  retrieveEnum(options?: RequestOptions): APIPromise<ToolRetrieveEnumResponse> {
     return this._client.get('/api/v3/tools/enum', options);
   }
 }
 
 export interface ToolRetrieveResponse {
+  /**
+   * List of all available versions for this tool
+   */
   available_versions: Array<string>;
 
+  deprecated: ToolRetrieveResponse.Deprecated;
+
+  /**
+   * Detailed explanation of the tool's functionality and purpose
+   */
   description: string;
 
-  input_parameters: Record<string, unknown>;
+  /**
+   * Schema definition of required input parameters for the tool
+   */
+  input_parameters: { [key: string]: unknown };
+
+  /**
+   * Indicates if this tool is deprecated and may be removed in the future
+   */
+  is_deprecated: boolean;
 
+  /**
+   * Human-readable display name of the tool
+   */
   name: string;
 
-  output_parameters: Record<string, unknown>;
+  /**
+   * Indicates if the tool can be used without authentication
+   */
+  no_auth: boolean;
+
+  /**
+   * Schema definition of return values from the tool
+   */
+  output_parameters: { [key: string]: unknown };
+
+  /**
+   * List of scopes associated with the tool
+   */
+  scopes: Array<string>;
 
+  /**
+   * Unique identifier for the tool
+   */
   slug: string;
 
+  /**
+   * List of tags associated with the tool for categorization and filtering
+   */
   tags: Array<string>;
 
   toolkit: ToolRetrieveResponse.Toolkit;
 
+  /**
+   * Current version of the tool
+   */
   version: string;
+
+  /**
+   * Human-friendly description of the tool, if available
+   */
+  human_description?: string;
 }
 
 export namespace ToolRetrieveResponse {
+  export interface Deprecated {
+    /**
+     * List of all available versions for this tool
+     */
+    available_versions: Array<string>;
+
+    /**
+     * The display name of the tool
+     */
+    displayName: string;
+
+    /**
+     * Indicates if this tool is deprecated and may be removed in the future
+     */
+    is_deprecated: boolean;
+
+    toolkit: Deprecated.Toolkit;
+
+    /**
+     * Current version identifier of the tool
+     */
+    version: string;
+  }
+
+  export namespace Deprecated {
+    export interface Toolkit {
+      /**
+       * URL to the toolkit logo image
+       */
+      logo: string;
+    }
+  }
+
   export interface Toolkit {
+    /**
+     * URL to the toolkit logo image
+     */
     logo: string;
 
+    /**
+     * Human-readable name of the parent toolkit
+     */
     name: string;
 
+    /**
+     * Unique identifier of the parent toolkit
+     */
     slug: string;
   }
 }
 
 export interface ToolListResponse {
+  current_page: number;
+
   items: Array<ToolListResponse.Item>;
 
-  next_cursor: string | null;
+  total_items: number;
 
   total_pages: number;
+
+  next_cursor?: string | null;
 }
 
 export namespace ToolListResponse {
   export interface Item {
     /**
-     * The description of the tool
+     * List of all available versions for this tool
+     */
+    available_versions: Array<string>;
+
+    deprecated: Item.Deprecated;
+
+    /**
+     * Detailed explanation of the tool's functionality and purpose
      */
     description: string;
 
     /**
-     * The input parameters of the tool
+     * Schema definition of required input parameters for the tool
+     */
+    input_parameters: { [key: string]: unknown };
+
+    /**
+     * Indicates if this tool is deprecated and may be removed in the future
      */
-    input_parameters: Record<string, unknown>;
+    is_deprecated: boolean;
 
     /**
-     * The name of the tool
+     * Human-readable display name of the tool
      */
     name: string;
 
     /**
-     * The output parameters of the tool
+     * Indicates if the tool can be used without authentication
+     */
+    no_auth: boolean;
+
+    /**
+     * Schema definition of return values from the tool
      */
-    output_parameters: Record<string, unknown>;
+    output_parameters: { [key: string]: unknown };
 
     /**
-     * The slug of the tool
+     * List of scopes associated with the tool
+     */
+    scopes: Array<string>;
+
+    /**
+     * Unique identifier for the tool
      */
     slug: string;
 
     /**
-     * The tags of the tool
+     * List of tags associated with the tool for categorization and filtering
      */
     tags: Array<string>;
 
     toolkit: Item.Toolkit;
+
+    /**
+     * Current version of the tool
+     */
+    version: string;
+
+    /**
+     * Human-friendly description of the tool, if available
+     */
+    human_description?: string;
   }
 
   export namespace Item {
+    export interface Deprecated {
+      /**
+       * List of all available versions for this tool
+       */
+      available_versions: Array<string>;
+
+      /**
+       * The display name of the tool
+       */
+      displayName: string;
+
+      /**
+       * Indicates if this tool is deprecated and may be removed in the future
+       */
+      is_deprecated: boolean;
+
+      toolkit: Deprecated.Toolkit;
+
+      /**
+       * Current version identifier of the tool
+       */
+      version: string;
+    }
+
+    export namespace Deprecated {
+      export interface Toolkit {
+        /**
+         * URL to the toolkit logo image
+         */
+        logo: string;
+      }
+    }
+
     export interface Toolkit {
       /**
-       * The name of the toolkit
+       * URL to the toolkit logo image
+       */
+      logo: string;
+
+      /**
+       * Human-readable name of the parent toolkit
        */
       name: string;
 
       /**
-       * The slug of the toolkit
+       * Unique identifier of the parent toolkit
        */
       slug: string;
     }
@@ -131,120 +376,1797 @@ export namespace ToolListResponse {
 }
 
 export interface ToolExecuteResponse {
-  data: Record<string, unknown>;
+  /**
+   * Tool execution output data that varies based on the specific tool
+   */
+  data: { [key: string]: unknown };
 
+  /**
+   * Error message if the tool execution was not successful (null if successful)
+   */
   error: string | null;
 
+  /**
+   * Indicates if the tool execution was successful
+   */
   successful: boolean;
 
+  /**
+   * Unique identifier for the execution log (useful for debugging and support)
+   */
   log_id?: string;
 
+  /**
+   * Optional session information for tools that return session context
+   */
   session_info?: unknown;
 }
 
 export interface ToolGetInputResponse {
   /**
-   * The arguments for the action needed to execute the given task.
+   * Key-value pairs of arguments required by the tool to accomplish the described
+   * task
    */
-  arguments?: Record<string, unknown>;
+  arguments?: { [key: string]: unknown };
 
   /**
-   * The error message if the arguments were not generated successfully.
+   * Error message if the arguments could not be generated (null if successful)
    */
   error?: string;
 }
 
 export interface ToolProxyResponse {
+  /**
+   * 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?: ToolProxyResponse.BinaryData;
+
+  /**
+   * The response data returned from the proxied API
+   */
   data?: unknown;
 
-  headers?: Record<string, string>;
+  /**
+   * The HTTP headers returned from the proxied API
+   */
+  headers?: { [key: string]: string };
+}
+
+export namespace ToolProxyResponse {
+  /**
+   * 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 type ToolRetrieveEnumResponse = string;
+/**
+ * JSON string containing all tool enum values from latest version of each toolkit
+ */
+export type ToolRetrieveEnumResponse = Array<string>;
+
+export interface ToolRetrieveParams {
+  /**
+   * Toolkit version specification. Use "latest" for latest versions or bracket
+   * notation for specific versions per toolkit.
+   */
+  toolkit_versions?: string | { [key: string]: string };
+
+  /**
+   * Optional version of the tool to retrieve
+   */
+  version?: string;
+}
 
 export interface ToolListParams {
   /**
-   * The cursor to paginate through the results
+   * Comma-separated list of auth config IDs to filter tools by
+   */
+  auth_config_ids?: string | Array<string>;
+
+  /**
+   * Cursor for pagination. The cursor is a base64 encoded string of the page and
+   * limit. The page is the page number and the limit is the number of items per
+   * page. The cursor is used to paginate through the items. The cursor is not
+   * required for the first page.
    */
   cursor?: string;
 
   /**
-   * Whether to filter by important tools
+   * Filter to only show important/featured tools (set to "true" to enable)
+   */
+  important?: 'true' | 'false';
+
+  /**
+   * Include deprecated tools in the response
+   */
+  include_deprecated?: boolean;
+
+  /**
+   * Number of items per page, max allowed is 1000
    */
-  important?: string;
+  limit?: number | null;
 
   /**
-   * The number of results to return
+   * Full-text search query to filter tools by name, slug, or description. Applied as
+   * a soft filter on top of other filters.
    */
-  limit?: string;
+  query?: string;
 
   /**
-   * The search query to filter by
+   * Array of scopes to filter tools by)
+   */
+  scopes?: Array<string> | null;
+
+  /**
+   * Deprecated: use "query" instead. Free-text search query to find tools by name,
+   * description, or functionality.
    */
   search?: string;
 
+  /**
+   * Filter tools by one or more tags (can be specified multiple times)
+   */
+  tags?: Array<string>;
+
+  /**
+   * Comma-separated list of specific tool slugs to retrieve (overrides other
+   * filters)
+   */
+  tool_slugs?: string;
+
   /**
    * The slug of the toolkit to filter by
    */
   toolkit_slug?: string;
+
+  /**
+   * Toolkit version specification. Use "latest" for latest versions or bracket
+   * notation for specific versions per toolkit.
+   */
+  toolkit_versions?: string | { [key: string]: string };
 }
 
 export interface ToolExecuteParams {
-  allow_tracing?: boolean;
+  /**
+   * @deprecated Body param: Deprecated. Enable debug tracing for tool execution
+   * (useful for debugging)
+   */
+  allow_tracing?: boolean | null;
 
-  arguments?: Record<string, unknown>;
+  /**
+   * Body param: Key-value pairs of arguments required by the tool (mutually
+   * exclusive with text)
+   */
+  arguments?: { [key: string]: unknown };
 
+  /**
+   * Body param: Unique identifier for the connected account to use for
+   * authentication
+   */
   connected_account_id?: string;
 
+  /**
+   * Body param: Custom authentication parameters for tools that support
+   * parameterized authentication
+   */
+  custom_auth_params?: ToolExecuteParams.CustomAuthParams;
+
+  /**
+   * Body param: Custom connection data for tools that support custom connection data
+   */
+  custom_connection_data?:
+    | ToolExecuteParams.UnionMember0
+    | ToolExecuteParams.UnionMember1
+    | ToolExecuteParams.UnionMember2
+    | ToolExecuteParams.UnionMember3
+    | ToolExecuteParams.UnionMember4
+    | ToolExecuteParams.UnionMember5
+    | ToolExecuteParams.UnionMember6
+    | ToolExecuteParams.UnionMember7
+    | ToolExecuteParams.UnionMember8
+    | ToolExecuteParams.UnionMember9;
+
+  /**
+   * @deprecated Body param: Deprecated: please use user_id instead. Entity
+   * identifier for multi-entity connected accounts (e.g. multiple repositories,
+   * organizations)
+   */
   entity_id?: string;
 
+  /**
+   * Body param: Natural language description of the task to perform (mutually
+   * exclusive with arguments)
+   */
   text?: string;
 
-  version?: string;
-}
+  /**
+   * Body param: User id for multi-user connected accounts (e.g. multiple users,
+   * organizations)
+   */
+  user_id?: string;
 
-export interface ToolGetInputParams {
   /**
-   * The use-case description for the action, this will give context to LLM to
-   * generate the correct inputs for the action.
+   * Body param: Tool version to execute (defaults to "00000000_00" if not specified)
    */
-  text: string;
+  version?: string;
 
   /**
-   * The custom description for the action, use this to provide customised context
-   * about the action to the LLM to suit your use-case.
+   * Header param: JSON object containing custom headers to pass to LLM providers
+   * (OpenAI, Bedrock, etc.)
    */
-  customDescription?: string;
+  'x-llm-gateway-headers'?: string;
+}
 
+export namespace ToolExecuteParams {
   /**
-   * The system prompt to be used by LLM, use this to control and guide the behaviour
-   * of the LLM.
+   * Custom authentication parameters for tools that support parameterized
+   * authentication
    */
-  systemPrompt?: string;
+  export interface CustomAuthParams {
+    /**
+     * The base URL (root address) what you should use while making http requests to
+     * the connected account. For example, for gmail, it would be
+     * 'https://gmail.googleapis.com'
+     */
+    base_url?: string;
 
-  version?: string;
-}
+    /**
+     * The body to be sent to the endpoint for authentication. This is a JSON object.
+     * Note: This is very rarely needed and is only required by very few apps.
+     */
+    body?: { [key: string]: unknown };
 
-export interface ToolProxyParams {
-  endpoint: string;
+    parameters?: Array<CustomAuthParams.Parameter>;
+  }
 
-  method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+  export namespace CustomAuthParams {
+    export interface Parameter {
+      /**
+       * The location of the parameter. Can be 'query' or 'header'.
+       */
+      in: 'query' | 'header';
 
-  body?: unknown;
+      /**
+       * The name of the parameter. For example, 'x-api-key', 'Content-Type', etc.
+       */
+      name: string;
 
-  connected_account_id?: string;
+      /**
+       * The value of the parameter. For example, '1234567890', 'application/json', etc.
+       */
+      value: string | number;
+    }
+  }
 
-  parameters?: Array<ToolProxyParams.Parameter>;
-}
+  export interface UnionMember0 {
+    authScheme: 'OAUTH2';
 
-export namespace ToolProxyParams {
-  export interface Parameter {
-    name: string;
+    toolkitSlug: string;
 
-    type: 'header' | 'query';
+    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 ToolGetInputParams {
+  /**
+   * Natural language description of what you want to accomplish with this tool
+   */
+  text: string;
+
+  /**
+   * Custom description of the tool to help guide the LLM in generating more accurate
+   * inputs
+   */
+  custom_description?: string;
+
+  /**
+   * System prompt to control and guide the behavior of the LLM when generating
+   * inputs
+   */
+  system_prompt?: string;
+
+  /**
+   * Tool version to use when generating inputs (defaults to "latest" if not
+   * specified)
+   */
+  version?: string;
+}
+
+export interface ToolProxyParams {
+  /**
+   * 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';
+
+  /**
+   * 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?: ToolProxyParams.UnionMember0 | ToolProxyParams.UnionMember1;
+
+  /**
+   * The request body (for POST, PUT, and PATCH requests)
+   */
+  body?: unknown;
+
+  /**
+   * The ID of the connected account to use for authentication (if not provided, will
+   * use the default account for the project)
+   */
+  connected_account_id?: string;
+
+  /**
+   * @deprecated
+   */
+  custom_connection_data?:
+    | ToolProxyParams.UnionMember0
+    | ToolProxyParams.UnionMember1
+    | ToolProxyParams.UnionMember2
+    | ToolProxyParams.UnionMember3
+    | ToolProxyParams.UnionMember4
+    | ToolProxyParams.UnionMember5
+    | ToolProxyParams.UnionMember6
+    | ToolProxyParams.UnionMember7
+    | ToolProxyParams.UnionMember8
+    | ToolProxyParams.UnionMember9;
+
+  /**
+   * Additional HTTP headers or query parameters to include in the request
+   */
+  parameters?: Array<ToolProxyParams.Parameter>;
+}
+
+export namespace ToolProxyParams {
+  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 Parameter {
+    /**
+     * Parameter name
+     */
+    name: string;
+
+    /**
+     * Parameter type (header or query)
+     */
+    type: 'header' | 'query';
+
+    /**
+     * Parameter value
+     */
     value: string;
   }
 }
@@ -257,6 +2179,7 @@ export declare namespace Tools {
     type ToolGetInputResponse as ToolGetInputResponse,
     type ToolProxyResponse as ToolProxyResponse,
     type ToolRetrieveEnumResponse as ToolRetrieveEnumResponse,
+    type ToolRetrieveParams as ToolRetrieveParams,
     type ToolListParams as ToolListParams,
     type ToolExecuteParams as ToolExecuteParams,
     type ToolGetInputParams as ToolGetInputParams,