1
import { Args, Command, Options } from '@effect/cli';
2
import { FileSystem } from '@effect/platform';
3
+import type { Composio as RawComposioClient } from '@composio/client';
4
import { Deferred, Effect, Option, Runtime } from 'effect';
5
import path from 'node:path';
6
import { requireAuth } from 'src/effects/require-auth';
22
import { parseTriggerListenEvent } from './triggers/parse';
23
24
const slug = Args.text({ name: 'slug' }).pipe(
24
- Args.withDescription('Trigger slug (e.g. "GMAIL_NEW_GMAIL_MESSAGE")')
25
+ Args.withDescription(
26
+ 'Trigger slug (e.g. "GMAIL_NEW_GMAIL_MESSAGE") or project event type (e.g. "composio.connected_account.expired")'
27
+ )
28
);
29
30
const params = Options.text('params').pipe(
31
Options.withAlias('p'),
29
- Options.withDescription('Trigger create params as JSON/JS object, @file, or - for stdin'),
32
+ Options.withDescription(
33
+ 'Trigger create params as JSON/JS object, @file, or - for stdin. Only valid for trigger slugs.'
34
+ ),
35
Options.optional
36
);
37
38
const maxEvents = Options.integer('max-events').pipe(
34
- Options.withDescription('Stop after receiving N events for this temporary trigger'),
39
+ Options.withDescription('Stop after receiving N matching events'),
40
Options.optional
41
);
42
62
const sanitizePathPart = (value: string): string =>
63
value.replace(/[^A-Z0-9._-]+/gi, '-').replace(/^-+|-+$/g, '') || 'unknown';
64
65
+const isProjectEventType = (value: string): boolean => value.startsWith('composio.');
66
+
67
const resolveParamsInput = (input: Option.Option<string>) =>
68
resolveOptionalTextInput(input, { missingValue: '{}' });
69
86
return parsed as Record<string, unknown>;
87
});
88
89
+const assertSupportedListenParams = (params: {
90
+ listeningToProjectEvent: boolean;
91
+ slug: string;
92
+ createParamsInput: Record<string, unknown>;
93
+}) =>
94
+ params.listeningToProjectEvent && Object.keys(params.createParamsInput).length > 0
95
+ ? Effect.fail(
96
+ new Error(
97
+ `--params is only supported for trigger slugs. "${params.slug}" is a project-level composio.* event type and does not create a temporary trigger.`
98
+ )
99
+ )
100
+ : Effect.void;
101
+
102
+const resolveConnectedAccountIdForTrigger = (params: {
103
+ client: RawComposioClient;
104
+ slug: string;
105
+ consumerUserId: string;
106
+}) =>
107
+ Effect.gen(function* () {
108
+ const toolkitSlug = toolkitFromToolSlug(params.slug);
109
+ if (!toolkitSlug) {
110
+ return yield* Effect.fail(
111
+ new Error(
112
+ `Could not infer a toolkit from trigger slug "${params.slug}". Use a standard trigger slug such as "GMAIL_NEW_GMAIL_MESSAGE", or a project event type such as "composio.connected_account.expired".`
113
+ )
114
+ );
115
+ }
116
+
117
+ const connectedAccounts = yield* Effect.tryPromise({
118
+ try: () =>
119
+ params.client.connectedAccounts.list({
120
+ toolkit_slugs: [toolkitSlug],
121
+ user_ids: [params.consumerUserId],
122
+ statuses: ['ACTIVE'],
123
+ limit: 100,
124
+ }),
125
+ catch: error =>
126
+ new Error(`Failed to list connected accounts for "${toolkitSlug}": ${String(error)}`),
127
+ });
128
+ const connectedAccountId = selectConnectedAccountId(connectedAccounts.items);
129
+
130
+ if (!connectedAccountId) {
131
+ return yield* Effect.fail(
132
+ new Error(
133
+ `No active connected account found for toolkit "${toolkitSlug}" and consumer user "${params.consumerUserId}". Run \`composio link ${toolkitSlug}\` first.`
134
+ )
135
+ );
136
+ }
137
+
138
+ return connectedAccountId;
139
+ });
140
+
141
const selectConnectedAccountId = (
142
items: ReadonlyArray<{
143
id: string;
161
yield* ui.output(line, { force: true });
162
});
163
164
+const eventTypeOf = (eventData: Record<string, unknown>): string | undefined =>
165
+ typeof eventData.type === 'string' && eventData.type.length > 0 ? eventData.type : undefined;
166
+
167
const extractEventFileId = (eventData: Record<string, unknown>): string => {
168
const candidates = [
169
eventData.id,
242
return JSON.stringify(value);
243
};
244
245
+const formatStopMessage = (params: {
246
+ matchingEvents: number;
247
+ timedOut: boolean;
248
+ temporaryTriggerDisabled: boolean;
249
+}): string => {
250
+ const eventLabel = `event${params.matchingEvents === 1 ? '' : 's'}`;
251
+ if (params.timedOut) {
252
+ return params.temporaryTriggerDisabled
253
+ ? `Stopped after timeout with ${params.matchingEvents} matching ${eventLabel}. Temporary trigger disabled.`
254
+ : `Stopped after timeout with ${params.matchingEvents} matching ${eventLabel}.`;
255
+ }
256
+
257
+ return params.temporaryTriggerDisabled
258
+ ? `Stopped after receiving ${params.matchingEvents} ${eventLabel}. Temporary trigger disabled.`
259
+ : `Stopped after receiving ${params.matchingEvents} ${eventLabel}.`;
260
+};
261
+
262
const TIMEOUT_UNITS_MS: Record<string, number> = {
263
ms: 1,
264
millisecond: 1,
331
);
332
}
333
334
+ const listeningToProjectEvent = isProjectEventType(slug);
335
const rawParams = Option.isSome(params)
336
? (yield* resolveParamsInput(params))?.trim() || '{}'
337
: '{}';
338
const createParamsInput = yield* parseCreateParams(rawParams);
259
- const toolkitSlug = toolkitFromToolSlug(slug);
260
- if (!toolkitSlug) {
261
- return yield* Effect.fail(
262
- new Error(
263
- `Could not infer a toolkit from trigger slug "${slug}". Use a standard trigger slug such as "GMAIL_NEW_GMAIL_MESSAGE".`
264
- )
265
- );
266
- }
267
-
268
- const connectedAccounts = yield* Effect.tryPromise({
269
- try: () =>
270
- client.connectedAccounts.list({
271
- toolkit_slugs: [toolkitSlug],
272
- user_ids: resolvedProject.consumerUserId ? [resolvedProject.consumerUserId] : undefined,
273
- statuses: ['ACTIVE'],
274
- limit: 100,
275
- }),
276
- catch: error =>
277
- new Error(`Failed to list connected accounts for "${toolkitSlug}": ${String(error)}`),
278
- });
279
- const resolvedConnectedAccountId = selectConnectedAccountId(connectedAccounts.items);
280
-
281
- if (!resolvedConnectedAccountId) {
282
- return yield* Effect.fail(
283
- new Error(
284
- `No active connected account found for toolkit "${toolkitSlug}" and consumer user "${resolvedProject.consumerUserId}". Run \`composio link ${toolkitSlug}\` first.`
285
- )
286
- );
287
- }
288
-
289
- const createParams = {
290
- ...createParamsInput,
291
- connected_account_id: resolvedConnectedAccountId,
292
- } as Parameters<typeof client.triggerInstances.upsert>[1];
339
+ yield* assertSupportedListenParams({ listeningToProjectEvent, slug, createParamsInput });
340
+
341
+ const resolvedConnectedAccountId = listeningToProjectEvent
342
+ ? undefined
343
+ : yield* resolveConnectedAccountIdForTrigger({
344
+ client,
345
+ slug,
346
+ consumerUserId: resolvedProject.consumerUserId,
347
+ });
348
+
349
+ const createParams = listeningToProjectEvent
350
+ ? undefined
351
+ : ({
352
+ ...createParamsInput,
353
+ connected_account_id: resolvedConnectedAccountId,
354
+ } as Parameters<typeof client.triggerInstances.upsert>[1]);
355
const timeoutMs = Option.match(timeout, {
356
onNone: () => undefined,
357
onSome: value => parseTimeoutMs(value),
373
onNone: () => resolveFallbackArtifactsDir(),
374
onSome: value => value.directoryPath,
375
});
314
- const triggerDir = path.join(artifactsRoot, 'triggers', sanitizePathPart(slug));
376
+ const triggerDir = path.join(
377
+ artifactsRoot,
378
+ listeningToProjectEvent ? 'events' : 'triggers',
379
+ sanitizePathPart(slug)
380
+ );
381
const streamFilePath = path.join(triggerDir, 'events.jsonl');
382
383
yield* fs.makeDirectory(triggerDir, { recursive: true });
389
const seenEventIds = new Set<string>();
390
391
yield* Effect.acquireUseRelease(
326
- Effect.tryPromise({
327
- try: () => client.triggerInstances.upsert(slug, createParams),
328
- catch: error =>
329
- new Error(`Failed to create temporary trigger "${slug}": ${String(error)}`),
330
- }),
392
+ listeningToProjectEvent
393
+ ? Effect.succeed<null | { trigger_id: string }>(null)
394
+ : Effect.tryPromise({
395
+ try: () => client.triggerInstances.upsert(slug, createParams),
396
+ catch: error =>
397
+ new Error(`Failed to create temporary trigger "${slug}": ${String(error)}`),
398
+ }),
399
createdTrigger =>
400
Effect.gen(function* () {
401
yield* emitStreamLine(`listening for events ${slug} (tail at ${streamFilePath})`, ui);
402
if (debug) {
335
- const debugMsg = `[debug] trigger_id=${createdTrigger.trigger_id} project=${resolvedProject.projectId} org=${resolvedProject.orgId} createParams=${JSON.stringify(createParams)}`;
403
+ const debugMsg =
404
+ createdTrigger === null
405
+ ? `[debug] event_type=${slug} project=${resolvedProject.projectId} org=${resolvedProject.orgId}`
406
+ : `[debug] trigger_id=${createdTrigger.trigger_id} project=${resolvedProject.projectId} org=${resolvedProject.orgId} createParams=${JSON.stringify(createParams)}`;
407
yield* emitStreamLine(debugMsg, ui);
337
- yield* emitStreamLine(
338
- `[debug] upsert response: ${JSON.stringify(createdTrigger)}`,
339
- ui
340
- );
408
+ if (createdTrigger !== null) {
409
+ yield* emitStreamLine(
410
+ `[debug] upsert response: ${JSON.stringify(createdTrigger)}`,
411
+ ui
412
+ );
413
+ }
414
}
415
416
const onEvent = (eventData: Record<string, unknown>) => {
426
ui
427
);
428
}
356
- const parsed = parseTriggerListenEvent(eventData);
357
- const filterResult = matchesTriggerListenFilters(
358
- { triggerId: createdTrigger.trigger_id },
359
- parsed
360
- );
429
+ const parsedTriggerEvent =
430
+ createdTrigger === null ? undefined : parseTriggerListenEvent(eventData);
431
+ const filterResult =
432
+ createdTrigger === null
433
+ ? eventTypeOf(eventData) === slug
434
+ : matchesTriggerListenFilters(
435
+ { triggerId: createdTrigger.trigger_id },
436
+ parsedTriggerEvent!
437
+ );
438
if (debug) {
439
yield* emitStreamLine(
363
- `[debug] parsed.id=${parsed.id} triggerSlug=${parsed.triggerSlug} trigger_id=${createdTrigger.trigger_id} match=${filterResult}`,
440
+ createdTrigger === null
441
+ ? `[debug] event.type=${eventTypeOf(eventData) ?? '<missing>'} match=${filterResult}`
442
+ : `[debug] parsed.id=${parsedTriggerEvent!.id} triggerSlug=${parsedTriggerEvent!.triggerSlug} trigger_id=${createdTrigger.trigger_id} match=${filterResult}`,
443
ui
444
);
445
}
461
const eventJson = JSON.stringify(eventData, null, 2);
462
const streamEntry = JSON.stringify({
463
event_id: eventFileId,
385
- trigger_id: createdTrigger.trigger_id,
386
- trigger_slug: slug,
464
+ event_type: eventTypeOf(eventData),
465
+ trigger_id: createdTrigger?.trigger_id,
466
+ trigger_slug: createdTrigger ? slug : undefined,
467
file_path: eventFilePath,
468
received_at: new Date().toISOString(),
469
});
520
const stopReason = yield* Effect.raceFirst(listenEffect, Deferred.await(stopWhenDone));
521
if (stopReason === 'max-events') {
522
yield* ui.outro(
443
- `Stopped after receiving ${matchingEvents} events. Temporary trigger disabled.`
523
+ formatStopMessage({
524
+ matchingEvents,
525
+ timedOut: false,
526
+ temporaryTriggerDisabled: createdTrigger !== null,
527
+ })
528
);
529
return;
530
}
531
532
if (stopReason === 'timeout') {
533
yield* ui.outro(
450
- `Stopped after timeout with ${matchingEvents} matching event${matchingEvents === 1 ? '' : 's'}. Temporary trigger disabled.`
534
+ formatStopMessage({
535
+ matchingEvents,
536
+ timedOut: true,
537
+ temporaryTriggerDisabled: createdTrigger !== null,
538
+ })
539
);
540
}
541
}),
542
created =>
455
- Effect.tryPromise({
456
- try: () =>
457
- client.triggerInstances.manage.update(created.trigger_id, { status: 'disable' }),
458
- catch: error =>
459
- new Error(
460
- `Failed to disable temporary trigger "${created.trigger_id}": ${String(error)}`
461
- ),
462
- }).pipe(
463
- Effect.catchAll(error =>
464
- ui.log.warn(error instanceof Error ? error.message : String(error))
465
- )
466
- )
543
+ created === null
544
+ ? Effect.void
545
+ : Effect.tryPromise({
546
+ try: () =>
547
+ client.triggerInstances.manage.update(created.trigger_id, { status: 'disable' }),
548
+ catch: error =>
549
+ new Error(
550
+ `Failed to disable temporary trigger "${created.trigger_id}": ${String(error)}`
551
+ ),
552
+ }).pipe(
553
+ Effect.catchAll(error =>
554
+ ui.log.warn(error instanceof Error ? error.message : String(error))
555
+ )
556
+ )
557
);
558
})
559
).pipe(
560
Command.withDescription(
471
- 'Create a temporary subscription for consumer-project events and write each event to artifacts for easy background-agent consumption.'
561
+ 'Listen to consumer-project realtime events. Trigger slugs create a temporary trigger; top-level composio.* event types subscribe directly.'
562
)
563
);