Make your computer a home for your AI partner. Avibe is the local-first Agent OS: Vibey, its built-in AI partner, works out of the box, and Claude Code, Codex & OpenCode run unchanged beside it — reach them from your browser, phone, or any chat app.
Python agentagent-osaiai-agentsai-partnerchatopsclaudeclaude-codecodexdevtoolsdiscord-botlark-botllmlocal-firstlong-term-memoryopencodeslack-botvibe-codingvibeywechat
/* @vitest-environment jsdom */
import type { ReactNode } from 'react';
import { cleanup, fireEvent, render, screen, waitFor, within } from '@testing-library/react';
import { I18nextProvider } from 'react-i18next';
import { MemoryRouter, Route, Routes } from 'react-router-dom';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import i18n from '@/i18n';
import { modelsApi } from './models/modelsApi';
import type { AgentSupply } from './models/types';
import { SettingsBackendPage } from './SettingsBackendPage';
import { SettingsBackendsPage } from './SettingsBackendsPage';
const mocks = vi.hoisted(() => ({
api: {
getConfig: vi.fn(),
detectCli: vi.fn(),
mutateConfig: vi.fn(),
getBackendRuntime: vi.fn(),
installAgent: vi.fn(),
restartBackend: vi.fn(),
},
showToast: vi.fn(),
}));
vi.mock('@/context/ApiContext', () => ({ useApi: () => mocks.api }));
vi.mock('@/context/ToastContext', () => ({ useToast: () => ({ showToast: mocks.showToast }) }));
vi.mock('./SettingsPageShell', () => ({
SettingsPageShell: ({ children, title }: { children: ReactNode; title: string }) => <main><h1>{title}</h1>{children}</main>,
}));
vi.mock('./models/useModelHubCapability', () => ({ useModelHubCapability: () => false }));
vi.mock('./BackendLifecycleChip', () => ({
BackendLifecycleChip: ({ name }: { name: string }) => <span data-testid={`lifecycle-${name}`} />,
}));
beforeEach(async () => {
vi.clearAllMocks();
await i18n.changeLanguage('en');
mocks.api.getConfig.mockResolvedValue({ agents: {} });
mocks.api.detectCli.mockImplementation(async (binary: string) => ({ found: true, status: 'ok' as const, path: binary }));
});
afterEach(() => {
cleanup();
vi.restoreAllMocks();
});
const renderBackends = () => render(
<I18nextProvider i18n={i18n}>
<MemoryRouter initialEntries={['/settings/backends']}>
<Routes>
<Route path="/settings/backends" element={<SettingsBackendsPage />} />
<Route path="/settings/backends/vibey" element={<SettingsBackendPage backend="vibey" />} />
</Routes>
</MemoryRouter>
</I18nextProvider>,
);
const rowOf = async (name: string) => (await screen.findByText(name)).closest('.rounded-xl') as HTMLElement;
describe('built-in backend settings', () => {
// The built-in Vibey is part of the platform: listed first, always on,
// and marked Built-in where every other backend has its enable switch.
it('uses the shared display order, with Vibey Built-in and no switch or native actions', async () => {
renderBackends();
const vibey = await rowOf('Vibey');
const rows = [...document.querySelectorAll('.rounded-xl')];
expect(rows.map((row) => row.querySelector('span.font-semibold')?.textContent)).toEqual([
'Vibey', 'Claude Code', 'Codex', 'OpenCode',
]);
expect(within(vibey).getByText('Built-in')).toBeTruthy();
expect(within(vibey).queryByRole('switch')).toBeNull();
expect(within(vibey).queryByTestId('lifecycle-vibey')).toBeNull();
for (const name of ['OpenCode', 'Claude Code', 'Codex']) {
const row = await rowOf(name);
expect(within(row).getByRole('switch')).toBeTruthy();
expect(within(row).queryByText('Built-in')).toBeNull();
}
await waitFor(() => expect(mocks.api.detectCli).toHaveBeenCalledTimes(3));
expect(mocks.api.detectCli.mock.calls.map(([binary]) => binary).sort()).toEqual(['claude', 'codex', 'opencode']);
const configure = within(vibey).getByRole('link', { name: 'Configure' });
expect(configure.getAttribute('href')).toBe('/settings/backends/vibey');
fireEvent.click(configure);
await screen.findByRole('heading', { level: 1, name: 'Vibey' });
expect(await screen.findByText('Built-in')).toBeTruthy();
expect(screen.queryByRole('switch')).toBeNull();
expect(screen.queryByRole('textbox')).toBeNull();
expect(screen.queryByRole('button', { name: /Detect|Install|Restart|Save|Sign in/i })).toBeNull();
expect(screen.queryByTestId('lifecycle-vibey')).toBeNull();
expect(mocks.api.mutateConfig).not.toHaveBeenCalled();
expect(mocks.api.detectCli).toHaveBeenCalledTimes(3);
expect(mocks.api.getBackendRuntime).not.toHaveBeenCalled();
expect(mocks.api.installAgent).not.toHaveBeenCalled();
expect(mocks.api.restartBackend).not.toHaveBeenCalled();
});
});
describe('backend attention', () => {
const withoutModel = [
{
backend: 'vibey', cli_present: false, mode: 'hub', menu_kind: 'fixed',
named_agents: [{ name: 'vibey', effective_model_id: null, supply_status: null }],
},
{
backend: 'claude', cli_present: true, mode: 'hub', menu_kind: 'fixed',
named_agents: [{ name: 'claude', effective_model_id: 'claude-opus-5-5', supply_status: 'ok' }],
},
] as AgentSupply[];
// GET /api/config carries the server's answer for each blocked backend.
const modelHubConfig = (enabled: boolean) => ({
agents: {},
capabilities: { model_hub: { enabled: true } },
agent_supply_blocks: enabled ? {} : { vibey: 'gateway_off' },
});
it('flags the always-on backend whose Agent has no model', async () => {
vi.spyOn(modelsApi, 'listAgents').mockResolvedValue(withoutModel);
mocks.api.getConfig.mockResolvedValue(modelHubConfig(true));
renderBackends();
const vibey = await rowOf('Vibey');
expect(await within(vibey).findByText('No model selected')).toBeTruthy();
expect(within(vibey).queryByText('Gateway unavailable')).toBeNull();
expect(within(await rowOf('Claude Code')).queryByText('No model selected')).toBeNull();
});
// A legacy disabled runtime leaves the backend enabled with nothing to run on;
// its status names the cause and its page leads to Models for recovery.
it('reports an unavailable gateway on the row and leads to recovery on the backend page', async () => {
vi.spyOn(modelsApi, 'listAgents').mockResolvedValue(withoutModel);
mocks.api.getConfig.mockResolvedValue(modelHubConfig(false));
renderBackends();
const vibey = await rowOf('Vibey');
expect(await within(vibey).findByText('Gateway unavailable')).toBeTruthy();
expect(within(vibey).queryByText('No model selected')).toBeNull();
expect(within(await rowOf('Claude Code')).queryByText('Gateway unavailable')).toBeNull();
fireEvent.click(within(vibey).getByRole('link', { name: 'Configure' }));
expect(await screen.findByText('The model gateway is off, so Vibey has no model to run on.')).toBeTruthy();
expect(screen.getByRole('link', { name: 'Open Models page' }).getAttribute('href')).toBe('/settings/models');
});
// No source may supply the always-on backend: its status names that, and its page leads to Models.
it('says no model source supplies it, on the row and on the backend page', async () => {
vi.spyOn(modelsApi, 'listAgents').mockResolvedValue(withoutModel);
mocks.api.getConfig.mockResolvedValue({
agents: {}, capabilities: { model_hub: { enabled: true } }, agent_supply_blocks: { vibey: 'no_source' },
});
renderBackends();
const vibey = await rowOf('Vibey');
expect(await within(vibey).findByText('No model source')).toBeTruthy();
expect(within(vibey).queryByText('No model selected')).toBeNull();
expect(within(await rowOf('Claude Code')).queryByText('No model source')).toBeNull();
fireEvent.click(within(vibey).getByRole('link', { name: 'Configure' }));
expect(await screen.findByText('Vibey gets its models from Model Hub. Add a source in Models.')).toBeTruthy();
expect(screen.getByRole('link', { name: 'Open Models page' }).getAttribute('href')).toBe('/settings/models');
});
// The deployment capability gate leaves the built-in backend nothing to run on,
// and there is no Models page to open.
it('says Model Hub is disabled when the instance turns it off', async () => {
vi.spyOn(modelsApi, 'listAgents').mockResolvedValue(withoutModel);
mocks.api.getConfig.mockResolvedValue({
agents: {}, capabilities: { model_hub: { enabled: false } }, agent_supply_blocks: { vibey: 'hub_disabled' },
});
renderBackends();
const vibey = await rowOf('Vibey');
expect(await within(vibey).findByText('Model Hub disabled')).toBeTruthy();
expect(within(await rowOf('Claude Code')).queryByText('Model Hub disabled')).toBeNull();
fireEvent.click(within(vibey).getByRole('link', { name: 'Configure' }));
expect(await screen.findByText('Model Hub is disabled on this instance, so Vibey has no model to run on.')).toBeTruthy();
expect(screen.queryByRole('link', { name: 'Open Models page' })).toBeNull();
});
});