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

package/src/resources/cli/realtime.ts

@@ -0,0 +1,72 @@
+// 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 Realtime extends APIResource {
+  /**
+   * Authenticate CLI client access to a private-cli-{nanoId} Pusher channel
+   */
+  auth(body: RealtimeAuthParams, options?: RequestOptions): APIPromise<RealtimeAuthResponse> {
+    return this._client.post('/api/v3/cli/realtime/auth', { body, ...options });
+  }
+
+  /**
+   * Get the Pusher key and project nanoId for the CLI realtime trigger channel. The
+   * CLI subscribes to private-cli-{project_id}.
+   */
+  credentials(options?: RequestOptions): APIPromise<RealtimeCredentialsResponse> {
+    return this._client.get('/api/v3/cli/realtime/credentials', options);
+  }
+}
+
+export interface RealtimeAuthResponse {
+  /**
+   * The authentication string for Pusher
+   */
+  auth: string;
+
+  /**
+   * Channel data for presence channels
+   */
+  channel_data?: string;
+}
+
+export interface RealtimeCredentialsResponse {
+  /**
+   * The project nanoId associated with the API Key provided. Used as part of the CLI
+   * channel name: private-cli-{project_id}
+   */
+  project_id: string;
+
+  /**
+   * The Pusher cluster for subscribing to the trigger
+   */
+  pusher_cluster: string;
+
+  /**
+   * The Pusher client key for subscribing to the trigger
+   */
+  pusher_key: string;
+}
+
+export interface RealtimeAuthParams {
+  /**
+   * The channel name to authenticate for
+   */
+  channel_name: string;
+
+  /**
+   * The socket ID for Pusher authentication
+   */
+  socket_id: string;
+}
+
+export declare namespace Realtime {
+  export {
+    type RealtimeAuthResponse as RealtimeAuthResponse,
+    type RealtimeCredentialsResponse as RealtimeCredentialsResponse,
+    type RealtimeAuthParams as RealtimeAuthParams,
+  };
+}

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/files.ts

@@ -28,11 +28,11 @@ export class Files extends APIResource {
    * @example
    * ```ts
    * const response = await client.files.createPresignedURL({
-   *   filename: 'photo.jpg',
-   *   md5: 'd41d8cd98f00b204e9800998ecf8427e',
-   *   mimetype: 'image/jpeg',
-   *   tool_slug: 'resize-image',
-   *   toolkit_slug: 'image-processing',
+   *   filename: 'quarterly_report.pdf',
+   *   md5: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6',
+   *   mimetype: 'application/pdf',
+   *   tool_slug: 'GMAIL_SEND_EMAIL',
+   *   toolkit_slug: 'gmail',
    * });
    * ```
    */
@@ -87,134 +87,46 @@ export namespace FileListResponse {
   }
 }
 
