Files
makelore/tests/unit/image-workspace-store.test.ts
brother7 90a249db31 feat: 流式展示设计 Agent 对话
需求:设计 Agent 对话与确认生成的回复需要实时展示。

实现:统一通过 Agent Gateway 提交 Turn,接收并去重 assistant delta,以 canonical Workspace 收口,并修复跨项目旧请求回写竞态。
2026-08-02 21:21:50 +08:00

360 lines
14 KiB
TypeScript

import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import { useImageWorkspaceStore } from '@/stores/image-workspace';
import type {
DesignAssistantDeltaEvent,
DesignGenerationTask,
DesignGenerationTasksSnapshotEvent,
DesignGenerationTaskUpdatedEvent,
DesignWorkspace,
DesignWorkspaceBootstrap,
} from '../../shared/image-workspace';
const fetchImageWorkspaceMock = vi.hoisted(() => vi.fn());
const fetchImageWorkspaceProjectMock = vi.hoisted(() => vi.fn());
const fetchImageWorkspaceTasksMock = vi.hoisted(() => vi.fn());
const openImageWorkspaceTaskEventsMock = vi.hoisted(() => vi.fn());
const sendImageWorkspaceMessageMock = vi.hoisted(() => vi.fn());
vi.mock('@/lib/image-workspace', async (importOriginal) => {
const actual = await importOriginal<typeof import('@/lib/image-workspace')>();
return {
...actual,
fetchImageWorkspace: (...args: unknown[]) => fetchImageWorkspaceMock(...args),
fetchImageWorkspaceProject: (...args: unknown[]) => fetchImageWorkspaceProjectMock(...args),
fetchImageWorkspaceTasks: (...args: unknown[]) => fetchImageWorkspaceTasksMock(...args),
openImageWorkspaceTaskEvents: (...args: unknown[]) => openImageWorkspaceTaskEventsMock(...args),
sendImageWorkspaceMessage: (...args: unknown[]) => sendImageWorkspaceMessageMock(...args),
};
});
type EventListener = (event: MessageEvent<string>) => void;
class MockEventSource {
onopen: ((event: Event) => void) | null = null;
onerror: ((event: Event) => void) | null = null;
readonly close = vi.fn();
private readonly listeners = new Map<string, Set<EventListener>>();
addEventListener(type: string, listener: EventListener): void {
const listeners = this.listeners.get(type) ?? new Set<EventListener>();
listeners.add(listener);
this.listeners.set(type, listeners);
}
emit(type: string, payload: unknown): void {
const event = { data: JSON.stringify(payload) } as MessageEvent<string>;
for (const listener of this.listeners.get(type) ?? []) listener(event);
}
}
function deferred<T>(): { promise: Promise<T>; resolve(value: T): void } {
let resolve!: (value: T) => void;
const promise = new Promise<T>((accept) => {
resolve = accept;
});
return { promise, resolve };
}
const task: DesignGenerationTask = {
taskId: 'task-one',
workspaceId: 'workspace-one',
medium: 'image',
status: 'queued',
briefVersion: 1,
briefSummary: '海洋公益海报',
quoteId: 'quote-one',
quotedDesignPoints: 1,
failureCode: null,
resultAssets: [],
createdAt: '2026-08-02T10:00:00Z',
updatedAt: '2026-08-02T10:00:00Z',
};
function workspace(workspaceId = 'workspace-one', viewRevision = 1): DesignWorkspace {
return {
workspaceId,
title: workspaceId,
turnRevision: 1,
viewRevision,
phase: 'shaping',
brief: {
version: 1,
status: 'ready',
medium: 'image',
summary: '海洋公益海报',
ready: true,
missingDecision: null,
},
updatedAt: '2026-08-02T10:00:00Z',
messages: [],
};
}
function bootstrap(workspaceIds = ['workspace-one']): DesignWorkspaceBootstrap {
return {
capabilities: { conversation: true, generation: true, image: true, video: true },
workspaces: workspaceIds.map((workspaceId) => {
const { messages: _messages, ...summary } = workspace(workspaceId);
return summary;
}),
};
}
function taskEvent(
workspaceViewRevision: number,
status: DesignGenerationTask['status'],
): DesignGenerationTaskUpdatedEvent {
return {
id: `session-one:${workspaceViewRevision}`,
type: 'design.generation_task.updated',
workspaceId: 'workspace-one',
workspaceViewRevision,
generationTask: {
...task,
status,
updatedAt: `2026-08-02T10:0${workspaceViewRevision}:00Z`,
},
};
}
function taskSnapshotEvent(
workspaceViewRevision: number,
status: DesignGenerationTask['status'],
): DesignGenerationTasksSnapshotEvent {
return {
id: `session-one:${workspaceViewRevision}`,
type: 'design.generation_tasks.snapshot',
workspaceId: 'workspace-one',
workspaceViewRevision,
workspace: workspace('workspace-one', workspaceViewRevision),
generationTasks: [{
...task,
status,
updatedAt: `2026-08-02T10:0${workspaceViewRevision}:00Z`,
}],
};
}
describe('AI design task event store', () => {
beforeEach(() => {
vi.useRealTimers();
vi.clearAllMocks();
useImageWorkspaceStore.getState().reset();
fetchImageWorkspaceMock.mockResolvedValue(bootstrap());
fetchImageWorkspaceProjectMock.mockResolvedValue(workspace());
fetchImageWorkspaceTasksMock.mockResolvedValue([task]);
sendImageWorkspaceMessageMock.mockResolvedValue(workspace());
});
afterEach(() => {
useImageWorkspaceStore.getState().reset();
vi.useRealTimers();
});
it('keeps a revision-5 snapshot over revision 3, then upserts a newer task by task id', async () => {
const source = new MockEventSource();
openImageWorkspaceTaskEventsMock.mockResolvedValue(source as unknown as EventSource);
fetchImageWorkspaceProjectMock.mockResolvedValue(workspace('workspace-one', 5));
await useImageWorkspaceStore.getState().load();
await vi.waitFor(() => expect(openImageWorkspaceTaskEventsMock)
.toHaveBeenCalledWith('workspace-one'));
source.onopen?.(new Event('open'));
source.emit('design.generation_task.updated', taskEvent(3, 'failed'));
expect(useImageWorkspaceStore.getState().tasks[0].status).toBe('queued');
source.emit('design.generation_tasks.snapshot', taskSnapshotEvent(6, 'running'));
source.emit('design.generation_task.updated', taskEvent(5, 'failed'));
expect(useImageWorkspaceStore.getState()).toMatchObject({
taskStreamState: 'connected',
workspace: { viewRevision: 6 },
tasks: [{ taskId: 'task-one', status: 'running' }],
});
});
it('assembles assistant deltas once and replaces them with the canonical snapshot', async () => {
const source = new MockEventSource();
const response = deferred<DesignWorkspace>();
openImageWorkspaceTaskEventsMock.mockResolvedValue(source as unknown as EventSource);
sendImageWorkspaceMessageMock.mockReturnValueOnce(response.promise);
await useImageWorkspaceStore.getState().load();
await vi.waitFor(() => expect(openImageWorkspaceTaskEventsMock).toHaveBeenCalledOnce());
const sending = useImageWorkspaceStore.getState().sendMessage('把主视觉改成鲸鱼');
const pending = useImageWorkspaceStore.getState().pendingTurn;
expect(pending).toMatchObject({
userText: '把主视觉改成鲸鱼',
assistantText: '',
turnRevision: 2,
});
const firstDelta = {
id: 'session-one:2',
type: 'design.assistant.delta',
workspaceId: 'workspace-one',
clientTurnId: pending!.clientTurnId,
turnRevision: 2,
chunkIndex: 0,
delta: '可以,先强化',
} satisfies DesignAssistantDeltaEvent;
source.emit('design.assistant.delta', firstDelta);
source.emit('design.assistant.delta', firstDelta);
source.emit('design.assistant.delta', {
...firstDelta,
id: 'session-one:3',
chunkIndex: 1,
delta: '鲸鱼的轮廓。',
} satisfies DesignAssistantDeltaEvent);
expect(useImageWorkspaceStore.getState().pendingTurn?.assistantText)
.toBe('可以,先强化鲸鱼的轮廓。');
const canonical = {
...workspace('workspace-one', 2),
turnRevision: 2,
messages: [{
id: 'workspace-one:2:assistant:0',
role: 'assistant' as const,
kind: 'reply' as const,
text: '可以,先强化鲸鱼的轮廓。',
quickReplies: [],
generationQuote: null,
turnRevision: 2,
createdAt: '2026-08-02T10:01:00Z',
}],
};
source.emit('design.generation_tasks.snapshot', {
...taskSnapshotEvent(2, 'queued'),
id: 'session-one:4',
workspace: canonical,
} satisfies DesignGenerationTasksSnapshotEvent);
expect(useImageWorkspaceStore.getState().pendingTurn).toBeNull();
expect(useImageWorkspaceStore.getState().workspace?.messages[0].text)
.toBe('可以,先强化鲸鱼的轮廓。');
response.resolve(canonical);
await sending;
});
it('closes the previous stream when switching workspaces and on reset', async () => {
const first = new MockEventSource();
const second = new MockEventSource();
openImageWorkspaceTaskEventsMock
.mockResolvedValueOnce(first as unknown as EventSource)
.mockResolvedValueOnce(second as unknown as EventSource);
fetchImageWorkspaceMock.mockResolvedValue(bootstrap(['workspace-one', 'workspace-two']));
fetchImageWorkspaceProjectMock.mockImplementation((workspaceId: string) => (
Promise.resolve(workspace(workspaceId))
));
await useImageWorkspaceStore.getState().load();
await vi.waitFor(() => expect(openImageWorkspaceTaskEventsMock).toHaveBeenCalledTimes(1));
await useImageWorkspaceStore.getState().selectProject('workspace-two');
await vi.waitFor(() => expect(openImageWorkspaceTaskEventsMock).toHaveBeenCalledTimes(2));
expect(first.close).toHaveBeenCalledOnce();
useImageWorkspaceStore.getState().reset();
expect(second.close).toHaveBeenCalledOnce();
expect(useImageWorkspaceStore.getState().taskStreamState).toBe('idle');
});
it('does not switch back when an Agent turn finishes after selecting another Workspace', async () => {
const first = new MockEventSource();
const second = new MockEventSource();
const response = deferred<DesignWorkspace>();
openImageWorkspaceTaskEventsMock
.mockResolvedValueOnce(first as unknown as EventSource)
.mockResolvedValueOnce(second as unknown as EventSource);
fetchImageWorkspaceMock.mockResolvedValue(bootstrap(['workspace-one', 'workspace-two']));
fetchImageWorkspaceProjectMock.mockImplementation((workspaceId: string) => (
Promise.resolve(workspace(workspaceId))
));
sendImageWorkspaceMessageMock.mockReturnValueOnce(response.promise);
await useImageWorkspaceStore.getState().load();
const sending = useImageWorkspaceStore.getState().sendMessage('继续优化海报');
await useImageWorkspaceStore.getState().selectProject('workspace-two');
response.resolve({
...workspace('workspace-one', 2),
turnRevision: 2,
});
await sending;
expect(useImageWorkspaceStore.getState()).toMatchObject({
activeWorkspaceId: 'workspace-two',
workspace: { workspaceId: 'workspace-two' },
pendingTurn: null,
});
});
it('does not let a slow previous Workspace selection overwrite the latest one', async () => {
const rootSource = new MockEventSource();
const latestSource = new MockEventSource();
const slowWorkspace = deferred<DesignWorkspace>();
openImageWorkspaceTaskEventsMock
.mockResolvedValueOnce(rootSource as unknown as EventSource)
.mockResolvedValueOnce(latestSource as unknown as EventSource);
fetchImageWorkspaceMock.mockResolvedValue(bootstrap([
'workspace-root',
'workspace-one',
'workspace-two',
]));
fetchImageWorkspaceProjectMock.mockImplementation((workspaceId: string) => (
workspaceId === 'workspace-one'
? slowWorkspace.promise
: Promise.resolve(workspace(workspaceId))
));
fetchImageWorkspaceTasksMock.mockResolvedValue([]);
await useImageWorkspaceStore.getState().load();
await vi.waitFor(() => expect(openImageWorkspaceTaskEventsMock)
.toHaveBeenCalledWith('workspace-root'));
const staleSelection = useImageWorkspaceStore.getState().selectProject('workspace-one');
await vi.waitFor(() => expect(fetchImageWorkspaceProjectMock)
.toHaveBeenCalledWith('workspace-one'));
await useImageWorkspaceStore.getState().selectProject('workspace-two');
slowWorkspace.resolve(workspace('workspace-one'));
await staleSelection;
expect(useImageWorkspaceStore.getState().activeWorkspaceId).toBe('workspace-two');
expect(useImageWorkspaceStore.getState().workspace?.workspaceId).toBe('workspace-two');
expect(openImageWorkspaceTaskEventsMock).not.toHaveBeenCalledWith('workspace-one');
});
it('advances each task watermark after a degraded REST snapshot', async () => {
const source = new MockEventSource();
openImageWorkspaceTaskEventsMock.mockResolvedValue(source as unknown as EventSource);
await useImageWorkspaceStore.getState().load();
await vi.waitFor(() => expect(openImageWorkspaceTaskEventsMock).toHaveBeenCalledOnce());
fetchImageWorkspaceProjectMock.mockResolvedValue(workspace('workspace-one', 8));
fetchImageWorkspaceTasksMock.mockResolvedValue([{
...task,
status: 'succeeded',
}]);
await useImageWorkspaceStore.getState().refreshWorkspace();
await useImageWorkspaceStore.getState().refreshTasks();
source.emit('design.generation_task.updated', taskEvent(7, 'failed'));
expect(useImageWorkspaceStore.getState().tasks[0].status).toBe('succeeded');
});
it('polls slowly only while the event stream is degraded', async () => {
vi.useFakeTimers();
const source = new MockEventSource();
openImageWorkspaceTaskEventsMock.mockResolvedValue(source as unknown as EventSource);
await useImageWorkspaceStore.getState().load();
await vi.waitFor(() => expect(source.onerror).not.toBeNull());
source.onerror?.(new Event('error'));
await vi.advanceTimersByTimeAsync(14_999);
expect(fetchImageWorkspaceTasksMock).toHaveBeenCalledTimes(1);
await vi.advanceTimersByTimeAsync(1);
expect(fetchImageWorkspaceTasksMock).toHaveBeenCalledTimes(2);
source.onopen?.(new Event('open'));
await vi.advanceTimersByTimeAsync(15_000);
expect(fetchImageWorkspaceTasksMock).toHaveBeenCalledTimes(2);
});
});