@composio/client 0.1.0-alpha.57 → 0.1.0-alpha.59

package/src/resources/logs/triggers.ts

@@ -0,0 +1,157 @@
+// 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 Triggers extends APIResource {
+  /**
+   * Search and retrieve trigger event logs with advanced filtering capabilities
+   * including search parameters
+   *
+   * @example
+   * ```ts
+   * const triggers = await client.logs.triggers.list();
+   * ```
+   */
+  list(
+    body: TriggerListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TriggerListResponse> {
+    return this._client.post('/api/v3/internal/trigger/logs', { body, ...options });
+  }
+}
+
+export interface TriggerListResponse {
+  nextCursor: string | null;
+
+  data?: Array<TriggerListResponse.Data>;
+}
+
+export namespace TriggerListResponse {
+  export interface Data {
+    id: string;
+
+    appName: string;
+
+    clientId: string;
+
+    connectionId: string;
+
+    createdAt: string;
+
+    entityId: string;
+
+    meta: Data.Meta;
+
+    status: string;
+
+    /**
+     * Log entity type (trigger or action)
+     */
+    type: 'trigger' | 'action';
+  }
+
+  export namespace Data {
+    export interface Meta {
+      id: string;
+
+      clientId: string;
+
+      connectionId: string;
+
+      createdAt: string;
+
+      provider: string;
+
+      /**
+       * Log entity type (trigger or action)
+       */
+      type: 'trigger' | 'action';
+
+      updatedAt: string;
+
+      triggerClientError?: string;
+
+      triggerClientPayload?: string;
+
+      triggerClientResponse?: string;
+
+      triggerId?: string;
+
+      triggerName?: string;
+
+      triggerNanoId?: string;
+
+      triggerProviderPayload?: string;
+    }
+  }
+}
+
+export interface TriggerListParams {
+  cursor?: string | null;
+
+  entityId?: string;
+
+  /**
+   * Start time for logs (epoch timestamp in milliseconds)
+   */
+  from?: number | null;
+
+  /**
+   * Whether to include payload fields in the response. Set to false for faster list
+   * views.
+   */
+  include_payload?: boolean;
+
+  integrationId?: string;
+
+  /**
+   * The limit of trigger logs to return
+   */
+  limit?: number | null;
+
+  /**
+   * Search term to filter logs
+   */
+  search?: string;
+
+  /**
+   * Advanced search parameters for filtering logs
+   */
+  search_params?: Array<TriggerListParams.SearchParam>;
+
+  /**
+   * Filter logs by their status level
+   */
+  status?: 'all' | 'success' | 'error';
+
+  /**
+   * Return logs from the last N time units
+   */
+  time?: '5m' | '30m' | '6h' | '1d' | '1w' | '1month' | '1y';
+
+  /**
+   * End time for logs (epoch timestamp in milliseconds)
+   */
+  to?: number | null;
+
+  /**
+   * Filter logs by user ID
+   */
+  userId?: string;
+}
+
+export namespace TriggerListParams {
+  export interface SearchParam {
+    field?: string;
+
+    operation?: string;
+
+    value?: string;
+  }
+}
+
+export declare namespace Triggers {
+  export { type TriggerListResponse as TriggerListResponse, type TriggerListParams as TriggerListParams };
+}

package/src/resources/logs.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './logs/index';

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

