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 { Command, Options } from '@effect/cli';
import { Data, Effect, Option, Predicate } from 'effect';
import { ensureBundledBinaryExecutable } from '@composio/cli-local-tools';
import { spawnDetached } from 'src/services/detached-process';
import { TerminalUI } from 'src/services/terminal-ui';
import { resolveNativeUiBinary } from 'src/services/native-ui-sidecar';
class NativeUiSetupError extends Data.TaggedError('commands/NativeUiSetupError')<{
readonly message: string;
readonly cause: unknown;
}> {}
const title = Options.text('title').pipe(
Options.withDefault('Composio'),
Options.withDescription('Title for the native sidecar window.')
);
const message = Options.text('message').pipe(
Options.withDefault('Native UI sidecar scaffold'),
Options.withDescription('Primary text displayed in the native sidecar window.')
);
const detail = Options.text('detail').pipe(
Options.withDefault('This window is rendered by a Swift sidecar bundled with the CLI.'),
Options.withDescription('Secondary text displayed in the native sidecar window.')
);
const timeout = Options.optional(Options.text('timeout')).pipe(
Options.withDescription('Optional auto-close timeout in seconds.')
);
export const devNativeUiCmd = Command.make('native-ui', { title, message, detail, timeout }).pipe(
Command.withDescription('Open the experimental native macOS UI sidecar.'),
Command.withHandler(({ title, message, detail, timeout }) =>
Effect.gen(function* () {
const ui = yield* TerminalUI;
const resolved = yield* resolveNativeUiBinary;
if (Predicate.isTagged(resolved, 'unsupported')) {
yield* ui.log.error(
`The native UI sidecar is currently only available on macOS (detected ${resolved.platform}).`
);
return;
}
if (Predicate.isTagged(resolved, 'missing')) {
yield* ui.log.error('The native UI sidecar binary was not found.');
yield* ui.log.step(
`Build it with: pnpm --filter @composio/cli-local-tools build:composio-native-ui -- --target ${resolved.platform}`
);
yield* ui.log.step(`Checked: ${resolved.candidates.join(', ')}`);
return;
}
yield* Effect.tryPromise({
try: () => ensureBundledBinaryExecutable(resolved.binaryPath),
catch: cause =>
new NativeUiSetupError({
message: `Failed to make the native UI sidecar binary executable: ${resolved.binaryPath}`,
cause,
}),
});
const args = ['--title', title, '--message', message, '--detail', detail];
const timeoutValue = Option.getOrUndefined(timeout)?.trim();
if (timeoutValue) {
args.push('--timeout', timeoutValue);
}
// The sidecar window must outlive the CLI process, so it goes through
// the sanctioned detached-spawn boundary instead of @effect/platform
// Command (whose processes are killed when their scope closes).
yield* spawnDetached(resolved.binaryPath, args);
yield* ui.log.success('Opened native UI sidecar.');
})
)
);