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 { describe, expect, it, vi } from '@effect/vitest';
import { Config, ConfigProvider, Effect, Exit, Layer } from 'effect';
import * as FetchHttpClient from '@effect/platform/FetchHttpClient';
import * as FileSystem from '@effect/platform/FileSystem';
import * as HttpClient from '@effect/platform/HttpClient';
import * as Path from '@effect/platform/Path';
import type * as PlatformError from '@effect/platform/Error';
import * as BunFileSystem from '@effect/platform-bun/BunFileSystem';
import * as BunPath from '@effect/platform-bun/BunPath';
import * as tempy from 'tempy';
import { TerminalUITest } from 'test/__utils__/services/terminal-ui-test';
import { startTestHttpServer } from 'test/__utils__/http-server';
import {
inferSkillReleaseChannel,
installSkill,
resolveInstalledSkillName,
resolveSkillReleaseTag,
resolveTargetSkillPath,
SKILL_RELEASE_TAG_FILENAME,
SkillInstallError,
type SkillReleaseChannel,
} from 'src/effects/install-skill';
import { GITHUB_CONFIG } from 'src/effects/github-config';
import { CliReleaseResolutionError } from 'src/effects/resolve-cli-release';
import { defaultNodeOs, NodeOs } from 'src/services/node-os';
const TEST_RELEASE_TAG = '@composio/[email protected]';
const TEST_SKILL_ZIP = Uint8Array.from(
atob(
'UEsDBAoAAAAAAEGX7lwAAAAAAAAAAAAAAAANABwAY29tcG9zaW8tY2xpL1VUCQADeU5WanlOVmp1eAsAAQT1AQAABBQAAABQSwMECgAAAAAAQZfuXMXglUQPAAAADwAAABUAHABjb21wb3Npby1jbGkvU0tJTEwubWRVVAkAA3lOVmp5TlZqdXgLAAEE9QEAAAQUAAAAIyBjb21wb3Npby1jbGkKUEsBAh4DCgAAAAAAQZfuXAAAAAAAAAAAAAAAAA0AGAAAAAAAAAAQAO1BAAAAAGNvbXBvc2lvLWNsaS9VVAUAA3lOVmp1eAsAAQT1AQAABBQAAABQSwECHgMKAAAAAABBl+5cxeCVRA8AAAAPAAAAFQAYAAAAAAABAAAApIFHAAAAY29tcG9zaW8tY2xpL1NLSUxMLm1kVVQFAAN5TlZqdXgLAAEE9QEAAAQUAAAAUEsFBgAAAAACAAIArgAAAKUAAAAAAA=='
),
character => character.charCodeAt(0)
);
const TestPlatform = Layer.mergeAll(BunFileSystem.layer, BunPath.layer);
const makeInstallEffect = (
home: string,
apiBaseUrl: string,
options: { readonly releaseTag?: string } = { releaseTag: TEST_RELEASE_TAG }
) =>
installSkill({ target: 'claude', ...options }).pipe(
Effect.provide(
Layer.mergeAll(
TestPlatform,
FetchHttpClient.layer,
TerminalUITest,
Layer.succeed(NodeOs, defaultNodeOs({ homedir: home }))
)
),
Effect.withConfigProvider(
ConfigProvider.fromMap(
new Map([
['GITHUB_API_BASE_URL', apiBaseUrl],
['GITHUB_OWNER', 'test-owner'],
['GITHUB_REPO', 'test-repo'],
])
)
),
Effect.scoped
);
const startSkillReleaseServer = (skillZip: Uint8Array) =>
startTestHttpServer((req, res) => {
if (req.url === '/skill.zip') {
res.writeHead(200, { 'content-type': 'application/zip' });
res.end(skillZip);
return;
}
res.writeHead(200, { 'content-type': 'application/json' });
res.end(
JSON.stringify({
assets: [
{
name: 'composio-skill.zip',
browser_download_url: `http://${req.headers.host}/skill.zip`,
},
],
})
);
});
/** Scoped stub of Bun.which that misses, so release resolution takes the HTTP path. */
const stubBunWhichMiss = Effect.acquireRelease(
Effect.sync(() => vi.stubGlobal('Bun', { which: vi.fn(() => null) })),
() =>
Effect.sync(() => {
vi.unstubAllGlobals();
vi.restoreAllMocks();
})
);
type TargetSetup = (
fs: FileSystem.FileSystem,
path: Path.Path,
home: string,
target: string
) => Effect.Effect<void, PlatformError.PlatformError>;
const TARGET_SCENARIOS = [
['a missing', (() => Effect.void) satisfies TargetSetup],
[
'an existing directory',
((fs, _path, _home, target) =>
fs.makeDirectory(target, { recursive: true })) satisfies TargetSetup,
],
[
'an existing symlink',
((fs, path, home, target) =>
Effect.gen(function* () {
const existingTarget = path.join(home, 'existing-skill');
yield* fs.makeDirectory(existingTarget, { recursive: true });
yield* fs.makeDirectory(path.dirname(target), { recursive: true });
yield* fs.symlink(path.relative(path.dirname(target), existingTarget), target);
})) satisfies TargetSetup,
],
[
'a broken symlink',
((fs, path, home, target) =>
Effect.gen(function* () {
yield* fs.makeDirectory(path.dirname(target), { recursive: true });
yield* fs.symlink(
path.relative(path.dirname(target), path.join(home, 'missing-skill')),
target
);
})) satisfies TargetSetup,
],
] as const;
const makeResolveEffect = (
configEntries: ReadonlyArray<[string, string]>,
options: {
channel?: SkillReleaseChannel;
installedReleaseTag?: string;
releaseTag?: string;
} = {}
) =>
Effect.gen(function* () {
const httpClient = yield* HttpClient.HttpClient;
const githubConfig = yield* Config.all(GITHUB_CONFIG);
return yield* resolveSkillReleaseTag({
channel: options.channel,
githubConfig,
httpClient,
installedReleaseTag: options.installedReleaseTag,
releaseTag: options.releaseTag,
});
}).pipe(
Effect.provide(FetchHttpClient.layer),
Effect.withConfigProvider(ConfigProvider.fromMap(new Map(configEntries))),
Effect.scoped
);
describe('install-skill', () => {
it('infers the stable channel from stable versions', () => {
expect(inferSkillReleaseChannel('0.2.19')).toBe('stable');
expect(inferSkillReleaseChannel('@composio/[email protected]')).toBe('stable');
});
it('infers the beta channel from beta versions', () => {
expect(inferSkillReleaseChannel('0.2.20-beta.4')).toBe('beta');
expect(inferSkillReleaseChannel('@composio/[email protected]')).toBe('beta');
});
it('defaults the installed skill name to composio-cli', () => {
expect(resolveInstalledSkillName()).toBe('composio-cli');
expect(resolveInstalledSkillName(' ')).toBe('composio-cli');
});
it('rejects unsafe installed skill names', () => {
expect(() => resolveInstalledSkillName('../bad')).toThrow(/Invalid skill name/);
expect(() => resolveInstalledSkillName('.')).toThrow(/Invalid skill name/);
expect(() => resolveInstalledSkillName('..')).toThrow(/Invalid skill name/);
});
it.effect('resolves the agent-specific skill path', () =>
Effect.gen(function* () {
const path = yield* Path.Path;
expect(
resolveTargetSkillPath({
home: '/tmp/test-home',
path,
skillName: 'composio-cli',
target: 'claude',
})
).toBe('/tmp/test-home/.claude/skills/composio-cli');
expect(
resolveTargetSkillPath({
home: '/tmp/test-home',
path,
skillName: 'composio-cli',
target: 'codex',
})
).toBe('/tmp/test-home/.codex/skills/composio-cli');
expect(
resolveTargetSkillPath({
home: '/tmp/test-home',
path,
skillName: 'composio-cli',
target: 'openclaw',
})
).toBe('/tmp/test-home/.openclaw/skills/composio-cli');
}).pipe(Effect.provide(Path.layer))
);
it.effect('prefers an explicit running release tag over channel discovery', () =>
Effect.gen(function* () {
const releaseTag = '@composio/[email protected]';
const tag = yield* makeResolveEffect([], {
channel: 'stable',
installedReleaseTag: '@composio/[email protected]',
releaseTag,
});
expect(tag).toBe(releaseTag);
})
);
it.effect('prefers the configured release tag over packaged metadata', () =>
Effect.gen(function* () {
const tag = yield* makeResolveEffect([['GITHUB_TAG', '@composio/[email protected]']], {
installedReleaseTag: '@composio/[email protected]',
});
expect(tag).toBe('@composio/[email protected]');
})
);
it.effect('uses the packaged release tag when no explicit selector is provided', () =>
Effect.gen(function* () {
const tag = yield* makeResolveEffect([], {
installedReleaseTag: '@composio/[email protected]',
});
expect(tag).toBe('@composio/[email protected]');
})
);
it.scoped('installs from the packaged release tag when package metadata differs', () => {
const installDir = tempy.temporaryDirectory();
const execPathSpy = vi
.spyOn(process, 'execPath', 'get')
.mockReturnValue(`${installDir}/composio`);
let requestedReleasePath = '';
return Effect.gen(function* () {
const fs = yield* FileSystem.FileSystem;
const path = yield* Path.Path;
const packagedReleaseTag = '@composio/[email protected]';
yield* fs.writeFileString(path.join(installDir, 'release-tag.txt'), packagedReleaseTag);
const apiBaseUrl = yield* startTestHttpServer((req, res) => {
if (req.url === '/skill.zip') {
res.writeHead(200, { 'content-type': 'application/zip' });
res.end(TEST_SKILL_ZIP);
return;
}
requestedReleasePath = req.url ?? '';
res.writeHead(200, { 'content-type': 'application/json' });
res.end(
JSON.stringify({
tag_name: packagedReleaseTag,
assets: [
{
name: 'composio-skill.zip',
browser_download_url: `http://${req.headers.host}/skill.zip`,
},
],
})
);
});
const home = tempy.temporaryDirectory();
yield* makeInstallEffect(home, apiBaseUrl, {});
expect(requestedReleasePath).toContain(encodeURIComponent(packagedReleaseTag));
expect(
yield* fs.readFileString(
path.join(home, '.agents', 'skills', 'composio-cli', SKILL_RELEASE_TAG_FILENAME)
)
).toBe(`${packagedReleaseTag}\n`);
}).pipe(
Effect.provide(TestPlatform),
Effect.ensuring(Effect.sync(() => execPathSpy.mockRestore()))
);
});
it.scoped('falls back to the latest inferred channel for source and development runs', () =>
Effect.gen(function* () {
yield* stubBunWhichMiss;
const apiBaseUrl = yield* startTestHttpServer((_req, res) => {
res.writeHead(200, { 'content-type': 'application/json' });
res.end(
JSON.stringify([
{
tag_name: '@composio/[email protected]',
draft: false,
prerelease: true,
assets: [
{
name: 'composio-skill.zip',
browser_download_url: 'http://127.0.0.1/beta-skill.zip',
},
],
},
{
tag_name: '@composio/[email protected]',
draft: false,
prerelease: false,
assets: [
{
name: 'composio-skill.zip',
browser_download_url: 'http://127.0.0.1/stable-skill.zip',
},
],
},
])
);
});
const tag = yield* makeResolveEffect([
['GITHUB_API_BASE_URL', apiBaseUrl],
['GITHUB_OWNER', 'test-owner'],
['GITHUB_REPO', 'test-repo'],
]);
expect(tag).toBe('@composio/[email protected]');
})
);
it.scoped('fails with a typed decode error for malformed GitHub release lists', () =>
Effect.gen(function* () {
const apiBaseUrl = yield* startTestHttpServer((_req, res) => {
res.writeHead(200, { 'content-type': 'application/json' });
res.end(JSON.stringify({ tag_name: '@composio/[email protected]' }));
});
const error = yield* Effect.flip(
makeResolveEffect(
[
['GITHUB_API_BASE_URL', apiBaseUrl],
['GITHUB_OWNER', 'test-owner'],
['GITHUB_REPO', 'test-repo'],
],
{ channel: 'stable' }
)
);
expect(error).toBeInstanceOf(CliReleaseResolutionError);
if (error instanceof CliReleaseResolutionError) {
expect(error.reason).toBe('decode');
expect(error.cause).toBeDefined();
}
})
);
it.scoped('fails with a typed decode error for malformed skill release metadata', () =>
Effect.gen(function* () {
const apiBaseUrl = yield* startTestHttpServer((_req, res) => {
res.writeHead(200, { 'content-type': 'application/json' });
res.end(JSON.stringify({ assets: [{ name: 'composio-skill.zip' }] }));
});
const home = tempy.temporaryDirectory();
const error = yield* Effect.flip(makeInstallEffect(home, apiBaseUrl));
expect(error).toBeInstanceOf(SkillInstallError);
if (error instanceof SkillInstallError) {
expect(error.phase).toBe('release');
expect(error.cause).toBeDefined();
}
})
);
it.scoped.each(TARGET_SCENARIOS)('installs over %s target', ([, prepareTarget]) =>
Effect.gen(function* () {
const apiBaseUrl = yield* startSkillReleaseServer(TEST_SKILL_ZIP);
const fs = yield* FileSystem.FileSystem;
const path = yield* Path.Path;
const home = tempy.temporaryDirectory();
const target = path.join(home, '.claude', 'skills', 'composio-cli');
const canonicalSkill = path.join(home, '.agents', 'skills', 'composio-cli');
yield* prepareTarget(fs, path, home, target);
yield* makeInstallEffect(home, apiBaseUrl);
expect(yield* fs.readFileString(path.join(target, 'SKILL.md'))).toBe('# composio-cli\n');
expect(yield* fs.readFileString(path.join(canonicalSkill, SKILL_RELEASE_TAG_FILENAME))).toBe(
`${TEST_RELEASE_TAG}\n`
);
expect(yield* fs.readLink(target)).toBe(path.relative(path.dirname(target), canonicalSkill));
expect(yield* fs.exists(path.join(home, '.agents', '.tmp-skill-install'))).toBe(false);
}).pipe(Effect.provide(TestPlatform))
);
it.scoped('removes the temporary install directory after extraction fails', () =>
Effect.gen(function* () {
const apiBaseUrl = yield* startSkillReleaseServer(new TextEncoder().encode('not a zip'));
const home = tempy.temporaryDirectory();
const exit = yield* Effect.exit(makeInstallEffect(home, apiBaseUrl));
expect(Exit.isFailure(exit)).toBe(true);
const fs = yield* FileSystem.FileSystem;
const path = yield* Path.Path;
expect(yield* fs.exists(path.join(home, '.agents', '.tmp-skill-install'))).toBe(false);
}).pipe(Effect.provide(TestPlatform))
);
it.scoped('resolves the latest stable release when the stable channel is requested', () =>
Effect.gen(function* () {
yield* stubBunWhichMiss;
const apiBaseUrl = yield* startTestHttpServer((_req, res) => {
res.writeHead(200, { 'content-type': 'application/json' });
res.end(
JSON.stringify([
{
tag_name: '@composio/[email protected]',
draft: false,
prerelease: true,
assets: [
{
name: 'composio-skill.zip',
browser_download_url: 'http://127.0.0.1/beta-skill.zip',
},
],
},
{
tag_name: '@composio/[email protected]',
draft: false,
prerelease: false,
assets: [
{
name: 'composio-skill.zip',
browser_download_url: 'http://127.0.0.1/stable-skill.zip',
},
],
},
{
tag_name: '@composio/[email protected]',
draft: false,
prerelease: false,
assets: [
{
name: 'composio-linux-x64.zip',
browser_download_url: 'http://127.0.0.1/no-skill.zip',
},
],
},
])
);
});
const tag = yield* makeResolveEffect(
[
['GITHUB_API_BASE_URL', apiBaseUrl],
['GITHUB_OWNER', 'test-owner'],
['GITHUB_REPO', 'test-repo'],
],
{ channel: 'stable' }
);
expect(tag).toBe('@composio/[email protected]');
})
);
it.scoped('resolves the latest beta release when the beta channel is requested', () =>
Effect.gen(function* () {
yield* stubBunWhichMiss;
const apiBaseUrl = yield* startTestHttpServer((_req, res) => {
res.writeHead(200, { 'content-type': 'application/json' });
res.end(
JSON.stringify([
{
tag_name: '@composio/[email protected]',
draft: false,
prerelease: true,
assets: [
{
name: 'composio-skill.zip',
browser_download_url: 'http://127.0.0.1/beta-1-skill.zip',
},
],
},
{
tag_name: '@composio/[email protected]',
draft: false,
prerelease: true,
assets: [
{
name: 'composio-skill.zip',
browser_download_url: 'http://127.0.0.1/beta-3-skill.zip',
},
],
},
{
tag_name: '@composio/[email protected]',
draft: false,
prerelease: false,
assets: [
{
name: 'composio-skill.zip',
browser_download_url: 'http://127.0.0.1/stable-skill.zip',
},
],
},
])
);
});
const tag = yield* makeResolveEffect(
[
['GITHUB_API_BASE_URL', apiBaseUrl],
['GITHUB_OWNER', 'test-owner'],
['GITHUB_REPO', 'test-repo'],
],
{ channel: 'beta' }
);
expect(tag).toBe('@composio/[email protected]');
})
);
});