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

package/src/resources/migration.ts

@@ -0,0 +1,49 @@
+// 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';
+
+/**
+ * Endpoints to help with migration from v1 to v3
+ */
+export class Migration extends APIResource {
+  /**
+   * Convert a legacy UUID to its corresponding NanoId for migration purposes. This
+   * endpoint facilitates the transition from UUID-based identifiers to the more
+   * compact NanoId format used in the v3 API.
+   */
+  retrieveNanoid(
+    query: MigrationRetrieveNanoidParams,
+    options?: RequestOptions,
+  ): APIPromise<MigrationRetrieveNanoidResponse> {
+    return this._client.get('/api/v3.1/migration/get-nanoid', { query, ...options });
+  }
+}
+
+export interface MigrationRetrieveNanoidResponse {
+  /**
+   * The NanoId corresponding to the provided UUID. This is the new identifier that
+   * should be used in place of the legacy UUID.
+   */
+  nanoid: string;
+}
+
+export interface MigrationRetrieveNanoidParams {
+  /**
+   * The type of resource that the UUID belongs to
+   */
+  type: 'CONNECTED_ACCOUNT' | 'AUTH_CONFIG' | 'TRIGGER_INSTANCE';
+
+  /**
+   * The legacy UUID that needs to be converted to a NanoId
+   */
+  uuid: string;
+}
+
+export declare namespace Migration {
+  export {
+    type MigrationRetrieveNanoidResponse as MigrationRetrieveNanoidResponse,
+    type MigrationRetrieveNanoidParams as MigrationRetrieveNanoidParams,
+  };
+}

package/src/resources/project/config.ts

@@ -0,0 +1,110 @@
+// 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 Config extends APIResource {
+  /**
+   * Retrieves the current project configuration including 2FA settings.
+   *
+   * @example
+   * ```ts
+   * const config = await client.project.config.retrieve();
+   * ```
+   */
+  retrieve(options?: RequestOptions): APIPromise<ConfigRetrieveResponse> {
+    return this._client.get('/api/v3.1/org/project/config', options);
+  }
+
+  /**
+   * Updates the project configuration settings.
+   *
+   * @example
+   * ```ts
+   * const config = await client.project.config.update({
+   *   is_2FA_enabled: true,
+   * });
+   * ```
+   */
+  update(
+    body: ConfigUpdateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ConfigUpdateResponse> {
+    return this._client.patch('/api/v3.1/org/project/config', { body, ...options });
+  }
+}
+
+export interface ConfigRetrieveResponse {
+  is_2FA_enabled: boolean;
+
+  log_visibility_setting: 'show_all' | 'dont_store_data';
+
+  mask_secret_keys_in_connected_account: boolean;
+
+  display_name?: string;
+
+  /**
+   * Whether to enable composio link for managed authentication. This key will be
+   * deprecated in the future. Please don't use this key.
+   */
+  is_composio_link_enabled_for_managed_auth?: boolean;
+
+  logo_url?: string;
+
+  require_mcp_api_key?: boolean;
+
+  signed_url_file_expiry_in_seconds?: number;
+}
+
+export interface ConfigUpdateResponse {
+  is_2FA_enabled: boolean;
+
+  log_visibility_setting: 'show_all' | 'dont_store_data';
+
+  mask_secret_keys_in_connected_account: boolean;
+
+  display_name?: string;
+
+  /**
+   * Whether to enable composio link for managed authentication. This key will be
+   * deprecated in the future. Please don't use this key.
+   */
+  is_composio_link_enabled_for_managed_auth?: boolean;
+
+  logo_url?: string;
+
+  require_mcp_api_key?: boolean;
+
+  signed_url_file_expiry_in_seconds?: number;
+}
+
+export interface ConfigUpdateParams {
+  display_name?: string;
+
+  is_2FA_enabled?: boolean;
+
+  /**
+   * Whether to enable composio link for managed authentication. This key will be
+   * deprecated in the future. Please don't use this key.
+   */
+  is_composio_link_enabled_for_managed_auth?: boolean;
+
+  log_visibility_setting?: 'show_all' | 'dont_store_data';
+
+  logo_url?: string;
+
+  mask_secret_keys_in_connected_account?: boolean;
+
+  require_mcp_api_key?: boolean;
+
+  signed_url_file_expiry_in_seconds?: number;
+}
+
+export declare namespace Config {
+  export {
+    type ConfigRetrieveResponse as ConfigRetrieveResponse,
+    type ConfigUpdateResponse as ConfigUpdateResponse,
+    type ConfigUpdateParams as ConfigUpdateParams,
+  };
+}

package/src/resources/project/index.ts

@@ -0,0 +1,9 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Config,
+  type ConfigRetrieveResponse,
+  type ConfigUpdateResponse,
+  type ConfigUpdateParams,
+} from './config';
+export { Project } from './project';

package/src/resources/project/project.ts

