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

package/src/resources/cli/cli.ts

@@ -0,0 +1,163 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as RealtimeAPI from './realtime';
+import { Realtime, RealtimeAuthParams, RealtimeAuthResponse, RealtimeCredentialsResponse } from './realtime';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+
+export class Cli extends APIResource {
+  realtime: RealtimeAPI.Realtime = new RealtimeAPI.Realtime(this._client);
+
+  /**
+   * 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.
+   * Optionally accepts a scope ('project' or 'user') and a source string.
+   */
+  createSession(
+    body: CliCreateSessionParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CliCreateSessionResponse> {
+    return this._client.post('/api/v3/cli/create-session', { body, ...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 key scope for this session
+   */
+  scope: 'project' | 'user';
+
+  /**
+   * 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 key scope for this session
+   */
+  scope: 'project' | 'user' | null;
+
+  /**
+   * 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 CliCreateSessionParams {
+  /**
+   * Key scope. 'project' (default) returns a project-level API key; 'user' returns a
+   * user-level API key valid across projects.
+   */
+  scope?: 'project' | 'user';
+
+  /**
+   * Free-form string describing the source, e.g. 'Johns MacBook (darwin, v1.2.3)'
+   */
+  source?: 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;
+}
+
+Cli.Realtime = Realtime;
+
+export declare namespace Cli {
+  export {
+    type CliCreateSessionResponse as CliCreateSessionResponse,
+    type CliGetSessionResponse as CliGetSessionResponse,
+    type CliCreateSessionParams as CliCreateSessionParams,
+    type CliGetSessionParams as CliGetSessionParams,
+  };
+
+  export {
+    Realtime as Realtime,
+    type RealtimeAuthResponse as RealtimeAuthResponse,
+    type RealtimeCredentialsResponse as RealtimeCredentialsResponse,
+    type RealtimeAuthParams as RealtimeAuthParams,
+  };
+}

package/src/resources/cli/index.ts

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Cli,
+  type CliCreateSessionResponse,
+  type CliGetSessionResponse,
+  type CliCreateSessionParams,
+  type CliGetSessionParams,
+} from './cli';
+export {
+  Realtime,
+  type RealtimeAuthResponse,
+  type RealtimeCredentialsResponse,
+  type RealtimeAuthParams,
+} from './realtime';

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/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,
@@ -40,6 +41,7 @@ export {
   type FileCreatePresignedURLParams,
 } from './files';
 export { Link, type LinkCreateResponse, type LinkCreateParams } from './link';
+export { Logs } from './logs/logs';
 export {
   Mcp,
   type McpCreateResponse,

package/src/resources/logs/index.ts

@@ -0,0 +1,11 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Logs } from './logs';
+export {
+  Tools,
+  type ToolRetrieveResponse,
+  type ToolListResponse,
+  type ToolRetrieveParams,
+  type ToolListParams,
+} from './tools';
+export { Triggers, type TriggerListResponse, type TriggerListParams } from './triggers';

package/src/resources/logs/logs.ts

@@ -0,0 +1,31 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ToolsAPI from './tools';
+import { ToolListParams, ToolListResponse, ToolRetrieveParams, ToolRetrieveResponse, Tools } from './tools';
+import * as TriggersAPI from './triggers';
+import { TriggerListParams, TriggerListResponse, Triggers } from './triggers';
+
+export class Logs extends APIResource {
+  triggers: TriggersAPI.Triggers = new TriggersAPI.Triggers(this._client);
+  tools: ToolsAPI.Tools = new ToolsAPI.Tools(this._client);
+}
+
+Logs.Triggers = Triggers;
+Logs.Tools = Tools;
+
+export declare namespace Logs {
+  export {
+    Triggers as Triggers,
+    type TriggerListResponse as TriggerListResponse,
+    type TriggerListParams as TriggerListParams,
+  };
+
+  export {
+    Tools as Tools,
+    type ToolRetrieveResponse as ToolRetrieveResponse,
+    type ToolListResponse as ToolListResponse,
+    type ToolRetrieveParams as ToolRetrieveParams,
+    type ToolListParams as ToolListParams,
+  };
+}

package/src/resources/logs/tools.ts

@@ -0,0 +1,214 @@
+// 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 Tools extends APIResource {
+  /**
+   * Search and retrieve action execution logs
+   *
+   * @example
+   * ```ts
+   * const tool = await client.logs.tools.retrieve({
+   *   cursor: 0,
+   * });
+   * ```
+   */
+  retrieve(body: ToolRetrieveParams, options?: RequestOptions): APIPromise<ToolRetrieveResponse> {
+    return this._client.post('/api/v3/internal/action_execution/logs', { body, ...options });
+  }
+
+  /**
+   * Search and retrieve action execution logs
+   *
+   * @example
+   * ```ts
+   * const tools = await client.logs.tools.list({ cursor: 0 });
+   * ```
+   */
+  list(body: ToolListParams, options?: RequestOptions): APIPromise<ToolListResponse> {
+    return this._client.post('/api/v3/internal/action_execution/logs', { body, ...options });
+  }
+}
+
+export interface ToolRetrieveResponse {
+  data: Array<ToolRetrieveResponse.Data>;
+
+  nextCursor: number | null;
+}
+
+export namespace ToolRetrieveResponse {
+  export interface Data {
+    id: string;
+
+    actionKey: string;
+
+    app: Data.App;
+
+    appKey: string;
+
+    connectedAccountId: string;
+
+    createdAt: number;
+
+    entityId: string;
+
+    executionTime: number;
+
+    /**
+     * @deprecated
+     */
+    minimalResponse: string;
+
+    status: 'success' | 'failed';
+
+    metadata?: Data.Metadata;
+  }
+
+  export namespace Data {
+    export interface App {
+      icon: string;
+
+      name: string;
+    }
+
+    export interface Metadata {
+      recipe_id?: string;
+    }
+  }
+}
+
+export interface ToolListResponse {
+  data: Array<ToolListResponse.Data>;
+
+  nextCursor: number | null;
+}
+
+export namespace ToolListResponse {
+  export interface Data {
+    id: string;
+
+    actionKey: string;
+
+    app: Data.App;
+
+    appKey: string;
+
+    connectedAccountId: string;
+
+    createdAt: number;
+
+    entityId: string;
+
+    executionTime: number;
+
+    /**
+     * @deprecated
+     */
+    minimalResponse: string;
+
+    status: 'success' | 'failed';
+
+    metadata?: Data.Metadata;
+  }
+
+  export namespace Data {
+    export interface App {
+      icon: string;
+
+      name: string;
+    }
+
+    export interface Metadata {
+      recipe_id?: string;
+    }
+  }
+}
+
+export interface ToolRetrieveParams {
+  /**
+   * cursor_that_can_be_used_to_paginate_through_the_logs
+   */
+  cursor: number | null;
+
+  /**
+   * whether_the_search_is_case_sensitive_or_not
+   */
+  case_sensitive?: boolean | null;
+
+  /**
+   * start_time_of_the_logs_in_epoch_time
+   */
+  from?: number;
+
+  /**
+   * number_of_logs_to_return
+   */
+  limit?: number;
+
+  search_params?: Array<ToolRetrieveParams.SearchParam>;
+
+  /**
+   * end_time_of_the_logs_in_epoch_time
+   */
+  to?: number;
+}
+
+export namespace ToolRetrieveParams {
+  export interface SearchParam {
+    field?: string;
+
+    operation?: string;
+
+    value?: string;
+  }
+}
+
+export interface ToolListParams {
+  /**
+   * cursor_that_can_be_used_to_paginate_through_the_logs
+   */
+  cursor: number | null;
+
+  /**
+   * whether_the_search_is_case_sensitive_or_not
+   */
+  case_sensitive?: boolean | null;
+
+  /**
+   * start_time_of_the_logs_in_epoch_time
+   */
+  from?: number;
+
+  /**
+   * number_of_logs_to_return
+   */
+  limit?: number;
+
+  search_params?: Array<ToolListParams.SearchParam>;
+
+  /**
+   * end_time_of_the_logs_in_epoch_time
+   */
+  to?: number;
+}
+
+export namespace ToolListParams {
+  export interface SearchParam {
+    field?: string;
+
+    operation?: string;
+
+    value?: string;
+  }
+}
+
+export declare namespace Tools {
+  export {
+    type ToolRetrieveResponse as ToolRetrieveResponse,
+    type ToolListResponse as ToolListResponse,
+    type ToolRetrieveParams as ToolRetrieveParams,
+    type ToolListParams as ToolListParams,
+  };
+}