@composio/client 0.1.0-alpha.56 → 0.1.0-alpha.58

package/src/resources/tools.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
+import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
@@ -54,10 +55,18 @@ export class Tools extends APIResource {
    */
   execute(
     toolSlug: string,
-    body: ToolExecuteParams | null | undefined = {},
+    params: ToolExecuteParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<ToolExecuteResponse> {
-    return this._client.post(path`/api/v3/tools/execute/${toolSlug}`, { body, ...options });
+    const { 'x-llm-gateway-headers': xLlmGatewayHeaders, ...body } = params ?? {};
+    return this._client.post(path`/api/v3/tools/execute/${toolSlug}`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { ...(xLlmGatewayHeaders != null ? { 'x-llm-gateway-headers': xLlmGatewayHeaders } : undefined) },
+        options?.headers,
+      ]),
+    });
   }
 
   /**
@@ -161,11 +170,6 @@ export interface ToolRetrieveResponse {
    */
   slug: string;
 
-  /**
-   * Lifecycle status of the tool
-   */
-  status: string;
-
   /**
    * List of tags associated with the tool for categorization and filtering
    */
@@ -177,6 +181,11 @@ export interface ToolRetrieveResponse {
    * Current version of the tool
    */
   version: string;
+
+  /**
+   * Human-friendly description of the tool, if available
+   */
+  human_description?: string;
 }
 
 export namespace ToolRetrieveResponse {
@@ -292,11 +301,6 @@ export namespace ToolListResponse {
      */
     slug: string;
 
-    /**
-     * Lifecycle status of the tool
-     */
-    status: string;
-
     /**
      * List of tags associated with the tool for categorization and filtering
      */
@@ -308,6 +312,11 @@ export namespace ToolListResponse {
      * Current version of the tool
      */
     version: string;
+
+    /**
+     * Human-friendly description of the tool, if available
+     */
+    human_description?: string;
   }
 
   export namespace Item {
@@ -499,13 +508,20 @@ export interface ToolListParams {
    */
   limit?: number | null;
 
+  /**
+   * Full-text search query to filter tools by name, slug, or description. Applied as
+   * a soft filter on top of other filters.
+   */
+  query?: string;
+
   /**
    * Array of scopes to filter tools by)
    */
   scopes?: Array<string> | null;
 
   /**
-   * Free-text search query to find tools by name, description, or functionality
+   * Deprecated: use "query" instead. Free-text search query to find tools by name,
+   * description, or functionality.
    */
   search?: string;
 
@@ -534,28 +550,31 @@ export interface ToolListParams {
 
 export interface ToolExecuteParams {
   /**
-   * Enable debug tracing for tool execution (useful for debugging)
+   * @deprecated Body param: Deprecated. Enable debug tracing for tool execution
+   * (useful for debugging)
    */
   allow_tracing?: boolean | null;
 
   /**
-   * Key-value pairs of arguments required by the tool (mutually exclusive with text)
+   * Body param: Key-value pairs of arguments required by the tool (mutually
+   * exclusive with text)
    */
   arguments?: { [key: string]: unknown };
 
   /**
-   * Unique identifier for the connected account to use for authentication
+   * Body param: Unique identifier for the connected account to use for
+   * authentication
    */
   connected_account_id?: string;
 
   /**
-   * Custom authentication parameters for tools that support parameterized
-   * authentication
+   * Body param: Custom authentication parameters for tools that support
+   * parameterized authentication
    */
   custom_auth_params?: ToolExecuteParams.CustomAuthParams;
 
   /**
-   * Custom connection data for tools that support custom connection data
+   * Body param: Custom connection data for tools that support custom connection data
    */
   custom_connection_data?:
     | ToolExecuteParams.UnionMember0
@@ -570,26 +589,34 @@ export interface ToolExecuteParams {
     | ToolExecuteParams.UnionMember9;
 
   /**
-   * @deprecated Deprecated: please use user_id instead. Entity identifier for
-   * multi-entity connected accounts (e.g. multiple repositories, organizations)
+   * @deprecated Body param: Deprecated: please use user_id instead. Entity
+   * identifier for multi-entity connected accounts (e.g. multiple repositories,
+   * organizations)
    */
   entity_id?: string;
 
   /**
-   * Natural language description of the task to perform (mutually exclusive with
-   * arguments)
+   * Body param: Natural language description of the task to perform (mutually
+   * exclusive with arguments)
    */
   text?: string;
 
   /**
-   * User id for multi-user connected accounts (e.g. multiple users, organizations)
+   * Body param: User id for multi-user connected accounts (e.g. multiple users,
+   * organizations)
    */
   user_id?: string;
 
   /**
-   * Tool version to execute (defaults to "00000000_00" if not specified)
+   * Body param: Tool version to execute (defaults to "00000000_00" if not specified)
    */
   version?: string;
+
+  /**
+   * Header param: JSON object containing custom headers to pass to LLM providers
+   * (OpenAI, Bedrock, etc.)
+   */
+  'x-llm-gateway-headers'?: string;
 }
 
 export namespace ToolExecuteParams {

package/src/resources/trigger-instances/manage.ts

@@ -7,6 +7,11 @@ import { path } from '../../internal/utils/path';
 
 export class Manage extends APIResource {
   /**
+   * Updates the status of a trigger instance to enable or disable it. Disabling a
+   * trigger pauses event listening without deleting the trigger configuration.
+   * Re-enabling restores the trigger to its active state. Use this for temporary
+   * maintenance or to control trigger execution.
+   *
    * @example
    * ```ts
    * const manage = await client.triggerInstances.manage.update(
@@ -24,6 +29,10 @@ export class Manage extends APIResource {
   }
 
   /**
+   * Permanently deletes a trigger instance. This stops the trigger from listening
+   * for events and removes it from your project. Use the PATCH endpoint with status
+   * "disable" if you want to temporarily pause a trigger instead.
+   *
    * @example
    * ```ts
    * const manage = await client.triggerInstances.manage.delete(

package/src/resources/trigger-instances/trigger-instances.ts

@@ -11,6 +11,11 @@ export class TriggerInstances extends APIResource {
   manage: ManageAPI.Manage = new ManageAPI.Manage(this._client);
 
   /**
+   * Retrieves all active trigger instances for your project. Triggers listen for
+   * events from connected accounts (e.g., new emails, Slack messages, GitHub
+   * commits) and can invoke webhooks or workflows. Use filters to find triggers for
+   * specific users, connected accounts, or trigger types.
+   *
    * @example
    * ```ts
    * const response = await client.triggerInstances.listActive();
@@ -24,6 +29,12 @@ export class TriggerInstances extends APIResource {
   }
 
   /**
+   * Creates a new trigger instance or updates an existing one with the same
+   * configuration. Triggers listen for events from external services (webhooks or
+   * polling) and can invoke your workflows. If a matching trigger already exists and
+   * is disabled, it will be re-enabled. Requires a connected account ID to associate
+   * the trigger with a specific user connection.
+   *
    * @example
    * ```ts
    * const response = await client.triggerInstances.upsert(

package/src/resources/triggers-types.ts

@@ -69,11 +69,6 @@ export interface TriggersTypeRetrieveResponse {
    */
   slug: string;
 
-  /**
-   * Lifecycle status of the trigger
-   */
-  status: string;
-
   /**
    * Information about the toolkit that provides this trigger
    */
@@ -156,11 +151,6 @@ export namespace TriggersTypeListResponse {
      */
     slug: string;
 
-    /**
-     * Lifecycle status of the trigger
-     */
-    status: string;
-
     /**
      * Information about the toolkit that provides this trigger
      */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.0-alpha.56'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.58'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.56";
+export declare const VERSION = "0.1.0-alpha.58";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.56";
+export declare const VERSION = "0.1.0-alpha.58";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.1.0-alpha.56'; // x-release-please-version
+exports.VERSION = '0.1.0-alpha.58'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.1.0-alpha.56'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.58'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map