Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 1 | import { Effect, Layer } from 'effect'; |
| 2 | import { |
| 3 | ComposioToolkitsRepository, |
| 4 | type ComposioToolkitsRepositoryShape, |
| 5 | type ToolkitProjectScope, |
| 6 | } from 'src/services/composio-clients'; |
| 7 | import type { Toolkits } from 'src/models/toolkits'; |
| 8 | |
| 9 | export type GetToolkitsError = Effect.Error< |
| 10 | ReturnType<ComposioToolkitsRepositoryShape['getToolkits']> |
| 11 | >; |
| 12 | |
| 13 | const notUsed = (method: string) => () => Effect.die(`${method} is not used in this test`); |
| 14 | |
| 15 | /** |
| 16 | * Every repository method the toolkit-catalog suites do not exercise. A call |
| 17 | * to any of them is a defect in the test, not a scenario to handle. |
| 18 | */ |
| 19 | const unusedRepositoryMethods = { |
| 20 | getToolkitsBySlugs: notUsed('getToolkitsBySlugs'), |
| 21 | getMetrics: notUsed('getMetrics'), |
| 22 | getToolsAsEnums: notUsed('getToolsAsEnums'), |
| 23 | getTools: notUsed('getTools'), |
| 24 | getToolsByVersionSpecs: notUsed('getToolsByVersionSpecs'), |
| 25 | getTriggerTypesAsEnums: notUsed('getTriggerTypesAsEnums'), |
| 26 | getTriggerTypes: notUsed('getTriggerTypes'), |
| 27 | getTriggerTypeDetailed: notUsed('getTriggerTypeDetailed'), |
| 28 | validateToolkits: notUsed('validateToolkits'), |
| 29 | validateToolkitVersions: notUsed('validateToolkitVersions'), |
| 30 | // The repository's one synchronous method cannot return a dying Effect. |
| 31 | filterToolkitsBySlugs: (): never => { |
| 32 | throw new Error('filterToolkitsBySlugs is not used in this test'); |
| 33 | }, |
| 34 | searchToolkits: notUsed('searchToolkits'), |
| 35 | getToolkitDetailed: notUsed('getToolkitDetailed'), |
| 36 | searchTools: notUsed('searchTools'), |
| 37 | getToolDetailed: notUsed('getToolDetailed'), |
| 38 | listAuthConfigs: notUsed('listAuthConfigs'), |
| 39 | getAuthConfig: notUsed('getAuthConfig'), |
| 40 | createAuthConfig: notUsed('createAuthConfig'), |
| 41 | getConnectedAccount: notUsed('getConnectedAccount'), |
| 42 | listActiveTriggers: notUsed('listActiveTriggers'), |
| 43 | createTrigger: notUsed('createTrigger'), |
| 44 | enableTrigger: notUsed('enableTrigger'), |
| 45 | disableTrigger: notUsed('disableTrigger'), |
| 46 | } as const; |
| 47 | |
| 48 | export type GetProjectToolkitsError = Effect.Error< |
| 49 | ReturnType<ComposioToolkitsRepositoryShape['getProjectToolkits']> |
| 50 | >; |
| 51 | |
| 52 | /** |
| 53 | * A repository whose every method dies unless the test overrides it. |
| 54 | */ |
| 55 | export const makeToolkitsRepositoryStub = ( |
| 56 | overrides: Partial<ComposioToolkitsRepositoryShape> |
| 57 | ): ComposioToolkitsRepositoryShape => |
| 58 | ComposioToolkitsRepository.of({ |
| 59 | ...unusedRepositoryMethods, |
| 60 | getToolkits: notUsed('getToolkits'), |
| 61 | getProjectToolkits: notUsed('getProjectToolkits'), |
| 62 | ...overrides, |
| 63 | }); |
| 64 | |
| 65 | /** |
| 66 | * A `ComposioToolkitsRepository` layer that counts catalog fetches, so a test |
| 67 | * can assert not just what was resolved but what it cost. The native and |
| 68 | * project-managed catalogs are counted separately. |
| 69 | */ |
| 70 | export const countingToolkitsRepository = ( |
| 71 | getToolkits: () => Effect.Effect<Toolkits, GetToolkitsError>, |
| 72 | getProjectToolkits: ( |
| 73 | scope?: ToolkitProjectScope |
| 74 | ) => Effect.Effect<Toolkits, GetProjectToolkitsError> = () => Effect.succeed([]) |
| 75 | ) => { |
| 76 | let calls = 0; |
| 77 | let projectCalls = 0; |
| 78 | |
| 79 | const layer = Layer.succeed( |
| 80 | ComposioToolkitsRepository, |
| 81 | ComposioToolkitsRepository.of({ |
| 82 | ...unusedRepositoryMethods, |
| 83 | getToolkits: () => |
| 84 | Effect.suspend(() => { |
| 85 | calls += 1; |
| 86 | return getToolkits(); |
| 87 | }), |
| 88 | getProjectToolkits: scope => |
| 89 | Effect.suspend(() => { |
| 90 | projectCalls += 1; |
| 91 | return getProjectToolkits(scope); |
| 92 | }), |
| 93 | }) |
| 94 | ); |
| 95 | |
| 96 | return { layer, calls: () => calls, projectCalls: () => projectCalls }; |
| 97 | }; |
| 98 | |
| 99 | /** The repository methods that act on a developer project's resources; each takes its scope first. */ |
| 100 | const PROJECT_RESOURCE_METHODS = [ |
| 101 | 'listAuthConfigs', |
| 102 | 'getAuthConfig', |
| 103 | 'createAuthConfig', |
| 104 | 'getConnectedAccount', |
| 105 | 'listActiveTriggers', |
| 106 | 'createTrigger', |
| 107 | 'enableTrigger', |
| 108 | 'disableTrigger', |
| 109 | ] as const; |
| 110 | |
| 111 | type ProjectResourceMethod = (typeof PROJECT_RESOURCE_METHODS)[number]; |
| 112 | |
| 113 | /** One project resource call: the method and the scope it was asked to act on. */ |
| 114 | export interface RecordedRepositoryScope { |
| 115 | readonly method: ProjectResourceMethod; |
| 116 | readonly scope: unknown; |
| 117 | } |
| 118 | |
| 119 | /** |
| 120 | * A layer over a test layer's `ComposioToolkitsRepository` that records the scope every project |
| 121 | * resource call names (its first argument), then answers as the test layer does. |
| 122 | */ |
| 123 | export const recordRepositoryScopes = () => { |
| 124 | const calls: Array<RecordedRepositoryScope> = []; |
| 125 | const layer = Layer.effect( |
| 126 | ComposioToolkitsRepository, |
| 127 | Effect.gen(function* () { |
| 128 | const base = yield* ComposioToolkitsRepository; |
| 129 | const recording = Object.fromEntries( |
| 130 | PROJECT_RESOURCE_METHODS.map(method => { |
| 131 | const call = base[method] as ( |
| 132 | ...args: ReadonlyArray<unknown> |
| 133 | ) => Effect.Effect<unknown, unknown>; |
| 134 | return [ |
| 135 | method, |
| 136 | (...args: ReadonlyArray<unknown>) => |
| 137 | Effect.suspend(() => { |
| 138 | calls.push({ method, scope: args[0] }); |
| 139 | return call(...args); |
| 140 | }), |
| 141 | ]; |
| 142 | }) |
| 143 | ) as Partial<ComposioToolkitsRepositoryShape>; |
| 144 | return ComposioToolkitsRepository.of({ ...base, ...recording }); |
| 145 | }) |
| 146 | ); |
| 147 | return { calls, layer }; |
| 148 | }; |