Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

3.3 KB
Raw Blame
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);
  });
});