@@ -0,0 +1,20 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ConfigAPI from './config';
+import { Config, ConfigRetrieveResponse, ConfigUpdateParams, ConfigUpdateResponse } from './config';
+
+export class Project extends APIResource {
+  config: ConfigAPI.Config = new ConfigAPI.Config(this._client);
+}
+
+Project.Config = Config;
+
+export declare namespace Project {
+  export {
+    Config as Config,
+    type ConfigRetrieveResponse as ConfigRetrieveResponse,
+    type ConfigUpdateResponse as ConfigUpdateResponse,
+    type ConfigUpdateParams as ConfigUpdateParams,
+  };
+}

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

@@ -0,0 +1,33 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Session,
+  type SessionCreateResponse,
+  type SessionRetrieveResponse,
+  type SessionAttachResponse,
+  type SessionConfigHistoryResponse,
+  type SessionExecuteResponse,
+  type SessionExecuteMetaResponse,
+  type SessionLinkResponse,
+  type SessionPatchResponse,
+  type SessionProxyExecuteResponse,
+  type SessionSearchResponse,
+  type SessionToolkitsResponse,
+  type SessionToolsResponse,
+  type SessionCreateParams,
+  type SessionAttachParams,
+  type SessionConfigHistoryParams,
+  type SessionExecuteParams,
+  type SessionExecuteMetaParams,
+  type SessionLinkParams,
+  type SessionPatchParams,
+  type SessionProxyExecuteParams,
+  type SessionSearchParams,
+  type SessionToolkitsParams,
+  type SessionToolsParams,
+} from './session/index';
+export {
+  ToolRouter,
+  type ToolRouterCreateSessionResponse,
+  type ToolRouterCreateSessionParams,
+} from './tool-router';

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

