@composio/client 0.1.0-alpha.56 → 0.1.0-alpha.57

package/src/resources/cli.ts

@@ -1,122 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../core/resource';
-import { APIPromise } from '../core/api-promise';
-import { RequestOptions } from '../internal/request-options';
-
-export class Cli extends APIResource {
-  /**
-   * Generates a new CLI session with a random 6-character code. This endpoint is the
-   * first step in the CLI authentication flow, creating a session that can later be
-   * linked to a user account. The generated code is displayed to the user in the CLI
-   * and should be entered in the web interface to complete authentication.
-   */
-  createSession(options?: RequestOptions): APIPromise<CliCreateSessionResponse> {
-    return this._client.post('/api/v3/cli/create-session', options);
-  }
-
-  /**
-   * Retrieves the current state of a CLI session using either the session ID (UUID)
-   * or the 6-character code. This endpoint is used by both the CLI client to check
-   * if the session has been linked, and by the web interface to display session
-   * details before linking.
-   */
-  getSession(query: CliGetSessionParams, options?: RequestOptions): APIPromise<CliGetSessionResponse> {
-    return this._client.get('/api/v3/cli/get-session', { query, ...options });
-  }
-}
-
-export interface CliCreateSessionResponse {
-  /**
-   * Unique identifier for the CLI session. UUID v4 format used for tracking and
-   * retrieval.
-   */
-  id: string;
-
-  /**
-   * The 6-character hexadecimal code used for CLI login
-   */
-  code: string;
-
-  /**
-   * The ISO timestamp when the session expires
-   */
-  expiresAt: string;
-
-  /**
-   * The current status of the session
-   */
-  status: 'pending' | 'linked';
-}
-
-export interface CliGetSessionResponse {
-  /**
-   * The unique identifier for the CLI session
-   */
-  id: string;
-
-  /**
-   * Information about the linked account, if any. Null if the session status is
-   * "pending".
-   */
-  account: CliGetSessionResponse.Account | null;
-
-  /**
-   * The API key for the linked account
-   */
-  api_key: string | null;
-
-  /**
-   * The 6-character hexadecimal code used for CLI login
-   */
-  code: string;
-
-  /**
-   * The ISO timestamp when the session expires
-   */
-  expiresAt: string;
-
-  /**
-   * The current status of the session
-   */
-  status: 'pending' | 'linked';
-}
-
-export namespace CliGetSessionResponse {
-  /**
-   * Information about the linked account, if any. Null if the session status is
-   * "pending".
-   */
-  export interface Account {
-    /**
-     * The ID of the linked account
-     */
-    id: string;
-
-    /**
-     * The email address of the linked account
-     */
-    email: string;
-
-    /**
-     * The display name of the linked account
-     */
-    name: string;
-  }
-}
-
-export interface CliGetSessionParams {
-  /**
-   * CLI session ID (UUID format) or 6-character code to check. Both formats are
-   * supported for flexibility in client implementations.
-   */
-  id: string;
-}
-
-export declare namespace Cli {
-  export {
-    type CliCreateSessionResponse as CliCreateSessionResponse,
-    type CliGetSessionResponse as CliGetSessionResponse,
-    type CliGetSessionParams as CliGetSessionParams,
-  };
-}
+export * from './cli/index';

package/src/resources/connected-accounts.ts

