@composio/client 0.1.0-alpha.10 → 0.1.0-alpha.12

package/src/resources/files.ts

@@ -6,7 +6,13 @@ import { RequestOptions } from '../internal/request-options';
 
 export class Files extends APIResource {
   /**
-   * List files with optional app and action filters
+   * Retrieves a list of files associated with the authenticated project. Results can
+   * be filtered by toolkit and tool slugs.
+   *
+   * @example
+   * ```ts
+   * const files = await client.files.list();
+   * ```
    */
   list(
     query: FileListParams | null | undefined = {},
@@ -16,7 +22,19 @@ export class Files extends APIResource {
   }
 
   /**
-   * Create presigned URL for request file upload to S3
+   * Generates a presigned URL for uploading a file to S3. This endpoint handles
+   * deduplication by checking if a file with the same MD5 hash already exists.
+   *
+   * @example
+   * ```ts
+   * const response = await client.files.createPresignedURL({
+   *   filename: 'photo.jpg',
+   *   md5: 'd41d8cd98f00b204e9800998ecf8427e',
+   *   mimetype: 'image/jpeg',
+   *   tool_slug: 'resize-image',
+   *   toolkit_slug: 'image-processing',
+   * });
+   * ```
    */
   createPresignedURL(
     body: FileCreatePresignedURLParams,
@@ -37,27 +55,29 @@ export interface FileListResponse {
 export namespace FileListResponse {
   export interface Item {
     /**
-     * Name of the original file.
+     * Name of the original file. Example: "document.docx"
      */
     filename: string;
 
     /**
-     * MD5 of a file.
+     * MD5 hash of the file for integrity verification. Example:
+     * "d41d8cd98f00b204e9800998ecf8427e"
      */
     md5: string;
 
     /**
-     * Mime type of the original file.
+     * Mime type of the original file. Example:
+     * "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
      */
     mimetype: string;
 
     /**
-     * Name of the action where this file belongs to.
+     * Slug of the action where this file belongs to. Example: "convert-to-pdf"
      */
     tool_slug: string;
 
     /**
-     * Slug of the app where this file belongs to.
+     * Slug of the app where this file belongs to. Example: "file-converter"
      */
     toolkit_slug: string;
   }
@@ -71,57 +91,88 @@ export type FileCreatePresignedURLResponse =
 export namespace FileCreatePresignedURLResponse {
   export interface UnionMember0 {
     /**
-     * ID of the request file
+     * ID of the request file. Example: "f1e2d3c4b5a6"
      */
     id: string;
 
     /**
-     * URL of the existing request file
+     * 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
+     * S3 upload location. Example: "projects/123/files/photo-1234.jpg"
      */
     key: string;
 
+    /**
+     * Indicates the file already exists and does not need to be uploaded again
+     */
     type: 'existing';
   }
 
   export interface UnionMember1 {
     /**
-     * ID of the request file
+     * ID of the request file. Example: "f1e2d3c4b5a6"
      */
     id: string;
 
     /**
-     * S3 upload location
+     * S3 upload location. Example: "projects/123/files/photo-1234.jpg"
      */
     key: string;
 
     /**
-     * Presigned URL for upload
+     * 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 interface UnionMember2 {
     /**
-     * ID of the request file
+     * ID of the request file. Example: "f1e2d3c4b5a6"
      */
     id: string;
 
     /**
-     * S3 upload location
+     * S3 upload location. Example: "projects/123/files/photo-1234.jpg"
      */
     key: string;
 
+    /**
+     * Indicates this file exists but needs to be updated with a new version
+     */
     type: 'update';
 
     /**
-     * Presigned URL for upload
+     * Presigned URL for upload. Example:
+     * "https://storage.example.com/projects/123/files/photo-1234.jpg?X-Amz-Algorithm=..."
+     */
+    update_presigned_url: string;
+
+    /**
+     * [DEPRECATED] Use update_presigned_url instead. Presigned URL for upload.
+     * Example:
+     * "https://storage.example.com/projects/123/files/photo-1234.jpg?X-Amz-Algorithm=..."
      */
     updatePresignedUrl: string;
   }
@@ -129,39 +180,40 @@ export namespace FileCreatePresignedURLResponse {
 
 export interface FileListParams {
   /**
-   * Name of the action where this file belongs to.
+   * Filter files by action slug. Example: "convert-to-pdf"
    */
   tool_slug?: string;
 
   /**
-   * Slug of the app where this file belongs to.
+   * Filter files by app slug. Example: "file-converter"
    */
   toolkit_slug?: string;
 }
 
 export interface FileCreatePresignedURLParams {
   /**
-   * Name of the original file.
+   * Name of the original file. Example: "photo.jpg"
    */
   filename: string;
 
   /**
-   * MD5 of a file.
+   * MD5 hash of the file for deduplication and integrity verification. Example:
+   * "d41d8cd98f00b204e9800998ecf8427e"
    */
   md5: string;
 
   /**
-   * Mime type of the original file.
+   * Mime type of the original file. Example: "image/jpeg"
    */
   mimetype: string;
 
   /**
-   * Slug of the action where this file belongs to.
+   * Slug of the action where this file belongs to. Example: "resize-image"
    */
   tool_slug: string;
 
   /**
-   * Slug of the app where this file belongs to.
+   * Slug of the app where this file belongs to. Example: "image-processing"
    */
   toolkit_slug: string;
 }

package/src/resources/index.ts

@@ -40,11 +40,10 @@ export {
   type McpListResponse,
   type McpDeleteResponse,
   type McpRetrieveAppResponse,
-  type McpValidateResponse,
   type McpCreateParams,
   type McpUpdateParams,
   type McpListParams,
-  type McpValidateParams,
+  type McpRetrieveAppParams,
 } from './mcp/mcp';
 export {
   Migration,
@@ -67,6 +66,7 @@ export {
   type ToolkitListResponse,
   type ToolkitRetrieveCategoriesResponse,
   type ToolkitListParams,
+  type ToolkitRetrieveCategoriesParams,
 } from './toolkits';
 export {
   Tools,
@@ -83,8 +83,8 @@ export {
 } from './tools';
 export {
   TriggerInstances,
+  type TriggerInstanceDeleteResponse,
   type TriggerInstanceListActiveResponse,
-  type TriggerInstanceRemoveUpsertResponse,
   type TriggerInstanceUpdateStatusResponse,
   type TriggerInstanceUpsertResponse,
   type TriggerInstanceListActiveParams,

package/src/resources/mcp/custom.ts

@@ -0,0 +1,103 @@
+// 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 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/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>;
+
+  /**
+   * Set of command line instructions for connecting various clients to this MCP
+   * server
+   */
+  commands: CustomCreateResponse.Commands;
+
+  /**
+   * URL endpoint for establishing Server-Sent Events (SSE) 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-25 characters,
+   * alphanumeric and hyphens only)
+   */
+  name: string;
+
+  /**
+   * List of application/toolkit identifiers to enable for this server
+   */
+  toolkits: Array<string>;
+
+  /**
+   * Additional custom tool identifiers to enable that aren't part of standard
+   * toolkits
+   */
+  custom_tools?: Array<string>;
+}
+
+export declare namespace Custom {
+  export { type CustomCreateResponse as CustomCreateResponse, type CustomCreateParams as CustomCreateParams };
+}

package/src/resources/mcp/index.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Command, type CommandGenerateResponse, type CommandGenerateParams } from './command';
+export { Custom, type CustomCreateResponse, type CustomCreateParams } from './custom';
 export {
   Mcp,
   type McpCreateResponse,
@@ -9,9 +9,8 @@ export {
   type McpListResponse,
   type McpDeleteResponse,
   type McpRetrieveAppResponse,
-  type McpValidateResponse,
   type McpCreateParams,
   type McpUpdateParams,
   type McpListParams,
-  type McpValidateParams,
+  type McpRetrieveAppParams,
 } from './mcp';