Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

feat(cli): add trigger status and lifecycle commands

haxzie25c6e06cd570
diff --git a/ts/packages/cli/src/commands/triggers/commands/triggers.create.cmd.ts b/ts/packages/cli/src/commands/triggers/commands/triggers.create.cmd.ts
new file mode 100644
index 000000000..3dcda05d2
--- /dev/null
+++ b/ts/packages/cli/src/commands/triggers/commands/triggers.create.cmd.ts
@@ -0,0 +1,88 @@
+import { Args, Command, Options } from '@effect/cli';
+import { Effect, Option } from 'effect';
+import { requireAuth } from 'src/effects/require-auth';
+import { handleHttpServerError } from 'src/effects/handle-http-error';
+import { ComposioToolkitsRepository } from 'src/services/composio-clients';
+import { TerminalUI } from 'src/services/terminal-ui';
+
+const triggerName = Args.text({ name: 'trigger-name' }).pipe(
+ Args.withDescription('Trigger slug (e.g. "GMAIL_NEW_GMAIL_MESSAGE")'),
+ Args.optional
+);
+
+const connectedAccountId = Options.text('connected-account-id').pipe(
+ Options.withDescription('Connected account ID (nanoid)'),
+ Options.optional
+);
+
+const triggerConfig = Options.text('trigger-config').pipe(
+ Options.withDescription('Trigger config as JSON string'),
+ Options.optional
+);
+
+/**
+ * Create a trigger instance.
+ */
+export const triggersCmd$Create = Command.make(
+ 'create',
+ { triggerName, connectedAccountId, triggerConfig },
+ ({ triggerName, connectedAccountId, triggerConfig }) =>
+ Effect.gen(function* () {
+ if (!(yield* requireAuth)) return;
+
+ const ui = yield* TerminalUI;
+ const repo = yield* ComposioToolkitsRepository;
+
+ if (Option.isNone(triggerName)) {
+ yield* ui.log.warn('Missing required argument: <trigger-name>');
+ yield* ui.log.step(
+ 'Try specifying a trigger slug, e.g.:\n> composio triggers create "GMAIL_NEW_GMAIL_MESSAGE" --connected-account-id "con_123"'
+ );
+ return;
+ }
+
+ let parsedTriggerConfig: Record<string, unknown> | undefined;
+ if (Option.isSome(triggerConfig)) {
+ try {
+ parsedTriggerConfig = JSON.parse(triggerConfig.value) as Record<string, unknown>;
+ } catch {
+ yield* ui.log.error('Invalid JSON in --trigger-config. Please provide valid JSON.');
+ yield* ui.log.step(
+ 'Example:\n> composio triggers create "GMAIL_NEW_GMAIL_MESSAGE" --trigger-config \'{"label":"inbox"}\''
+ );
+ return;
+ }
+ }
+
+ const createdOpt = yield* ui
+ .withSpinner(
+ `Creating trigger "${triggerName.value}"...`,
+ repo.createTrigger(triggerName.value, {
+ connected_account_id: Option.getOrUndefined(connectedAccountId),
+ trigger_config: parsedTriggerConfig,
+ })
+ )
+ .pipe(
+ Effect.asSome,
+ Effect.catchTag(
+ 'services/HttpServerError',
+ handleHttpServerError(ui, {
+ fallbackMessage: `Failed to create trigger "${triggerName.value}".`,
+ hint: 'List available trigger types with:\n> composio triggers status',
+ fallbackValue: Option.none(),
+ })
+ )
+ );
+
+ if (Option.isNone(createdOpt)) {
+ return;
+ }
+
+ const created = createdOpt.value;
+ yield* ui.log.success(`Trigger created: ${created.trigger_id}`);
+ yield* ui.log.step(
+ `To check status:\n> composio triggers status --trigger-ids "${created.trigger_id}"`
+ );
+ yield* ui.output(JSON.stringify(created, null, 2));
+ })
+).pipe(Command.withDescription('Create a new trigger instance.'));
diff --git a/ts/packages/cli/src/commands/triggers/commands/triggers.delete.cmd.ts b/ts/packages/cli/src/commands/triggers/commands/triggers.delete.cmd.ts
new file mode 100644
index 000000000..5e8f50b53
--- /dev/null
+++ b/ts/packages/cli/src/commands/triggers/commands/triggers.delete.cmd.ts
@@ -0,0 +1,67 @@
+import { Args, Command, Options } from '@effect/cli';
+import { Effect, Option } from 'effect';
+import { requireAuth } from 'src/effects/require-auth';
+import { handleHttpServerError } from 'src/effects/handle-http-error';
+import { ComposioToolkitsRepository } from 'src/services/composio-clients';
+import { TerminalUI } from 'src/services/terminal-ui';
+
+const id = Args.text({ name: 'id' }).pipe(
+ Args.withDescription('Trigger instance ID'),
+ Args.optional
+);
+
+const yes = Options.boolean('yes').pipe(
+ Options.withAlias('y'),
+ Options.withDescription('Skip confirmation prompt'),
+ Options.withDefault(false)
+);
+
+/**
+ * Delete a trigger instance.
+ */
+export const triggersCmd$Delete = Command.make('delete', { id, yes }, ({ id, yes }) =>
+ Effect.gen(function* () {
+ if (!(yield* requireAuth)) return;
+
+ const ui = yield* TerminalUI;
+ const repo = yield* ComposioToolkitsRepository;
+
+ if (Option.isNone(id)) {
+ yield* ui.log.warn('Missing required argument: <id>');
+ yield* ui.log.step(
+ 'Try specifying a trigger ID, e.g.:\n> composio triggers delete "trg_123" --yes\n\nTo find trigger IDs:\n> composio triggers status --show-disabled'
+ );
+ return;
+ }
+
+ const idValue = id.value;
+
+ if (!yes) {
+ const confirmed = yield* ui.confirm(`Delete trigger "${idValue}"? This cannot be undone.`, {
+ defaultValue: false,
+ });
+ if (!confirmed) {
+ yield* ui.log.warn('Deletion cancelled.');
+ return;
+ }
+ }
+
+ const deleted = yield* ui
+ .withSpinner(`Deleting trigger "${idValue}"...`, repo.deleteTrigger(idValue))
+ .pipe(
+ Effect.as(true),
+ Effect.catchTag(
+ 'services/HttpServerError',
+ handleHttpServerError(ui, {
+ fallbackMessage: `Failed to delete trigger "${idValue}".`,
+ hint: 'Browse available triggers:\n> composio triggers status --show-disabled',
+ fallbackValue: false,
+ })
+ )
+ );
+
+ if (!deleted) return;
+
+ yield* ui.log.success(`Trigger "${idValue}" deleted.`);
+ })
+).pipe(Command.withDescription('Delete a trigger instance.'));
diff --git a/ts/packages/cli/src/commands/triggers/commands/triggers.disable.cmd.ts b/ts/packages/cli/src/commands/triggers/commands/triggers.disable.cmd.ts
new file mode 100644
index 000000000..213ba16c2
--- /dev/null
+++ b/ts/packages/cli/src/commands/triggers/commands/triggers.disable.cmd.ts
@@ -0,0 +1,50 @@
+import { Args, Command } from '@effect/cli';
+import { Effect, Option } from 'effect';
+import { requireAuth } from 'src/effects/require-auth';
+import { handleHttpServerError } from 'src/effects/handle-http-error';
+import { ComposioToolkitsRepository } from 'src/services/composio-clients';
+import { TerminalUI } from 'src/services/terminal-ui';
+
+const id = Args.text({ name: 'id' }).pipe(
+ Args.withDescription('Trigger instance ID'),
+ Args.optional
+);
+
+/**
+ * Disable an existing trigger instance.
+ */
+export const triggersCmd$Disable = Command.make('disable', { id }, ({ id }) =>
+ Effect.gen(function* () {
+ if (!(yield* requireAuth)) return;
+
+ const ui = yield* TerminalUI;
+ const repo = yield* ComposioToolkitsRepository;
+
+ if (Option.isNone(id)) {
+ yield* ui.log.warn('Missing required argument: <id>');
+ yield* ui.log.step(
+ 'Try specifying a trigger ID, e.g.:\n> composio triggers disable "trg_123"\n\nTo find trigger IDs:\n> composio triggers status'
+ );
+ return;
+ }
+
+ const idValue = id.value;
+ const disabled = yield* ui
+ .withSpinner(`Disabling trigger "${idValue}"...`, repo.disableTrigger(idValue))
+ .pipe(
+ Effect.as(true),
+ Effect.catchTag(
+ 'services/HttpServerError',
+ handleHttpServerError(ui, {
+ fallbackMessage: `Failed to disable trigger "${idValue}".`,
+ hint: 'Browse available triggers:\n> composio triggers status',
+ fallbackValue: false,
+ })
+ )
+ );
+
+ if (!disabled) return;
+
+ yield* ui.log.success(`Trigger "${idValue}" disabled.`);
+ })
+).pipe(Command.withDescription('Disable a trigger instance.'));
diff --git a/ts/packages/cli/src/commands/triggers/commands/triggers.enable.cmd.ts b/ts/packages/cli/src/commands/triggers/commands/triggers.enable.cmd.ts
new file mode 100644
index 000000000..645a85b0f
--- /dev/null
+++ b/ts/packages/cli/src/commands/triggers/commands/triggers.enable.cmd.ts
@@ -0,0 +1,50 @@
+import { Args, Command } from '@effect/cli';
+import { Effect, Option } from 'effect';
+import { requireAuth } from 'src/effects/require-auth';
+import { handleHttpServerError } from 'src/effects/handle-http-error';
+import { ComposioToolkitsRepository } from 'src/services/composio-clients';
+import { TerminalUI } from 'src/services/terminal-ui';
+
+const id = Args.text({ name: 'id' }).pipe(
+ Args.withDescription('Trigger instance ID'),
+ Args.optional
+);
+
+/**
+ * Enable an existing trigger instance.
+ */
+export const triggersCmd$Enable = Command.make('enable', { id }, ({ id }) =>
+ Effect.gen(function* () {
+ if (!(yield* requireAuth)) return;
+
+ const ui = yield* TerminalUI;
+ const repo = yield* ComposioToolkitsRepository;
+
+ if (Option.isNone(id)) {
+ yield* ui.log.warn('Missing required argument: <id>');
+ yield* ui.log.step(
+ 'Try specifying a trigger ID, e.g.:\n> composio triggers enable "trg_123"\n\nTo find trigger IDs:\n> composio triggers status --show-disabled'
+ );
+ return;
+ }
+
+ const idValue = id.value;
+ const enabled = yield* ui
+ .withSpinner(`Enabling trigger "${idValue}"...`, repo.enableTrigger(idValue))
+ .pipe(
+ Effect.as(true),
+ Effect.catchTag(
+ 'services/HttpServerError',
+ handleHttpServerError(ui, {
+ fallbackMessage: `Failed to enable trigger "${idValue}".`,
+ hint: 'Browse available triggers:\n> composio triggers status --show-disabled',
+ fallbackValue: false,
+ })
+ )
+ );
+
+ if (!enabled) return;
+
+ yield* ui.log.success(`Trigger "${idValue}" enabled.`);
+ })
+).pipe(Command.withDescription('Enable a trigger instance.'));
diff --git a/ts/packages/cli/src/commands/triggers/commands/triggers.status.cmd.ts b/ts/packages/cli/src/commands/triggers/commands/triggers.status.cmd.ts
new file mode 100644
index 000000000..ca2f7cf8b
--- /dev/null
+++ b/ts/packages/cli/src/commands/triggers/commands/triggers.status.cmd.ts
@@ -0,0 +1,152 @@
+import { Command, Options } from '@effect/cli';
+import { Effect, Option } from 'effect';
+import { requireAuth } from 'src/effects/require-auth';
+import { ComposioToolkitsRepository } from 'src/services/composio-clients';
+import { TerminalUI } from 'src/services/terminal-ui';
+import { clampLimit } from 'src/ui/clamp-limit';
+import { formatTriggersStatusJson, formatTriggersStatusTable } from '../format';
+
+const userIds = Options.text('user-ids').pipe(
+ Options.withDescription('Filter by user IDs, comma-separated'),
+ Options.optional
+);
+
+const connectedAccountIds = Options.text('connected-account-ids').pipe(
+ Options.withDescription('Filter by connected account IDs, comma-separated'),
+ Options.optional
+);
+
+const toolkits = Options.text('toolkits').pipe(
+ Options.withDescription(
+ 'Filter by toolkit slugs, comma-separated (e.g. "gmail" or "gmail,slack")'
+ ),
+ Options.optional
+);
+
+const triggerIds = Options.text('trigger-ids').pipe(
+ Options.withDescription('Filter by trigger instance IDs, comma-separated'),
+ Options.optional
+);
+
+const triggerNames = Options.text('trigger-names').pipe(
+ Options.withDescription(
+ 'Filter by trigger names, comma-separated (case-insensitive; normalized to uppercase)'
+ ),
+ Options.optional
+);
+
+const showDisabled = Options.boolean('show-disabled').pipe(
+ Options.withDefault(false),
+ Options.withDescription('Include disabled triggers in the response')
+);
+
+const deprecatedConnectedAccountUuids = Options.text('deprecated-connected-account-uuids').pipe(
+ Options.withDescription(
+ 'DEPRECATED: Use --connected-account-ids instead. Filter by connected account UUIDs, comma-separated'
+ ),
+ Options.optional
+);
+
+const limit = Options.integer('limit').pipe(
+ Options.withDefault(30),
+ Options.withDescription('Number of results per page (1-1000)')
+);
+
+const parseCsv = (value: string): string[] =>
+ value
+ .split(',')
+ .map(item => item.trim())
+ .filter(Boolean);
+
+const csvOption = (opt: Option.Option<string>): string[] | undefined =>
+ Option.isSome(opt) ? parseCsv(opt.value) : undefined;
+
+const mergeCsvOptions = (
+ preferred: Option.Option<string>,
+ deprecated: Option.Option<string>
+): string[] | undefined => {
+ const preferredValues = csvOption(preferred) ?? [];
+ const deprecatedValues = csvOption(deprecated) ?? [];
+ const merged = [...preferredValues, ...deprecatedValues];
+ return merged.length > 0 ? merged : undefined;
+};
+
+const deriveToolkitSlug = (triggerName: string): string => {
+ const prefix = triggerName.split('_')[0];
+ return prefix ? prefix.toLowerCase() : '';
+};
+
+/**
+ * Display active trigger instances with optional filters.
+ */
+export const triggersCmd$Status = Command.make(
+ 'status',
+ {
+ userIds,
+ connectedAccountIds,
+ toolkits,
+ triggerIds,
+ triggerNames,
+ showDisabled,
+ deprecatedConnectedAccountUuids,
+ limit,
+ },
+ ({
+ userIds,
+ connectedAccountIds,
+ toolkits,
+ triggerIds,
+ triggerNames,
+ showDisabled,
+ deprecatedConnectedAccountUuids,
+ limit,
+ }) =>
+ Effect.gen(function* () {
+ if (!(yield* requireAuth)) return;
+
+ const ui = yield* TerminalUI;
+ const repo = yield* ComposioToolkitsRepository;
+
+ const connectedAccountIdsList = mergeCsvOptions(
+ connectedAccountIds,
+ deprecatedConnectedAccountUuids
+ );
+ const triggerNamesList = csvOption(triggerNames)?.map(name => name.toUpperCase());
+ const toolkitsList = csvOption(toolkits)?.map(slug => slug.toLowerCase());
+
+ const result = yield* ui.withSpinner(
+ 'Fetching trigger status...',
+ repo.listActiveTriggers({
+ user_ids: csvOption(userIds),
+ connected_account_ids: connectedAccountIdsList,
+ trigger_ids: csvOption(triggerIds),
+ trigger_names: triggerNamesList,
+ show_disabled: showDisabled,
+ deprecatedConnectedAccountUuids: csvOption(deprecatedConnectedAccountUuids),
+ limit: clampLimit(limit),
+ })
+ );
+
+ const filteredItems =
+ toolkitsList && toolkitsList.length > 0
+ ? result.items.filter(item => toolkitsList.includes(deriveToolkitSlug(item.trigger_name)))
+ : result.items;
+
+ if (filteredItems.length === 0) {
+ yield* ui.log.warn(
+ showDisabled
+ ? 'No triggers found for the provided filters.'
+ : 'No active triggers found for the provided filters.'
+ );
+ return;
+ }
+
+ const showing = filteredItems.length;
+ const total = filteredItems.length;
+
+ yield* ui.log.info(
+ `Listing ${showing} of ${total} triggers\n\n${formatTriggersStatusTable(filteredItems)}`
+ );
+ yield* ui.output(formatTriggersStatusJson(filteredItems));
+ })
+).pipe(Command.withDescription('Show active triggers with optional filters.'));
diff --git a/ts/packages/cli/src/commands/triggers/format.ts b/ts/packages/cli/src/commands/triggers/format.ts
index 2ed47e18d..37697f5ca 100644
--- a/ts/packages/cli/src/commands/triggers/format.ts
+++ b/ts/packages/cli/src/commands/triggers/format.ts
@@ -1,4 +1,5 @@
import type { TriggerListenEvent } from './types';
+import type { TriggerInstanceItem } from 'src/models/triggers';
import { bold, gray } from 'src/ui/colors';
import { truncate } from 'src/ui/truncate';
@@ -56,3 +57,71 @@ export const formatTriggerListenTableRow = ({
truncate(connectedAccountId, TRIGGER_TABLE.connectedAccountId),
].join(' ');
};
+
+const TRIGGER_STATUS_TABLE = {
+ id: 20,
+ triggerName: 26,
+ toolkit: 10,
+ userId: 16,
+ connectedAccountId: 22,
+ status: 10,
+} as const;
+
+const toStatus = (item: TriggerInstanceItem): string =>
+ item.disabled_at === null ? 'ACTIVE' : 'DISABLED';
+
+const toToolkitSlug = (triggerName: string): string => {
+ const prefix = triggerName.split('_')[0];
+ return prefix ? prefix.toLowerCase() : '-';
+};
+
+export const formatTriggersStatusTable = (items: ReadonlyArray<TriggerInstanceItem>): string => {
+ const header = [
+ bold('Trigger Id'.padEnd(TRIGGER_STATUS_TABLE.id)),
+ bold('Trigger Name'.padEnd(TRIGGER_STATUS_TABLE.triggerName)),
+ bold('Toolkit'.padEnd(TRIGGER_STATUS_TABLE.toolkit)),
+ bold('User Id'.padEnd(TRIGGER_STATUS_TABLE.userId)),
+ bold('Connected Account'.padEnd(TRIGGER_STATUS_TABLE.connectedAccountId)),
+ bold('Status'),
+ ].join(' ');
+
+ const rows = items.map(item => {
+ const status = toStatus(item);
+ return [
+ truncate(item.id, TRIGGER_STATUS_TABLE.id).padEnd(TRIGGER_STATUS_TABLE.id),
+ truncate(item.trigger_name, TRIGGER_STATUS_TABLE.triggerName).padEnd(
+ TRIGGER_STATUS_TABLE.triggerName
+ ),
+ truncate(toToolkitSlug(item.trigger_name), TRIGGER_STATUS_TABLE.toolkit).padEnd(
+ TRIGGER_STATUS_TABLE.toolkit
+ ),
+ truncate(item.user_id || '-', TRIGGER_STATUS_TABLE.userId).padEnd(
+ TRIGGER_STATUS_TABLE.userId
+ ),
+ truncate(item.connected_account_id || '-', TRIGGER_STATUS_TABLE.connectedAccountId).padEnd(
+ TRIGGER_STATUS_TABLE.connectedAccountId
+ ),
+ status === 'ACTIVE' ? status : gray(status),
+ ].join(' ');
+ });
+
+ return [header, ...rows].join('\n');
+};
+
+export const formatTriggersStatusJson = (items: ReadonlyArray<TriggerInstanceItem>): string =>
+ JSON.stringify(
+ items.map(item => ({
+ id: item.id,
+ uuid: item.uuid || undefined,
+ trigger_name: item.trigger_name,
+ toolkit_slug: toToolkitSlug(item.trigger_name),
+ user_id: item.user_id || undefined,
+ connected_account_id: item.connected_account_id || undefined,
+ status: toStatus(item),
+ disabled_at: item.disabled_at,
+ updated_at: item.updated_at || undefined,
+ trigger_data: item.trigger_data || undefined,
+ })),
+ null,
+ 2
+ );
diff --git a/ts/packages/cli/src/commands/triggers/triggers.cmd.ts b/ts/packages/cli/src/commands/triggers/triggers.cmd.ts
index ac9b76938..b38b16e04 100644
--- a/ts/packages/cli/src/commands/triggers/triggers.cmd.ts
+++ b/ts/packages/cli/src/commands/triggers/triggers.cmd.ts
@@ -1,5 +1,10 @@
import { Command } from '@effect/cli';
import { triggersCmd$Listen } from './commands/triggers.listen.cmd';
+import { triggersCmd$Status } from './commands/triggers.status.cmd';
+import { triggersCmd$Create } from './commands/triggers.create.cmd';
+import { triggersCmd$Enable } from './commands/triggers.enable.cmd';
+import { triggersCmd$Disable } from './commands/triggers.disable.cmd';
+import { triggersCmd$Delete } from './commands/triggers.delete.cmd';
/**
* CLI entry point for realtime trigger commands.
@@ -10,6 +15,13 @@ import { triggersCmd$Listen } from './commands/triggers.listen.cmd';
* ```
*/
export const triggersCmd = Command.make('triggers').pipe(
- Command.withDescription('Subscribe to realtime trigger events.'),
- Command.withSubcommands([triggersCmd$Listen])
+ Command.withDescription('Inspect and subscribe to trigger events.'),
+ Command.withSubcommands([
+ triggersCmd$Listen,
+ triggersCmd$Status,
+ triggersCmd$Create,
+ triggersCmd$Enable,
+ triggersCmd$Disable,
+ triggersCmd$Delete,
+ ])
);
diff --git a/ts/packages/cli/src/models/triggers.ts b/ts/packages/cli/src/models/triggers.ts
new file mode 100644
index 000000000..e9b11aed8
--- /dev/null
+++ b/ts/packages/cli/src/models/triggers.ts
@@ -0,0 +1,33 @@
+import { Schema } from 'effect';
+
+/**
+ * A trigger instance item from the list-active endpoint.
+ * Field names match the raw API response (snake_case).
+ */
+export const TriggerInstanceItem = Schema.Struct({
+ id: Schema.String,
+ uuid: Schema.optionalWith(Schema.String, { default: () => '' }),
+ trigger_name: Schema.optionalWith(Schema.String, { default: () => '' }),
+ connected_account_id: Schema.optionalWith(Schema.String, { default: () => '' }),
+ auth_config_id: Schema.optionalWith(Schema.String, { default: () => '' }),
+ user_id: Schema.optionalWith(Schema.String, { default: () => '' }),
+ disabled_at: Schema.optionalWith(Schema.NullOr(Schema.String), { default: () => null }),
+ updated_at: Schema.optionalWith(Schema.String, { default: () => '' }),
+ trigger_data: Schema.optionalWith(Schema.String, { default: () => '' }),
+ state: Schema.optionalWith(
+ Schema.NullOr(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
+ {
+ default: () => null,
+ }
+ ),
+ trigger_config: Schema.optionalWith(
+ Schema.NullOr(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
+ {
+ default: () => null,
+ }
+ ),
+}).annotations({ identifier: 'TriggerInstanceItem' });
+export type TriggerInstanceItem = Schema.Schema.Type<typeof TriggerInstanceItem>;
+
+export const TriggerInstanceItems = Schema.Array(TriggerInstanceItem);
+export type TriggerInstanceItems = Schema.Schema.Type<typeof TriggerInstanceItems>;
diff --git a/ts/packages/cli/src/services/composio-clients-cached.ts b/ts/packages/cli/src/services/composio-clients-cached.ts
index 2112e33b3..36dd64423 100644
--- a/ts/packages/cli/src/services/composio-clients-cached.ts
+++ b/ts/packages/cli/src/services/composio-clients-cached.ts
@@ -256,6 +256,14 @@ export const ComposioToolkitsRepositoryCached = Layer.effect(
getConnectedAccount: nanoid => underlyingRepository.getConnectedAccount(nanoid),
deleteConnectedAccount: nanoid => underlyingRepository.deleteConnectedAccount(nanoid),
createConnectedAccountLink: params => underlyingRepository.createConnectedAccountLink(params),
+ // Trigger instance listing should NOT be cached (status can change frequently)
+ listActiveTriggers: params => underlyingRepository.listActiveTriggers(params),
+ // Trigger instance mutations should NOT be cached
+ createTrigger: (triggerSlug, params) =>
+ underlyingRepository.createTrigger(triggerSlug, params),
+ enableTrigger: triggerId => underlyingRepository.enableTrigger(triggerId),
+ disableTrigger: triggerId => underlyingRepository.disableTrigger(triggerId),
+ deleteTrigger: triggerId => underlyingRepository.deleteTrigger(triggerId),
});
})
).pipe(
diff --git a/ts/packages/cli/src/services/composio-clients.ts b/ts/packages/cli/src/services/composio-clients.ts
index 11eb988d2..35dcda1e4 100644
--- a/ts/packages/cli/src/services/composio-clients.ts
+++ b/ts/packages/cli/src/services/composio-clients.ts
@@ -17,6 +17,7 @@ import type { AuthConfigCreateParams } from '@composio/client/resources/auth-con
import { Toolkit, Toolkits, ToolkitDetailed, type ToolkitSearchResult } from 'src/models/toolkits';
import { AuthConfigItem, AuthConfigItems } from 'src/models/auth-configs';
import { ConnectedAccountItem, ConnectedAccountItems } from 'src/models/connected-accounts';
+import { TriggerInstanceItems } from 'src/models/triggers';
import { ToolsAsEnums, Tools, Tool } from 'src/models/tools';
import {
groupByVersion,
@@ -301,6 +302,137 @@ export const TriggerTypesResponse = Schema.Struct({
total_pages: Schema.Int,
next_cursor: Schema.NullOr(Schema.String),
}).annotations({ identifier: 'TriggerTypesResponse' });
+export type TriggerTypesResponse = Schema.Schema.Type<typeof TriggerTypesResponse>;
+
+export const TriggerInstancesListActiveResponse = Schema.Struct({
+ items: TriggerInstanceItems,
+ total_items: Schema.optionalWith(Schema.Int, { default: () => 0 }),
+ total_pages: Schema.optionalWith(Schema.Int, { default: () => 1 }),
+ current_page: Schema.optionalWith(Schema.Int, { default: () => 1 }),
+ next_cursor: Schema.optionalWith(Schema.NullOr(Schema.String), { default: () => null }),
+}).annotations({ identifier: 'TriggerInstancesListActiveResponse' });
+export type TriggerInstancesListActiveResponse = Schema.Schema.Type<
+ typeof TriggerInstancesListActiveResponse
+>;
+
+export const TriggerInstanceUpsertResponse = Schema.Struct({
+ trigger_id: Schema.String,
+}).annotations({ identifier: 'TriggerInstanceUpsertResponse' });
+export type TriggerInstanceUpsertResponse = Schema.Schema.Type<
+ typeof TriggerInstanceUpsertResponse
+>;
+
+export const TriggerInstanceManageUpdateResponse = Schema.Struct({
+ status: Schema.Literal('success'),
+}).annotations({ identifier: 'TriggerInstanceManageUpdateResponse' });
+export type TriggerInstanceManageUpdateResponse = Schema.Schema.Type<
+ typeof TriggerInstanceManageUpdateResponse
+>;
+
+export const TriggerInstanceManageDeleteResponse = Schema.Struct({
+ trigger_id: Schema.String,
+}).annotations({ identifier: 'TriggerInstanceManageDeleteResponse' });
+export type TriggerInstanceManageDeleteResponse = Schema.Schema.Type<
+ typeof TriggerInstanceManageDeleteResponse
+>;
+
+export interface TriggerInstancesListActiveParams {
+ user_ids?: string[];
+ connected_account_ids?: string[];
+ auth_config_ids?: string[];
+ trigger_ids?: string[];
+ trigger_names?: string[];
+ connectedAccountIds?: string[];
+ authConfigIds?: string[];
+ triggerIds?: string[];
+ triggerNames?: string[];
+ show_disabled?: boolean;
+ showDisabled?: boolean;
+ deprecatedConnectedAccountUuids?: string[];
+ deprecatedAuthConfigUuids?: string[];
+ limit?: number;
+}
+
+export interface TriggerInstanceUpsertParams {
+ connected_account_id?: string;
+ trigger_config?: Record<string, unknown>;
+}
+
+function buildTriggerInstancesNamespace(
+ clientSingleton: ComposioClientSingleton,
+ withMetrics: <A, E, R>(
+ effect: Effect.Effect<{ data: A; metrics: Metrics }, E, R>
+ ) => Effect.Effect<A, E, R>
+) {
+ return {
+ /**
+ * Lists active trigger instances with optional filters.
+ * Returns a single page of results.
+ */
+ listActive: (params: TriggerInstancesListActiveParams) =>
+ withMetrics(
+ callClient(
+ clientSingleton,
+ client =>
+ client.triggerInstances.listActive({
+ user_ids: params.user_ids,
+ connected_account_ids: params.connected_account_ids,
+ auth_config_ids: params.auth_config_ids,
+ trigger_ids: params.trigger_ids,
+ trigger_names: params.trigger_names,
+ connectedAccountIds: params.connectedAccountIds,
+ authConfigIds: params.authConfigIds,
+ triggerIds: params.triggerIds,
+ show_disabled: params.show_disabled,
+ triggerNames: params.triggerNames,
+ showDisabled: params.showDisabled,
+ deprecatedConnectedAccountUuids: params.deprecatedConnectedAccountUuids,
+ deprecatedAuthConfigUuids: params.deprecatedAuthConfigUuids,
+ limit: params.limit,
+ }),
+ TriggerInstancesListActiveResponse
+ )
+ ),
+ upsert: (triggerSlug: string, params?: TriggerInstanceUpsertParams) =>
+ withMetrics(
+ callClient(
+ clientSingleton,
+ client => client.triggerInstances.upsert(triggerSlug, params),
+ TriggerInstanceUpsertResponse
+ )
+ ),
+ manageUpdate: (triggerId: string, params: { status: 'enable' | 'disable' }) =>
+ withMetrics(
+ callClient(
+ clientSingleton,
+ client => client.triggerInstances.manage.update(triggerId, params),
+ TriggerInstanceManageUpdateResponse
+ )
+ ),
+ manageDelete: (triggerId: string) =>
+ withMetrics(
+ callClient(
+ clientSingleton,
+ client => client.triggerInstances.manage.delete(triggerId),
+ TriggerInstanceManageDeleteResponse
+ )
+ ),
+ };
+}
+
+function buildTriggerInstanceRepositoryOperations(client: ComposioClientLive) {
+ return {
+ listActiveTriggers: (params: TriggerInstancesListActiveParams) =>
+ client.triggerInstances.listActive(params),
+ createTrigger: (triggerSlug: string, params?: TriggerInstanceUpsertParams) =>
+ client.triggerInstances.upsert(triggerSlug, params),
+ enableTrigger: (triggerId: string) =>
+ client.triggerInstances.manageUpdate(triggerId, { status: 'enable' }),
+ disableTrigger: (triggerId: string) =>
+ client.triggerInstances.manageUpdate(triggerId, { status: 'disable' }),
+ deleteTrigger: (triggerId: string) => client.triggerInstances.manageDelete(triggerId),
+ };
+}
// Single-page search response (includes total_items for "Listing X of Y" display)
export const ToolkitSearchResponse = Schema.Struct({
@@ -1101,6 +1233,7 @@ export class ComposioClientLive extends Effect.Service<ComposioClientLive>()(
)
),
},
+ triggerInstances: buildTriggerInstancesNamespace(clientSingleton, withMetrics),
cli: {
/**
* Generates a new CLI session with a random 6-character code.
@@ -1391,6 +1524,7 @@ export class ComposioToolkitsRepository extends Effect.Service<ComposioToolkitsR
deleteConnectedAccount: (nanoid: string) => client.connectedAccounts.delete(nanoid),
createConnectedAccountLink: (params: { auth_config_id: string; user_id: string }) =>
client.connectedAccounts.createLink(params),
+ ...buildTriggerInstanceRepositoryOperations(client),
};
}),
dependencies: [ComposioClientLive.Default],
diff --git a/ts/packages/cli/test/__utils__/services/test-layer.ts b/ts/packages/cli/test/__utils__/services/test-layer.ts
index a8d61b5b7..dbcd5e43a 100644
--- a/ts/packages/cli/test/__utils__/services/test-layer.ts
+++ b/ts/packages/cli/test/__utils__/services/test-layer.ts
@@ -35,6 +35,7 @@ import type { Tools } from 'src/models/tools';
import type { TriggerTypes, TriggerTypesAsEnums } from 'src/models/trigger-types';
import type { AuthConfigItem } from 'src/models/auth-configs';
import type { ConnectedAccountItem } from 'src/models/connected-accounts';
+import type { TriggerInstanceItem } from 'src/models/triggers';
import type { AuthConfigCreateResponse, LinkCreateResponse } from 'src/services/composio-clients';
import type { ToolkitVersionSpec } from 'src/effects/toolkit-version-overrides';
import { ComposioUserContextLive } from 'src/services/user-context';
@@ -82,6 +83,13 @@ export interface TestLiveInput {
linkResponse?: LinkCreateResponse;
};
+ /**
+ * Mock trigger instance data to use in test.
+ */
+ triggersData?: {
+ items?: TriggerInstanceItem[];
+ };
+
/**
* Mock realtime trigger data to use in test.
*/
@@ -149,6 +157,14 @@ export const TestLayer = (input?: TestLiveInput) =>
...(input?.realtimeData ?? {}),
};
+ const defaultTriggersData = {
+ items: [] as TriggerInstanceItem[],
+ } satisfies TestLiveInput['triggersData'];
+ const triggersData = {
+ ...defaultTriggersData,
+ ...(input?.triggersData ?? {}),
+ };
+
const tempDir = tempy.temporaryDirectory({ prefix: 'test' });
const cwd = (yield* setupFixtureFolder({ fixture, tempDir })) ?? tempDir;
@@ -514,6 +530,82 @@ export const TestLayer = (input?: TestLiveInput) =>
redirect_url: `https://app.composio.dev/link?token=lt_test_token`,
} satisfies LinkCreateResponse);
},
+ listActiveTriggers: (params: {
+ user_ids?: string[];
+ connected_account_ids?: string[];
+ auth_config_ids?: string[];
+ trigger_ids?: string[];
+ trigger_names?: string[];
+ connectedAccountIds?: string[];
+ authConfigIds?: string[];
+ triggerIds?: string[];
+ triggerNames?: string[];
+ show_disabled?: boolean;
+ showDisabled?: boolean;
+ deprecatedConnectedAccountUuids?: string[];
+ deprecatedAuthConfigUuids?: string[];
+ limit?: number;
+ }) => {
+ let results = [...triggersData.items];
+
+ const userIds = params.user_ids;
+ if (userIds && userIds.length > 0) {
+ const set = new Set(userIds);
+ results = results.filter(item => set.has(item.user_id));
+ }
+
+ const connectedAccountIds = params.connected_account_ids;
+ if (connectedAccountIds && connectedAccountIds.length > 0) {
+ const set = new Set(connectedAccountIds);
+ results = results.filter(item => set.has(item.connected_account_id));
+ }
+
+ const authConfigIds = params.auth_config_ids;
+ if (authConfigIds && authConfigIds.length > 0) {
+ const set = new Set(authConfigIds);
+ results = results.filter(item => set.has(item.auth_config_id));
+ }
+
+ const triggerIds = params.trigger_ids;
+ if (triggerIds && triggerIds.length > 0) {
+ const set = new Set(triggerIds);
+ results = results.filter(item => set.has(item.id));
+ }
+
+ const triggerNames = params.trigger_names;
+ if (triggerNames && triggerNames.length > 0) {
+ const set = new Set(triggerNames.map(name => name.toUpperCase()));
+ results = results.filter(item => set.has(item.trigger_name.toUpperCase()));
+ }
+
+ const includeDisabled = params.show_disabled ?? false;
+ if (!includeDisabled) {
+ results = results.filter(item => item.disabled_at === null);
+ }
+
+ const limit = params.limit ?? 30;
+ const items = results.slice(0, limit);
+ return Effect.succeed({
+ items,
+ total_items: results.length,
+ total_pages: Math.ceil(results.length / limit),
+ current_page: 1,
+ next_cursor: null,
+ });
+ },
+ createTrigger: (
+ triggerSlug: string,
+ params?: {
+ connected_account_id?: string;
+ trigger_config?: Record<string, unknown>;
+ }
+ ) =>
+ Effect.succeed({
+ trigger_id: `trg_${triggerSlug.toLowerCase()}_${params?.connected_account_id ?? 'new'}`,
+ }),
+ enableTrigger: () => Effect.succeed({ status: 'success' as const }),
+ disableTrigger: () => Effect.succeed({ status: 'success' as const }),
+ deleteTrigger: triggerId => Effect.succeed({ trigger_id: triggerId }),
})
);
const ComposioSessionRepositoryTest = yield* setupComposioSessionRepository();
diff --git a/ts/packages/cli/test/src/commands/$default.cmd.test.ts b/ts/packages/cli/test/src/commands/$default.cmd.test.ts
index fb0fc5e43..94fd9591e 100644
--- a/ts/packages/cli/test/src/commands/$default.cmd.test.ts
+++ b/ts/packages/cli/test/src/commands/$default.cmd.test.ts
@@ -56,75 +56,85 @@ describe('CLI: composio', () => {
COMMANDS
- - version Display the current Composio CLI version.
+ - version Display the current Composio CLI version.
- - upgrade Upgrade your Composio CLI to the latest available version.
+ - upgrade Upgrade your Composio CLI to the latest available version.
- - whoami Display your account information.
+ - whoami Display your account information.
- - login [--no-browser] Log in to the Composio SDK.
+ - login [--no-browser] Log in to the Composio SDK.
- - logout Log out from the Composio SDK.
+ - logout Log out from the Composio SDK.
- - generate [(-o, --output-dir directory)] [--type-tools] --toolkits text... Generate type stubs for toolkits, tools, and triggers, auto-detecting project language (TypeScript | Python)
+ - generate [(-o, --output-dir directory)] [--type-tools] --toolkits text... Generate type stubs for toolkits, tools, and triggers, auto-detecting project language (TypeScript | Python)
- - py Handle Python projects.
+ - py Handle Python projects.
- - py generate [(-o, --output-dir directory)] --toolkits text... Generate Python type stubs for toolkits, tools, and triggers from the Composio API.
+ - py generate [(-o, --output-dir directory)] --toolkits text... Generate Python type stubs for toolkits, tools, and triggers from the Composio API.
Environment Variables:
COMPOSIO_TOOLKIT_VERSION_<TOOLKIT> Override toolkit version (e.g., COMPOSIO_TOOLKIT_VERSION_GMAIL=20250901_00)
Use "latest" or unset to use the latest version.
- - ts Handle TypeScript projects.
+ - ts Handle TypeScript projects.
- - ts generate [(-o, --output-dir directory)] [--compact] [--transpiled] [--type-tools] --toolkits text... Generate TypeScript types for toolkits, tools, and triggers from the Composio API.
+ - ts generate [(-o, --output-dir directory)] [--compact] [--transpiled] [--type-tools] --toolkits text... Generate TypeScript types for toolkits, tools, and triggers from the Composio API.
Environment Variables:
COMPOSIO_TOOLKIT_VERSION_<TOOLKIT> Override toolkit version (e.g., COMPOSIO_TOOLKIT_VERSION_GMAIL=20250901_00)
Use "latest" or unset to use the latest version.
- - toolkits Discover and inspect Composio toolkits.
+ - toolkits Discover and inspect Composio toolkits.
- - toolkits list [--query text] [--limit integer] List available toolkits.
+ - toolkits list [--query text] [--limit integer] List available toolkits.
- - toolkits info [<slug>] View details of a specific toolkit.
+ - toolkits info [<slug>] View details of a specific toolkit.
- - toolkits search [--limit integer] <query> Search toolkits by use case.
+ - toolkits search [--limit integer] <query> Search toolkits by use case.
- - tools Discover and inspect Composio tools.
+ - tools Discover and inspect Composio tools.
- - tools list [--query text] [--toolkits text] [--tags text] [--limit integer] List available tools.
+ - tools list [--query text] [--toolkits text] [--tags text] [--limit integer] List available tools.
- - tools info [<slug>] View details of a specific tool.
+ - tools info [<slug>] View details of a specific tool.
- - tools search [--toolkits text] [--limit integer] <query> Search tools by use case.
+ - tools search [--toolkits text] [--limit integer] <query> Search tools by use case.
- - auth-configs View and manage Composio auth configs.
+ - auth-configs View and manage Composio auth configs.
- - auth-configs list [--toolkits text] [--query text] [--limit integer] List auth configs.
+ - auth-configs list [--toolkits text] [--query text] [--limit integer] List auth configs.
- - auth-configs info [<id>] View details of a specific auth config.
+ - auth-configs info [<id>] View details of a specific auth config.
- - auth-configs create --toolkit text [--auth-scheme text] [--scopes text] [--custom-credentials text] [<name>] Create a new auth config.
+ - auth-configs create --toolkit text [--auth-scheme text] [--scopes text] [--custom-credentials text] [<name>] Create a new auth config.
- - auth-configs delete [(-y, --yes)] [<id>] Delete an auth config.
+ - auth-configs delete [(-y, --yes)] [<id>] Delete an auth config.
- - connected-accounts View and manage Composio connected accounts.
+ - connected-accounts View and manage Composio connected accounts.
- - connected-accounts list [--toolkits text] [--user-id text] [--status INITIALIZING | INITIATED | ACTIVE | FAILED | EXPIRED | INACTIVE] [--limit integer] List connected accounts.
+ - connected-accounts list [--toolkits text] [--user-id text] [--status INITIALIZING | INITIATED | ACTIVE | FAILED | EXPIRED | INACTIVE] [--limit integer] List connected accounts.
- - connected-accounts info [<id>] View details of a specific connected account.
+ - connected-accounts info [<id>] View details of a specific connected account.
- - connected-accounts whoami [<id>] Show the external account profile for a connected account.
+ - connected-accounts whoami [<id>] Show the external account profile for a connected account.
- - connected-accounts delete [(-y, --yes)] [<id>] Delete a connected account.
+ - connected-accounts delete [(-y, --yes)] [<id>] Delete a connected account.
- - connected-accounts link --auth-config text [--user-id text] [--no-browser] Link an external account via OAuth redirect.
+ - connected-accounts link --auth-config text [--user-id text] [--no-browser] Link an external account via OAuth redirect.
- - triggers Subscribe to realtime trigger events.
+ - triggers Inspect and subscribe to trigger events.
- - triggers listen [--toolkits text] [--trigger-id text] [--connected-account-id text] [--trigger-slug text] [--user-id text] [--json] [--table] [--max-events integer] [--forward text] [--out text] Listen to realtime trigger events for your project.
+ - triggers listen [--toolkits text] [--trigger-id text] [--connected-account-id text] [--trigger-slug text] [--user-id text] [--json] [--table] [--max-events integer] [--forward text] [--out text] Listen to realtime trigger events for your project.
+
+ - triggers status [--user-ids text] [--connected-account-ids text] [--toolkits text] [--trigger-ids text] [--trigger-names text] [--show-disabled] [--deprecated-connected-account-uuids text] [--limit integer] Show active triggers with optional filters.
+
+ - triggers create [--connected-account-id text] [--trigger-config text] [<trigger-name>] Create a new trigger instance.
+
+ - triggers enable [<id>] Enable a trigger instance.
+
+ - triggers disable [<id>] Disable a trigger instance.
+
+ - triggers delete [(-y, --yes)] [<id>] Delete a trigger instance.
"
`);
})
diff --git a/ts/packages/cli/test/src/commands/triggers/triggers.mutations.cmd.test.ts b/ts/packages/cli/test/src/commands/triggers/triggers.mutations.cmd.test.ts
new file mode 100644
index 000000000..a95012134
--- /dev/null
+++ b/ts/packages/cli/test/src/commands/triggers/triggers.mutations.cmd.test.ts
@@ -0,0 +1,103 @@
+import { describe, expect, layer } from '@effect/vitest';
+import { ConfigProvider, Effect } from 'effect';
+import { extendConfigProvider } from 'src/services/config';
+import { cli, MockConsole, TestLive } from 'test/__utils__';
+
+const testConfigProvider = ConfigProvider.fromMap(
+ new Map([['COMPOSIO_API_KEY', 'test_api_key']])
+).pipe(extendConfigProvider);
+
+describe('CLI: composio triggers mutations', () => {
+ layer(TestLive({ baseConfigProvider: testConfigProvider }))(
+ '[Given] create with valid args [Then] creates trigger',
+ it => {
+ it.scoped('creates trigger and prints id', () =>
+ Effect.gen(function* () {
+ yield* cli([
+ 'triggers',
+ 'create',
+ 'GMAIL_NEW_GMAIL_MESSAGE',
+ '--connected-account-id',
+ 'con_123',
+ ]);
+ const lines = yield* MockConsole.getLines({ stripAnsi: true });
+ const output = lines.join('\n');
+
+ expect(output).toContain('Trigger created');
+ expect(output).toContain('trg_gmail_new_gmail_message_con_123');
+ })
+ );
+ }
+ );
+
+ layer(TestLive({ baseConfigProvider: testConfigProvider }))(
+ '[Given] create with invalid JSON config [Then] shows JSON validation error',
+ it => {
+ it.scoped('rejects invalid trigger config JSON', () =>
+ Effect.gen(function* () {
+ yield* cli(['triggers', 'create', 'GMAIL_NEW_GMAIL_MESSAGE', '--trigger-config', '{']);
+ const lines = yield* MockConsole.getLines({ stripAnsi: true });
+ const output = lines.join('\n');
+
+ expect(output).toContain('Invalid JSON in --trigger-config');
+ })
+ );
+ }
+ );
+
+ layer(TestLive({ baseConfigProvider: testConfigProvider }))(
+ '[Given] enable with ID [Then] enables trigger',
+ it => {
+ it.scoped('enables trigger successfully', () =>
+ Effect.gen(function* () {
+ yield* cli(['triggers', 'enable', 'trg_123']);
+ const lines = yield* MockConsole.getLines({ stripAnsi: true });
+ const output = lines.join('\n');
+ expect(output).toContain('enabled');
+ })
+ );
+ }
+ );
+
+ layer(TestLive({ baseConfigProvider: testConfigProvider }))(
+ '[Given] disable with ID [Then] disables trigger',
+ it => {
+ it.scoped('disables trigger successfully', () =>
+ Effect.gen(function* () {
+ yield* cli(['triggers', 'disable', 'trg_123']);
+ const lines = yield* MockConsole.getLines({ stripAnsi: true });
+ const output = lines.join('\n');
+ expect(output).toContain('disabled');
+ })
+ );
+ }
+ );
+
+ layer(TestLive({ baseConfigProvider: testConfigProvider }))(
+ '[Given] delete with --yes [Then] deletes trigger',
+ it => {
+ it.scoped('deletes trigger successfully', () =>
+ Effect.gen(function* () {
+ yield* cli(['triggers', 'delete', 'trg_123', '--yes']);
+ const lines = yield* MockConsole.getLines({ stripAnsi: true });
+ const output = lines.join('\n');
+ expect(output).toContain('deleted');
+ })
+ );
+ }
+ );
+
+ layer(TestLive({ baseConfigProvider: testConfigProvider }))(
+ '[Given] missing ID for enable [Then] warns about missing argument',
+ it => {
+ it.scoped('shows missing id warning', () =>
+ Effect.gen(function* () {
+ yield* cli(['triggers', 'enable']);
+ const lines = yield* MockConsole.getLines({ stripAnsi: true });
+ const output = lines.join('\n');
+ expect(output).toContain('Missing required argument');
+ })
+ );
+ }
+ );
+});
diff --git a/ts/packages/cli/test/src/commands/triggers/triggers.status.cmd.test.ts b/ts/packages/cli/test/src/commands/triggers/triggers.status.cmd.test.ts
new file mode 100644
index 000000000..0bd2e02f3
--- /dev/null
+++ b/ts/packages/cli/test/src/commands/triggers/triggers.status.cmd.test.ts
@@ -0,0 +1,156 @@
+import { describe, expect, layer } from '@effect/vitest';
+import { ConfigProvider, Effect } from 'effect';
+import { extendConfigProvider } from 'src/services/config';
+import { cli, MockConsole, TestLive } from 'test/__utils__';
+import type { TestLiveInput } from 'test/__utils__/services/test-layer';
+import type { TriggerInstanceItem } from 'src/models/triggers';
+
+const testTriggers: TriggerInstanceItem[] = [
+ {
+ id: 'trg_active_1',
+ uuid: 'uuid-trg-active-1',
+ trigger_name: 'GMAIL_NEW_GMAIL_MESSAGE',
+ connected_account_id: 'con_gmail_1',
+ auth_config_id: 'ac_gmail_1',
+ user_id: 'user_default',
+ disabled_at: null,
+ updated_at: '2026-02-01T00:00:00Z',
+ trigger_data: '',
+ state: {},
+ trigger_config: {},
+ },
+ {
+ id: 'trg_active_2',
+ uuid: 'uuid-trg-active-2',
+ trigger_name: 'SLACK_NEW_MESSAGE',
+ connected_account_id: 'con_slack_1',
+ auth_config_id: 'ac_slack_1',
+ user_id: 'user_123',
+ disabled_at: null,
+ updated_at: '2026-02-02T00:00:00Z',
+ trigger_data: '',
+ state: {},
+ trigger_config: {},
+ },
+ {
+ id: 'trg_disabled_1',
+ uuid: 'uuid-trg-disabled-1',
+ trigger_name: 'GITHUB_COMMIT_EVENT',
+ connected_account_id: 'con_github_1',
+ auth_config_id: 'ac_github_1',
+ user_id: 'user_default',
+ disabled_at: '2026-02-03T00:00:00Z',
+ updated_at: '2026-02-03T00:00:00Z',
+ trigger_data: '',
+ state: {},
+ trigger_config: {},
+ },
+];
+
+const triggersData = {
+ items: testTriggers,
+} satisfies TestLiveInput['triggersData'];
+
+const testConfigProvider = ConfigProvider.fromMap(
+ new Map([['COMPOSIO_API_KEY', 'test_api_key']])
+).pipe(extendConfigProvider);
+
+describe('CLI: composio triggers status', () => {
+ layer(TestLive({ baseConfigProvider: testConfigProvider, triggersData }))(
+ '[Given] no flags [Then] lists active triggers only',
+ it => {
+ it.scoped('lists active trigger instances', () =>
+ Effect.gen(function* () {
+ yield* cli(['triggers', 'status']);
+ const lines = yield* MockConsole.getLines({ stripAnsi: true });
+ const output = lines.join('\n');
+
+ expect(output).toContain('trg_active_1');
+ expect(output).toContain('trg_active_2');
+ expect(output).not.toContain('trg_disabled_1');
+ expect(output).toContain('Listing 2 of 2 triggers');
+ })
+ );
+ }
+ );
+
+ layer(TestLive({ baseConfigProvider: testConfigProvider, triggersData }))(
+ '[Given] --show-disabled [Then] includes disabled triggers',
+ it => {
+ it.scoped('includes disabled trigger instances', () =>
+ Effect.gen(function* () {
+ yield* cli(['triggers', 'status', '--show-disabled']);
+ const lines = yield* MockConsole.getLines({ stripAnsi: true });
+ const output = lines.join('\n');
+
+ expect(output).toContain('trg_active_1');
+ expect(output).toContain('trg_disabled_1');
+ expect(output).toContain('Listing 3 of 3 triggers');
+ })
+ );
+ }
+ );
+
+ layer(TestLive({ baseConfigProvider: testConfigProvider, triggersData }))(
+ '[Given] --user-ids [Then] filters by user IDs',
+ it => {
+ it.scoped('filters by user_ids', () =>
+ Effect.gen(function* () {
+ yield* cli(['triggers', 'status', '--user-ids', 'user_123']);
+ const lines = yield* MockConsole.getLines({ stripAnsi: true });
+ const output = lines.join('\n');
+
+ expect(output).toContain('trg_active_2');
+ expect(output).not.toContain('trg_active_1');
+ expect(output).toContain('Listing 1 of 1 triggers');
+ })
+ );
+ }
+ );
+
+ layer(TestLive({ baseConfigProvider: testConfigProvider, triggersData }))(
+ '[Given] --trigger-names lowercase [Then] applies case-insensitive filter',
+ it => {
+ it.scoped('normalizes trigger names to uppercase', () =>
+ Effect.gen(function* () {
+ yield* cli(['triggers', 'status', '--trigger-names', 'gmail_new_gmail_message']);
+ const lines = yield* MockConsole.getLines({ stripAnsi: true });
+ const output = lines.join('\n');
+
+ expect(output).toContain('trg_active_1');
+ expect(output).not.toContain('trg_active_2');
+ expect(output).toContain('Listing 1 of 1 triggers');
+ })
+ );
+ }
+ );
+
+ layer(TestLive({ baseConfigProvider: testConfigProvider, triggersData }))(
+ '[Given] --toolkits [Then] filters by toolkit slug',
+ it => {
+ it.scoped('filters by toolkit prefix in trigger name', () =>
+ Effect.gen(function* () {
+ yield* cli(['triggers', 'status', '--toolkits', 'slack']);
+ const lines = yield* MockConsole.getLines({ stripAnsi: true });
+ const output = lines.join('\n');
+
+ expect(output).toContain('trg_active_2');
+ expect(output).not.toContain('trg_active_1');
+ expect(output).toContain('Listing 1 of 1 triggers');
+ })
+ );
+ }
+ );
+
+ layer(TestLive())('[Given] no API key [Then] warns user to login', it => {
+ it.scoped('warns user to login', () =>
+ Effect.gen(function* () {
+ yield* cli(['triggers', 'status']);
+ const lines = yield* MockConsole.getLines({ stripAnsi: true });
+ const output = lines.join('\n');
+
+ expect(output).toContain('not logged in');
+ })
+ );
+ });
+});