Self-improving AI Employees for everyone
Python ai-agentsai-employeeai-employeesassistantautonomous-agentsco-employeescompanygrok-botinstinctloop-agentsmuseown-your-datapersonalself-hosted
import { fireEvent, screen, within } from '@testing-library/react';
import { beforeEach, describe, expect, it, vi } from 'vitest';
import { renderWithProviders as render } from '../../../../test/providers';
import type { CanvasItem } from '../../../../lib/canvasBoard';
const { wsMock } = vi.hoisted(() => ({
wsMock: { sendRequest: vi.fn(), isReady: true },
}));
vi.mock('../../../../contexts/WebSocketContext', () => ({
useWebSocket: () => wsMock,
useWebSocketActions: () => wsMock,
}));
// Isolate iframe/sandbox assertions from real fetches.
const { textHookMock } = vi.hoisted(() => ({ textHookMock: vi.fn() }));
vi.mock('../../../../hooks/useWorkspaceText', () => ({
TEXT_FETCH_CAP_BYTES: 512 * 1024,
fetchWorkspaceText: vi.fn(),
useWorkspaceTextQuery: (ref: unknown) => textHookMock(ref),
}));
import CanvasContent from '../CanvasContent';
const note = (id: string, content: string): CanvasItem => ({
id,
kind: 'note',
title: null,
ref: null,
url: null,
content,
language: null,
source: 'agent',
created_at: null,
});
const urlItem = (id: string, url: string): CanvasItem => ({
...note(id, ''),
kind: 'url',
content: null,
url,
});
const htmlItem = (id: string): CanvasItem => ({
id,
kind: 'file',
title: null,
ref: {
kind: 'file',
path: 'reports/page.html',
filename: 'page.html',
mime_type: 'text/html',
workflow_id: 'wf-1',
url: '/api/workspace/wf-1/files/reports/page.html',
},
url: null,
content: null,
language: null,
source: 'agent',
created_at: null,
});
describe('CanvasContent carousel', () => {
beforeEach(() => {
vi.clearAllMocks();
textHookMock.mockReturnValue({
data: { text: '<h1>report</h1>', truncated: false },
isLoading: false,
isError: false,
});
});
it('shows the newest item by default and follows new pushes', () => {
const items = [note('a', 'first'), note('b', 'second')];
const { rerender } = render(<CanvasContent items={items} workflowId="wf-1" />);
expect(screen.getByText('second')).toBeInTheDocument();
// Unpinned = stick to newest: a pushed item surfaces automatically.
rerender(<CanvasContent items={[...items, note('c', 'third')]} workflowId="wf-1" />);
expect(screen.getByText('third')).toBeInTheDocument();
});
it('pins on prev, stays pinned across pushes, resumes follow at the end', () => {
const items = [note('a', 'first'), note('b', 'second')];
const { rerender } = render(<CanvasContent items={items} workflowId="wf-1" />);
fireEvent.click(screen.getByRole('button', { name: 'Previous item' }));
expect(screen.getByText('first')).toBeInTheDocument();
// Pinned: a new push does NOT yank the view.
const grown = [...items, note('c', 'third')];
rerender(<CanvasContent items={grown} workflowId="wf-1" />);
expect(screen.getByText('first')).toBeInTheDocument();
expect(screen.getByText('1/3')).toBeInTheDocument();
// Navigating to the last item resumes follow-newest.
fireEvent.click(screen.getByRole('button', { name: 'Next item' }));
fireEvent.click(screen.getByRole('button', { name: 'Next item' }));
rerender(<CanvasContent items={[...grown, note('d', 'fourth')]} workflowId="wf-1" />);
expect(screen.getByText('fourth')).toBeInTheDocument();
});
it('navigates with arrow keys on the focused group only', () => {
render(
<CanvasContent items={[note('a', 'first'), note('b', 'second')]} workflowId="wf-1" />,
);
const group = screen.getByRole('group', { name: 'Canvas items' });
fireEvent.keyDown(group, { key: 'ArrowLeft' });
expect(screen.getByText('first')).toBeInTheDocument();
fireEvent.keyDown(group, { key: 'ArrowRight' });
expect(screen.getByText('second')).toBeInTheDocument();
});
it('reports the active item id on remove', () => {
const onRemove = vi.fn();
render(
<CanvasContent
items={[note('a', 'first'), note('b', 'second')]}
workflowId="wf-1"
onRemove={onRemove}
/>,
);
fireEvent.click(screen.getByRole('button', { name: 'Remove item' }));
expect(onRemove).toHaveBeenCalledWith('b');
});
it('renders the empty hint when the board is empty', () => {
render(<CanvasContent items={[]} workflowId="wf-1" emptyHint="Board is empty" />);
expect(screen.getByText('Board is empty')).toBeInTheDocument();
});
});
describe('CanvasContent sandbox regression (security invariants)', () => {
beforeEach(() => {
vi.clearAllMocks();
textHookMock.mockReturnValue({
data: { text: '<h1>report</h1>', truncated: false },
isLoading: false,
isError: false,
});
});
it('external URLs get exactly allow-scripts allow-forms and no referrer', () => {
const { container } = render(
<CanvasContent items={[urlItem('u', 'https://example.com')]} workflowId="wf-1" />,
);
const iframe = container.querySelector('iframe') as HTMLIFrameElement;
expect(iframe).toBeTruthy();
expect(iframe.getAttribute('sandbox')).toBe('allow-scripts allow-forms');
expect(iframe.getAttribute('referrerpolicy')).toBe('no-referrer');
// The escape hatch must always be visible — framing denial is undetectable.
expect(screen.getByRole('link', { name: /Open in new tab/ })).toBeInTheDocument();
});
it('workspace HTML renders via srcDoc WITHOUT allow-same-origin', () => {
const { container } = render(
<CanvasContent items={[htmlItem('h')]} workflowId="wf-1" />,
);
const iframe = container.querySelector('iframe') as HTMLIFrameElement;
expect(iframe).toBeTruthy();
expect(iframe.getAttribute('srcdoc')).toContain('<h1>report</h1>');
expect(iframe.getAttribute('sandbox')).toBe('allow-scripts');
expect(iframe.getAttribute('sandbox')).not.toContain('allow-same-origin');
// Never a src pointing at the app origin for HTML.
expect(iframe.getAttribute('src')).toBeNull();
});
});
describe('CanvasContent notes as documents', () => {
const doc = (id: string, content: string, extra: Partial<CanvasItem> = {}): CanvasItem => ({
...note(id, content),
...extra,
});
const versionReply = (content: string, version: number, latest: number) => ({
success: true,
item: { ...doc('a', content), version, latest },
});
beforeEach(() => {
vi.clearAllMocks();
wsMock.sendRequest.mockReset();
});
it('shows the preview, or the Markdown source', () => {
render(<CanvasContent items={[doc('a', '# Plan\n\nA **bold** step', { title: 'Plan' })]} workflowId="wf-1" />);
expect(screen.getByRole('heading', { name: 'Plan' })).toBeInTheDocument();
fireEvent.click(screen.getByRole('radio', { name: 'Markdown' }));
expect(screen.getByText(/A \*\*bold\*\* step/)).toBeInTheDocument();
});
it('previews a code note as a code block and downloads it as text', () => {
const createObjectURL = vi.fn(() => 'blob:code');
Object.assign(URL, { createObjectURL, revokeObjectURL: vi.fn() });
const click = vi.spyOn(HTMLAnchorElement.prototype, 'click').mockImplementation(function (this: HTMLAnchorElement) {
expect(this.download).toBe('script.txt');
});
const { container } = render(
<CanvasContent items={[doc('a', 'print("```")', { title: 'script', language: 'Python' })]} workflowId="wf-1" />,
);
expect(container.querySelector('pre code')?.textContent).toBe('print("```")\n');
fireEvent.click(screen.getByRole('button', { name: 'Download' }));
expect(click).toHaveBeenCalledTimes(1);
expect((createObjectURL.mock.calls[0] as unknown as [Blob])[0].type).toBe('text/plain;charset=utf-8');
click.mockRestore();
});
it('steps back to an earlier version read from its node', async () => {
wsMock.sendRequest.mockResolvedValue(versionReply('second draft', 2, 3));
render(<CanvasContent items={[doc('a', 'final', { version: 3 })]} workflowId="wf-1" nodeId="canvas-1" />);
expect(screen.getByText('v3/3')).toBeInTheDocument();
expect(screen.getByRole('button', { name: 'Next version' })).toBeDisabled();
fireEvent.click(screen.getByRole('button', { name: 'Previous version' }));
expect(await screen.findByText('second draft')).toBeInTheDocument();
expect(screen.getByText('v2/3')).toBeInTheDocument();
expect(wsMock.sendRequest).toHaveBeenCalledWith('canvas_version', {
workflow_id: 'wf-1',
node_id: 'canvas-1',
item_id: 'a',
version: 2,
});
});
it('shows only the latest without a node to read versions from', () => {
render(<CanvasContent items={[doc('a', 'final', { version: 3 })]} workflowId="wf-1" />);
expect(screen.queryByRole('button', { name: 'Previous version' })).not.toBeInTheDocument();
expect(screen.getByText('final')).toBeInTheDocument();
});
it('follows a newer version unless the owner stepped back', async () => {
wsMock.sendRequest.mockResolvedValue(versionReply('one', 1, 2));
const { rerender } = render(
<CanvasContent items={[doc('a', 'one', { version: 1 })]} workflowId="wf-1" nodeId="canvas-1" />,
);
rerender(<CanvasContent items={[doc('a', 'two', { version: 2 })]} workflowId="wf-1" nodeId="canvas-1" />);
expect(screen.getByText('two')).toBeInTheDocument();
fireEvent.click(screen.getByRole('button', { name: 'Previous version' }));
expect(await screen.findByText('one')).toBeInTheDocument();
rerender(<CanvasContent items={[doc('a', 'three', { version: 3 })]} workflowId="wf-1" nodeId="canvas-1" />);
expect(screen.getByText('v1/3')).toBeInTheDocument();
expect(screen.queryByText('three')).not.toBeInTheDocument();
});
it('says so when a version cannot be read', async () => {
wsMock.sendRequest.mockResolvedValue({ success: false, error: 'No such version' });
render(<CanvasContent items={[doc('a', 'final', { version: 2 })]} workflowId="wf-1" nodeId="canvas-1" />);
fireEvent.click(screen.getByRole('button', { name: 'Previous version' }));
expect(await screen.findByText('Couldn’t load version 1.')).toBeInTheDocument();
expect(screen.getByRole('button', { name: 'Copy' })).toBeDisabled();
});
it('opens on the item and version a reply asks for, and holds it while others arrive', async () => {
wsMock.sendRequest.mockResolvedValue(versionReply('draft of a', 1, 2));
const items = [doc('a', 'a, final', { version: 2 }), doc('b', 'b')];
const focus = { itemId: 'a', version: 1, nonce: 1 };
const { rerender } = render(
<CanvasContent items={items} workflowId="wf-1" nodeId="canvas-1" focus={focus} />,
);
expect(await screen.findByText('draft of a')).toBeInTheDocument();
expect(screen.getByText('v1/2')).toBeInTheDocument();
rerender(<CanvasContent items={[...items, doc('c', 'c')]} workflowId="wf-1" nodeId="canvas-1" focus={focus} />);
expect(screen.getByText('draft of a')).toBeInTheDocument();
expect(screen.getByText('1/3')).toBeInTheDocument();
// Moving on lets go of it: back on the item, the latest shows.
fireEvent.click(screen.getByRole('button', { name: 'Next item' }));
fireEvent.click(screen.getByRole('button', { name: 'Previous item' }));
expect(screen.getByText('a, final')).toBeInTheDocument();
});
it('waits for the item a reply asks for to reach the board', () => {
const focus = { itemId: 'b', version: null, nonce: 1 };
const { rerender } = render(
<CanvasContent items={[doc('a', 'a')]} workflowId="wf-1" nodeId="canvas-1" focus={focus} />,
);
rerender(<CanvasContent items={[doc('a', 'a'), doc('b', 'b'), doc('c', 'c')]} workflowId="wf-1" nodeId="canvas-1" focus={focus} />);
expect(screen.getByText('b')).toBeInTheDocument();
expect(screen.getByText('2/3')).toBeInTheDocument();
});
it('copies the text and downloads it as a .md file', async () => {
const writeText = vi.fn().mockResolvedValue(undefined);
Object.defineProperty(navigator, 'clipboard', { value: { writeText }, configurable: true });
const createObjectURL = vi.fn(() => 'blob:doc');
const revokeObjectURL = vi.fn();
Object.assign(URL, { createObjectURL, revokeObjectURL });
const click = vi.spyOn(HTMLAnchorElement.prototype, 'click').mockImplementation(function (this: HTMLAnchorElement) {
expect(this.download).toBe('Weekly-report-v2.md');
expect(this.href).toBe('blob:doc');
});
render(
<CanvasContent
items={[doc('a', '# Weekly report', { title: 'Weekly report!', version: 2 })]}
workflowId="wf-1"
nodeId="canvas-1"
/>,
);
fireEvent.click(screen.getByRole('button', { name: 'Copy' }));
expect(writeText).toHaveBeenCalledWith('# Weekly report');
expect(await screen.findByRole('button', { name: 'Copied' })).toBeInTheDocument();
fireEvent.click(screen.getByRole('button', { name: 'Download' }));
expect(click).toHaveBeenCalledTimes(1);
const blob = (createObjectURL.mock.calls[0] as unknown as [Blob])[0];
expect(blob.type).toBe('text/markdown;charset=utf-8');
click.mockRestore();
});
});
describe('CanvasContent library (Home)', () => {
const image = (id: string, filename: string): CanvasItem => ({
...htmlItem(id),
title: null,
ref: {
kind: 'image',
path: `shots/${filename}`,
filename,
mime_type: 'image/png',
workflow_id: 'wf-1',
url: `/api/workspace/wf-1/files/shots/${filename}`,
size_bytes: 2048,
},
});
const titled = (item: CanvasItem, title: string): CanvasItem => ({ ...item, title });
beforeEach(() => {
vi.clearAllMocks();
textHookMock.mockReturnValue({ data: { text: '', truncated: false }, isLoading: false, isError: false });
});
it('shows the six newest items on the strip and returns to the newest with Latest', () => {
const items = Array.from({ length: 8 }, (_, index) => titled(note(`n${index}`, `body ${index}`), `Note ${index}`));
render(<CanvasContent items={items} workflowId="wf-1" library />);
const chips = screen.getAllByRole('button', { name: /^Note \d$/ });
expect(chips.map((chip) => chip.textContent)).toEqual(['MDNote 7', 'MDNote 6', 'MDNote 5', 'MDNote 4', 'MDNote 3', 'MDNote 2']);
expect(chips[0]).toHaveAttribute('aria-current', 'true');
expect(screen.queryByRole('button', { name: 'Latest' })).not.toBeInTheDocument();
// No prev/next in the library footer.
expect(screen.queryByRole('button', { name: 'Previous item' })).not.toBeInTheDocument();
fireEvent.click(chips[2]);
expect(screen.getByText('body 5')).toBeInTheDocument();
fireEvent.click(screen.getByRole('button', { name: 'Latest' }));
expect(screen.getByText('body 7')).toBeInTheDocument();
});
it('lists artifacts and files in the Library and opens one', () => {
const items = [titled(note('n1', 'the plan'), 'Weekly plan'), image('i1', 'booking.png'), urlItem('u1', 'https://example.com/menu')];
render(<CanvasContent items={items} workflowId="wf-1" library />);
fireEvent.click(screen.getByRole('button', { name: 'Library, 3 items' }));
const library = screen.getByRole('region', { name: 'Library' });
expect(library).toHaveTextContent('Artifacts · 1');
expect(library).toHaveTextContent('Files · 2');
expect(within(library).getByRole('button', { name: /Weekly plan/ })).toHaveTextContent('Note · v1');
expect(within(library).getByRole('button', { name: /booking\.png/ })).toHaveTextContent('Image · 2.0 KB');
expect(within(library).getByRole('button', { name: /example\.com\/menu/ })).toHaveTextContent('Web page · example.com');
fireEvent.click(within(library).getByRole('button', { name: /Weekly plan/ }));
expect(screen.queryByRole('region', { name: 'Library' })).not.toBeInTheDocument();
expect(screen.getByText('the plan')).toBeInTheDocument();
expect(screen.getByRole('button', { name: 'Latest' })).toBeInTheDocument();
});
});