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 } from 'vitest';
import {
ComposioNoActiveConnectionError,
mapComposioError,
mapOnlyComposioOverrideError,
} from 'src/services/composio-error-overrides';
describe('composio-error-overrides', () => {
it('rewrites tool-router no-active-connection errors by toolkit', () => {
const result = mapComposioError({
toolkit: 'gmail',
error: {
details: {
code: 4302,
slug: 'ToolRouterV2_NoActiveConnection',
message: 'No active connection',
},
},
});
expect(result.normalized).toBeInstanceOf(ComposioNoActiveConnectionError);
expect(result.message).toBe(
'No active connection found for toolkit "gmail". Run `composio link gmail`, then retry.'
);
});
it('rewrites execute no-connection errors by tool slug', () => {
const result = mapComposioError({
toolSlug: 'SLACK_SEND_MESSAGE',
error: {
error: {
slug: 'ActionExecute_ConnectedAccountNotFound',
message: 'Missing connected account',
},
},
});
expect(result.normalized).toBeInstanceOf(ComposioNoActiveConnectionError);
expect(result.message).toBe(
'No active connection found for toolkit "slack". Run `composio link slack`, then retry.'
);
});
it('passes through unrelated errors', () => {
const error = new Error('Something else broke');
const result = mapComposioError({ error });
expect(result.normalized).toBe(error);
expect(result.override).toBeNull();
expect(result.message).toBe('Something else broke');
});
it('does not trust malformed API error fields but keeps the valid ones', () => {
const error = {
details: {
code: '4302',
slug: 4302,
message: 'Malformed API error',
},
};
const result = mapComposioError({ error });
expect(result.normalized).toBe(error);
expect(result.apiDetails?.message).toBe('Malformed API error');
expect(result.apiDetails?.code).toBeUndefined();
expect(result.apiDetails?.slug).toBeUndefined();
expect(result.override).toBeNull();
expect(result.message).toBe('Malformed API error');
});
it('skips UnknownException wrappers while decoding their causes', () => {
const result = mapComposioError({
toolkit: 'gmail',
error: {
_tag: 'UnknownException',
cause: {
code: 4302,
slug: 'ToolRouterV2_NoActiveConnection',
message: 'No active connection',
},
},
});
expect(result.normalized).toBeInstanceOf(ComposioNoActiveConnectionError);
expect(result.apiDetails).toEqual({
code: 4302,
slug: 'ToolRouterV2_NoActiveConnection',
message: 'No active connection',
});
});
it('preserves original generic errors for top-level CLI handling', () => {
const error = {
_tag: 'ToolExecutionError',
error: new Error('inner'),
};
expect(mapOnlyComposioOverrideError({ error })).toBe(error);
});
it('still rewrites override-class Composio errors at the top level', () => {
const mapped = mapOnlyComposioOverrideError({
toolkit: 'gmail',
error: {
details: {
code: 4302,
slug: 'ToolRouterV2_NoActiveConnection',
},
},
});
expect(mapped).toBeInstanceOf(ComposioNoActiveConnectionError);
});
});