The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.
Rust agent-orchestrationai-agentsai-assistantdesktopllmlocal-firstmcppersonal-aiprivacyrustsecond-braintauri
import { fireEvent, render, screen, waitFor } from '@testing-library/react';
import { beforeEach, describe, expect, it, vi } from 'vitest';
import type { FlowSuggestion } from '../../services/api/flowsApi';
import SuggestedWorkflows from './SuggestedWorkflows';
// Echo i18n keys so assertions can target them directly.
vi.mock('../../lib/i18n/I18nContext', () => ({ useT: () => ({ t: (key: string) => key }) }));
const navigateMock = vi.hoisted(() => vi.fn());
vi.mock('react-router-dom', () => ({ useNavigate: () => navigateMock }));
const api = vi.hoisted(() => ({
createFlow: vi.fn(),
discoverWorkflows: vi.fn(),
listSuggestions: vi.fn(),
dismissSuggestion: vi.fn(),
markSuggestionBuilt: vi.fn(),
}));
vi.mock('../../services/api/flowsApi', () => ({
createFlow: (...a: unknown[]) => api.createFlow(...a),
discoverWorkflows: (...a: unknown[]) => api.discoverWorkflows(...a),
listSuggestions: (...a: unknown[]) => api.listSuggestions(...a),
dismissSuggestion: (...a: unknown[]) => api.dismissSuggestion(...a),
markSuggestionBuilt: (...a: unknown[]) => api.markSuggestionBuilt(...a),
}));
function suggestion(overrides: Partial<FlowSuggestion> = {}): FlowSuggestion {
return {
id: 'sug_1',
title: 'Auto-file receipts',
one_liner: 'Add each Gmail receipt to your sheet.',
rationale: 'You forward receipts weekly.',
trigger_hint: 'app_event',
steps_outline: ['Watch Gmail'],
suggested_connections: ['composio:gmail:c1'],
suggested_slugs: [],
build_prompt: 'Build a workflow that files receipts.',
confidence: 0.8,
status: 'new',
created_at: '2026-07-05T00:00:00Z',
source_run_id: null,
...overrides,
};
}
describe('SuggestedWorkflows', () => {
beforeEach(() => {
navigateMock.mockReset();
api.createFlow = vi.fn().mockResolvedValue({ id: 'flow-1', name: 'Auto-file receipts' });
api.discoverWorkflows = vi.fn().mockResolvedValue([]);
api.listSuggestions = vi.fn().mockResolvedValue([]);
api.dismissSuggestion = vi.fn().mockResolvedValue(true);
api.markSuggestionBuilt = vi.fn().mockResolvedValue(true);
});
it('shows the empty state when there are no suggestions', async () => {
render(<SuggestedWorkflows />);
await waitFor(() => expect(api.listSuggestions).toHaveBeenCalledWith('new'));
expect(screen.getByTestId('flow-suggestions-empty')).toBeInTheDocument();
});
it('loads persisted suggestions on mount and renders a card', async () => {
api.listSuggestions = vi.fn().mockResolvedValue([suggestion()]);
render(<SuggestedWorkflows />);
await waitFor(() => expect(screen.getByTestId('flow-suggestion-card')).toBeInTheDocument());
expect(screen.getByText('Auto-file receipts')).toBeInTheDocument();
});
it('runs discovery on Discover click and renders the returned suggestions', async () => {
api.discoverWorkflows = vi.fn().mockResolvedValue([suggestion({ title: 'Fresh idea' })]);
render(<SuggestedWorkflows />);
await waitFor(() => expect(api.listSuggestions).toHaveBeenCalled());
fireEvent.click(screen.getByTestId('flow-suggestions-discover'));
await waitFor(() => expect(screen.getByText('Fresh idea')).toBeInTheDocument());
expect(api.discoverWorkflows).toHaveBeenCalledTimes(1);
});
it('dismisses a suggestion optimistically and calls the API', async () => {
api.listSuggestions = vi.fn().mockResolvedValue([suggestion()]);
render(<SuggestedWorkflows />);
await waitFor(() => expect(screen.getByTestId('flow-suggestion-card')).toBeInTheDocument());
fireEvent.click(screen.getByTestId('flow-suggestion-dismiss'));
await waitFor(() =>
expect(screen.queryByTestId('flow-suggestion-card')).not.toBeInTheDocument()
);
expect(api.dismissSuggestion).toHaveBeenCalledWith('sug_1');
});
it('creates a blank flow and navigates to its canvas with a prefill seed on Build this', async () => {
api.listSuggestions = vi.fn().mockResolvedValue([suggestion()]);
render(<SuggestedWorkflows />);
await waitFor(() => expect(screen.getByTestId('flow-suggestion-card')).toBeInTheDocument());
fireEvent.click(screen.getByTestId('flow-suggestion-build'));
await waitFor(() => expect(navigateMock).toHaveBeenCalledTimes(1));
expect(api.createFlow).toHaveBeenCalledTimes(1);
const [name, graph, requireApproval] = api.createFlow.mock.calls[0];
// Named from the suggestion's title, matching WorkflowPromptBar's naming.
expect(name).toBe('Auto-file receipts');
// The standard blank graph (single manual trigger) — same as instant-create.
expect(graph.nodes).toHaveLength(1);
expect(graph.nodes[0].kind).toBe('trigger');
// Suggestion-authored flows require approval by default, same as prompt-bar.
expect(requireApproval).toBe(true);
// Navigates with the suggestion's build_prompt as an UNSENT prefill seed,
// tagged `mode: 'build'` so the copilot's first Send runs a full build
// turn against the just-created blank flow (not a `revise`) — never a
// `send()`/inline builder turn here.
expect(navigateMock).toHaveBeenCalledWith('/flows/flow-1', {
state: { copilotPrefill: { text: 'Build a workflow that files receipts.', mode: 'build' } },
});
});
it('drops the suggestion from the local list once the flow is created, WITHOUT marking it built server-side', async () => {
api.listSuggestions = vi.fn().mockResolvedValue([suggestion()]);
render(<SuggestedWorkflows />);
await waitFor(() => expect(screen.getByTestId('flow-suggestion-card')).toBeInTheDocument());
fireEvent.click(screen.getByTestId('flow-suggestion-build'));
// Card dropped from THIS session's active list so it doesn't linger...
await waitFor(() =>
expect(screen.queryByTestId('flow-suggestion-card')).not.toBeInTheDocument()
);
// ...but `markSuggestionBuilt` must NOT be called at navigate time: this
// path only creates a blank flow + an unsent prompt, and the suggestion
// must only be marked built once the user actually SAVES a flow authored
// from it (which this component can't observe) — see the `onBuild` doc
// comment. Prematurely marking it built would permanently hide/dedupe an
// abandoned build from Flow Scout.
expect(api.markSuggestionBuilt).not.toHaveBeenCalled();
});
it('disables every suggestion card\'s "Build this" while any one build is in flight', async () => {
api.listSuggestions = vi
.fn()
.mockResolvedValue([
suggestion({ id: 'sug_1' }),
suggestion({ id: 'sug_2', title: 'Other' }),
]);
// Never resolves within the test, so `openingId` stays set and we can
// observe the disabled state on the OTHER card.
api.createFlow = vi.fn().mockReturnValue(new Promise(() => {}));
render(<SuggestedWorkflows />);
await waitFor(() => expect(screen.getAllByTestId('flow-suggestion-card')).toHaveLength(2));
const buildButtons = screen.getAllByTestId('flow-suggestion-build');
expect(buildButtons).toHaveLength(2);
fireEvent.click(buildButtons[0]);
// Both the active card AND the other (untouched) card must be disabled —
// clicking the other one must not silently no-op against `onBuild`'s
// `if (openingId) return` guard.
await waitFor(() => expect(buildButtons[0]).toBeDisabled());
expect(buildButtons[1]).toBeDisabled();
});
describe('trigger filters', () => {
async function renderWithMixedTriggers() {
api.listSuggestions = vi
.fn()
.mockResolvedValue([
suggestion({ id: 'sug_schedule', title: 'Scheduled one', trigger_hint: 'schedule' }),
suggestion({ id: 'sug_event_1', title: 'Event one', trigger_hint: 'app_event' }),
suggestion({ id: 'sug_event_2', title: 'Event two', trigger_hint: 'app_event' }),
suggestion({ id: 'sug_manual', title: 'Manual one', trigger_hint: 'manual' }),
]);
render(<SuggestedWorkflows />);
await waitFor(() => expect(screen.getAllByTestId('flow-suggestion-card')).toHaveLength(4));
}
it('shows a chip per trigger present, with counts, and only "all" when there is one card', async () => {
api.listSuggestions = vi.fn().mockResolvedValue([suggestion()]);
render(<SuggestedWorkflows />);
await waitFor(() => expect(screen.getByTestId('flow-suggestion-card')).toBeInTheDocument());
expect(screen.getByTestId('flow-suggestions-filter-all')).toBeInTheDocument();
// Only `app_event` is present among this single suggestion's triggers.
expect(screen.getByTestId('flow-suggestions-filter-app_event')).toBeInTheDocument();
expect(screen.queryByTestId('flow-suggestions-filter-schedule')).not.toBeInTheDocument();
expect(screen.queryByTestId('flow-suggestions-filter-manual')).not.toBeInTheDocument();
});
it('filters the visible cards when a trigger chip is clicked', async () => {
await renderWithMixedTriggers();
fireEvent.click(screen.getByTestId('flow-suggestions-filter-app_event'));
expect(screen.getByText('Event one')).toBeInTheDocument();
expect(screen.getByText('Event two')).toBeInTheDocument();
expect(screen.queryByText('Scheduled one')).not.toBeInTheDocument();
expect(screen.queryByText('Manual one')).not.toBeInTheDocument();
expect(screen.getByTestId('flow-suggestions-filter-app_event')).toHaveAttribute(
'aria-pressed',
'true'
);
});
it('clicking the "all" chip restores every card after a filter was applied', async () => {
await renderWithMixedTriggers();
fireEvent.click(screen.getByTestId('flow-suggestions-filter-manual'));
expect(screen.getAllByTestId('flow-suggestion-card')).toHaveLength(1);
fireEvent.click(screen.getByTestId('flow-suggestions-filter-all'));
expect(screen.getAllByTestId('flow-suggestion-card')).toHaveLength(4);
});
it('falls back to "all" once the active filter\'s last matching card is dismissed', async () => {
await renderWithMixedTriggers();
fireEvent.click(screen.getByTestId('flow-suggestions-filter-schedule'));
expect(screen.getAllByTestId('flow-suggestion-card')).toHaveLength(1);
fireEvent.click(screen.getByTestId('flow-suggestion-dismiss'));
// The `schedule` chip disappears (0 left) and the view falls back to "all".
await waitFor(() =>
expect(screen.queryByTestId('flow-suggestions-filter-schedule')).not.toBeInTheDocument()
);
expect(screen.getAllByTestId('flow-suggestion-card')).toHaveLength(3);
});
});
it('surfaces an error and re-enables Build this when createFlow fails', async () => {
api.listSuggestions = vi.fn().mockResolvedValue([suggestion()]);
api.createFlow = vi.fn().mockRejectedValue(new Error('boom'));
render(<SuggestedWorkflows />);
await waitFor(() => expect(screen.getByTestId('flow-suggestion-card')).toBeInTheDocument());
fireEvent.click(screen.getByTestId('flow-suggestion-build'));
const error = await screen.findByTestId('flow-suggestions-error');
expect(error).toHaveTextContent('flows.suggest.error');
expect(navigateMock).not.toHaveBeenCalled();
// The suggestion stays put — nothing was built, so it's not marked/removed.
expect(screen.getByTestId('flow-suggestion-card')).toBeInTheDocument();
expect(screen.getByTestId('flow-suggestion-build')).not.toBeDisabled();
});
});