Skip to content

The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.

8.9 KB
Raw Blame
/**
 * Tests for McpServerPanel — MCP client configuration UI.
 *
 * Covers: tool list rendering, client tab selector, JSON snippet shape for
 * each client, copy-to-clipboard, binary-path error fallback, open-config
 * invoke, and Tauri-gate on the "Open Config File" button.
 */
import { fireEvent, screen, waitFor } from '@testing-library/react';
import { beforeEach, describe, expect, test, vi } from 'vitest';

import { renderWithProviders } from '../../../test/test-utils';

// ---------------------------------------------------------------------------
// Hoisted mocks — must be defined before any imports that trigger the module
// ---------------------------------------------------------------------------

const hoisted = vi.hoisted(() => ({ invoke: vi.fn(), isTauri: vi.fn(() => true) }));

// McpServerPanel imports `invoke` from `tauriCommands/common` (aliased from
// `safeInvoke` — see OPENHUMAN-TAURI-REACT-7 / TAURI-REACT-6). Route
// `hoisted.invoke` through `safeInvoke` so assertions on
// `hoisted.invoke.toHaveBeenCalledWith(...)` work unchanged. The
// `@tauri-apps/api/core` mock is omitted because `safeInvoke` shadows it
// for all panel call sites.
vi.mock('../../../utils/tauriCommands/common', () => ({
  isTauri: hoisted.isTauri,
  safeInvoke: (...args: unknown[]) => hoisted.invoke(...args),
}));

vi.mock('../hooks/useSettingsNavigation', () => ({
  useSettingsNavigation: () => ({
    navigateToSettings: vi.fn(),
    navigateBack: vi.fn(),
    breadcrumbs: [],
  }),
}));

// ---------------------------------------------------------------------------
// Helpers
// ---------------------------------------------------------------------------

const BINARY_PATH = '/usr/local/bin/openhuman-core';
const DEFAULT_BINARY_INFO = { path: BINARY_PATH, os: 'macos' };

async function importPanel() {
  const mod = await import('./McpServerPanel');
  return mod.default;
}

function setupClipboard() {
  const writeText = vi.fn().mockResolvedValue(undefined);
  Object.defineProperty(navigator, 'clipboard', { configurable: true, value: { writeText } });
  return writeText;
}

// ---------------------------------------------------------------------------
// Tests
// ---------------------------------------------------------------------------

describe('McpServerPanel — tool list', () => {
  beforeEach(() => {
    hoisted.invoke.mockReset();
    hoisted.invoke.mockResolvedValue(DEFAULT_BINARY_INFO);
    hoisted.isTauri.mockReset();
    hoisted.isTauri.mockReturnValue(true);
  });

  test('renders the panel with all 10 tool names visible', async () => {
    vi.resetModules();
    const Panel = await importPanel();
    renderWithProviders(<Panel />);

    const expectedTools = [
      'core.list_tools',
      'core.tool_instructions',
      'agent.list_subagents',
      'agent.run_subagent',
      'memory.search',
      'memory.recall',
      'tree.read_chunk',
      'tree.browse',
      'tree.top_entities',
      'tree.list_sources',
    ];

    for (const tool of expectedTools) {
      expect(screen.getByText(tool)).toBeInTheDocument();
    }
  });
});

describe('McpServerPanel — client tabs', () => {
  beforeEach(() => {
    hoisted.invoke.mockReset();
    hoisted.invoke.mockResolvedValue(DEFAULT_BINARY_INFO);
    hoisted.isTauri.mockReset();
    hoisted.isTauri.mockReturnValue(true);
  });

  test('renders all four client tabs', async () => {
    vi.resetModules();
    const Panel = await importPanel();
    renderWithProviders(<Panel />);

    expect(screen.getByRole('tab', { name: /Claude Desktop/i })).toBeInTheDocument();
    expect(screen.getByRole('tab', { name: /Cursor/i })).toBeInTheDocument();
    expect(screen.getByRole('tab', { name: /Codex/i })).toBeInTheDocument();
    expect(screen.getByRole('tab', { name: /Zed/i })).toBeInTheDocument();
  });
});

describe('McpServerPanel — JSON snippets', () => {
  beforeEach(() => {
    hoisted.invoke.mockReset();
    hoisted.invoke.mockResolvedValue(DEFAULT_BINARY_INFO);
    hoisted.isTauri.mockReset();
    hoisted.isTauri.mockReturnValue(true);
  });

  test('Claude Desktop snippet contains mcpServers key', async () => {
    vi.resetModules();
    const Panel = await importPanel();
    renderWithProviders(<Panel />);

    // Claude Desktop is selected by default
    await waitFor(() => {
      expect(hoisted.invoke).toHaveBeenCalledWith('mcp_resolve_binary_path');
    });

    // The snippet should be in a <pre> element
    const preEl = document.querySelector('pre');
    expect(preEl).not.toBeNull();
    const content = preEl!.textContent ?? '';
    expect(content).toContain('mcpServers');
    expect(content).toContain(BINARY_PATH);
  });

  test('Zed snippet contains context_servers key', async () => {
    vi.resetModules();
    const Panel = await importPanel();
    renderWithProviders(<Panel />);

    await waitFor(() => {
      expect(hoisted.invoke).toHaveBeenCalledWith('mcp_resolve_binary_path');
    });

    fireEvent.click(screen.getByRole('tab', { name: /Zed/i }));

    const preEl = document.querySelector('pre');
    expect(preEl).not.toBeNull();
    const content = preEl!.textContent ?? '';
    expect(content).toContain('context_servers');
    expect(content).toContain(BINARY_PATH);
  });
});