@@ -0,0 +1,284 @@
+// 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';
+
+/**
+ * (Labs) Tool router endpoints
+ */
+export class Files extends APIResource {
+  /**
+   * Lists files in a workbench session storage mount with cursor-based pagination.
+   * Use the download_url endpoint with the returned mount_relative_path to get a
+   * presigned download URL.
+   *
+   * @example
+   * ```ts
+   * const files = await client.toolRouter.session.files.list(
+   *   'files',
+   *   { session_id: 'trs_1a2b3c4d5e6f' },
+   * );
+   * ```
+   */
+  list(mountID: string, params: FileListParams, options?: RequestOptions): APIPromise<FileListResponse> {
+    const { session_id, ...query } = params;
+    return this._client.get(path`/api/v3.1/tool_router/session/${session_id}/mounts/${mountID}/items`, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Deletes a file from a workbench session storage mount. S3 delete is idempotent —
+   * deleting a non-existent file succeeds silently.
+   *
+   * @example
+   * ```ts
+   * const file = await client.toolRouter.session.files.delete(
+   *   'files',
+   *   {
+   *     session_id: 'trs_1a2b3c4d5e6f',
+   *     mount_relative_path: 'report.pdf',
+   *   },
+   * );
+   * ```
+   */
+  delete(
+    mountID: string,
+    params: FileDeleteParams,
+    options?: RequestOptions,
+  ): APIPromise<FileDeleteResponse> {
+    const { session_id, ...body } = params;
+    return this._client.post(path`/api/v3.1/tool_router/session/${session_id}/mounts/${mountID}/delete`, {
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Generates a presigned download URL for a file in a workbench session mount.
+   * Accepts a relative path within the mount.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.toolRouter.session.files.createDownloadURL(
+   *     'files',
+   *     {
+   *       session_id: 'trs_1a2b3c4d5e6f',
+   *       mount_relative_path: 'report.pdf',
+   *     },
+   *   );
+   * ```
+   */
+  createDownloadURL(
+    mountID: string,
+    params: FileCreateDownloadURLParams,
+    options?: RequestOptions,
+  ): APIPromise<FileCreateDownloadURLResponse> {
+    const { session_id, ...body } = params;
+    return this._client.post(
+      path`/api/v3.1/tool_router/session/${session_id}/mounts/${mountID}/download_url`,
+      { body, ...options },
+    );
+  }
+
+  /**
+   * Generates a presigned upload URL for uploading a file to a workbench session
+   * mount. The caller should PUT the file content directly to the returned URL.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.toolRouter.session.files.createUploadURL(
+   *     'files',
+   *     {
+   *       session_id: 'trs_1a2b3c4d5e6f',
+   *       mount_relative_path: 'report.pdf',
+   *     },
+   *   );
+   * ```
+   */
+  createUploadURL(
+    mountID: string,
+    params: FileCreateUploadURLParams,
+    options?: RequestOptions,
+  ): APIPromise<FileCreateUploadURLResponse> {
+    const { session_id, ...body } = params;
+    return this._client.post(path`/api/v3.1/tool_router/session/${session_id}/mounts/${mountID}/upload_url`, {
+      body,
+      ...options,
+    });
+  }
+}
+
+export interface FileListResponse {
+  /**
+   * List of files in the mount
+   */
+  items: Array<FileListResponse.Item>;
+
+  /**
+   * Cursor for the next page of results. If absent, there are no more pages.
+   */
+  next_cursor?: string;
+}
+
+export namespace FileListResponse {
+  export interface Item {
+    /**
+     * ISO 8601 timestamp of last modification
+     */
+    last_modified: string;
+
+    /**
+     * Relative file path within the mount (e.g. "report.pdf")
+     */
+    mount_relative_path: string;
+
+    /**
+     * Absolute mount path inside the sandbox (e.g. /mnt/files)
+     */
+    sandbox_mount_prefix: string;
+
+    /**
+     * File size in bytes
+     */
+    size: number;
+  }
+}
+
+export interface FileDeleteResponse {
+  /**
+   * Relative file path that was deleted
+   */
+  mount_relative_path: string;
+
+  /**
+   * Absolute mount path inside the sandbox (e.g. /mnt/files)
+   */
+  sandbox_mount_prefix: string;
+}
+
+export interface FileCreateDownloadURLResponse {
+  /**
+   * Presigned download URL for the file
+   */
+  download_url: string;
+
+  /**
+   * ISO 8601 timestamp when the download URL expires
+   */
+  expires_at: string;
+
+  /**
+   * Relative file path within the mount (e.g. "report.pdf")
+   */
+  mount_relative_path: string;
+
+  /**
+   * Absolute mount path inside the sandbox (e.g. /mnt/files)
+   */
+  sandbox_mount_prefix: string;
+}
+
+export interface FileCreateUploadURLResponse {
+  /**
+   * ISO 8601 timestamp when the upload URL expires
+   */
+  expires_at: string;
+
+  /**
+   * Relative file path within the mount (e.g. "report.pdf")
+   */
+  mount_relative_path: string;
+
+  /**
+   * Absolute mount path inside the sandbox (e.g. /mnt/files)
+   */
+  sandbox_mount_prefix: string;
+
+  /**
+   * Presigned upload URL — PUT the file content here
+   */
+  upload_url: string;
+}
+
+export interface FileListParams {
+  /**
+   * Path param: The unique identifier of the tool router session
+   */
+  session_id: string;
+
+  /**
+   * Query param: Pagination cursor from the previous response next_cursor field
+   */
+  cursor?: string;
+
+  /**
+   * Query param: Maximum number of files to return per page (1-500)
+   */
+  limit?: number;
+
+  /**
+   * Query param: Relative path prefix within the mount for filtering
+   */
+  mount_relative_prefix?: string;
+}
+
+export interface FileDeleteParams {
+  /**
+   * Path param: The unique identifier of the tool router session
+   */
+  session_id: string;
+
+  /**
+   * Body param: Relative file path within the mount
+   */
+  mount_relative_path: string;
+}
+
+export interface FileCreateDownloadURLParams {
+  /**
+   * Path param: The unique identifier of the tool router session
+   */
+  session_id: string;
+
+  /**
+   * Body param: Relative file path within the mount
+   */
+  mount_relative_path: string;
+}
+
+export interface FileCreateUploadURLParams {
+  /**
+   * Path param: The unique identifier of the tool router session
+   */
+  session_id: string;
+
+  /**
+   * Body param: Supports subdirectories (e.g. "data/output.csv",
+   * "images/charts/chart.png")
+   */
+  mount_relative_path: string;
+
+  /**
+   * Body param: MIME type of the file being uploaded
+   */
+  mimetype?: string;
+}
+
+export declare namespace Files {
+  export {
+    type FileListResponse as FileListResponse,
+    type FileDeleteResponse as FileDeleteResponse,
+    type FileCreateDownloadURLResponse as FileCreateDownloadURLResponse,
+    type FileCreateUploadURLResponse as FileCreateUploadURLResponse,
+    type FileListParams as FileListParams,
+    type FileDeleteParams as FileDeleteParams,
+    type FileCreateDownloadURLParams as FileCreateDownloadURLParams,
+    type FileCreateUploadURLParams as FileCreateUploadURLParams,
+  };
+}

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

@@ -0,0 +1,39 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Files,
+  type FileListResponse,
+  type FileDeleteResponse,
+  type FileCreateDownloadURLResponse,
+  type FileCreateUploadURLResponse,
+  type FileListParams,
+  type FileDeleteParams,
+  type FileCreateDownloadURLParams,
+  type FileCreateUploadURLParams,
+} from './files';
+export {
+  Session,
+  type SessionCreateResponse,
+  type SessionRetrieveResponse,
+  type SessionAttachResponse,
+  type SessionConfigHistoryResponse,
+  type SessionExecuteResponse,
+  type SessionExecuteMetaResponse,
+  type SessionLinkResponse,
+  type SessionPatchResponse,
+  type SessionProxyExecuteResponse,
+  type SessionSearchResponse,
+  type SessionToolkitsResponse,
+  type SessionToolsResponse,
+  type SessionCreateParams,
+  type SessionAttachParams,
+  type SessionConfigHistoryParams,
+  type SessionExecuteParams,
+  type SessionExecuteMetaParams,
+  type SessionLinkParams,
+  type SessionPatchParams,
+  type SessionProxyExecuteParams,
+  type SessionSearchParams,
+  type SessionToolkitsParams,
+  type SessionToolsParams,
+} from './session';