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

next
ts 73 lines 2.51 KB
Raw
1 import { Array as Arr, Effect, Option } from 'effect';
2 import { reportFailure } from 'src/effects/report-failure';
3 import { ComposioClientSingleton } from 'src/services/composio-clients';
4 import { idempotent } from 'src/services/composio-request';
5 import { TerminalUI } from 'src/services/terminal-ui';
6 import { extractMessage } from 'src/utils/api-error-extraction';
7 import {
8 formatToolkitVersions,
9 formatToolkitVersionsJson,
10 type ToolkitVersions,
11 } from './toolkits.version.format';
12 import { BROWSE_TOOLKITS_HINT } from '../format';
13
14 export type ToolkitsVersionParams = {
15 readonly slug: string;
16 };
17
18 /** How many of the most recent versions the command prints. */
19 export const RECENT_VERSIONS_LIMIT = 20;
20
21 /**
22 * The fields `toolkits version` reads. The response is not validated, so a toolkit that lacks
23 * other catalog fields, or its version list, still prints.
24 */
25 export type VersionedToolkit = {
26 readonly slug: string;
27 readonly name: string;
28 readonly meta?: { readonly available_versions?: ReadonlyArray<string> };
29 };
30
31 /** The latest version is the last one the API lists. */
32 export const toolkitVersionsOf = (toolkit: VersionedToolkit): ToolkitVersions => {
33 const availableVersions = toolkit.meta?.available_versions ?? [];
34 return {
35 slug: toolkit.slug,
36 name: toolkit.name,
37 latestVersion: Option.getOrNull(Arr.last(availableVersions)),
38 recentVersions: availableVersions.slice(-RECENT_VERSIONS_LIMIT),
39 };
40 };
41
42 /**
43 * Shows a toolkit's latest version and its last 20 available versions. A failed lookup prints the
44 * error and a browse hint on stderr and exits 1.
45 */
46 export const runToolkitsVersion = ({ slug }: ToolkitsVersionParams) =>
47 Effect.gen(function* () {
48 const ui = yield* TerminalUI;
49 const clientSingleton = yield* ComposioClientSingleton;
50 const client = yield* clientSingleton.get();
51
52 const versions = yield* ui
53 .withSpinner(
54 `Fetching versions for toolkit "${slug}"...`,
55 client.toolkits.retrieve(slug, undefined, idempotent)
56 )
57 .pipe(
58 Effect.map(toolkitVersionsOf),
59 Effect.catch(error =>
60 Effect.gen(function* () {
61 yield* Effect.logDebug('Toolkit version error:', error);
62 return yield* reportFailure(
63 ui,
64 extractMessage(error) ?? `Failed to fetch version info for toolkit "${slug}".`,
65 BROWSE_TOOLKITS_HINT
66 );
67 })
68 )
69 );
70
71 yield* ui.log.message(formatToolkitVersions(versions));
72 yield* ui.output(formatToolkitVersionsJson(versions));
73 });