@composio/client 0.1.0-alpha.74 → 0.1.0-alpha.76

package/src/resources/connected-accounts.ts

@@ -129,16 +129,14 @@ export class ConnectedAccounts extends APIResource {
   }
 
   /**
+   * DEPRECATED: Manual refresh of a connected account is deprecated. Composio
+   * automatically refreshes credentials in the background as they approach expiry,
+   * so this endpoint is no longer required and may be removed in a future release.
    * Initiates a new authentication flow for a connected account when credentials
    * have expired or become invalid. This may generate a new authentication URL for
    * OAuth flows or refresh tokens for other auth schemes.
    *
-   * @example
-   * ```ts
-   * const response = await client.connectedAccounts.refresh(
-   *   'ca_1a2b3c4d5e6f',
-   * );
-   * ```
+   * @deprecated
    */
   refresh(
     nanoid: string,
@@ -216,12 +214,6 @@ export interface ConnectedAccountCreateResponse {
    */
   status: 'INITIALIZING' | 'INITIATED' | 'ACTIVE' | 'FAILED' | 'EXPIRED' | 'INACTIVE' | 'REVOKED';
 
-  /**
-   * @deprecated DEPRECATED: This field will be removed in a future version. Please
-   * use id and auth_config.id instead.
-   */
-  deprecated?: ConnectedAccountCreateResponse.Deprecated;
-
   /**
    * Experimental features - not stable, may be modified or removed in future
    * versions.
@@ -4405,10 +4397,6 @@ export namespace ConnectedAccountCreateResponse {
     export interface UnionMember2 {
       access_token: string;
 
-      client_id: string;
-
-      client_secret: string;
-
       status: 'ACTIVE';
 
       account_id?: string;
@@ -4421,6 +4409,10 @@ export namespace ConnectedAccountCreateResponse {
 
       borneo_dashboard_url?: string;
 
+      client_id?: string;
+
+      client_secret?: string;
+
       COMPANYDOMAIN?: string;
 
       dc?: string;
@@ -4469,10 +4461,6 @@ export namespace ConnectedAccountCreateResponse {
     export interface UnionMember3 {
       access_token: string;
 
-      client_id: string;
-
-      client_secret: string;
-
       status: 'INACTIVE';
 
       account_id?: string;
@@ -4485,6 +4473,10 @@ export namespace ConnectedAccountCreateResponse {
 
       borneo_dashboard_url?: string;
 
+      client_id?: string;
+
+      client_secret?: string;
+
       COMPANYDOMAIN?: string;
 
       dc?: string;
@@ -4637,22 +4629,6 @@ export namespace ConnectedAccountCreateResponse {
     }
   }
 
-  /**
-   * @deprecated DEPRECATED: This field will be removed in a future version. Please
-   * use id and auth_config.id instead.
-   */
-  export interface Deprecated {
-    /**
-     * The uuid of the auth config
-     */
-    authConfigUuid: string;
-
-    /**
-     * The uuid of the connected account
-     */
-    uuid: string;
-  }
-
   /**
    * Experimental features - not stable, may be modified or removed in future
    * versions.
@@ -4776,11 +4752,6 @@ export interface ConnectedAccountRetrieveResponse {
    */
   word_id: string | null;
 
-  /**
-   * @deprecated
-   */
-  deprecated?: ConnectedAccountRetrieveResponse.Deprecated;
-
   /**
    * Experimental features - not stable, may be modified or removed in future
    * versions.
@@ -4841,23 +4812,6 @@ export namespace ConnectedAccountRetrieveResponse {
      * Whether the auth config is disabled
      */
     is_disabled: boolean;
-
-    /**
-     * @deprecated
-     */
-    deprecated?: AuthConfig.Deprecated;
-  }
-
-  export namespace AuthConfig {
-    /**
-     * @deprecated
-     */
-    export interface Deprecated {
-      /**
-       * The uuid of the auth config
-       */
-      uuid: string;
-    }
   }
 
   export interface UnionMember0 {
@@ -9035,10 +8989,6 @@ export namespace ConnectedAccountRetrieveResponse {
     export interface UnionMember2 {
       access_token: string;
 
-      client_id: string;
-
-      client_secret: string;
-
       status: 'ACTIVE';
 
       account_id?: string;
@@ -9051,6 +9001,10 @@ export namespace ConnectedAccountRetrieveResponse {
 
       borneo_dashboard_url?: string;
 
+      client_id?: string;
+
+      client_secret?: string;
+
       COMPANYDOMAIN?: string;
 
       dc?: string;
@@ -9099,10 +9053,6 @@ export namespace ConnectedAccountRetrieveResponse {
     export interface UnionMember3 {
       access_token: string;
 
-      client_id: string;
-
-      client_secret: string;
-
       status: 'INACTIVE';
 
       account_id?: string;
@@ -9115,6 +9065,10 @@ export namespace ConnectedAccountRetrieveResponse {
 
       borneo_dashboard_url?: string;
 
+      client_id?: string;
+
+      client_secret?: string;
+
       COMPANYDOMAIN?: string;
 
       dc?: string;
@@ -9274,21 +9228,6 @@ export namespace ConnectedAccountRetrieveResponse {
     slug: string;
   }
 
-  /**
-   * @deprecated
-   */
-  export interface Deprecated {
-    /**
-     * The labels of the connection
-     */
-    labels: Array<string>;
-
-    /**
-     * The uuid of the connection
-     */
-    uuid: string;
-  }
-
   /**
    * Experimental features - not stable, may be modified or removed in future
    * versions.
@@ -9419,11 +9358,6 @@ export namespace ConnectedAccountListResponse {
      */
     word_id: string | null;
 
-    /**
-     * @deprecated
-     */
-    deprecated?: Item.Deprecated;
-
     /**
      * Experimental features - not stable, may be modified or removed in future
      * versions.
@@ -9471,23 +9405,6 @@ export namespace ConnectedAccountListResponse {
        * Whether the auth config is disabled
        */
       is_disabled: boolean;
-
-      /**
-       * @deprecated
-       */
-      deprecated?: AuthConfig.Deprecated;
-    }
-
-    export namespace AuthConfig {
-      /**
-       * @deprecated
-       */
-      export interface Deprecated {
-        /**
-         * The uuid of the auth config
-         */
-        uuid: string;
-      }
     }
 
     export interface UnionMember0 {
@@ -13665,10 +13582,6 @@ export namespace ConnectedAccountListResponse {
       export interface UnionMember2 {
         access_token: string;
 
-        client_id: string;
-
-        client_secret: string;
-
         status: 'ACTIVE';
 
         account_id?: string;
@@ -13681,6 +13594,10 @@ export namespace ConnectedAccountListResponse {
 
         borneo_dashboard_url?: string;
 
+        client_id?: string;
+
+        client_secret?: string;
+
         COMPANYDOMAIN?: string;
 
         dc?: string;
@@ -13729,10 +13646,6 @@ export namespace ConnectedAccountListResponse {
       export interface UnionMember3 {
         access_token: string;
 
-        client_id: string;
-
-        client_secret: string;
-
         status: 'INACTIVE';
 
         account_id?: string;
@@ -13745,6 +13658,10 @@ export namespace ConnectedAccountListResponse {
 
         borneo_dashboard_url?: string;
 
+        client_id?: string;
+
+        client_secret?: string;
+
         COMPANYDOMAIN?: string;
 
         dc?: string;
@@ -13904,21 +13821,6 @@ export namespace ConnectedAccountListResponse {
       slug: string;
     }
 
-    /**
-     * @deprecated
-     */
-    export interface Deprecated {
-      /**
-       * The labels of the connection
-       */
-      labels: Array<string>;
-
-      /**
-       * The uuid of the connection
-       */
-      uuid: string;
-    }
-
     /**
      * Experimental features - not stable, may be modified or removed in future
      * versions.
@@ -18327,10 +18229,6 @@ export namespace ConnectedAccountCreateParams {
       export interface UnionMember2 {
         access_token: string;
 
-        client_id: string;
-
-        client_secret: string;
-
         status: 'ACTIVE';
 
         account_id?: string;
@@ -18343,6 +18241,10 @@ export namespace ConnectedAccountCreateParams {
 
         borneo_dashboard_url?: string;
 
+        client_id?: string;
+
+        client_secret?: string;
+
         COMPANYDOMAIN?: string;
 
         dc?: string;
@@ -18391,10 +18293,6 @@ export namespace ConnectedAccountCreateParams {
       export interface UnionMember3 {
         access_token: string;
 
-        client_id: string;
-
-        client_secret: string;
-
         status: 'INACTIVE';
 
         account_id?: string;
@@ -18407,6 +18305,10 @@ export namespace ConnectedAccountCreateParams {
 
         borneo_dashboard_url?: string;
 
+        client_id?: string;
+
+        client_secret?: string;
+
         COMPANYDOMAIN?: string;
 
         dc?: string;

package/src/resources/files.ts

@@ -9,13 +9,12 @@ import { RequestOptions } from '../internal/request-options';
  */
 export class Files extends APIResource {
   /**
+   * DEPRECATED: This endpoint is deprecated and will be removed in a future release.
    * Retrieves a list of files associated with the authenticated project. Results can
-   * be filtered by toolkit and tool slugs.
+   * be filtered by toolkit and tool slugs. Responses carry a `Deprecation` header
+   * (RFC 9745) for client-side detection.
    *
-   * @example
-   * ```ts
-   * const files = await client.files.list();
-   * ```
+   * @deprecated
    */
   list(
     query: FileListParams | null | undefined = {},

package/src/resources/link.ts

@@ -4039,10 +4039,6 @@ export namespace LinkCreateParams {
   export interface UnionMember71 {
     access_token: string;
 
-    client_id: string;
-
-    client_secret: string;
-
     account_id?: string;
 
     account_url?: string;
@@ -4053,6 +4049,10 @@ export namespace LinkCreateParams {
 
     borneo_dashboard_url?: string;
 
+    client_id?: string;
+
+    client_secret?: string;
+
     COMPANYDOMAIN?: string;
 
     dc?: string;
@@ -4101,10 +4101,6 @@ export namespace LinkCreateParams {
   export interface UnionMember72 {
     access_token: string;
 
-    client_id: string;
-
-    client_secret: string;
-
     account_id?: string;
 
     account_url?: string;
@@ -4115,6 +4111,10 @@ export namespace LinkCreateParams {
 
     borneo_dashboard_url?: string;
 
+    client_id?: string;
+
+    client_secret?: string;
+
     COMPANYDOMAIN?: string;
 
     dc?: string;

package/src/resources/logs/triggers.ts

@@ -10,12 +10,10 @@ import { path } from '../../internal/utils/path';
  */
 export class Triggers extends APIResource {
   /**
-   * Get detailed trigger log by ID
+   * DEPRECATED: This endpoint has declining traffic and will be removed in a future
+   * version.
    *
-   * @example
-   * ```ts
-   * const trigger = await client.logs.triggers.retrieve('id');
-   * ```
+   * @deprecated
    */
   retrieve(id: string, options?: RequestOptions): APIPromise<TriggerRetrieveResponse> {
     return this._client.get(path`/api/v3.1/internal/trigger/log/${id}`, options);

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

@@ -4770,10 +4770,6 @@ export namespace SessionProxyExecuteParams {
     export interface Val {
       access_token: string;
 
-      client_id: string;
-
-      client_secret: string;
-
       account_id?: string;
 
       account_url?: string;
@@ -4784,6 +4780,10 @@ export namespace SessionProxyExecuteParams {
 
       borneo_dashboard_url?: string;
 
+      client_id?: string;
+
+      client_secret?: string;
+
       COMPANYDOMAIN?: string;
 
       dc?: string;

package/src/resources/toolkits.ts

@@ -51,6 +51,11 @@ export class Toolkits extends APIResource {
  * Detailed information about a single toolkit
  */
 export interface ToolkitRetrieveResponse {
+  /**
+   * Managed-auth-only metadata, including the supported OAuth scope ceiling.
+   */
+  composio_managed_auth: Array<ToolkitRetrieveResponse.ComposioManagedAuth>;
+
   deprecated: ToolkitRetrieveResponse.Deprecated;
 
   /**
@@ -81,6 +86,12 @@ export interface ToolkitRetrieveResponse {
    */
   slug: string;
 
+  /**
+   * Toolkit provenance: "native" for Composio-managed toolkits, "custom" for a
+   * project-registered custom (MCP) toolkit
+   */
+  type: 'native' | 'custom';
+
   /**
    * Complete authentication configuration details for each supported auth method
    */
@@ -114,6 +125,47 @@ export interface ToolkitRetrieveResponse {
 }
 
 export namespace ToolkitRetrieveResponse {
+  export interface ComposioManagedAuth {
+    /**
+     * Authentication mode for the Composio-managed auth config
+     */
+    mode: string;
+
+    /**
+     * OAuth scopes available in the Composio-managed auth config for this auth mode.
+     */
+    scopes: ComposioManagedAuth.Scopes;
+
+    /**
+     * OAuth user scopes available in the Composio-managed auth config for this auth
+     * mode. Only present for Slack toolkits.
+     */
+    user_scopes?: ComposioManagedAuth.UserScopes;
+  }
+
+  export namespace ComposioManagedAuth {
+    /**
+     * OAuth scopes available in the Composio-managed auth config for this auth mode.
+     */
+    export interface Scopes {
+      /**
+       * Available OAuth scopes
+       */
+      available: Array<string>;
+    }
+
+    /**
+     * OAuth user scopes available in the Composio-managed auth config for this auth
+     * mode. Only present for Slack toolkits.
+     */
+    export interface UserScopes {
+      /**
+       * Available OAuth user scopes
+       */
+      available: Array<string>;
+    }
+  }
+
   export interface Deprecated {
     rawProxyInfoByAuthSchemes: Array<{ [key: string]: unknown }>;
 
@@ -268,8 +320,6 @@ export namespace ToolkitRetrieveResponse {
 
           type: string;
 
-          advanced?: boolean;
-
           default?: string | null;
 
           is_secret?: boolean;
@@ -288,8 +338,6 @@ export namespace ToolkitRetrieveResponse {
 
           type: string;
 
-          advanced?: boolean;
-
           default?: string | null;
 
           is_secret?: boolean;
@@ -320,8 +368,6 @@ export namespace ToolkitRetrieveResponse {
 
           type: string;
 
-          advanced?: boolean;
-
           default?: string | null;
 
           is_secret?: boolean;
@@ -340,8 +386,6 @@ export namespace ToolkitRetrieveResponse {
 
           type: string;
 
-          advanced?: boolean;
-
           default?: string | null;
 
           is_secret?: boolean;
@@ -417,6 +461,12 @@ export namespace ToolkitListResponse {
      */
     slug: string;
 
+    /**
+     * Toolkit provenance: "native" for Composio-managed toolkits, "custom" for a
+     * project-registered custom (MCP) toolkit
+     */
+    type: 'native' | 'custom';
+
     /**
      * URL to a guide page with authentication setup instructions for this toolkit
      */
@@ -586,6 +636,11 @@ export interface ToolkitListParams {
    * Sort order for returned toolkits
    */
   sort_by?: 'usage' | 'alphabetically';
+
+  /**
+   * Filter toolkits by provenance (alias over managed_by)
+   */
+  type?: 'native' | 'custom' | 'all';
 }
 
 export declare namespace Toolkits {

package/src/resources/tools.ts

@@ -1413,10 +1413,6 @@ export namespace ToolExecuteParams {
     export interface Val {
       access_token: string;
 
-      client_id: string;
-
-      client_secret: string;
-
       account_id?: string;
 
       account_url?: string;
@@ -1427,6 +1423,10 @@ export namespace ToolExecuteParams {
 
       borneo_dashboard_url?: string;
 
+      client_id?: string;
+
+      client_secret?: string;
+
       COMPANYDOMAIN?: string;
 
       dc?: string;
@@ -2284,10 +2284,6 @@ export namespace ToolProxyParams {
     export interface Val {
       access_token: string;
 
-      client_id: string;
-
-      client_secret: string;
-
       account_id?: string;
 
       account_url?: string;
@@ -2298,6 +2294,10 @@ export namespace ToolProxyParams {
 
       borneo_dashboard_url?: string;
 
+      client_id?: string;
+
+      client_secret?: string;
+
       COMPANYDOMAIN?: string;
 
       dc?: string;

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

@@ -35,8 +35,9 @@ 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.
+   * is disabled, it will be re-enabled. Provide either a connected_account_id to pin
+   * a specific user connection, or a user_id to auto-resolve the first active
+   * connection for that user and the trigger's toolkit.
    *
    * @example
    * ```ts
@@ -183,17 +184,6 @@ export interface TriggerInstanceUpsertResponse {
    * ID of the updated trigger
    */
   trigger_id: string;
-
-  deprecated?: TriggerInstanceUpsertResponse.Deprecated;
-}
-
-export namespace TriggerInstanceUpsertResponse {
-  export interface Deprecated {
-    /**
-     * ID of the updated trigger
-     */
-    uuid: string;
-  }
 }
 
 export interface TriggerInstanceListActiveParams {
@@ -286,7 +276,8 @@ export interface TriggerInstanceListActiveParams {
 
 export interface TriggerInstanceUpsertParams {
   /**
-   * Connected account nanoid
+   * Connected account nanoid. Optional when user_id is provided — the first active
+   * connection for that user and the trigger's toolkit is auto-resolved.
    */
   connected_account_id?: string;
 
@@ -314,8 +305,11 @@ export interface TriggerInstanceUpsertParams {
   triggerConfig?: { [key: string]: unknown };
 
   /**
-   * The user id (entity id) that owns the connected account. When the project has
-   * 2FA enabled, this is validated against the owner of connected_account_id.
+   * The user id (entity id) that owns the connection. When connected_account_id is
+   * omitted, the first active connection for this user and the trigger's toolkit is
+   * auto-resolved (same as tool execution). When connected_account_id is also
+   * provided and the project has 2FA enabled, user_id is validated against the owner
+   * of that connection.
    */
   user_id?: string;
 

package/src/version.ts

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

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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