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 131 lines 4.57 KB
Raw
1 import { Record as EffectRecord } from 'effect';
2
3 type HintParams = Readonly<Record<string, string | undefined>>;
4
5 const getParam = (params: HintParams | undefined, key: string, fallback: string) => {
6 const value = params?.[key];
7 return value?.trim() ? value : fallback;
8 };
9
10 export type CommandHintId =
11 | 'root.search'
12 | 'root.tools.list'
13 | 'root.tools.info'
14 | 'root.triggers.list'
15 | 'root.triggers.info'
16 | 'root.execute'
17 | 'root.execute.getSchema'
18 | 'root.link'
19 | 'root.orgs.switch'
20 | 'dev.init'
21 | 'dev.playgroundExecute'
22 | 'dev.playgroundExecute.getSchema'
23 | 'dev.logs.tools'
24 | 'dev.logs.triggers'
25 | 'dev.projects.list'
26 | 'dev.toolkits.list'
27 | 'dev.connectedAccounts.link'
28 | 'dev.authConfigs.list';
29
30 type CommandHintNode = {
31 readonly example: (params?: HintParams) => string;
32 readonly links?: ReadonlyArray<CommandHintId>;
33 };
34
35 export const COMMAND_HINTS: Record<CommandHintId, CommandHintNode> = {
36 'root.search': {
37 example: params => {
38 const toolkits = params?.toolkits?.trim();
39 const search = `composio search "${getParam(params, 'query', '<query>')}"`;
40 return toolkits ? `${search} --toolkits ${toolkits}` : search;
41 },
42 links: ['root.execute', 'root.link', 'root.tools.list'],
43 },
44 'root.tools.list': {
45 example: params => `composio tools list "${getParam(params, 'toolkit', '<toolkit>')}"`,
46 links: ['root.tools.info', 'root.execute'],
47 },
48 'root.tools.info': {
49 example: params => `composio tools info "${getParam(params, 'slug', '<slug>')}"`,
50 links: ['root.execute.getSchema', 'root.execute'],
51 },
52 'root.triggers.list': {
53 example: params => `composio triggers list "${getParam(params, 'toolkit', '<toolkit>')}"`,
54 links: ['root.triggers.info'],
55 },
56 'root.triggers.info': {
57 example: params => `composio triggers info "${getParam(params, 'slug', '<slug>')}"`,
58 links: ['root.triggers.list'],
59 },
60 'root.execute': {
61 example: params =>
62 `composio execute "${getParam(params, 'slug', '<slug>')}" ${getParam(params, 'data', "-d '{}'")}`.trim(),
63 links: ['root.link', 'root.execute.getSchema'],
64 },
65 'root.execute.getSchema': {
66 example: params => `composio execute "${getParam(params, 'slug', '<slug>')}" --get-schema`,
67 links: ['root.execute', 'root.tools.info'],
68 },
69 'root.link': {
70 example: params => `composio link ${getParam(params, 'toolkit', '<toolkit>')}`,
71 links: ['root.execute'],
72 },
73 'root.orgs.switch': {
74 example: () => 'composio orgs switch',
75 links: ['root.execute'],
76 },
77 'dev.init': {
78 example: () => 'composio dev init',
79 links: ['dev.playgroundExecute', 'dev.logs.tools', 'dev.logs.triggers'],
80 },
81 'dev.playgroundExecute': {
82 example: params =>
83 `composio dev playground-execute "${getParam(params, 'slug', '<slug>')}" --user-id "${getParam(params, 'userId', '<user-id>')}" ${getParam(params, 'data', "-d '{}'")}`.trim(),
84 links: ['dev.connectedAccounts.link', 'dev.init', 'dev.playgroundExecute.getSchema'],
85 },
86 'dev.playgroundExecute.getSchema': {
87 example: params =>
88 `composio dev playground-execute "${getParam(params, 'slug', '<slug>')}" --get-schema`,
89 links: ['dev.playgroundExecute'],
90 },
91 'dev.logs.tools': {
92 example: params => `composio dev logs tools "${getParam(params, 'logId', '<log_id>')}"`,
93 },
94 'dev.logs.triggers': {
95 example: params => `composio dev logs triggers "${getParam(params, 'logId', '<log_id>')}"`,
96 },
97 'dev.projects.list': {
98 example: () => 'composio dev projects list',
99 links: ['dev.init'],
100 },
101 'dev.toolkits.list': {
102 example: () => 'composio dev toolkits list',
103 links: ['root.tools.list', 'dev.connectedAccounts.link'],
104 },
105 'dev.connectedAccounts.link': {
106 example: params =>
107 `composio dev connected-accounts link ${getParam(params, 'toolkit', '<toolkit>')} --user-id "${getParam(params, 'userId', '<user-id>')}"`,
108 links: ['dev.playgroundExecute'],
109 },
110 'dev.authConfigs.list': {
111 example: () => 'composio dev auth-configs list',
112 links: ['dev.connectedAccounts.link'],
113 },
114 };
115
116 export const commandHintExample = (id: CommandHintId, params?: HintParams): string =>
117 COMMAND_HINTS[id].example(params);
118
119 export const commandHintStep = (label: string, id: CommandHintId, params?: HintParams): string =>
120 `${label}:\n> ${commandHintExample(id, params)}`;
121
122 export const commandHintLinks = (id: CommandHintId): ReadonlyArray<CommandHintId> =>
123 COMMAND_HINTS[id].links ?? [];
124
125 export const renderCommandHintGraph = () => ({
126 nodes: EffectRecord.toEntries(COMMAND_HINTS).map(([id]) => ({
127 id,
128 example: commandHintExample(id),
129 links: [...commandHintLinks(id)],
130 })),
131 });