@composio/client 0.1.0-alpha.7 → 0.1.0-alpha.71

package/src/resources/logs/index.ts

@@ -0,0 +1,10 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Logs } from './logs';
+export { Tools, type ToolRetrieveResponse, type ToolListResponse, type ToolListParams } from './tools';
+export {
+  Triggers,
+  type TriggerRetrieveResponse,
+  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, ToolRetrieveResponse, Tools } from './tools';
+import * as TriggersAPI from './triggers';
+import { TriggerListParams, TriggerListResponse, TriggerRetrieveResponse, 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 TriggerRetrieveResponse as TriggerRetrieveResponse,
+    type TriggerListResponse as TriggerListResponse,
+    type TriggerListParams as TriggerListParams,
+  };
+
+  export {
+    Tools as Tools,
+    type ToolRetrieveResponse as ToolRetrieveResponse,
+    type ToolListResponse as ToolListResponse,
+    type ToolListParams as ToolListParams,
+  };
+}

package/src/resources/logs/tools.ts

@@ -0,0 +1,239 @@
+// 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';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Logging and monitoring
+ */
+export class Tools extends APIResource {
+  /**
+   * Get detailed execution log by ID
+   *
+   * @example
+   * ```ts
+   * const tool = await client.logs.tools.retrieve('id');
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<ToolRetrieveResponse> {
+    return this._client.get(path`/api/v3.1/internal/action_execution/log/${id}`, 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.1/internal/action_execution/logs', { body, ...options });
+  }
+}
+
+export interface ToolRetrieveResponse {
+  actionId: string;
+
+  actionLogId: string;
+
+  app: ToolRetrieveResponse.App;
+
+  connection: ToolRetrieveResponse.Connection;
+
+  endTime: number;
+
+  error: { [key: string]: unknown };
+
+  executionMetadata: { [key: string]: unknown };
+
+  payloadReceived: { [key: string]: unknown };
+
+  response: { [key: string]: unknown };
+
+  session: { [key: string]: unknown };
+
+  startTime: number;
+
+  status: 'success' | 'error' | 'warning' | 'info';
+
+  steps: Array<ToolRetrieveResponse.Step>;
+
+  totalDuration: string;
+
+  version: string;
+}
+
+export namespace ToolRetrieveResponse {
+  export interface App {
+    icon: string;
+
+    name: string;
+
+    uniqueId: string;
+  }
+
+  export interface Connection {
+    id: string;
+
+    entity: string;
+  }
+
+  export interface Step {
+    endTime: number;
+
+    message: string;
+
+    startTime: number;
+
+    status: 'success' | 'failure' | 'error';
+
+    totalDuration: number;
+
+    type: 'tool_execution' | 'fetch_connection_details';
+
+    logs?: Array<Step.Log>;
+
+    metadata?: Step.Metadata;
+  }
+
+  export namespace Step {
+    export interface Log {
+      level: string;
+
+      message: string;
+
+      request: Log.Request;
+
+      requestId: string;
+
+      response: Log.Response;
+
+      time: number;
+
+      type: 'network' | 'system';
+    }
+
+    export namespace Log {
+      export interface Request {
+        method: string;
+
+        url: string;
+
+        headers?: { [key: string]: string };
+
+        json?: { [key: string]: unknown };
+
+        params?: { [key: string]: unknown };
+
+        timeout?: number;
+      }
+
+      export interface Response {
+        status: number;
+
+        time: string;
+      }
+    }
+
+    export interface Metadata {
+      encryption?: 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 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 ToolListParams as ToolListParams,
+  };
+}

package/src/resources/logs/triggers.ts

@@ -0,0 +1,241 @@
+// 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';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Logging and monitoring
+ */
+export class Triggers extends APIResource {
+  /**
+   * Get detailed trigger log by ID
+   *
+   * @example
+   * ```ts
+   * const trigger = await client.logs.triggers.retrieve('id');
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<TriggerRetrieveResponse> {
+    return this._client.get(path`/api/v3.1/internal/trigger/log/${id}`, options);
+  }
+
+  /**
+   * Search and retrieve trigger event logs with advanced filtering capabilities
+   * including search parameters
+   *
+   * @example
+   * ```ts
+   * const triggers = await client.logs.triggers.list();
+   * ```
+   */
+  list(
+    body: TriggerListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TriggerListResponse> {
+    return this._client.post('/api/v3.1/internal/trigger/logs', { body, ...options });
+  }
+}
+
+export interface TriggerRetrieveResponse {
+  log: TriggerRetrieveResponse.Log;
+}
+
+export namespace TriggerRetrieveResponse {
+  export interface Log {
+    id: string;
+
+    appName: string;
+
+    clientId: string;
+
+    connectionId: string;
+
+    createdAt: string;
+
+    entityId: string;
+
+    meta: Log.Meta;
+
+    status: string;
+
+    /**
+     * Log entity type (trigger or action)
+     */
+    type: 'trigger' | 'action';
+  }
+
+  export namespace Log {
+    export interface Meta {
+      id: string;
+
+      clientId: string;
+
+      connectionId: string;
+
+      createdAt: string;
+
+      provider: string;
+
+      /**
+       * Log entity type (trigger or action)
+       */
+      type: 'trigger' | 'action';
+
+      updatedAt: string;
+
+      triggerClientError?: string;
+
+      triggerClientPayload?: string;
+
+      triggerClientResponse?: string;
+
+      triggerId?: string;
+
+      triggerName?: string;
+
+      triggerNanoId?: string;
+
+      triggerProviderPayload?: string;
+    }
+  }
+}
+
+export interface TriggerListResponse {
+  nextCursor: string | null;
+
+  data?: Array<TriggerListResponse.Data>;
+}
+
+export namespace TriggerListResponse {
+  export interface Data {
+    id: string;
+
+    appName: string;
+
+    clientId: string;
+
+    connectionId: string;
+
+    createdAt: string;
+
+    entityId: string;
+
+    meta: Data.Meta;
+
+    status: string;
+
+    /**
+     * Log entity type (trigger or action)
+     */
+    type: 'trigger' | 'action';
+  }
+
+  export namespace Data {
+    export interface Meta {
+      id: string;
+
+      clientId: string;
+
+      connectionId: string;
+
+      createdAt: string;
+
+      provider: string;
+
+      /**
+       * Log entity type (trigger or action)
+       */
+      type: 'trigger' | 'action';
+
+      updatedAt: string;
+
+      triggerClientError?: string;
+
+      triggerClientPayload?: string;
+
+      triggerClientResponse?: string;
+
+      triggerId?: string;
+
+      triggerName?: string;
+
+      triggerNanoId?: string;
+
+      triggerProviderPayload?: string;
+    }
+  }
+}
+
+export interface TriggerListParams {
+  cursor?: string | null;
+
+  entityId?: string;
+
+  /**
+   * Start time for logs (epoch timestamp in milliseconds)
+   */
+  from?: number | null;
+
+  /**
+   * Whether to include payload fields in the response. Set to false for faster list
+   * views.
+   */
+  include_payload?: boolean;
+
+  integrationId?: string;
+
+  /**
+   * The limit of trigger logs to return
+   */
+  limit?: number | null;
+
+  /**
+   * Search term to filter logs
+   */
+  search?: string;
+
+  /**
+   * Advanced search parameters for filtering logs
+   */
+  search_params?: Array<TriggerListParams.SearchParam>;
+
+  /**
+   * Filter logs by their status level
+   */
+  status?: 'all' | 'success' | 'error';
+
+  /**
+   * Return logs from the last N time units
+   */
+  time?: '5m' | '30m' | '6h' | '1d' | '1w' | '1month' | '1y';
+
+  /**
+   * End time for logs (epoch timestamp in milliseconds)
+   */
+  to?: number | null;
+
+  /**
+   * Filter logs by user ID
+   */
+  userId?: string;
+}
+
+export namespace TriggerListParams {
+  export interface SearchParam {
+    field?: string;
+
+    operation?: string;
+
+    value?: string;
+  }
+}
+
+export declare namespace Triggers {
+  export {
+    type TriggerRetrieveResponse as TriggerRetrieveResponse,
+    type TriggerListResponse as TriggerListResponse,
+    type TriggerListParams as TriggerListParams,
+  };
+}

package/src/resources/{auth.ts → logs.ts}

@@ -1,3 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export * from './auth/index';
+export * from './logs/index';

package/src/resources/mcp/custom.ts

@@ -0,0 +1,125 @@
+// 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';
+
+/**
+ * MCP server management
+ */
+export class Custom extends APIResource {
+  /**
+   * Creates a new Model Control Protocol (MCP) server instance that can integrate
+   * with multiple applications or toolkits simultaneously. This endpoint allows you
+   * to create a server that can access tools from different applications, making it
+   * suitable for complex workflows that span multiple services.
+   *
+   * @example
+   * ```ts
+   * const custom = await client.mcp.custom.create({
+   *   name: 'Development Integration Server',
+   *   toolkits: ['github', 'jira'],
+   * });
+   * ```
+   */
+  create(body: CustomCreateParams, options?: RequestOptions): APIPromise<CustomCreateResponse> {
+    return this._client.post('/api/v3.1/mcp/servers/custom', { body, ...options });
+  }
+}
+
+/**
+ * Response for a successfully created custom MCP server with multiple applications
+ */
+export interface CustomCreateResponse {
+  /**
+   * Unique identifier for the newly created custom MCP server
+   */
+  id: string;
+
+  /**
+   * List of tool identifiers that are enabled for this server
+   */
+  allowed_tools: Array<string>;
+
+  /**
+   * ID references to the auth configurations used by this server
+   */
+  auth_config_ids: Array<string>;
+
+  /**
+   * Set of command line instructions for connecting various clients to this MCP
+   * server
+   */
+  commands: CustomCreateResponse.Commands;
+
+  /**
+   * URL endpoint for establishing connection to this MCP server
+   */
+  mcp_url: string;
+
+  /**
+   * Human-readable name of the custom MCP server
+   */
+  name: string;
+}
+
+export namespace CustomCreateResponse {
+  /**
+   * Set of command line instructions for connecting various clients to this MCP
+   * server
+   */
+  export interface Commands {
+    /**
+     * Command line instruction for Claude client setup
+     */
+    claude: string;
+
+    /**
+     * Command line instruction for Cursor client setup
+     */
+    cursor: string;
+
+    /**
+     * Command line instruction for Windsurf client setup
+     */
+    windsurf: string;
+  }
+}
+
+export interface CustomCreateParams {
+  /**
+   * Human-readable name to identify this custom MCP server (4-30 characters,
+   * alphanumeric, spaces, and hyphens only)
+   */
+  name: string;
+
+  /**
+   * Tool identifiers to enable that aren't part of standard toolkits
+   */
+  allowed_tools?: Array<string>;
+
+  /**
+   * ID references to existing authentication configurations
+   */
+  auth_config_ids?: Array<string>;
+
+  /**
+   * DEPRECATED: Use allowed_tools instead. Tool identifiers to enable that aren't
+   * part of standard toolkits
+   */
+  custom_tools?: Array<string>;
+
+  /**
+   * Whether to manage authentication via Composio
+   */
+  managed_auth_via_composio?: boolean;
+
+  /**
+   * List of application/toolkit identifiers to enable for this server
+   */
+  toolkits?: Array<string>;
+}
+
+export declare namespace Custom {
+  export { type CustomCreateResponse as CustomCreateResponse, type CustomCreateParams as CustomCreateParams };
+}