@composio/client 0.1.0-alpha.52 → 0.1.0-alpha.54

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

@@ -124,6 +124,26 @@ export class Session extends APIResource {
   ): APIPromise<SessionToolkitsResponse> {
     return this._client.get(path`/api/v3/tool_router/session/${sessionID}/toolkits`, { query, ...options });
   }
+
+  /**
+   * 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> {
+    return this._client.get(path`/api/v3/tool_router/session/${sessionID}/tools`, options);
+  }
 }
 
 export interface SessionCreateResponse {
@@ -142,14 +162,7 @@ export interface SessionCreateResponse {
   /**
    * List of available tools in this session
    */
-  tool_router_tools: Array<
-    | 'COMPOSIO_SEARCH_TOOLS'
-    | 'COMPOSIO_MULTI_EXECUTE_TOOL'
-    | 'COMPOSIO_MANAGE_CONNECTIONS'
-    | 'COMPOSIO_REMOTE_WORKBENCH'
-    | 'COMPOSIO_REMOTE_BASH_TOOL'
-    | 'COMPOSIO_GET_TOOL_SCHEMAS'
-  >;
+  tool_router_tools: Array<string>;
 }
 
 export namespace SessionCreateResponse {
@@ -210,6 +223,12 @@ export namespace SessionCreateResponse {
        */
       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
        */
@@ -313,14 +332,7 @@ export interface SessionRetrieveResponse {
   /**
    * List of available tools in this session
    */
-  tool_router_tools: Array<
-    | 'COMPOSIO_SEARCH_TOOLS'
-    | 'COMPOSIO_MULTI_EXECUTE_TOOL'
-    | 'COMPOSIO_MANAGE_CONNECTIONS'
-    | 'COMPOSIO_REMOTE_WORKBENCH'
-    | 'COMPOSIO_REMOTE_BASH_TOOL'
-    | 'COMPOSIO_GET_TOOL_SCHEMAS'
-  >;
+  tool_router_tools: Array<string>;
 }
 
 export namespace SessionRetrieveResponse {
@@ -381,6 +393,12 @@ export namespace SessionRetrieveResponse {
        */
       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
        */
@@ -639,6 +657,128 @@ export namespace SessionToolkitsResponse {
   }
 }
 
+export interface SessionToolsResponse {
+  /**
+   * List of tools with their complete schemas
+   */
+  items: Array<SessionToolsResponse.Item>;
+}
+
+export namespace SessionToolsResponse {
+  export 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;
+  }
+
+  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 {
+      /**
+       * 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
@@ -712,6 +852,13 @@ export namespace SessionCreateParams {
      * 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;
   }
 
   export interface UnionMember1 {
@@ -821,9 +968,12 @@ export interface SessionExecuteMetaParams {
     | '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_GET_TOOL_SCHEMAS'
+    | 'COMPOSIO_UPSERT_RECIPE'
+    | 'COMPOSIO_GET_RECIPE';
 
   /**
    * The arguments required by the meta tool
@@ -875,6 +1025,8 @@ export interface SessionToolkitsParams {
   toolkits?: Array<string> | null;
 }
 
+export interface SessionToolsParams {}
+
 export declare namespace Session {
   export {
     type SessionCreateResponse as SessionCreateResponse,
@@ -883,10 +1035,12 @@ export declare namespace Session {
     type SessionExecuteMetaResponse as SessionExecuteMetaResponse,
     type SessionLinkResponse as SessionLinkResponse,
     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 SessionToolkitsParams as SessionToolkitsParams,
+    type SessionToolsParams as SessionToolsParams,
   };
 }

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

@@ -15,115 +15,17 @@ import {
   SessionRetrieveResponse,
   SessionToolkitsParams,
   SessionToolkitsResponse,
+  SessionToolsParams,
+  SessionToolsResponse,
 } from './session';
-import { APIPromise } from '../../core/api-promise';
-import { RequestOptions } from '../../internal/request-options';
 
 export class ToolRouter extends APIResource {
   session: SessionAPI.Session = new SessionAPI.Session(this._client);
-
-  /**
-   * Creates a new session for the tool router lab feature (Legacy). 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 response = await client.toolRouter.createSession({
-   *   user_id: 'user_123456789',
-   *   config: {
-   *     toolkits: [
-   *       {
-   *         toolkit: 'gmail',
-   *         auth_config_id: 'auth_config_123',
-   *       },
-   *       {
-   *         toolkit: 'slack',
-   *         auth_config_id: 'auth_config_456',
-   *       },
-   *       { toolkit: 'github' },
-   *     ],
-   *   },
-   * });
-   * ```
-   */
-  createSession(
-    body: ToolRouterCreateSessionParams,
-    options?: RequestOptions,
-  ): APIPromise<ToolRouterCreateSessionResponse> {
-    return this._client.post('/api/v3/labs/tool_router/session', { body, ...options });
-  }
-}
-
-export interface ToolRouterCreateSessionResponse {
-  /**
-   * MCP server endpoint URL for this specific chat session
-   */
-  chat_session_mcp_url: string;
-
-  /**
-   * Generated session identifier
-   */
-  session_id: string;
-
-  /**
-   * MCP server endpoint URL for this specific tool router instance
-   */
-  tool_router_instance_mcp_url: string;
-}
-
-export interface ToolRouterCreateSessionParams {
-  /**
-   * Unique user identifier for the session owner
-   */
-  user_id: string;
-
-  /**
-   * Session configuration including enabled toolkits and their auth configs
-   */
-  config?: ToolRouterCreateSessionParams.Config;
-}
-
-export namespace ToolRouterCreateSessionParams {
-  /**
-   * Session configuration including enabled toolkits and their auth configs
-   */
-  export interface Config {
-    /**
-     * Whether to manually manage connections
-     */
-    manually_manage_connections?: boolean | null;
-
-    /**
-     * Array of toolkit configurations with optional auth configs
-     */
-    toolkits?: Array<Config.Toolkit>;
-  }
-
-  export namespace Config {
-    export interface Toolkit {
-      /**
-       * Toolkit identifier (e.g., gmail, slack, github)
-       */
-      toolkit: string;
-
-      /**
-       * Specific auth configuration ID for this toolkit
-       */
-      auth_config_id?: string;
-    }
-  }
 }
 
 ToolRouter.Session = Session;
 
 export declare namespace ToolRouter {
-  export {
-    type ToolRouterCreateSessionResponse as ToolRouterCreateSessionResponse,
-    type ToolRouterCreateSessionParams as ToolRouterCreateSessionParams,
-  };
-
   export {
     Session as Session,
     type SessionCreateResponse as SessionCreateResponse,
@@ -132,10 +34,12 @@ export declare namespace ToolRouter {
     type SessionExecuteMetaResponse as SessionExecuteMetaResponse,
     type SessionLinkResponse as SessionLinkResponse,
     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 SessionToolkitsParams as SessionToolkitsParams,
+    type SessionToolsParams as SessionToolsParams,
   };
 }

package/src/resources/tools.ts

@@ -399,6 +399,11 @@ export interface ToolProxyResponse {
    */
   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
    */
@@ -410,6 +415,33 @@ export interface ToolProxyResponse {
   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;
+  }
+}
+
 /**
  * JSON string containing all tool enum values from latest version of each toolkit
  */
@@ -1323,6 +1355,13 @@ export interface ToolProxyParams {
    */
   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)
    */
@@ -1356,6 +1395,30 @@ export interface ToolProxyParams {
 }
 
 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';
 

package/src/resources/trigger-instances/trigger-instances.ts

@@ -81,7 +81,8 @@ export namespace TriggerInstanceListActiveResponse {
     disabled_at: string | null;
 
     /**
-     * ID of the user who disabled the trigger instance, if applicable
+     * @deprecated DEPRECATED: This parameter will be removed in a future version.
+     * Please use disabled_at instead.
      */
     disabledAt: string | null;
 
@@ -245,7 +246,8 @@ export interface TriggerInstanceListActiveParams {
   trigger_ids?: Array<string> | null;
 
   /**
-   * Array of trigger names to filter triggers by
+   * Array of trigger names to filter triggers by. Case-insensitive (internally
+   * normalized to uppercase).
    */
   trigger_names?: Array<string> | null;
 
@@ -260,6 +262,11 @@ export interface TriggerInstanceListActiveParams {
    * trigger_names instead.
    */
   triggerNames?: Array<string> | null;
+
+  /**
+   * Array of user IDs to filter triggers by
+   */
+  user_ids?: Array<string> | null;
 }
 
 export interface TriggerInstanceUpsertParams {

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.0-alpha.52'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.54'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.52";
+export declare const VERSION = "0.1.0-alpha.54";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.52";
+export declare const VERSION = "0.1.0-alpha.54";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.1.0-alpha.52'; // x-release-please-version
+exports.VERSION = '0.1.0-alpha.54'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.1.0-alpha.52'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.54'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map