Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 04:45 UTC
| 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 | }); |