describe('McpServerPanel — copy to clipboard', () => {
  beforeEach(() => {
    hoisted.invoke.mockReset();
    hoisted.invoke.mockResolvedValue(DEFAULT_BINARY_INFO);
    hoisted.isTauri.mockReset();
    hoisted.isTauri.mockReturnValue(true);
  });

  test('copy button calls clipboard.writeText with JSON containing the binary path', async () => {
    const writeText = setupClipboard();

    vi.resetModules();
    const Panel = await importPanel();
    renderWithProviders(<Panel />);

    await waitFor(() => {
      expect(hoisted.invoke).toHaveBeenCalledWith('mcp_resolve_binary_path');
    });

    fireEvent.click(screen.getByRole('button', { name: /Copy to Clipboard/i }));

    await waitFor(() => {
      expect(writeText).toHaveBeenCalledTimes(1);
    });

    const written: string = writeText.mock.calls[0][0];
    expect(written).toContain(BINARY_PATH);
    expect(written).toContain('mcpServers');
  });
});

describe('McpServerPanel — binary path error', () => {
  beforeEach(() => {
    hoisted.invoke.mockReset();
    hoisted.isTauri.mockReset();
    hoisted.isTauri.mockReturnValue(true);
  });

  test('shows fallback placeholder when binary resolution fails', async () => {
    hoisted.invoke.mockRejectedValue(new Error('binary not found on disk'));

    vi.resetModules();
    const Panel = await importPanel();
    renderWithProviders(<Panel />);

    await waitFor(() => {
      expect(screen.getByText(/OpenHuman binary not found/i)).toBeInTheDocument();
    });
  });
});

describe('McpServerPanel — open config file', () => {
  beforeEach(() => {
    hoisted.invoke.mockReset();
    hoisted.invoke.mockResolvedValue(DEFAULT_BINARY_INFO);
    hoisted.isTauri.mockReset();
    hoisted.isTauri.mockReturnValue(true);
  });

  test('Open Config File calls invoke with the active client', async () => {
    hoisted.invoke.mockImplementation((cmd: string) => {
      if (cmd === 'mcp_resolve_binary_path') return Promise.resolve(DEFAULT_BINARY_INFO);
      if (cmd === 'mcp_open_client_config') return Promise.resolve();
      return Promise.resolve();
    });

    vi.resetModules();
    const Panel = await importPanel();
    renderWithProviders(<Panel />);

    await waitFor(() => {
      expect(hoisted.invoke).toHaveBeenCalledWith('mcp_resolve_binary_path');
    });

    fireEvent.click(screen.getByRole('button', { name: /Open Config File/i }));

    await waitFor(() => {
      expect(hoisted.invoke).toHaveBeenCalledWith('mcp_open_client_config', {
        client: 'claude-desktop',
      });
    });
  });

  test('Open Config File button is hidden when not in Tauri', async () => {
    hoisted.isTauri.mockReturnValue(false);

    vi.resetModules();
    const Panel = await importPanel();
    renderWithProviders(<Panel />);

    // The button should not appear
    expect(screen.queryByRole('button', { name: /Open Config File/i })).toBeNull();
  });

  test('shows openConfigError in role=status div when invoke rejects (line 280)', async () => {
    hoisted.invoke.mockImplementation((cmd: string) => {
      if (cmd === 'mcp_resolve_binary_path') return Promise.resolve(DEFAULT_BINARY_INFO);
      if (cmd === 'mcp_open_client_config') return Promise.reject(new Error('permission denied'));
      return Promise.resolve();
    });

    vi.resetModules();
    const Panel = await importPanel();
    renderWithProviders(<Panel />);

    await waitFor(() => {
      expect(hoisted.invoke).toHaveBeenCalledWith('mcp_resolve_binary_path');
    });

    fireEvent.click(screen.getByRole('button', { name: /Open Config File/i }));

    // The error message should appear inside a role=status element (line 280-286)
    await waitFor(() => {
      const statusEl = document.querySelector('[role="status"]');
      expect(statusEl).not.toBeNull();
      expect(statusEl!.textContent).toContain('permission denied');
    });
  });
});