@@ -7,12 +7,14 @@ export {
   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';

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

@@ -105,6 +105,31 @@ export class Session extends APIResource {
     return this._client.post(path`/api/v3/tool_router/session/${sessionID}/link`, { body, ...options });
   }
 
+  /**
+   * Search for tools matching a given use case query within a tool router session.
+   * Returns matching tool slugs, full tool schemas, toolkit connection statuses, and
+   * workflow guidance in a predictable format.
+   *
+   * @example
+   * ```ts
+   * const response = await client.toolRouter.session.search(
+   *   'trs_LX9uJKBinWWr',
+   *   {
+   *     queries: [
+   *       { use_case: 'Send a slack message to a channel' },
+   *     ],
+   *   },
+   * );
+   * ```
+   */
+  search(
+    sessionID: string,
+    body: SessionSearchParams,
+    options?: RequestOptions,
+  ): APIPromise<SessionSearchResponse> {
+    return this._client.post(path`/api/v3/tool_router/session/${sessionID}/search`, { body, ...options });
+  }
+
   /**
    * Retrieves a cursor-paginated list of toolkits available in the tool router
    * session. Includes toolkit metadata, composio-managed auth schemes, and connected
@@ -555,6 +580,285 @@ export interface SessionLinkResponse {
   redirect_url: string;
 }
 
+export interface SessionSearchResponse {
+  /**
+   * Error message if any searches failed, null if all succeeded. Format: "X out of Y
+   * searches failed, reasons: <details>"
+   */
+  error: string | null;
+
+  /**
+   * Combined workflow guidance covering connections, planner, and memory usage. Each
+   * element is a step instruction.
+   */
+  next_steps_guidance: Array<string>;
+
+  /**
+   * Per-query search results with tools, reasoning, and memory. One entry per query
+   * in request order.
+   */
+  results: Array<SessionSearchResponse.Result>;
+
+  /**
+   * Session info for correlating meta tool calls
+   */
+  session: SessionSearchResponse.Session;
+
+  /**
+   * Whether all searches completed successfully. False if any query failed.
+   */
+  success: boolean;
+
+  /**
+   * Time information for the query
+   */
+  time_info: SessionSearchResponse.TimeInfo;
+
+  /**
+   * Deduplicated tool definitions keyed by tool_slug for O(1) lookup. Each tool
+   * appears once even if used in multiple queries.
+   */
+  tool_schemas: { [key: string]: SessionSearchResponse.ToolSchemas };
+
+  /**
+   * Connection status for all toolkits mentioned across all queries, with
+   * descriptions merged in.
+   */
+  toolkit_connection_statuses: Array<SessionSearchResponse.ToolkitConnectionStatus>;
+}
+
+export namespace SessionSearchResponse {
+  export interface Result {
+    /**
+     * 1-based index of the query in the request
+     */
+    index: number;
+
+    /**
+     * List of main tool slugs matching the search criteria
+     */
+    primary_tool_slugs: Array<string>;
+
+    /**
+     * List of related tool slugs that might be useful
+     */
+    related_tool_slugs: Array<string>;
+
+    /**
+     * List of unique toolkit slugs used by tools in this query
+     */
+    toolkits: Array<string>;
+
+    /**
+     * The use case that was searched
+     */
+    use_case: string;
+
+    /**
+     * Task difficulty assessment (e.g., "easy - Simple single-tool operation with
+     * known parameters")
+     */
+    difficulty?: string;
+
+    /**
+     * Error message if the search for this query failed, null otherwise. Always
+     * present for failed queries.
+     */
+    error?: string | null;
+
+    /**
+     * Guidance message about the search results, particularly when a cached plan is
+     * available
+     */
+    execution_guidance?: string;
+
+    /**
+     * Common pitfalls and considerations (only present when cached plan is available)
+     */
+    known_pitfalls?: Array<string>;
+
+    /**
+     * Memory data relevant to this query, grouped by app. Only present for non-cached
+     * search results.
+     */
+    memory?: { [key: string]: Array<string> };
+
+    /**
+     * ID of cached plan if available
+     */
+    plan_id?: string;
+
+    /**
+     * Workflow steps from cached plan (only present when cached plan is available)
+     */
+    recommended_plan_steps?: Array<string>;
+
+    /**
+     * Reference Python code snippets for processing tool responses in the workbench
+     * (only present when cached plan is available)
+     */
+    reference_workbench_snippets?: Array<Result.ReferenceWorkbenchSnippet>;
+  }
+
+  export namespace Result {
+    export interface ReferenceWorkbenchSnippet {
+      /**
+       * Python code snippet for the workbench
+       */
+      code: string;
+
+      /**
+       * Description of what the code snippet does
+       */
+      description: string;
+    }
+  }
+
+  /**
+   * Session info for correlating meta tool calls
+   */
+  export interface Session {
+    /**
+     * Session identifier to be passed to subsequent meta tool calls as session_id.
+     */
+    id: string;
+
+    /**
+     * Whether a fresh session id was generated in this call.
+     */
+    generate_id: boolean;
+
+    /**
+     * LLM-facing guidance on how to reuse this session id
+     */
+    instructions: string;
+  }
+
+  /**
+   * Time information for the query
+   */
+  export interface TimeInfo {
+    /**
+     * Current time in ISO format (UTC)
+     */
+    current_time_utc: string;
+
+    /**
+     * Current time as Unix epoch timestamp in seconds
+     */
+    current_time_utc_epoch_seconds: number;
+
+    /**
+     * Important message about time handling and timezone considerations
+     */
+    message: string;
+  }
+
+  export interface ToolSchemas {
+    /**
+     * The slug of the tool
+     */
+    tool_slug: string;
+
+    /**
+     * The slug of the toolkit that provides this tool
+     */
+    toolkit: string;
+
+    /**
+     * Description of the tool
+     */
+    description?: string;
+
+    /**
+     * Whether the full input_schema is included in this response
+     */
+    hasFullSchema?: boolean;
+
+    /**
+     * Input schema for the tool (only present when hasFullSchema is true)
+     */
+    input_schema?: { [key: string]: unknown };
+
+    /**
+     * Output/response schema for the tool
+     */
+    output_schema?: { [key: string]: unknown };
+
+    /**
+     * Reference to fetch full schema when hasFullSchema is false
+     */
+    schemaRef?: ToolSchemas.SchemaRef;
+  }
+
+  export namespace ToolSchemas {
+    /**
+     * Reference to fetch full schema when hasFullSchema is false
+     */
+    export interface SchemaRef {
+      /**
+       * Arguments to pass to the tool
+       */
+      args: SchemaRef.Args;
+
+      /**
+       * Instruction message for the LLM
+       */
+      message: string;
+
+      /**
+       * Tool to call
+       */
+      tool: 'COMPOSIO_GET_TOOL_SCHEMAS';
+    }
+
+    export namespace SchemaRef {
+      /**
+       * Arguments to pass to the tool
+       */
+      export interface Args {
+        /**
+         * Tool slugs to fetch schemas for
+         */
+        tool_slugs: Array<string>;
+      }
+    }
+  }
+
+  export interface ToolkitConnectionStatus {
+    /**
+     * Description of what the toolkit does and its capabilities
+     */
+    description: string;
+
+    /**
+     * Whether an active connection exists for this toolkit
+     */
+    has_active_connection: boolean;
+
+    /**
+     * Human-readable message about the connection status and next steps
+     */
+    status_message: string;
+
+    /**
+     * The toolkit slug identifier (e.g., "gmail", "slack")
+     */
+    toolkit: string;
+
+    /**
+     * Connection details including auth config and connected account IDs. Only present
+     * when has_active_connection is true.
+     */
+    connection_details?: { [key: string]: unknown };
+
+    /**
+     * Information about the currently connected user (email, name, etc.)
+     */
+    current_user_info?: { [key: string]: unknown };
+  }
+}
+
 export interface SessionToolkitsResponse {
   current_page: number;
 
@@ -742,6 +1046,11 @@ export namespace SessionToolsResponse {
      * Current version of the tool
      */
     version: string;
+
+    /**
+     * Human-friendly description of the tool, if available
+     */
+    human_description?: string;
   }
 
   export namespace Item {
@@ -1041,6 +1350,35 @@ export interface SessionLinkParams {
   callback_url?: string;
 }
 
+export interface SessionSearchParams {
+  /**
+   * List of search queries to execute in parallel. Up to 7 queries supported.
+   */
+  queries: Array<SessionSearchParams.Query>;
+
+  /**
+   * Optional model hint for search/planning behavior (e.g., "gpt-4o"). Ignored if
+   * invalid.
+   */
+  model?: string;
+}
+
+export namespace SessionSearchParams {
+  export interface Query {
+    /**
+     * The task or use case to search tools for. Provide a detailed description to get
+     * the best results.
+     */
+    use_case: string;
+
+    /**
+     * Known field hints as key:value pairs (e.g., "channel_name:general,
+     * user_email:john@example.com")
+     */
+    known_fields?: string;
+  }
+}
+
 export interface SessionToolkitsParams {
   /**
    * Cursor for pagination. The cursor is a base64 encoded string of the page and
@@ -1082,12 +1420,14 @@ export declare namespace Session {
     type SessionExecuteResponse as SessionExecuteResponse,
     type SessionExecuteMetaResponse as SessionExecuteMetaResponse,
     type SessionLinkResponse as SessionLinkResponse,
+    type SessionSearchResponse as SessionSearchResponse,
     type SessionToolkitsResponse as SessionToolkitsResponse,
     type SessionToolsResponse as SessionToolsResponse,
     type SessionCreateParams as SessionCreateParams,
     type SessionExecuteParams as SessionExecuteParams,
     type SessionExecuteMetaParams as SessionExecuteMetaParams,
     type SessionLinkParams as SessionLinkParams,
+    type SessionSearchParams as SessionSearchParams,
     type SessionToolkitsParams as SessionToolkitsParams,
     type SessionToolsParams as SessionToolsParams,
   };

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

@@ -13,6 +13,8 @@ import {
   SessionLinkParams,
   SessionLinkResponse,
   SessionRetrieveResponse,
+  SessionSearchParams,
+  SessionSearchResponse,
   SessionToolkitsParams,
   SessionToolkitsResponse,
   SessionToolsParams,
@@ -133,12 +135,14 @@ export declare namespace ToolRouter {
     type SessionExecuteResponse as SessionExecuteResponse,
     type SessionExecuteMetaResponse as SessionExecuteMetaResponse,
     type SessionLinkResponse as SessionLinkResponse,
+    type SessionSearchResponse as SessionSearchResponse,
     type SessionToolkitsResponse as SessionToolkitsResponse,
     type SessionToolsResponse as SessionToolsResponse,
     type SessionCreateParams as SessionCreateParams,
     type SessionExecuteParams as SessionExecuteParams,
     type SessionExecuteMetaParams as SessionExecuteMetaParams,
     type SessionLinkParams as SessionLinkParams,
+    type SessionSearchParams as SessionSearchParams,
     type SessionToolkitsParams as SessionToolkitsParams,
     type SessionToolsParams as SessionToolsParams,
   };

package/src/resources/tools.ts

@@ -181,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 {
@@ -307,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 {

package/src/version.ts

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

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.57";
+export declare const VERSION = "0.1.0-alpha.59";
 //# 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.57'; // x-release-please-version
+exports.VERSION = '0.1.0-alpha.59'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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