@@ -7,7 +7,11 @@ import { path } from '../internal/utils/path';
 
 export class ConnectedAccounts extends APIResource {
   /**
-   * Create a new connected account
+   * Initiates a new connection to an external service for a user. For OAuth-based
+   * toolkits, this returns a redirect URL to complete authentication. For API
+   * key-based toolkits, provide the credentials directly in the request body. Use
+   * the `user_id` field to associate the connection with a specific user in your
+   * system.
    *
    * @example
    * ```ts
@@ -42,7 +46,10 @@ export class ConnectedAccounts extends APIResource {
   }
 
   /**
-   * List connected accounts with optional filters
+   * Retrieves all connected accounts for your project. Connected accounts represent
+   * authenticated user connections to external services (e.g., a user's Gmail
+   * account, Slack workspace). Filter by toolkit, status, user ID, or auth config to
+   * find specific connections.
    *
    * @example
    * ```ts
@@ -4280,7 +4287,8 @@ export namespace ConnectedAccountRetrieveResponse {
       | 'CALCOM_AUTH'
       | 'SERVICE_ACCOUNT'
       | 'SAML'
-      | 'DCR_OAUTH';
+      | 'DCR_OAUTH'
+      | 'S2S_OAUTH2';
 
     /**
      * Whether the auth config is managed by Composio
@@ -8436,7 +8444,8 @@ export namespace ConnectedAccountListResponse {
         | 'CALCOM_AUTH'
         | 'SERVICE_ACCOUNT'
         | 'SAML'
-        | 'DCR_OAUTH';
+        | 'DCR_OAUTH'
+        | 'S2S_OAUTH2';
 
       /**
        * Whether the auth config is managed by Composio

package/src/resources/index.ts

@@ -17,8 +17,9 @@ export {
   Cli,
   type CliCreateSessionResponse,
   type CliGetSessionResponse,
+  type CliCreateSessionParams,
   type CliGetSessionParams,
-} from './cli';
+} from './cli/cli';
 export {
   ConnectedAccounts,
   type ConnectedAccountCreateResponse,

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

@@ -731,11 +731,6 @@ export namespace SessionToolsResponse {
      */
     slug: string;
 
-    /**
-     * Lifecycle status of the tool
-     */
-    status: string;
-
     /**
      * List of tags associated with the tool for categorization and filtering
      */

package/src/resources/toolkits.ts

@@ -78,11 +78,6 @@ export interface ToolkitRetrieveResponse {
    */
   slug: string;
 
-  /**
-   * Lifecycle status of the toolkit
-   */
-  status: string;
-
   /**
    * Complete authentication configuration details for each supported auth method
    */
@@ -392,11 +387,6 @@ export namespace ToolkitListResponse {
      */
     slug: string;
 
-    /**
-     * Lifecycle status of the toolkit
-     */
-    status: string;
-
     /**
      * List of authentication methods supported by this toolkit
      */

package/src/resources/tools.ts

@@ -2,6 +2,7 @@
 
 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';
 
@@ -54,10 +55,18 @@ export class Tools extends APIResource {
    */
   execute(
     toolSlug: string,
-    body: ToolExecuteParams | null | undefined = {},
+    params: ToolExecuteParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<ToolExecuteResponse> {
-    return this._client.post(path`/api/v3/tools/execute/${toolSlug}`, { 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,
+      ]),
+    });
   }
 
   /**
@@ -161,11 +170,6 @@ export interface ToolRetrieveResponse {
    */
   slug: string;
 
-  /**
-   * Lifecycle status of the tool
-   */
-  status: string;
-
   /**
    * List of tags associated with the tool for categorization and filtering
    */
@@ -292,11 +296,6 @@ export namespace ToolListResponse {
      */
     slug: string;
 
-    /**
-     * Lifecycle status of the tool
-     */
-    status: string;
-
     /**
      * List of tags associated with the tool for categorization and filtering
      */
@@ -499,13 +498,20 @@ export interface ToolListParams {
    */
   limit?: number | null;
 
+  /**
+   * Full-text search query to filter tools by name, slug, or description. Applied as
+   * a soft filter on top of other filters.
+   */
+  query?: string;
+
   /**
    * Array of scopes to filter tools by)
    */
   scopes?: Array<string> | null;
 
   /**
-   * Free-text search query to find tools by name, description, or functionality
+   * Deprecated: use "query" instead. Free-text search query to find tools by name,
+   * description, or functionality.
    */
   search?: string;
 
@@ -534,28 +540,31 @@ export interface ToolListParams {
 
 export interface ToolExecuteParams {
   /**
-   * Enable debug tracing for tool execution (useful for debugging)
+   * @deprecated Body param: Deprecated. Enable debug tracing for tool execution
+   * (useful for debugging)
    */
   allow_tracing?: boolean | null;
 
   /**
-   * Key-value pairs of arguments required by the tool (mutually exclusive with text)
+   * Body param: Key-value pairs of arguments required by the tool (mutually
+   * exclusive with text)
    */
   arguments?: { [key: string]: unknown };
 
   /**
-   * Unique identifier for the connected account to use for authentication
+   * Body param: Unique identifier for the connected account to use for
+   * authentication
    */
   connected_account_id?: string;
 
   /**
-   * Custom authentication parameters for tools that support parameterized
-   * authentication
+   * Body param: Custom authentication parameters for tools that support
+   * parameterized authentication
    */
   custom_auth_params?: ToolExecuteParams.CustomAuthParams;
 
   /**
-   * Custom connection data for tools that support custom connection data
+   * Body param: Custom connection data for tools that support custom connection data
    */
   custom_connection_data?:
     | ToolExecuteParams.UnionMember0
@@ -570,26 +579,34 @@ export interface ToolExecuteParams {
     | ToolExecuteParams.UnionMember9;
 
   /**
-   * @deprecated Deprecated: please use user_id instead. Entity identifier for
-   * multi-entity connected accounts (e.g. multiple repositories, organizations)
+   * @deprecated Body param: Deprecated: please use user_id instead. Entity
+   * identifier for multi-entity connected accounts (e.g. multiple repositories,
+   * organizations)
    */
   entity_id?: string;
 
   /**
-   * Natural language description of the task to perform (mutually exclusive with
-   * arguments)
+   * Body param: Natural language description of the task to perform (mutually
+   * exclusive with arguments)
    */
   text?: string;
 
   /**
-   * User id for multi-user connected accounts (e.g. multiple users, organizations)
+   * Body param: User id for multi-user connected accounts (e.g. multiple users,
+   * organizations)
    */
   user_id?: string;
 
   /**
-   * Tool version to execute (defaults to "00000000_00" if not specified)
+   * Body param: Tool version to execute (defaults to "00000000_00" if not specified)
    */
   version?: string;
+
+  /**
+   * Header param: JSON object containing custom headers to pass to LLM providers
+   * (OpenAI, Bedrock, etc.)
+   */
+  'x-llm-gateway-headers'?: string;
 }
 
 export namespace ToolExecuteParams {

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

@@ -7,6 +7,11 @@ import { path } from '../../internal/utils/path';
 
 export class Manage extends APIResource {
   /**
+   * Updates the status of a trigger instance to enable or disable it. Disabling a
+   * trigger pauses event listening without deleting the trigger configuration.
+   * Re-enabling restores the trigger to its active state. Use this for temporary
+   * maintenance or to control trigger execution.
+   *
    * @example
    * ```ts
    * const manage = await client.triggerInstances.manage.update(
@@ -24,6 +29,10 @@ export class Manage extends APIResource {
   }
 
   /**
+   * Permanently deletes a trigger instance. This stops the trigger from listening
+   * for events and removes it from your project. Use the PATCH endpoint with status
+   * "disable" if you want to temporarily pause a trigger instead.
+   *
    * @example
    * ```ts
    * const manage = await client.triggerInstances.manage.delete(

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

@@ -11,6 +11,11 @@ export class TriggerInstances extends APIResource {
   manage: ManageAPI.Manage = new ManageAPI.Manage(this._client);
 
   /**
+   * Retrieves all active trigger instances for your project. Triggers listen for
+   * events from connected accounts (e.g., new emails, Slack messages, GitHub
+   * commits) and can invoke webhooks or workflows. Use filters to find triggers for
+   * specific users, connected accounts, or trigger types.
+   *
    * @example
    * ```ts
    * const response = await client.triggerInstances.listActive();
@@ -24,6 +29,12 @@ export class TriggerInstances extends APIResource {
   }
 
   /**
+   * Creates a new trigger instance or updates an existing one with the same
+   * configuration. Triggers listen for events from external services (webhooks or
+   * polling) and can invoke your workflows. If a matching trigger already exists and
+   * is disabled, it will be re-enabled. Requires a connected account ID to associate
+   * the trigger with a specific user connection.
+   *
    * @example
    * ```ts
    * const response = await client.triggerInstances.upsert(

package/src/resources/triggers-types.ts

@@ -69,11 +69,6 @@ export interface TriggersTypeRetrieveResponse {
    */
   slug: string;
 
-  /**
-   * Lifecycle status of the trigger
-   */
-  status: string;
-
   /**
    * Information about the toolkit that provides this trigger
    */
@@ -156,11 +151,6 @@ export namespace TriggersTypeListResponse {
      */
     slug: string;
 
-    /**
-     * Lifecycle status of the trigger
-     */
-    status: string;
-
     /**
      * Information about the toolkit that provides this trigger
      */

package/src/version.ts

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

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.56";
+export declare const VERSION = "0.1.0-alpha.57";
 //# 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.56'; // x-release-please-version
+exports.VERSION = '0.1.0-alpha.57'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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