@composio/client 0.1.0-alpha.60 → 0.1.0-alpha.61

package/src/client.ts

@@ -11,7 +11,7 @@ import type { APIResponseProps } from './internal/parse';
 import { getPlatformHeaders } from './internal/detect-platform';
 import * as Shims from './internal/shims';
 import * as Opts from './internal/request-options';
-import * as qs from './internal/qs';
+import { stringifyQuery } from './internal/utils/query';
 import { VERSION } from './version';
 import * as Errors from './core/error';
 import * as Uploads from './core/uploads';
@@ -336,8 +336,8 @@ export class Composio {
     return buildHeaders([{ 'x-api-key': this.apiKey }]);
   }
 
-  protected stringifyQuery(query: Record<string, unknown>): string {
-    return qs.stringify(query, { arrayFormat: 'comma' });
+  protected stringifyQuery(query: object | Record<string, unknown>): string {
+    return stringifyQuery(query);
   }
 
   private getUserAgent(): string {
@@ -369,12 +369,13 @@ export class Composio {
       : new URL(baseURL + (baseURL.endsWith('/') && path.startsWith('/') ? path.slice(1) : path));
 
     const defaultQuery = this.defaultQuery();
-    if (!isEmptyObj(defaultQuery)) {
-      query = { ...defaultQuery, ...query };
+    const pathQuery = Object.fromEntries(url.searchParams);
+    if (!isEmptyObj(defaultQuery) || !isEmptyObj(pathQuery)) {
+      query = { ...pathQuery, ...defaultQuery, ...query };
     }
 
     if (typeof query === 'object' && query && !Array.isArray(query)) {
-      url.search = this.stringifyQuery(query as Record<string, unknown>);
+      url.search = this.stringifyQuery(query);
     }
 
     return url.toString();
@@ -679,9 +680,9 @@ export class Composio {
       }
     }
 
-    // If the API asks us to wait a certain amount of time (and it's a reasonable amount),
-    // just do what it says, but otherwise calculate a default
-    if (!(timeoutMillis && 0 <= timeoutMillis && timeoutMillis < 60 * 1000)) {
+    // If the API asks us to wait a certain amount of time, just do what it
+    // says, but otherwise calculate a default
+    if (timeoutMillis === undefined) {
       const maxRetries = options.maxRetries ?? this.maxRetries;
       timeoutMillis = this.calculateDefaultRetryTimeoutMillis(retriesRemaining, maxRetries);
     }
@@ -813,7 +814,7 @@ export class Composio {
     ) {
       return {
         bodyHeaders: { 'content-type': 'application/x-www-form-urlencoded' },
-        body: this.stringifyQuery(body as Record<string, unknown>),
+        body: this.stringifyQuery(body),
       };
     } else {
       return this.#encoder({ body, headers });
@@ -839,19 +840,52 @@ export class Composio {
 
   static toFile = Uploads.toFile;
 
+  /**
+   * Authentication configuration management
+   */
   authConfigs: API.AuthConfigs = new API.AuthConfigs(this);
+  /**
+   * Connected account management
+   */
   connectedAccounts: API.ConnectedAccounts = new API.ConnectedAccounts(this);
+  /**
+   * Connected account management
+   */
   link: API.Link = new API.Link(this);
+  /**
+   * Toolkit and tool management
+   */
   toolkits: API.Toolkits = new API.Toolkits(this);
+  /**
+   * Tool execution endpoints
+   */
   tools: API.Tools = new API.Tools(this);
+  /**
+   * Trigger management and execution
+   */
   triggerInstances: API.TriggerInstances = new API.TriggerInstances(this);
+  /**
+   * Trigger management and execution
+   */
   triggersTypes: API.TriggersTypes = new API.TriggersTypes(this);
+  /**
+   * MCP server management
+   */
   mcp: API.Mcp = new API.Mcp(this);
+  /**
+   * File management
+   */
   files: API.Files = new API.Files(this);
+  /**
+   * Endpoints to help with migration from v1 to v3
+   */
   migration: API.Migration = new API.Migration(this);
   cli: API.Cli = new API.Cli(this);
   project: API.Project = new API.Project(this);
   logs: API.Logs = new API.Logs(this);
+  /**
+   * (Labs) Tool router endpoints
+   */
   toolRouter: API.ToolRouter = new API.ToolRouter(this);
 }
 

package/src/internal/utils/query.ts

@@ -0,0 +1,7 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import * as qs from '../qs/stringify';
+
+export function stringifyQuery(query: object | Record<string, unknown>) {
+  return qs.stringify(query, { arrayFormat: 'comma' });
+}

package/src/internal/utils.ts

@@ -6,3 +6,4 @@ export * from './utils/env';
 export * from './utils/log';
 export * from './utils/uuid';
 export * from './utils/sleep';
+export * from './utils/query';

package/src/resources/auth-configs.ts

@@ -5,6 +5,9 @@ import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
+/**
+ * Authentication configuration management
+ */
 export class AuthConfigs extends APIResource {
   /**
    * Creates a new auth config for a toolkit, allowing you to use your own OAuth
@@ -813,7 +816,7 @@ export interface AuthConfigListParams {
   limit?: number | null;
 
   /**
-   * Search auth configs by name
+   * Search auth configs by name or id
    */
   search?: string;
 

package/src/resources/cli/realtime.ts

@@ -4,6 +4,9 @@ import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 
+/**
+ * CLI integration endpoints
+ */
 export class Realtime extends APIResource {
   /**
    * Authenticate CLI client access to a private-cli-{nanoId} Pusher channel

package/src/resources/connected-accounts.ts

@@ -5,6 +5,9 @@ import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
+/**
+ * Connected account management
+ */
 export class ConnectedAccounts extends APIResource {
   /**
    * Initiates a new connection to an external service for a user. For OAuth-based
@@ -4236,7 +4239,10 @@ export interface ConnectedAccountRetrieveResponse {
   status: 'INITIALIZING' | 'INITIATED' | 'ACTIVE' | 'FAILED' | 'EXPIRED' | 'INACTIVE';
 
   /**
-   * The reason the connection is disabled
+   * The reason the connection status changed. Possible reasons: Connection
+   * initiation did not complete within 10 minutes, Permanent auth error during token
+   * refresh, Max auth failures reached, OAuth callback failed during token exchange,
+   * Connection status updated by user, Auth config is disabled
    */
   status_reason: string | null;
 
@@ -8393,7 +8399,10 @@ export namespace ConnectedAccountListResponse {
     status: 'INITIALIZING' | 'INITIATED' | 'ACTIVE' | 'FAILED' | 'EXPIRED' | 'INACTIVE';
 
     /**
-     * The reason the connection is disabled
+     * The reason the connection status changed. Possible reasons: Connection
+     * initiation did not complete within 10 minutes, Permanent auth error during token
+     * refresh, Max auth failures reached, OAuth callback failed during token exchange,
+     * Connection status updated by user, Auth config is disabled
      */
     status_reason: string | null;
 

package/src/resources/files.ts

@@ -4,6 +4,9 @@ import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 
+/**
+ * File management
+ */
 export class Files extends APIResource {
   /**
    * Retrieves a list of files associated with the authenticated project. Results can

package/src/resources/link.ts

@@ -4,6 +4,9 @@ import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 
+/**
+ * Connected account management
+ */
 export class Link extends APIResource {
   /**
    * Creates a new authentication link session that users can use to connect their

package/src/resources/logs/tools.ts

@@ -5,6 +5,9 @@ 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

package/src/resources/logs/triggers.ts

@@ -5,6 +5,9 @@ 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

package/src/resources/mcp/custom.ts

@@ -4,6 +4,9 @@ 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

package/src/resources/mcp/generate.ts

@@ -4,6 +4,9 @@ import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 
+/**
+ * MCP server management
+ */
 export class Generate extends APIResource {
   /**
    * Generates a Model Control Protocol (MCP) URL for an existing server with custom

package/src/resources/mcp/mcp.ts

@@ -9,6 +9,9 @@ import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * MCP server management
+ */
 export class Mcp extends APIResource {
   custom: CustomAPI.Custom = new CustomAPI.Custom(this._client);
   generate: GenerateAPI.Generate = new GenerateAPI.Generate(this._client);

package/src/resources/migration.ts

@@ -4,6 +4,9 @@ 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

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

@@ -17,7 +17,7 @@ export {
   type SessionSearchParams,
   type SessionToolkitsParams,
   type SessionToolsParams,
-} from './session';
+} from './session/index';
 export {
   ToolRouter,
   type ToolRouterCreateSessionResponse,

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_123456789' },
+   * );
+   * ```
+   */
+  list(mountID: string, params: FileListParams, options?: RequestOptions): APIPromise<FileListResponse> {
+    const { session_id, ...query } = params;
+    return this._client.get(path`/api/v3/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_123456789',
+   *     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/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_123456789',
+   *       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/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_123456789',
+   *       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/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,31 @@
+// 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 SessionExecuteResponse,
+  type SessionExecuteMetaResponse,
+  type SessionLinkResponse,
+  type SessionSearchResponse,
+  type SessionToolkitsResponse,
+  type SessionToolsResponse,
+  type SessionCreateParams,
+  type SessionExecuteParams,
+  type SessionExecuteMetaParams,
+  type SessionLinkParams,
+  type SessionSearchParams,
+  type SessionToolkitsParams,
+  type SessionToolsParams,
+} from './session';