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

package/resources/connected-accounts.js

@@ -4,24 +4,141 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConnectedAccounts = void 0;
 const resource_1 = require("../core/resource.js");
 const path_1 = require("../internal/utils/path.js");
+/**
+ * Connected account management
+ */
 class ConnectedAccounts extends resource_1.APIResource {
+    /**
+     * 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.
+     *
+     * **Deprecated for Composio-managed OAuth:** For Composio-managed auth configs on
+     * OAuth1, OAuth2, or DCR_OAUTH schemes, this endpoint is being retired and will
+     * start returning `400 BadRequest` on **2026-05-08** for new organizations and
+     * **2026-07-03** for all remaining organizations. Migrate those calls to
+     * `POST /api/v3/connected_accounts/link`. Custom auth configs and non-OAuth
+     * schemes (API key, bearer, basic) continue to be supported here. Responses on the
+     * retiring path carry a `Deprecation` header (RFC 9745) and a `Sunset` header
+     * (RFC 8594) for client-side detection.
+     *
+     * @example
+     * ```ts
+     * const connectedAccount =
+     *   await client.connectedAccounts.create({
+     *     auth_config: { id: 'id' },
+     *     connection: {},
+     *   });
+     * ```
+     */
     create(body, options) {
-        return this._client.post('/api/v3/connected_accounts', { body, ...options });
+        return this._client.post('/api/v3.1/connected_accounts', { body, ...options });
     }
+    /**
+     * Retrieves comprehensive details of a connected account, including authentication
+     * configuration, connection status, and all parameters needed for API requests.
+     *
+     * @example
+     * ```ts
+     * const connectedAccount =
+     *   await client.connectedAccounts.retrieve(
+     *     'ca_1a2b3c4d5e6f',
+     *   );
+     * ```
+     */
     retrieve(nanoid, options) {
-        return this._client.get((0, path_1.path) `/api/v3/connected_accounts/${nanoid}`, options);
+        return this._client.get((0, path_1.path) `/api/v3.1/connected_accounts/${nanoid}`, options);
     }
+    /**
+     * 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
+     * const connectedAccounts =
+     *   await client.connectedAccounts.list();
+     * ```
+     */
     list(query = {}, options) {
-        return this._client.get('/api/v3/connected_accounts', { query, ...options });
+        return this._client.get('/api/v3.1/connected_accounts', { query, ...options });
     }
+    /**
+     * Soft-deletes a connected account by marking it as deleted in the database. This
+     * prevents the account from being used for API calls but preserves the record for
+     * audit purposes.
+     *
+     * @example
+     * ```ts
+     * const connectedAccount =
+     *   await client.connectedAccounts.delete('ca_1a2b3c4d5e6f');
+     * ```
+     */
     delete(nanoid, options) {
-        return this._client.delete((0, path_1.path) `/api/v3/connected_accounts/${nanoid}`, options);
+        return this._client.delete((0, path_1.path) `/api/v3.1/connected_accounts/${nanoid}`, options);
     }
-    refresh(nanoid, options) {
-        return this._client.post((0, path_1.path) `/api/v3/connected_accounts/${nanoid}/refresh`, options);
+    /**
+     * Update a connected account. Supports updating the alias and/or credentials. Only
+     * specified fields will be updated. Set a credential field to null to remove it.
+     * Alias must be unique within the same project, entity, and toolkit scope.
+     *
+     * @example
+     * ```ts
+     * const response = await client.connectedAccounts.patch(
+     *   'ca_1a2b3c4d5e6f',
+     *   {
+     *     connection: {
+     *       state: {
+     *         authScheme: 'BEARER_TOKEN',
+     *         val: { token: 'new_access_token' },
+     *       },
+     *     },
+     *   },
+     * );
+     * ```
+     */
+    patch(nanoid, body = {}, options) {
+        return this._client.patch((0, path_1.path) `/api/v3.1/connected_accounts/${nanoid}`, { body, ...options });
     }
+    /**
+     * 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',
+     * );
+     * ```
+     */
+    refresh(nanoid, params = {}, options) {
+        const { query_redirect_url, ...body } = params ?? {};
+        return this._client.post((0, path_1.path) `/api/v3.1/connected_accounts/${nanoid}/refresh`, {
+            query: { redirect_url: query_redirect_url },
+            body,
+            ...options,
+        });
+    }
+    /**
+     * Updates the status of a connected account to either enabled (active) or disabled
+     * (inactive). Disabled accounts cannot be used for API calls but remain in the
+     * database.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.connectedAccounts.updateStatus(
+     *     'ca_1a2b3c4d5e6f',
+     *     { enabled: true },
+     *   );
+     * ```
+     */
     updateStatus(nanoID, body, options) {
-        return this._client.patch((0, path_1.path) `/api/v3/connected_accounts/${nanoID}/status`, { body, ...options });
+        return this._client.patch((0, path_1.path) `/api/v3.1/connected_accounts/${nanoID}/status`, { body, ...options });
     }
 }
 exports.ConnectedAccounts = ConnectedAccounts;

package/resources/connected-accounts.js.map

@@ -1 +1 @@
-{"version":3,"file":"connected-accounts.js","sourceRoot":"","sources":["../src/resources/connected-accounts.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,oDAA8C;AAE9C,MAAa,iBAAkB,SAAQ,sBAAW;IAChD,MAAM,CACJ,IAAkC,EAClC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,8BAA8B,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED,IAAI,CACF,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,CAAC,MAAc,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,8BAA8B,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,CAAC,MAAc,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,8BAA8B,MAAM,UAAU,EAAE,OAAO,CAAC,CAAC;IACxF,CAAC;IAED,YAAY,CACV,MAAc,EACd,IAAwC,EACxC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,8BAA8B,MAAM,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrG,CAAC;CACF;AAlCD,8CAkCC"}
+{"version":3,"file":"connected-accounts.js","sourceRoot":"","sources":["../src/resources/connected-accounts.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,oDAA8C;AAE9C;;GAEG;AACH,MAAa,iBAAkB,SAAQ,sBAAW;IAChD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CACJ,IAAkC,EAClC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gCAAgC,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,CACF,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAc,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,gCAAgC,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CACH,MAAc,EACd,OAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,gCAAgC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChG,CAAC;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CACL,MAAc,EACd,SAA2D,EAAE,EAC7D,OAAwB;QAExB,MAAM,EAAE,kBAAkB,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,gCAAgC,MAAM,UAAU,EAAE;YAC7E,KAAK,EAAE,EAAE,YAAY,EAAE,kBAAkB,EAAE;YAC3C,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,YAAY,CACV,MAAc,EACd,IAAwC,EACxC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,gCAAgC,MAAM,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvG,CAAC;CACF;AA7JD,8CA6JC"}

package/resources/connected-accounts.mjs

@@ -1,24 +1,141 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../core/resource.mjs";
 import { path } from "../internal/utils/path.mjs";
+/**
+ * Connected account management
+ */
 export class ConnectedAccounts extends APIResource {
+    /**
+     * 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.
+     *
+     * **Deprecated for Composio-managed OAuth:** For Composio-managed auth configs on
+     * OAuth1, OAuth2, or DCR_OAUTH schemes, this endpoint is being retired and will
+     * start returning `400 BadRequest` on **2026-05-08** for new organizations and
+     * **2026-07-03** for all remaining organizations. Migrate those calls to
+     * `POST /api/v3/connected_accounts/link`. Custom auth configs and non-OAuth
+     * schemes (API key, bearer, basic) continue to be supported here. Responses on the
+     * retiring path carry a `Deprecation` header (RFC 9745) and a `Sunset` header
+     * (RFC 8594) for client-side detection.
+     *
+     * @example
+     * ```ts
+     * const connectedAccount =
+     *   await client.connectedAccounts.create({
+     *     auth_config: { id: 'id' },
+     *     connection: {},
+     *   });
+     * ```
+     */
     create(body, options) {
-        return this._client.post('/api/v3/connected_accounts', { body, ...options });
+        return this._client.post('/api/v3.1/connected_accounts', { body, ...options });
     }
+    /**
+     * Retrieves comprehensive details of a connected account, including authentication
+     * configuration, connection status, and all parameters needed for API requests.
+     *
+     * @example
+     * ```ts
+     * const connectedAccount =
+     *   await client.connectedAccounts.retrieve(
+     *     'ca_1a2b3c4d5e6f',
+     *   );
+     * ```
+     */
     retrieve(nanoid, options) {
-        return this._client.get(path `/api/v3/connected_accounts/${nanoid}`, options);
+        return this._client.get(path `/api/v3.1/connected_accounts/${nanoid}`, options);
     }
+    /**
+     * 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
+     * const connectedAccounts =
+     *   await client.connectedAccounts.list();
+     * ```
+     */
     list(query = {}, options) {
-        return this._client.get('/api/v3/connected_accounts', { query, ...options });
+        return this._client.get('/api/v3.1/connected_accounts', { query, ...options });
     }
+    /**
+     * Soft-deletes a connected account by marking it as deleted in the database. This
+     * prevents the account from being used for API calls but preserves the record for
+     * audit purposes.
+     *
+     * @example
+     * ```ts
+     * const connectedAccount =
+     *   await client.connectedAccounts.delete('ca_1a2b3c4d5e6f');
+     * ```
+     */
     delete(nanoid, options) {
-        return this._client.delete(path `/api/v3/connected_accounts/${nanoid}`, options);
+        return this._client.delete(path `/api/v3.1/connected_accounts/${nanoid}`, options);
     }
-    refresh(nanoid, options) {
-        return this._client.post(path `/api/v3/connected_accounts/${nanoid}/refresh`, options);
+    /**
+     * Update a connected account. Supports updating the alias and/or credentials. Only
+     * specified fields will be updated. Set a credential field to null to remove it.
+     * Alias must be unique within the same project, entity, and toolkit scope.
+     *
+     * @example
+     * ```ts
+     * const response = await client.connectedAccounts.patch(
+     *   'ca_1a2b3c4d5e6f',
+     *   {
+     *     connection: {
+     *       state: {
+     *         authScheme: 'BEARER_TOKEN',
+     *         val: { token: 'new_access_token' },
+     *       },
+     *     },
+     *   },
+     * );
+     * ```
+     */
+    patch(nanoid, body = {}, options) {
+        return this._client.patch(path `/api/v3.1/connected_accounts/${nanoid}`, { body, ...options });
     }
+    /**
+     * 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',
+     * );
+     * ```
+     */
+    refresh(nanoid, params = {}, options) {
+        const { query_redirect_url, ...body } = params ?? {};
+        return this._client.post(path `/api/v3.1/connected_accounts/${nanoid}/refresh`, {
+            query: { redirect_url: query_redirect_url },
+            body,
+            ...options,
+        });
+    }
+    /**
+     * Updates the status of a connected account to either enabled (active) or disabled
+     * (inactive). Disabled accounts cannot be used for API calls but remain in the
+     * database.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.connectedAccounts.updateStatus(
+     *     'ca_1a2b3c4d5e6f',
+     *     { enabled: true },
+     *   );
+     * ```
+     */
     updateStatus(nanoID, body, options) {
-        return this._client.patch(path `/api/v3/connected_accounts/${nanoID}/status`, { body, ...options });
+        return this._client.patch(path `/api/v3.1/connected_accounts/${nanoID}/status`, { body, ...options });
     }
 }
 //# sourceMappingURL=connected-accounts.mjs.map

package/resources/connected-accounts.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"connected-accounts.mjs","sourceRoot":"","sources":["../src/resources/connected-accounts.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAChD,MAAM,CACJ,IAAkC,EAClC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,8BAA8B,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED,IAAI,CACF,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,CAAC,MAAc,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,8BAA8B,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,CAAC,MAAc,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,8BAA8B,MAAM,UAAU,EAAE,OAAO,CAAC,CAAC;IACxF,CAAC;IAED,YAAY,CACV,MAAc,EACd,IAAwC,EACxC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,8BAA8B,MAAM,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrG,CAAC;CACF"}
+{"version":3,"file":"connected-accounts.mjs","sourceRoot":"","sources":["../src/resources/connected-accounts.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAChD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CACJ,IAAkC,EAClC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gCAAgC,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,CACF,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAc,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,gCAAgC,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CACH,MAAc,EACd,OAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,gCAAgC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChG,CAAC;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CACL,MAAc,EACd,SAA2D,EAAE,EAC7D,OAAwB;QAExB,MAAM,EAAE,kBAAkB,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,gCAAgC,MAAM,UAAU,EAAE;YAC7E,KAAK,EAAE,EAAE,YAAY,EAAE,kBAAkB,EAAE;YAC3C,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,YAAY,CACV,MAAc,EACd,IAAwC,EACxC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,gCAAgC,MAAM,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvG,CAAC;CACF"}

package/resources/files.d.mts

@@ -0,0 +1,152 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+/**
+ * File management
+ */
+export declare class Files extends APIResource {
+    /**
+     * 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, options?: RequestOptions): APIPromise<FileListResponse>;
+    /**
+     * 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: 'quarterly_report.pdf',
+     *   md5: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6',
+     *   mimetype: 'application/pdf',
+     *   tool_slug: 'GMAIL_SEND_EMAIL',
+     *   toolkit_slug: 'gmail',
+     * });
+     * ```
+     */
+    createPresignedURL(body: FileCreatePresignedURLParams, options?: RequestOptions): APIPromise<FileCreatePresignedURLResponse>;
+}
+export interface FileListResponse {
+    current_page: number;
+    items: Array<FileListResponse.Item>;
+    total_items: number;
+    total_pages: number;
+    next_cursor?: string | null;
+}
+export declare namespace FileListResponse {
+    interface Item {
+        /**
+         * Name of the original file. Example: "document.docx"
+         */
+        filename: string;
+        /**
+         * MD5 hash of the file for integrity verification. Example:
+         * "d41d8cd98f00b204e9800998ecf8427e"
+         */
+        md5: string;
+        /**
+         * Mime type of the original file. Example:
+         * "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
+         */
+        mimetype: string;
+        /**
+         * 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. Example: "file-converter"
+         */
+        toolkit_slug: string;
+    }
+}
+export interface FileCreatePresignedURLResponse {
+    /**
+     * ID of the request file. Example: "req_file_9mZn4qR8sXwT"
+     */
+    id: string;
+    /**
+     * Object storage upload location. Example:
+     * "projects/pr_1a2b3c4d5e6f/requests/slack/SLACK_UPLOAD_FILE/document_9mZn4q.docx"
+     */
+    key: string;
+    metadata: FileCreatePresignedURLResponse.Metadata;
+    /**
+     * Presigned URL for upload. Example:
+     * "https://storage.composio.dev/projects/pr_1a2b3c4d5e6f/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600..."
+     */
+    new_presigned_url: string;
+    /**
+     * @deprecated [DEPRECATED] Use new_presigned_url instead. Presigned URL for
+     * upload. Example:
+     * "https://storage.composio.dev/projects/pr_1a2b3c4d5e6f/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600..."
+     */
+    newPresignedUrl: string;
+    /**
+     * @deprecated [DEPRECATED] Indicates this is a new file that needs to be uploaded
+     */
+    type: 'new';
+}
+export declare namespace FileCreatePresignedURLResponse {
+    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 FileListParams {
+    /**
+     * Cursor for pagination. The cursor is a base64 encoded string of the page and
+     * limit. The page is the page number and the limit is the number of items per
+     * page. The cursor is used to paginate through the items. The cursor is not
+     * required for the first page.
+     */
+    cursor?: string;
+    /**
+     * Number of items per page, max allowed is 1000
+     */
+    limit?: number | null;
+    /**
+     * Filter files by action slug. Example: "convert-to-pdf"
+     */
+    tool_slug?: string;
+    /**
+     * Filter files by app slug. Example: "file-converter"
+     */
+    toolkit_slug?: string;
+}
+export interface FileCreatePresignedURLParams {
+    /**
+     * Name of the original file. Example: "quarterly_report.pdf"
+     */
+    filename: string;
+    /**
+     * MD5 hash of the file for deduplication and integrity verification. Example:
+     * "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
+     */
+    md5: string;
+    /**
+     * Mime type of the original file. Example: "application/pdf", "image/png"
+     */
+    mimetype: string;
+    /**
+     * 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: "gmail", "slack", "github"
+     */
+    toolkit_slug: string;
+}
+export declare namespace Files {
+    export { type FileListResponse as FileListResponse, type FileCreatePresignedURLResponse as FileCreatePresignedURLResponse, type FileListParams as FileListParams, type FileCreatePresignedURLParams as FileCreatePresignedURLParams, };
+}
+//# sourceMappingURL=files.d.mts.map

package/resources/files.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.mts","sourceRoot":"","sources":["../src/resources/files.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB;;GAEG;AACH,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;;;OAQG;IACH,IAAI,CACF,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,gBAAgB,CAAC;IAI/B;;;;;;;;;;;;;;OAcG;IACH,kBAAkB,CAChB,IAAI,EAAE,4BAA4B,EAClC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;CAG9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IAErB,KAAK,EAAE,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAEpC,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,yBAAiB,gBAAgB,CAAC;IAChC,UAAiB,IAAI;QACnB;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;;WAGG;QACH,GAAG,EAAE,MAAM,CAAC;QAEZ;;;WAGG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,YAAY,EAAE,MAAM,CAAC;KACtB;CACF;AAED,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ,QAAQ,EAAE,8BAA8B,CAAC,QAAQ,CAAC;IAElD;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,IAAI,EAAE,KAAK,CAAC;CACb;AAED,yBAAiB,8BAA8B,CAAC;IAC9C,UAAiB,QAAQ;QACvB;;;WAGG;QACH,eAAe,EAAE,IAAI,GAAG,oBAAoB,CAAC;KAC9C;CACF;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,4BAA4B,IAAI,4BAA4B,GAClE,CAAC;CACH"}

package/resources/files.d.ts

@@ -0,0 +1,152 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+/**
+ * File management
+ */
+export declare class Files extends APIResource {
+    /**
+     * 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, options?: RequestOptions): APIPromise<FileListResponse>;
+    /**
+     * 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: 'quarterly_report.pdf',
+     *   md5: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6',
+     *   mimetype: 'application/pdf',
+     *   tool_slug: 'GMAIL_SEND_EMAIL',
+     *   toolkit_slug: 'gmail',
+     * });
+     * ```
+     */
+    createPresignedURL(body: FileCreatePresignedURLParams, options?: RequestOptions): APIPromise<FileCreatePresignedURLResponse>;
+}
+export interface FileListResponse {
+    current_page: number;
+    items: Array<FileListResponse.Item>;
+    total_items: number;
+    total_pages: number;
+    next_cursor?: string | null;
+}
+export declare namespace FileListResponse {
+    interface Item {
+        /**
+         * Name of the original file. Example: "document.docx"
+         */
+        filename: string;
+        /**
+         * MD5 hash of the file for integrity verification. Example:
+         * "d41d8cd98f00b204e9800998ecf8427e"
+         */
+        md5: string;
+        /**
+         * Mime type of the original file. Example:
+         * "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
+         */
+        mimetype: string;
+        /**
+         * 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. Example: "file-converter"
+         */
+        toolkit_slug: string;
+    }
+}
+export interface FileCreatePresignedURLResponse {
+    /**
+     * ID of the request file. Example: "req_file_9mZn4qR8sXwT"
+     */
+    id: string;
+    /**
+     * Object storage upload location. Example:
+     * "projects/pr_1a2b3c4d5e6f/requests/slack/SLACK_UPLOAD_FILE/document_9mZn4q.docx"
+     */
+    key: string;
+    metadata: FileCreatePresignedURLResponse.Metadata;
+    /**
+     * Presigned URL for upload. Example:
+     * "https://storage.composio.dev/projects/pr_1a2b3c4d5e6f/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600..."
+     */
+    new_presigned_url: string;
+    /**
+     * @deprecated [DEPRECATED] Use new_presigned_url instead. Presigned URL for
+     * upload. Example:
+     * "https://storage.composio.dev/projects/pr_1a2b3c4d5e6f/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600..."
+     */
+    newPresignedUrl: string;
+    /**
+     * @deprecated [DEPRECATED] Indicates this is a new file that needs to be uploaded
+     */
+    type: 'new';
+}
+export declare namespace FileCreatePresignedURLResponse {
+    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 FileListParams {
+    /**
+     * Cursor for pagination. The cursor is a base64 encoded string of the page and
+     * limit. The page is the page number and the limit is the number of items per
+     * page. The cursor is used to paginate through the items. The cursor is not
+     * required for the first page.
+     */
+    cursor?: string;
+    /**
+     * Number of items per page, max allowed is 1000
+     */
+    limit?: number | null;
+    /**
+     * Filter files by action slug. Example: "convert-to-pdf"
+     */
+    tool_slug?: string;
+    /**
+     * Filter files by app slug. Example: "file-converter"
+     */
+    toolkit_slug?: string;
+}
+export interface FileCreatePresignedURLParams {
+    /**
+     * Name of the original file. Example: "quarterly_report.pdf"
+     */
+    filename: string;
+    /**
+     * MD5 hash of the file for deduplication and integrity verification. Example:
+     * "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
+     */
+    md5: string;
+    /**
+     * Mime type of the original file. Example: "application/pdf", "image/png"
+     */
+    mimetype: string;
+    /**
+     * 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: "gmail", "slack", "github"
+     */
+    toolkit_slug: string;
+}
+export declare namespace Files {
+    export { type FileListResponse as FileListResponse, type FileCreatePresignedURLResponse as FileCreatePresignedURLResponse, type FileListParams as FileListParams, type FileCreatePresignedURLParams as FileCreatePresignedURLParams, };
+}
+//# sourceMappingURL=files.d.ts.map

package/resources/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/resources/files.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB;;GAEG;AACH,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;;;OAQG;IACH,IAAI,CACF,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,gBAAgB,CAAC;IAI/B;;;;;;;;;;;;;;OAcG;IACH,kBAAkB,CAChB,IAAI,EAAE,4BAA4B,EAClC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;CAG9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IAErB,KAAK,EAAE,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAEpC,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,yBAAiB,gBAAgB,CAAC;IAChC,UAAiB,IAAI;QACnB;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;;WAGG;QACH,GAAG,EAAE,MAAM,CAAC;QAEZ;;;WAGG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,YAAY,EAAE,MAAM,CAAC;KACtB;CACF;AAED,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ,QAAQ,EAAE,8BAA8B,CAAC,QAAQ,CAAC;IAElD;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,IAAI,EAAE,KAAK,CAAC;CACb;AAED,yBAAiB,8BAA8B,CAAC;IAC9C,UAAiB,QAAQ;QACvB;;;WAGG;QACH,eAAe,EAAE,IAAI,GAAG,oBAAoB,CAAC;KAC9C;CACF;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,4BAA4B,IAAI,4BAA4B,GAClE,CAAC;CACH"}

package/resources/files.js

@@ -0,0 +1,42 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Files = void 0;
+const resource_1 = require("../core/resource.js");
+/**
+ * File management
+ */
+class Files extends resource_1.APIResource {
+    /**
+     * 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 = {}, options) {
+        return this._client.get('/api/v3.1/files/list', { query, ...options });
+    }
+    /**
+     * 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: 'quarterly_report.pdf',
+     *   md5: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6',
+     *   mimetype: 'application/pdf',
+     *   tool_slug: 'GMAIL_SEND_EMAIL',
+     *   toolkit_slug: 'gmail',
+     * });
+     * ```
+     */
+    createPresignedURL(body, options) {
+        return this._client.post('/api/v3.1/files/upload/request', { body, ...options });
+    }
+}
+exports.Files = Files;
+//# sourceMappingURL=files.js.map