Files
makelore/shared/image-workspace.ts
brother7 518d7ab4cd feat: 对接设计 Agent Gateway WebSocket
需求:服务端统一 Agent Gateway 将设计任务状态流切换为 WebSocket,客户端需要实时展示生成任务并支持断线恢复。

实现:Electron Main 管理 Session、一次性 Ticket、WebSocket 心跳与游标续传,按关闭码回收会话;Renderer 继续通过本机 Host API 的 SSE 投影接收任务事件,并保留 REST 降级同步。

验证:typecheck、变更文件 ESLint、37 个聚焦测试及 build:vite 通过。
2026-08-02 20:15:37 +08:00

141 lines
3.5 KiB
TypeScript

export const IMAGE_WORKSPACE_UNAVAILABLE_CODE = 'IMAGE_WORKSPACE_UNAVAILABLE';
export const IMAGE_WORKSPACE_UNAVAILABLE_MESSAGE = 'AI 设计暂不可用';
export const IMAGE_WORKSPACE_API_PATH = '/api/works/image-workspace';
export type DesignMedium = 'image' | 'video';
export type DesignWorkspacePhase = 'shaping' | 'awaiting_confirmation' | 'blocked';
export type DesignTaskStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled';
export type DesignQuoteStatus = 'active' | 'consumed' | 'expired' | 'superseded';
export type DesignCapabilities = {
conversation: boolean;
generation: boolean;
image: boolean;
video: boolean;
};
export type DesignBrief = {
version: number;
status: 'draft' | 'ready' | 'confirmed';
medium: DesignMedium | null;
summary: string;
ready: boolean;
missingDecision: string | null;
};
export type DesignGenerationQuote = {
quoteId: string;
status: DesignQuoteStatus;
medium: DesignMedium;
briefVersion: number;
briefSummary: string;
quotedDesignPoints: number;
expiresAt: string;
};
export type DesignMessage = {
id: string;
role: 'user' | 'assistant';
kind: 'user' | 'reply' | 'choice' | 'confirmation' | 'safety_redirect' | 'failure';
text: string;
quickReplies: string[];
generationQuote: DesignGenerationQuote | null;
turnRevision: number;
createdAt: string;
};
export type DesignWorkspaceSummary = {
workspaceId: string;
title: string;
turnRevision: number;
viewRevision: number;
phase: DesignWorkspacePhase;
brief: DesignBrief;
updatedAt: string;
};
export type DesignWorkspace = DesignWorkspaceSummary & {
messages: DesignMessage[];
};
export type DesignAsset = {
assetId: string;
workspaceId: string;
mediaType: DesignMedium;
mimeType: string;
width: number;
height: number;
durationMilliseconds: number | null;
createdAt: string;
contentPath: string;
};
export type DesignGenerationTask = {
taskId: string;
workspaceId: string;
medium: DesignMedium;
status: DesignTaskStatus;
briefVersion: number;
briefSummary: string;
quoteId: string | null;
quotedDesignPoints: number | null;
failureCode: string | null;
resultAssets: DesignAsset[];
createdAt: string;
updatedAt: string;
};
export type DesignGenerationTaskUpdatedEvent = {
id: string;
type: 'design.generation_task.updated';
workspaceId: string;
workspaceViewRevision: number;
generationTask: DesignGenerationTask;
};
export type DesignGenerationTasksSnapshotEvent = {
id: string;
type: 'design.generation_tasks.snapshot';
workspaceId: string;
workspaceViewRevision: number;
generationTasks: DesignGenerationTask[];
};
export type DesignWorkspaceEvent =
| DesignGenerationTaskUpdatedEvent
| DesignGenerationTasksSnapshotEvent;
export type DesignWorkspaceBootstrap = {
capabilities: DesignCapabilities;
workspaces: DesignWorkspaceSummary[];
};
export type DesignCreateWorkspaceInput = {
clientWorkspaceId: string;
title: string;
};
export type DesignRenameWorkspaceInput = {
workspaceId: string;
title: string;
};
export type DesignSubmitMessageInput = {
workspaceId: string;
clientTurnId: string;
expectedTurnRevision: number;
message: string;
attachmentAssetIds?: string[];
};
export type DesignConfirmGenerationInput = {
workspaceId: string;
clientTurnId: string;
expectedTurnRevision: number;
quoteId: string;
};
export function designAssetContentPath(workspaceId: string, assetId: string): string {
return `${IMAGE_WORKSPACE_API_PATH}/workspaces/${encodeURIComponent(workspaceId)}/assets/${encodeURIComponent(assetId)}/content`;
}