-export type FileCreatePresignedURLResponse =
-  | FileCreatePresignedURLResponse.UnionMember0
-  | FileCreatePresignedURLResponse.UnionMember1
-  | FileCreatePresignedURLResponse.UnionMember2;
-
-export namespace FileCreatePresignedURLResponse {
-  export interface UnionMember0 {
-    /**
-     * ID of the request file. Example: "f1e2d3c4b5a6"
-     */
-    id: string;
-
-    /**
-     * URL of the existing request file. Example:
-     * "https://storage.example.com/projects/123/files/photo-1234.jpg"
-     */
-    existing_url: string;
-
-    /**
-     * [DEPRECATED] Use existing_url instead. URL of the existing request file.
-     * Example: "https://storage.example.com/projects/123/files/photo-1234.jpg"
-     */
-    existingUrl: string;
-
-    /**
-     * S3 upload location. Example: "projects/123/files/photo-1234.jpg"
-     */
-    key: string;
-
-    metadata: UnionMember0.Metadata;
-
-    /**
-     * Indicates the file already exists and does not need to be uploaded again
-     */
-    type: 'existing';
-  }
-
-  export namespace UnionMember0 {
-    export interface Metadata {
-      /**
-       * Storage backend used for the file. If this is azure, use `x-ms-blob-type` header
-       * to set the blob type to `BlockBlob` while uploading the file
-       */
-      storage_backend: 's3' | 'azure_blob_storage';
-    }
-  }
-
-  export interface UnionMember1 {
-    /**
-     * ID of the request file. Example: "f1e2d3c4b5a6"
-     */
-    id: string;
-
-    /**
-     * S3 upload location. Example: "projects/123/files/photo-1234.jpg"
-     */
-    key: string;
-
-    metadata: UnionMember1.Metadata;
-
-    /**
-     * Presigned URL for upload. Example:
-     * "https://storage.example.com/projects/123/files/photo-1234.jpg?X-Amz-Algorithm=..."
-     */
-    new_presigned_url: string;
-
-    /**
-     * [DEPRECATED] Use new_presigned_url instead. Presigned URL for upload. Example:
-     * "https://storage.example.com/projects/123/files/photo-1234.jpg?X-Amz-Algorithm=..."
-     */
-    newPresignedUrl: string;
-
-    /**
-     * Indicates this is a new file that needs to be uploaded
-     */
-    type: 'new';
-  }
-
-  export namespace UnionMember1 {
-    export interface Metadata {
-      /**
-       * Storage backend used for the file. If this is azure, use `x-ms-blob-type` header
-       * to set the blob type to `BlockBlob` while uploading the file
-       */
-      storage_backend: 's3' | 'azure_blob_storage';
-    }
-  }
+export interface FileCreatePresignedURLResponse {
+  /**
+   * ID of the request file. Example: "req_file_9mZn4qR8sXwT"
+   */
+  id: string;
 
-  export interface UnionMember2 {
-    /**
-     * ID of the request file. Example: "f1e2d3c4b5a6"
-     */
-    id: string;
+  /**
+   * Object storage upload location. Example:
+   * "projects/prj_xyz789/requests/slack/SLACK_UPLOAD_FILE/document_9mZn4q.docx"
+   */
+  key: string;
 
-    /**
-     * S3 upload location. Example: "projects/123/files/photo-1234.jpg"
-     */
-    key: string;
+  metadata: FileCreatePresignedURLResponse.Metadata;
 
-    metadata: UnionMember2.Metadata;
+  /**
+   * Presigned URL for upload. Example:
+   * "https://storage.composio.dev/projects/prj_xyz789/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600..."
+   */
+  new_presigned_url: string;
 
-    /**
-     * Indicates this file exists but needs to be updated with a new version
-     */
-    type: 'update';
+  /**
+   * @deprecated [DEPRECATED] Use new_presigned_url instead. Presigned URL for
+   * upload. Example:
+   * "https://storage.composio.dev/projects/prj_xyz789/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600..."
+   */
+  newPresignedUrl: string;
 
-    /**
-     * Presigned URL for upload. Example:
-     * "https://storage.example.com/projects/123/files/photo-1234.jpg?X-Amz-Algorithm=..."
-     */
-    update_presigned_url: string;
+  /**
+   * @deprecated [DEPRECATED] Indicates this is a new file that needs to be uploaded
+   */
+  type: 'new';
+}
 
+export namespace FileCreatePresignedURLResponse {
+  export interface Metadata {
     /**
-     * [DEPRECATED] Use update_presigned_url instead. Presigned URL for upload.
-     * Example:
-     * "https://storage.example.com/projects/123/files/photo-1234.jpg?X-Amz-Algorithm=..."
+     * Storage backend used for the file. If this is azure, use `x-ms-blob-type` header
+     * to set the blob type to `BlockBlob` while uploading the file
      */
-    updatePresignedUrl: string;
-  }
-
-  export namespace UnionMember2 {
-    export interface Metadata {
-      /**
-       * Storage backend used for the file. If this is azure, use `x-ms-blob-type` header
-       * to set the blob type to `BlockBlob` while uploading the file
-       */
-      storage_backend: 's3' | 'azure_blob_storage';
-    }
+    storage_backend: 's3' | 'azure_blob_storage';
   }
 }
 
@@ -245,28 +157,29 @@ export interface FileListParams {
 
 export interface FileCreatePresignedURLParams {
   /**
-   * Name of the original file. Example: "photo.jpg"
+   * Name of the original file. Example: "quarterly_report.pdf"
    */
   filename: string;
 
   /**
    * MD5 hash of the file for deduplication and integrity verification. Example:
-   * "d41d8cd98f00b204e9800998ecf8427e"
+   * "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
    */
   md5: string;
 
   /**
-   * Mime type of the original file. Example: "image/jpeg"
+   * Mime type of the original file. Example: "application/pdf", "image/png"
    */
   mimetype: string;
 
   /**
-   * Slug of the action where this file belongs to. Example: "resize-image"
+   * Slug of the action where this file belongs to. Example: "GMAIL_SEND_EMAIL",
+   * "SLACK_UPLOAD_FILE"
    */
   tool_slug: string;
 
   /**
-   * Slug of the app where this file belongs to. Example: "image-processing"
+   * Slug of the app where this file belongs to. Example: "gmail", "slack", "github"
    */
   toolkit_slug: string;
 }

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/project/config.ts

@@ -53,6 +53,8 @@ export interface ConfigRetrieveResponse {
   logo_url?: string;
 
   require_mcp_api_key?: boolean;
+
+  signed_url_file_expiry_in_seconds?: number;
 }
 
 export interface ConfigUpdateResponse {
@@ -73,6 +75,8 @@ export interface ConfigUpdateResponse {
   logo_url?: string;
 
   require_mcp_api_key?: boolean;
+
+  signed_url_file_expiry_in_seconds?: number;
 }
 
 export interface ConfigUpdateParams {
@@ -93,6 +97,8 @@ export interface ConfigUpdateParams {
   mask_secret_keys_in_connected_account?: boolean;
 
   require_mcp_api_key?: boolean;
+
+  signed_url_file_expiry_in_seconds?: number;
 }
 
 export declare namespace Config {

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

@@ -163,6 +163,12 @@ export interface SessionCreateResponse {
    * 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 namespace SessionCreateResponse {
@@ -314,6 +320,18 @@ export namespace SessionCreateResponse {
      */
     url: string;
   }
+
+  /**
+   * Experimental features including the generated system prompt. Only returned on
+   * session creation, not on GET.
+   */
+  export interface Experimental {
+    /**
+     * The assistive system prompt to inject into your agent for optimal tool router
+     * usage
+     */
+    assistive_prompt: string;
+  }
 }
 
 export interface SessionRetrieveResponse {
@@ -713,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
      */
@@ -804,6 +817,12 @@ export interface SessionCreateParams {
    */
   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
    */
@@ -840,6 +859,30 @@ export interface SessionCreateParams {
 }
 
 export namespace SessionCreateParams {
+  /**
+   * Experimental features - not stable, may be modified or removed in future
+   * versions.
+   */
+  export interface Experimental {
+    /**
+     * Customize assistive prompt generation (e.g., timezone).
+     */
+    assistive_prompt_config?: Experimental.AssistivePromptConfig;
+  }
+
+  export namespace Experimental {
+    /**
+     * Customize assistive prompt generation (e.g., timezone).
+     */
+    export 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;
+    }
+  }
+
   /**
    * Configuration for connection management settings
    */

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
    */
@@ -103,6 +98,11 @@ export interface ToolkitRetrieveResponse {
    * Endpoint to get the current user
    */
   get_current_user_endpoint?: string;
+
+  /**
+   * HTTP method to use when calling the get current user endpoint (e.g., GET, POST)
+   */
+  get_current_user_endpoint_method?: string;
 }
 
 export namespace ToolkitRetrieveResponse {
@@ -387,11 +387,6 @@ export namespace ToolkitListResponse {
      */
     slug: string;
 
-    /**
-     * Lifecycle status of the toolkit
-     */
-    status: string;
-
     /**
      * List of authentication methods supported by this toolkit
      */