Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
import { CommandDescriptor } from '@effect/cli';
import { layer } from '@effect/vitest';
import { Effect, HashMap } from 'effect';
import { describe, expect, it } from 'vitest';
import { buildRootCommand } from 'src/commands';
import {
getCommandHelpText,
matchCommandFromArgv,
matchSubcommandHelp,
printSubcommandHelp,
} from 'src/commands/root-help';
import { MockConsole, TestLive } from 'test/__utils__';
const stableVisibility = {
isDevModeEnabled: true,
isExperimentalFeatureEnabled: () => false,
};
const betaVisibility = {
isDevModeEnabled: true,
isExperimentalFeatureEnabled: () => true,
};
const getSubcommandNames = (visibility: typeof stableVisibility) =>
HashMap.toEntries(CommandDescriptor.getSubcommands(buildRootCommand(visibility).descriptor)).map(
([name]) => name
);
describe('CLI experimental feature visibility', () => {
it('hides experimental root commands from the stable root command graph', () => {
expect(getSubcommandNames(stableVisibility)).not.toContain('listen');
expect(getSubcommandNames(stableVisibility)).not.toContain('local-tools');
expect(getSubcommandNames(betaVisibility)).toContain('listen');
expect(getSubcommandNames(betaVisibility)).toContain('local-tools');
});
it('hides listen help when the feature is disabled', () => {
expect(matchSubcommandHelp(['bun', 'composio', 'listen', '--help'], stableVisibility)).toBe(
undefined
);
expect(matchSubcommandHelp(['bun', 'composio', 'listen', '--help'], betaVisibility)).toBe(
'listen'
);
});
it('hides contextual experimental help when the feature is disabled', () => {
expect(matchCommandFromArgv(['bun', 'composio', 'listen'], stableVisibility)).toBe(undefined);
expect(matchCommandFromArgv(['bun', 'composio', 'listen'], betaVisibility)).toBe('listen');
expect(getCommandHelpText('listen', stableVisibility)).toBe(undefined);
expect(getCommandHelpText('listen', betaVisibility)).toContain('composio listen');
expect(matchCommandFromArgv(['bun', 'composio', 'local-tools'], stableVisibility)).toBe(
undefined
);
expect(matchCommandFromArgv(['bun', 'composio', 'local-tools'], betaVisibility)).toBe(
'local-tools'
);
expect(getCommandHelpText('local-tools', stableVisibility)).toBe(undefined);
expect(getCommandHelpText('local-tools', betaVisibility)).toContain('composio local-tools');
});
it('shows stable account selection for execute and proxy', () => {
expect(getCommandHelpText('execute', stableVisibility)).toContain('--account <selector>');
expect(getCommandHelpText('proxy', stableVisibility)).toContain('--account <selector>');
expect(getCommandHelpText('link', stableVisibility)).not.toContain(
'multi_account experimental feature'
);
});
it('accepts help mode suffixes when matching subcommand help', () => {
expect(
matchSubcommandHelp(['bun', 'composio', 'search', '--help', 'simple'], stableVisibility)
).toBe('search');
expect(
matchSubcommandHelp(['bun', 'composio', 'search', '--help', 'full'], stableVisibility)
).toBe('search');
});
});
describe('CLI help levels', () => {
layer(TestLive())(it => {
it.scoped('renders compact subcommand help in simple mode', () =>
Effect.gen(function* () {
yield* printSubcommandHelp('run', stableVisibility, 'simple');
const output = (yield* MockConsole.getLines({ stripAnsi: true })).join('\n');
expect(output).toContain('USAGE');
expect(output).toContain('DESCRIPTION');
expect(output).not.toContain('EXAMPLES');
expect(output).not.toContain('INJECTED HELPERS');
})
);
});
});