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

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

@@ -0,0 +1,1990 @@
+import { APIResource } from "../../../core/resource.js";
+import * as FilesAPI from "./files.js";
+import { FileCreateDownloadURLParams, FileCreateDownloadURLResponse, FileCreateUploadURLParams, FileCreateUploadURLResponse, FileDeleteParams, FileDeleteResponse, FileListParams, FileListResponse, Files } from "./files.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+/**
+ * (Labs) Tool router endpoints
+ */
+export declare class Session extends APIResource {
+    files: FilesAPI.Files;
+    /**
+     * Creates a new session for the tool router feature. This endpoint initializes a
+     * new session with specified toolkits and their authentication configurations. The
+     * session provides an isolated environment for testing and managing tool routing
+     * logic with scoped MCP server access.
+     *
+     * @example
+     * ```ts
+     * const session = await client.toolRouter.session.create({
+     *   user_id: 'user_123456789',
+     * });
+     * ```
+     */
+    create(body: SessionCreateParams, options?: RequestOptions): APIPromise<SessionCreateResponse>;
+    /**
+     * Retrieves an existing tool router session by its ID. Returns the session
+     * configuration, MCP server URL, and available tools.
+     *
+     * @example
+     * ```ts
+     * const session = await client.toolRouter.session.retrieve(
+     *   'trs_123456789',
+     * );
+     * ```
+     */
+    retrieve(sessionID: string, options?: RequestOptions): APIPromise<SessionRetrieveResponse>;
+    /**
+     * Executes a specific tool within a tool router session. The toolkit is
+     * automatically inferred from the tool slug. The tool must belong to an allowed
+     * toolkit and must not be disabled in the session configuration. This endpoint
+     * validates permissions, resolves connected accounts, and executes the tool with
+     * the session context.
+     *
+     * @example
+     * ```ts
+     * const response = await client.toolRouter.session.execute(
+     *   'trs_LX9uJKBinWWr',
+     *   { tool_slug: 'GITHUB_CREATE_ISSUE' },
+     * );
+     * ```
+     */
+    execute(sessionID: string, body: SessionExecuteParams, options?: RequestOptions): APIPromise<SessionExecuteResponse>;
+    /**
+     * Executes a Composio meta tool (COMPOSIO\_\*) within a tool router session.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.toolRouter.session.executeMeta(
+     *     'trs_LX9uJKBinWWr',
+     *     { slug: 'COMPOSIO_MANAGE_CONNECTIONS' },
+     *   );
+     * ```
+     */
+    executeMeta(sessionID: string, body: SessionExecuteMetaParams, options?: RequestOptions): APIPromise<SessionExecuteMetaResponse>;
+    /**
+     * Initiates an authentication link session for a specific toolkit within a tool
+     * router session. Returns a link token and redirect URL that users can use to
+     * complete the OAuth flow.
+     *
+     * @example
+     * ```ts
+     * const response = await client.toolRouter.session.link(
+     *   'trs_LX9uJKBinWWr',
+     *   { toolkit: 'github' },
+     * );
+     * ```
+     */
+    link(sessionID: string, body: SessionLinkParams, options?: RequestOptions): APIPromise<SessionLinkResponse>;
+    /**
+     * 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>;
+    /**
+     * 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
+     * workflow guidance in a predictable format.
+     *
+     * @example
+     * ```ts
+     * const response = await client.toolRouter.session.search(
+     *   'trs_LX9uJKBinWWr',
+     *   {
+     *     queries: [
+     *       { use_case: 'Send a slack message to a channel' },
+     *     ],
+     *   },
+     * );
+     * ```
+     */
+    search(sessionID: string, body: SessionSearchParams, options?: RequestOptions): APIPromise<SessionSearchResponse>;
+    /**
+     * Retrieves a cursor-paginated list of toolkits available in the tool router
+     * session. Includes toolkit metadata, composio-managed auth schemes, and connected
+     * accounts if available. Optionally filter by specific toolkit slugs.
+     *
+     * @example
+     * ```ts
+     * const response = await client.toolRouter.session.toolkits(
+     *   'trs_123456789',
+     * );
+     * ```
+     */
+    toolkits(sessionID: string, query?: SessionToolkitsParams | null | undefined, options?: RequestOptions): APIPromise<SessionToolkitsResponse>;
+    /**
+     * Returns the meta tools available in a tool router session with their complete
+     * schemas. This includes request and response schemas specific to the session
+     * context.
+     *
+     * @example
+     * ```ts
+     * const response = await client.toolRouter.session.tools(
+     *   'session_id',
+     * );
+     * ```
+     */
+    tools(sessionID: string, query?: SessionToolsParams | null | undefined, options?: RequestOptions): APIPromise<SessionToolsResponse>;
+}
+export interface SessionCreateResponse {
+    /**
+     * The session configuration including user, toolkits, and overrides
+     */
+    config: SessionCreateResponse.Config;
+    mcp: SessionCreateResponse.Mcp;
+    /**
+     * The identifier of the session
+     */
+    session_id: string;
+    /**
+     * List of available tools in this session
+     */
+    tool_router_tools: Array<string>;
+    /**
+     * Experimental features including the generated system prompt. Only returned on
+     * session creation, not on GET.
+     */
+    experimental?: SessionCreateResponse.Experimental;
+}
+export declare namespace SessionCreateResponse {
+    /**
+     * The session configuration including user, toolkits, and overrides
+     */
+    interface Config {
+        /**
+         * User identifier for this session
+         */
+        user_id: string;
+        /**
+         * Auth config overrides per toolkit
+         */
+        auth_configs?: {
+            [key: string]: string;
+        };
+        /**
+         * Connected account overrides per toolkit
+         */
+        connected_accounts?: {
+            [key: string]: string;
+        };
+        /**
+         * Manage connections configuration
+         */
+        manage_connections?: Config.ManageConnections;
+        /**
+         * MCP tool annotation hints for filtering tools with enabled/disabled support.
+         * enabled: tags that the tool must have at least one of. disabled: tags that the
+         * tool must NOT have any of. Both conditions must be satisfied.
+         */
+        tags?: Config.Tags;
+        /**
+         * Toolkit configuration - either enabled list or disabled list
+         */
+        toolkits?: Config.Enabled | Config.Disabled;
+        /**
+         * Tool-level configuration per toolkit
+         */
+        tools?: {
+            [key: string]: Config.Enabled | Config.Disabled | Config.Tags;
+        };
+        /**
+         * Workbench configuration
+         */
+        workbench?: Config.Workbench;
+    }
+    namespace Config {
+        /**
+         * Manage connections configuration
+         */
+        interface ManageConnections {
+            /**
+             * Custom callback URL for connected account auth flows
+             */
+            callback_url?: string;
+            /**
+             * Enable the COMPOSIO_WAIT_FOR_CONNECTIONS tool for polling connection status.
+             * Default false. May not work reliably with GPT models.
+             */
+            enable_wait_for_connections?: boolean;
+            /**
+             * Whether to enable the connection manager for automatic connection handling
+             */
+            enabled?: boolean;
+        }
+        /**
+         * MCP tool annotation hints for filtering tools with enabled/disabled support.
+         * enabled: tags that the tool must have at least one of. disabled: tags that the
+         * tool must NOT have any of. Both conditions must be satisfied.
+         */
+        interface Tags {
+            /**
+             * Tags that the tool must NOT have any of
+             */
+            disabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
+            /**
+             * Tags that the tool must have at least one of
+             */
+            enabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
+        }
+        interface Enabled {
+            enabled: Array<string>;
+        }
+        interface Disabled {
+            disabled: Array<string>;
+        }
+        interface Enabled {
+            enabled: Array<string>;
+        }
+        interface Disabled {
+            disabled: Array<string>;
+        }
+        interface Tags {
+            tags: Tags.Tags;
+        }
+        namespace Tags {
+            interface Tags {
+                /**
+                 * Tags that the tool must NOT have any of
+                 */
+                disabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
+                /**
+                 * Tags that the tool must have at least one of
+                 */
+                enabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
+            }
+        }
+        /**
+         * Workbench configuration
+         */
+        interface Workbench {
+            /**
+             * Character threshold after which tool execution response are saved to a file in
+             * workbench. Default is 20k.
+             */
+            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
+             */
+            proxy_execution_enabled?: boolean;
+        }
+    }
+    interface Mcp {
+        /**
+         * The type of the MCP server. Can be http
+         */
+        type: 'http';
+        /**
+         * The URL of the MCP server
+         */
+        url: string;
+    }
+    /**
+     * Experimental features including the generated system prompt. Only returned on
+     * session creation, not on GET.
+     */
+    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>;
+    }
+    namespace Experimental {
+        interface CustomToolkit {
+            description: string;
+            name: string;
+            slug: string;
+            tools: Array<CustomToolkit.Tool>;
+        }
+        namespace CustomToolkit {
+            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;
+                };
+            }
+        }
+        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 SessionRetrieveResponse {
+    /**
+     * The session configuration including user, toolkits, and overrides
+     */
+    config: SessionRetrieveResponse.Config;
+    mcp: SessionRetrieveResponse.Mcp;
+    /**
+     * The identifier of the session
+     */
+    session_id: string;
+    /**
+     * List of available tools in this session
+     */
+    tool_router_tools: Array<string>;
+    /**
+     * Experimental features
+     */
+    experimental?: SessionRetrieveResponse.Experimental;
+}
+export declare namespace SessionRetrieveResponse {
+    /**
+     * The session configuration including user, toolkits, and overrides
+     */
+    interface Config {
+        /**
+         * User identifier for this session
+         */
+        user_id: string;
+        /**
+         * Auth config overrides per toolkit
+         */
+        auth_configs?: {
+            [key: string]: string;
+        };
+        /**
+         * Connected account overrides per toolkit
+         */
+        connected_accounts?: {
+            [key: string]: string;
+        };
+        /**
+         * Manage connections configuration
+         */
+        manage_connections?: Config.ManageConnections;
+        /**
+         * MCP tool annotation hints for filtering tools with enabled/disabled support.
+         * enabled: tags that the tool must have at least one of. disabled: tags that the
+         * tool must NOT have any of. Both conditions must be satisfied.
+         */
+        tags?: Config.Tags;
+        /**
+         * Toolkit configuration - either enabled list or disabled list
+         */
+        toolkits?: Config.Enabled | Config.Disabled;
+        /**
+         * Tool-level configuration per toolkit
+         */
+        tools?: {
+            [key: string]: Config.Enabled | Config.Disabled | Config.Tags;
+        };
+        /**
+         * Workbench configuration
+         */
+        workbench?: Config.Workbench;
+    }
+    namespace Config {
+        /**
+         * Manage connections configuration
+         */
+        interface ManageConnections {
+            /**
+             * Custom callback URL for connected account auth flows
+             */
+            callback_url?: string;
+            /**
+             * Enable the COMPOSIO_WAIT_FOR_CONNECTIONS tool for polling connection status.
+             * Default false. May not work reliably with GPT models.
+             */
+            enable_wait_for_connections?: boolean;
+            /**
+             * Whether to enable the connection manager for automatic connection handling
+             */
+            enabled?: boolean;
+        }
+        /**
+         * MCP tool annotation hints for filtering tools with enabled/disabled support.
+         * enabled: tags that the tool must have at least one of. disabled: tags that the
+         * tool must NOT have any of. Both conditions must be satisfied.
+         */
+        interface Tags {
+            /**
+             * Tags that the tool must NOT have any of
+             */
+            disabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
+            /**
+             * Tags that the tool must have at least one of
+             */
+            enabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
+        }
+        interface Enabled {
+            enabled: Array<string>;
+        }
+        interface Disabled {
+            disabled: Array<string>;
+        }
+        interface Enabled {
+            enabled: Array<string>;
+        }
+        interface Disabled {
+            disabled: Array<string>;
+        }
+        interface Tags {
+            tags: Tags.Tags;
+        }
+        namespace Tags {
+            interface Tags {
+                /**
+                 * Tags that the tool must NOT have any of
+                 */
+                disabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
+                /**
+                 * Tags that the tool must have at least one of
+                 */
+                enabled?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
+            }
+        }
+        /**
+         * Workbench configuration
+         */
+        interface Workbench {
+            /**
+             * Character threshold after which tool execution response are saved to a file in
+             * workbench. Default is 20k.
+             */
+            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
+             */
+            proxy_execution_enabled?: boolean;
+        }
+    }
+    interface Mcp {
+        /**
+         * The type of the MCP server. Can be http
+         */
+        type: 'http';
+        /**
+         * The URL of the MCP server
+         */
+        url: string;
+    }
+    /**
+     * Experimental features
+     */
+    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>;
+    }
+    namespace Experimental {
+        interface CustomToolkit {
+            description: string;
+            name: string;
+            slug: string;
+            tools: Array<CustomToolkit.Tool>;
+        }
+        namespace CustomToolkit {
+            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;
+                };
+            }
+        }
+        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 {
+    /**
+     * The data returned by the tool execution
+     */
+    data: {
+        [key: string]: unknown;
+    };
+    /**
+     * Error message if the execution failed, null otherwise
+     */
+    error: string | null;
+    /**
+     * Unique identifier for the execution log
+     */
+    log_id: string;
+}
+export interface SessionExecuteMetaResponse {
+    /**
+     * The data returned by the tool execution
+     */
+    data: {
+        [key: string]: unknown;
+    };
+    /**
+     * Error message if the execution failed, null otherwise
+     */
+    error: string | null;
+    /**
+     * Unique identifier for the execution log
+     */
+    log_id: string;
+}
+export interface SessionLinkResponse {
+    /**
+     * The unique identifier for the connected account
+     */
+    connected_account_id: string;
+    /**
+     * Token used to complete the authentication flow
+     */
+    link_token: string;
+    /**
+     * The URL where users should be redirected to complete OAuth
+     */
+    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 declare namespace SessionProxyExecuteResponse {
+    /**
+     * Binary body response data. Present when the response is a binary file.
+     */
+    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
+     * searches failed, reasons: <details>"
+     */
+    error: string | null;
+    /**
+     * Combined workflow guidance covering connections, planner, and memory usage. Each
+     * element is a step instruction.
+     */
+    next_steps_guidance: Array<string>;
+    /**
+     * Per-query search results with tools, reasoning, and memory. One entry per query
+     * in request order.
+     */
+    results: Array<SessionSearchResponse.Result>;
+    /**
+     * Session info for correlating meta tool calls
+     */
+    session: SessionSearchResponse.Session;
+    /**
+     * Whether all searches completed successfully. False if any query failed.
+     */
+    success: boolean;
+    /**
+     * Time information for the query
+     */
+    time_info: SessionSearchResponse.TimeInfo;
+    /**
+     * Deduplicated tool definitions keyed by tool_slug for O(1) lookup. Each tool
+     * appears once even if used in multiple queries.
+     */
+    tool_schemas: {
+        [key: string]: SessionSearchResponse.ToolSchemas;
+    };
+    /**
+     * Connection status for all toolkits mentioned across all queries, with
+     * descriptions merged in.
+     */
+    toolkit_connection_statuses: Array<SessionSearchResponse.ToolkitConnectionStatus>;
+}
+export declare namespace SessionSearchResponse {
+    interface Result {
+        /**
+         * 1-based index of the query in the request
+         */
+        index: number;
+        /**
+         * List of main tool slugs matching the search criteria
+         */
+        primary_tool_slugs: Array<string>;
+        /**
+         * List of related tool slugs that might be useful
+         */
+        related_tool_slugs: Array<string>;
+        /**
+         * List of unique toolkit slugs used by tools in this query
+         */
+        toolkits: Array<string>;
+        /**
+         * The use case that was searched
+         */
+        use_case: string;
+        /**
+         * Task difficulty assessment (e.g., "easy - Simple single-tool operation with
+         * known parameters")
+         */
+        difficulty?: string;
+        /**
+         * Error message if the search for this query failed, null otherwise. Always
+         * present for failed queries.
+         */
+        error?: string | null;
+        /**
+         * Guidance message about the search results, particularly when a cached plan is
+         * available
+         */
+        execution_guidance?: string;
+        /**
+         * Common pitfalls and considerations (only present when cached plan is available)
+         */
+        known_pitfalls?: Array<string>;
+        /**
+         * Memory data relevant to this query, grouped by app. Only present for non-cached
+         * search results.
+         */
+        memory?: {
+            [key: string]: Array<string>;
+        };
+        /**
+         * ID of cached plan if available
+         */
+        plan_id?: string;
+        /**
+         * Workflow steps from cached plan (only present when cached plan is available)
+         */
+        recommended_plan_steps?: Array<string>;
+        /**
+         * Reference Python code snippets for processing tool responses in the workbench
+         * (only present when cached plan is available)
+         */
+        reference_workbench_snippets?: Array<Result.ReferenceWorkbenchSnippet>;
+    }
+    namespace Result {
+        interface ReferenceWorkbenchSnippet {
+            /**
+             * Python code snippet for the workbench
+             */
+            code: string;
+            /**
+             * Description of what the code snippet does
+             */
+            description: string;
+        }
+    }
+    /**
+     * Session info for correlating meta tool calls
+     */
+    interface Session {
+        /**
+         * Session identifier to be passed to subsequent meta tool calls as session_id.
+         */
+        id: string;
+        /**
+         * Whether a fresh session id was generated in this call.
+         */
+        generate_id: boolean;
+        /**
+         * LLM-facing guidance on how to reuse this session id
+         */
+        instructions: string;
+    }
+    /**
+     * Time information for the query
+     */
+    interface TimeInfo {
+        /**
+         * Current time in ISO format (UTC)
+         */
+        current_time_utc: string;
+        /**
+         * Current time as Unix epoch timestamp in seconds
+         */
+        current_time_utc_epoch_seconds: number;
+        /**
+         * Important message about time handling and timezone considerations
+         */
+        message: string;
+    }
+    interface ToolSchemas {
+        /**
+         * The slug of the tool
+         */
+        tool_slug: string;
+        /**
+         * The slug of the toolkit that provides this tool
+         */
+        toolkit: string;
+        /**
+         * Description of the tool
+         */
+        description?: string;
+        /**
+         * Whether the full input_schema is included in this response
+         */
+        hasFullSchema?: boolean;
+        /**
+         * Input schema for the tool (only present when hasFullSchema is true)
+         */
+        input_schema?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Output/response schema for the tool
+         */
+        output_schema?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Reference to fetch full schema when hasFullSchema is false
+         */
+        schemaRef?: ToolSchemas.SchemaRef;
+    }
+    namespace ToolSchemas {
+        /**
+         * Reference to fetch full schema when hasFullSchema is false
+         */
+        interface SchemaRef {
+            /**
+             * Arguments to pass to the tool
+             */
+            args: SchemaRef.Args;
+            /**
+             * Instruction message for the LLM
+             */
+            message: string;
+            /**
+             * Tool to call
+             */
+            tool: 'COMPOSIO_GET_TOOL_SCHEMAS';
+        }
+        namespace SchemaRef {
+            /**
+             * Arguments to pass to the tool
+             */
+            interface Args {
+                /**
+                 * Tool slugs to fetch schemas for
+                 */
+                tool_slugs: Array<string>;
+            }
+        }
+    }
+    interface ToolkitConnectionStatus {
+        /**
+         * Description of what the toolkit does and its capabilities
+         */
+        description: string;
+        /**
+         * Whether an active connection exists for this toolkit
+         */
+        has_active_connection: boolean;
+        /**
+         * Human-readable message about the connection status and next steps
+         */
+        status_message: string;
+        /**
+         * The toolkit slug identifier (e.g., "gmail", "slack")
+         */
+        toolkit: string;
+        /**
+         * Connection details including auth config and connected account IDs. Only present
+         * when has_active_connection is true.
+         */
+        connection_details?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Information about the currently connected user (email, name, etc.)
+         */
+        current_user_info?: {
+            [key: string]: unknown;
+        };
+    }
+}
+export interface SessionToolkitsResponse {
+    current_page: number;
+    items: Array<SessionToolkitsResponse.Item>;
+    total_items: number;
+    total_pages: number;
+    next_cursor?: string | null;
+}
+export declare namespace SessionToolkitsResponse {
+    interface Item {
+        /**
+         * Available Composio-managed auth schemes
+         */
+        composio_managed_auth_schemes: Array<string>;
+        /**
+         * Connected account if available
+         */
+        connected_account: Item.ConnectedAccount | null;
+        /**
+         * Whether the toolkit is enabled
+         */
+        enabled: boolean;
+        /**
+         * Whether the toolkit is no-auth
+         */
+        is_no_auth: boolean;
+        /**
+         * Toolkit metadata
+         */
+        meta: Item.Meta;
+        /**
+         * Display name of the toolkit
+         */
+        name: string;
+        /**
+         * Unique slug identifier
+         */
+        slug: string;
+    }
+    namespace Item {
+        /**
+         * Connected account if available
+         */
+        interface ConnectedAccount {
+            /**
+             * Connected account identifier
+             */
+            id: string;
+            /**
+             * Auth config details
+             */
+            auth_config: ConnectedAccount.AuthConfig;
+            /**
+             * Creation timestamp
+             */
+            created_at: string;
+            /**
+             * Connection status
+             */
+            status: string;
+            /**
+             * User identifier
+             */
+            user_id: string;
+        }
+        namespace ConnectedAccount {
+            /**
+             * Auth config details
+             */
+            interface AuthConfig {
+                /**
+                 * Auth config identifier
+                 */
+                id: string;
+                /**
+                 * Authentication scheme type
+                 */
+                auth_scheme: string;
+                /**
+                 * Whether this is a Composio-managed auth config
+                 */
+                is_composio_managed: boolean;
+            }
+        }
+        /**
+         * Toolkit metadata
+         */
+        interface Meta {
+            /**
+             * Description of the toolkit
+             */
+            description: string;
+            /**
+             * URL to the toolkit logo
+             */
+            logo: string;
+        }
+    }
+}
+export interface SessionToolsResponse {
+    /**
+     * List of tools with their complete schemas
+     */
+    items: Array<SessionToolsResponse.Item>;
+}
+export declare namespace SessionToolsResponse {
+    interface Item {
+        /**
+         * 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;
+        /**
+         * 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;
+        /**
+         * 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: Item.Toolkit;
+        /**
+         * Current version of the tool
+         */
+        version: string;
+        /**
+         * Human-friendly description of the tool, if available
+         */
+        human_description?: string;
+    }
+    namespace Item {
+        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;
+        }
+        namespace Deprecated {
+            interface Toolkit {
+                /**
+                 * URL to the toolkit logo image
+                 */
+                logo: string;
+            }
+        }
+        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 SessionCreateParams {
+    /**
+     * The identifier of the user who is initiating the session, ideally a unique
+     * identifier from your database like a user ID or email address
+     */
+    user_id: string;
+    /**
+     * The auth configs to use for the session. This will override the default behavior
+     * and use the given auth config when specific toolkits are being executed
+     */
+    auth_configs?: {
+        [key: string]: string;
+    };
+    /**
+     * The connected accounts to use for the session. This will override the default
+     * behaviour and use the given connected account when specific toolkits are being
+     * executed
+     */
+    connected_accounts?: {
+        [key: string]: string;
+    };
+    /**
+     * Experimental features - not stable, may be modified or removed in future
+     * versions.
+     */
+    experimental?: SessionCreateParams.Experimental;
+    /**
+     * Configuration for connection management settings
+     */
+    manage_connections?: SessionCreateParams.ManageConnections;
+    /**
+     * Global MCP tool annotation hints for filtering. Array format is treated as
+     * enabled list. Object format supports both enabled (tool must have at least one)
+     * and disabled (tool must NOT have any) lists. Toolkit-level tags override this.
+     * Toolkit enabled/disabled lists take precedence over tag filtering.
+     */
+    tags?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'> | SessionCreateParams.UnionMember1;
+    /**
+     * Toolkit configuration - specify either enable toolkits (allowlist) or disable
+     * toolkits (denylist). Mutually exclusive.
+     */
+    toolkits?: SessionCreateParams.Enable | SessionCreateParams.Disable;
+    /**
+     * Tool-level configuration per toolkit - either specify enable tools (whitelist),
+     * disable tools (blacklist), or filter by MCP tags for each toolkit
+     */
+    tools?: {
+        [key: string]: SessionCreateParams.Enable | SessionCreateParams.Disable | SessionCreateParams.Tags;
+    };
+    /**
+     * Configuration for workbench behavior
+     */
+    workbench?: SessionCreateParams.Workbench;
+}
+export declare namespace SessionCreateParams {
+    /**
+     * Experimental features - not stable, may be modified or removed in future
+     * versions.
+     */
+    interface Experimental {
+        /**
+         * 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>;
+    }
+    namespace Experimental {
+        /**
+         * Customize assistive prompt generation (e.g., timezone).
+         */
+        interface AssistivePromptConfig {
+            /**
+             * IANA timezone identifier (e.g., 'America/New_York', 'Europe/London'). Used to
+             * customize the system prompt with timezone-aware instructions.
+             */
+            user_timezone?: string;
+        }
+        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>;
+        }
+        namespace CustomToolkit {
+            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;
+                };
+            }
+        }
+        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
+     */
+    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;
+        /**
+         * 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;
+    }
+    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)
+     */
+    interface Enable {
+        /**
+         * Only these specific toolkits will be enabled
+         */
+        enable: Array<string>;
+    }
+    /**
+     * Disable specific toolkits (denylist)
+     */
+    interface Disable {
+        /**
+         * These specific toolkits will be disabled
+         */
+        disable: Array<string>;
+    }
+    interface Enable {
+        /**
+         * Only these specific tools will be available for this toolkit
+         */
+        enable: Array<string>;
+    }
+    interface Disable {
+        /**
+         * These specific tools will be disabled for this toolkit
+         */
+        disable: Array<string>;
+    }
+    interface Tags {
+        /**
+         * MCP tags to filter tools. Array format is treated as enabled list. Object format
+         * supports both enabled and disabled lists.
+         */
+        tags: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'> | Tags.UnionMember1;
+    }
+    namespace Tags {
+        interface UnionMember1 {
+            /**
+             * Tags that the tool must NOT have any of
+             */
+            disable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
+            /**
+             * Tags that the tool must have at least one of
+             */
+            enable?: Array<'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>;
+        }
+    }
+    /**
+     * Configuration for workbench behavior
+     */
+    interface Workbench {
+        /**
+         * Character threshold for automatic offloading. When workbench response exceeds
+         * this threshold, it will be automatically offloaded. Default is picked
+         * automatically based on the response size.
+         */
+        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.
+         */
+        enable_proxy_execution?: boolean;
+    }
+}
+export interface SessionExecuteParams {
+    /**
+     * The unique slug identifier of the tool to execute
+     */
+    tool_slug: string;
+    /**
+     * The arguments required by the tool
+     */
+    arguments?: {
+        [key: string]: unknown;
+    };
+}
+export interface SessionExecuteMetaParams {
+    /**
+     * The unique slug identifier of the meta tool to execute
+     */
+    slug: 'COMPOSIO_SEARCH_TOOLS' | 'COMPOSIO_MULTI_EXECUTE_TOOL' | 'COMPOSIO_MANAGE_CONNECTIONS' | 'COMPOSIO_WAIT_FOR_CONNECTIONS' | 'COMPOSIO_REMOTE_WORKBENCH' | 'COMPOSIO_REMOTE_BASH_TOOL' | 'COMPOSIO_GET_TOOL_SCHEMAS' | 'COMPOSIO_UPSERT_RECIPE' | 'COMPOSIO_GET_RECIPE';
+    /**
+     * The arguments required by the meta tool
+     */
+    arguments?: {
+        [key: string]: unknown;
+    };
+}
+export interface SessionLinkParams {
+    /**
+     * The unique slug identifier of the toolkit to connect
+     */
+    toolkit: string;
+    /**
+     * URL where users will be redirected after completing auth
+     */
+    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 declare namespace SessionProxyExecuteParams {
+    interface UnionMember0 {
+        /**
+         * URL to fetch binary content from
+         */
+        url: string;
+        /**
+         * Content-Type header to use for the request
+         */
+        content_type?: string;
+    }
+    interface UnionMember1 {
+        /**
+         * Base64-encoded binary data
+         */
+        base64: string;
+        /**
+         * Content-Type header to use for the request
+         */
+        content_type?: string;
+    }
+    interface UnionMember0 {
+        authScheme: 'OAUTH2';
+        toolkitSlug: string;
+        val: UnionMember0.Val;
+    }
+    namespace UnionMember0 {
+        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;
+        }
+        namespace Val {
+            /**
+             * for slack user scopes
+             */
+            interface AuthedUser {
+                access_token?: string;
+                scope?: string;
+            }
+        }
+    }
+    interface UnionMember1 {
+        authScheme: 'DCR_OAUTH';
+        toolkitSlug: string;
+        val: UnionMember1.Val;
+    }
+    namespace UnionMember1 {
+        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;
+        }
+    }
+    interface UnionMember2 {
+        authScheme: 'API_KEY';
+        toolkitSlug: string;
+        val: UnionMember2.Val;
+    }
+    namespace UnionMember2 {
+        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;
+        }
+    }
+    interface UnionMember3 {
+        authScheme: 'BASIC_WITH_JWT';
+        toolkitSlug: string;
+        val: UnionMember3.Val;
+    }
+    namespace UnionMember3 {
+        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;
+        }
+    }
+    interface UnionMember4 {
+        authScheme: 'BASIC';
+        toolkitSlug: string;
+        val: UnionMember4.Val;
+    }
+    namespace UnionMember4 {
+        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;
+        }
+    }
+    interface UnionMember5 {
+        authScheme: 'BEARER_TOKEN';
+        toolkitSlug: string;
+        val: UnionMember5.Val;
+    }
+    namespace UnionMember5 {
+        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;
+        }
+    }
+    interface UnionMember6 {
+        authScheme: 'OAUTH1';
+        toolkitSlug: string;
+        val: UnionMember6.Val;
+    }
+    namespace UnionMember6 {
+        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;
+        }
+    }
+    interface UnionMember7 {
+        authScheme: 'NO_AUTH';
+        toolkitSlug: string;
+        val: UnionMember7.Val;
+    }
+    namespace UnionMember7 {
+        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;
+        }
+    }
+    interface UnionMember8 {
+        authScheme: 'SERVICE_ACCOUNT';
+        toolkitSlug: string;
+        val: UnionMember8.Val;
+    }
+    namespace UnionMember8 {
+        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;
+        }
+    }
+    interface UnionMember9 {
+        authScheme: 'GOOGLE_SERVICE_ACCOUNT';
+        toolkitSlug: string;
+        val: UnionMember9.Val;
+    }
+    namespace UnionMember9 {
+        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;
+        }
+    }
+    interface UnionMember10 {
+        authScheme: 'S2S_OAUTH2';
+        toolkitSlug: string;
+        val: UnionMember10.Val;
+    }
+    namespace UnionMember10 {
+        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;
+        }
+    }
+    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.
+     */
+    queries: Array<SessionSearchParams.Query>;
+    /**
+     * Optional model hint for search/planning behavior (e.g., "gpt-4o"). Ignored if
+     * invalid.
+     */
+    model?: string;
+}
+export declare namespace SessionSearchParams {
+    interface Query {
+        /**
+         * The task or use case to search tools for. Provide a detailed description to get
+         * the best results.
+         */
+        use_case: string;
+        /**
+         * Known field hints as key:value pairs (e.g., "channel_name:general,
+         * user_email:john@example.com")
+         */
+        known_fields?: string;
+    }
+}
+export interface SessionToolkitsParams {
+    /**
+     * 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 connected toolkits. If provided, only connected toolkits
+     * will be returned.
+     */
+    is_connected?: boolean | null;
+    /**
+     * Number of items per page, max allowed is 1000
+     */
+    limit?: number | null;
+    /**
+     * Search query to filter toolkits by name, slug, or description
+     */
+    search?: string;
+    /**
+     * Optional comma-separated list of toolkit slugs to filter by. If provided, only
+     * these toolkits will be returned, overriding the session configuration.
+     */
+    toolkits?: Array<string> | null;
+}
+export interface SessionToolsParams {
+}
+export declare namespace Session {
+    export { type SessionCreateResponse as SessionCreateResponse, type SessionRetrieveResponse as SessionRetrieveResponse, 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, type SessionCreateParams as SessionCreateParams, 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, };
+    export { Files as Files, type FileListResponse as FileListResponse, type FileDeleteResponse as FileDeleteResponse, type FileCreateDownloadURLResponse as FileCreateDownloadURLResponse, type FileCreateUploadURLResponse as FileCreateUploadURLResponse, type FileListParams as FileListParams, type FileDeleteParams as FileDeleteParams, type FileCreateDownloadURLParams as FileCreateDownloadURLParams, type FileCreateUploadURLParams as FileCreateUploadURLParams, };
+}
+//# sourceMappingURL=session.d.ts.map