From 20b5ebeefd67d56ddf9d7faa0466f377a15f3007 Mon Sep 17 00:00:00 2001 From: Yiling-J Date: Fri, 2 Oct 2026 20:09:32 +0800 Subject: [PATCH] fix(asset): mark asset as failed and display failure state in webui when transcoding fails (#445) * fix(asset): mark asset as failed and display failure state in webui when transcoding fails * fix(transcode): do not mark asset as failed if media processing already succeeded * test(workflow): add e2e test for video transcode failure status transition * fix(webui): update failed file card badge to top-right Transcoding Failed label with error tooltip --- CHANGELOG.md | 2 + .../migration.sql | 2 + packages/db/prisma/schema.prisma | 1 + packages/db/src/generated/prisma/enums.ts | 1 + .../db/src/generated/prisma/internal/class.ts | 2 +- packages/db/src/prisma-json-types.ts | 1 + packages/dtos/src/asset.ts | 1 + packages/e2e/workflow/transcode-video.test.ts | 66 +++++++++ packages/transcode/src/workflows/common.ts | 23 +++- .../src/workflows/transcode-image.ts | 4 +- .../transcode/src/workflows/transcode-pdf.ts | 4 +- .../src/workflows/transcode-video.test.ts | 125 ++++++++++++++++++ .../src/workflows/transcode-video.ts | 4 +- .../file-browser/file-card.test.tsx | 59 +++++++++ .../components/file-browser/file-card.tsx | 57 ++++++-- .../file-browser/file-list-item.test.tsx | 13 ++ .../file-browser/file-list-item.tsx | 27 +++- .../viewers/default/default-viewer.test.tsx | 46 +++++++ .../viewers/default/default-viewer.tsx | 35 ++++- .../viewers/video/video-viewer.test.tsx | 16 +++ .../components/viewers/video/video-viewer.tsx | 30 ++++- packages/webui/messages/en.json | 6 + packages/webui/messages/zh.json | 6 + .../workflow-core/src/activities/task.test.ts | 66 +++++++++ packages/workflow-core/src/activities/task.ts | 25 ++++ 25 files changed, 597 insertions(+), 25 deletions(-) create mode 100644 packages/db/prisma/migrations/20261002104921_add_asset_status_failed/migration.sql create mode 100644 packages/webui/components/viewers/default/default-viewer.test.tsx diff --git a/CHANGELOG.md b/CHANGELOG.md index 442345ce..847730ab 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -14,6 +14,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). ### Fixed +- **asset**: Fix an issue where media files remained stuck in a perpetual "Preparing..." state when transcoding failed, by displaying a clear failed status and error details in the file list and file viewer + * **transcode**: Fix an issue where videos or audio-only files containing attached cover art or picture streams could cause transcoding to fail during poster generation or select a single static image instead of the video * **webui**: Fix inconsistent video resolution labels across download menus, mobile file headers, and the video player by correctly deriving resolutions from the video's short side, including portrait videos and 480p videos diff --git a/packages/db/prisma/migrations/20261002104921_add_asset_status_failed/migration.sql b/packages/db/prisma/migrations/20261002104921_add_asset_status_failed/migration.sql new file mode 100644 index 00000000..2e229942 --- /dev/null +++ b/packages/db/prisma/migrations/20261002104921_add_asset_status_failed/migration.sql @@ -0,0 +1,2 @@ +-- AlterEnum +ALTER TYPE "AssetStatus" ADD VALUE 'failed'; diff --git a/packages/db/prisma/schema.prisma b/packages/db/prisma/schema.prisma index 951b73f9..f10a3af8 100644 --- a/packages/db/prisma/schema.prisma +++ b/packages/db/prisma/schema.prisma @@ -40,6 +40,7 @@ enum AssetStatus { uploaded processing processed + failed trashed pending_purge } diff --git a/packages/db/src/generated/prisma/enums.ts b/packages/db/src/generated/prisma/enums.ts index 4c5b5b47..d3057bca 100644 --- a/packages/db/src/generated/prisma/enums.ts +++ b/packages/db/src/generated/prisma/enums.ts @@ -36,6 +36,7 @@ export const AssetStatus = { uploaded: 'uploaded', processing: 'processing', processed: 'processed', + failed: 'failed', trashed: 'trashed', pending_purge: 'pending_purge' } as const diff --git a/packages/db/src/generated/prisma/internal/class.ts b/packages/db/src/generated/prisma/internal/class.ts index 86d5d7ec..b775f4aa 100644 --- a/packages/db/src/generated/prisma/internal/class.ts +++ b/packages/db/src/generated/prisma/internal/class.ts @@ -22,7 +22,7 @@ const config: runtime.GetPrismaClientConfig = { "clientVersion": "7.10.0", "engineVersion": "0edf323efd1d98336f3f0a68684b56f689b900d3", "activeProvider": "postgresql", - "inlineSchema": "generator client {\n provider = \"prisma-client\"\n output = \"../src/generated/prisma\"\n binaryTargets = [\"native\", \"linux-musl-openssl-3.0.x\"]\n previewFeatures = [\"postgresqlExtensions\"]\n}\n\ngenerator json {\n provider = \"prisma-json-types-generator\"\n allowAny = false\n}\n\ndatasource db {\n provider = \"postgresql\"\n extensions = [vector]\n}\n\n// ----------------------------------------------------------------------\n// Enums\n// ----------------------------------------------------------------------\n\nenum UserType {\n human\n agent\n}\n\nenum AssetType {\n folder\n file\n share\n root\n attachment\n version_stack\n share_root\n symlink\n}\n\nenum AssetStatus {\n uploading\n uploaded\n processing\n processed\n trashed\n pending_purge\n}\n\nenum StorageKeyStatus {\n active\n purging\n}\n\nenum InviteRole {\n editor\n reviewer\n}\n\nenum MetadataFieldScope {\n SYSTEM\n TEAM\n PROJECT\n}\n\nenum NotificationType {\n comment_created\n reply_created\n mention\n successful_file_uploaded\n metadata_field_updated_status\n new_user_join_team\n new_user_join_project\n kanban_task_created\n kanban_task_assigned\n kanban_task_status_updated\n kanban_task_updated\n kanban_task_deleted\n kanban_task_comment_created\n}\n\nenum NotificationEmailStatus {\n pending\n processing\n processed\n failed\n}\n\nenum ProjectMemberRole {\n owner\n editor\n reviewer\n}\n\nenum TaskType {\n upload\n}\n\nenum TaskStatus {\n pending\n uploading\n completed\n failed\n}\n\nenum TeamMemberRole {\n owner\n editor\n reviewer\n}\n\nenum TeamMemberScope {\n team\n project\n}\n\nenum WorkflowTaskType {\n transcode\n transcode_video\n transcode_image\n transcode_pdf\n transcode_pdf_pages\n transcode_screenshot\n transcode_image_annotation\n transcode_watermark\n ai_metadata_autofill\n chat\n ai_embedding\n query_embedding_for_search\n agent_tool_call // @deprecated: Agent tools now execute directly in-process via Core services\n kanban_agent_run\n}\n\nenum WorkflowTaskStatus {\n pending\n processing\n completed\n failed\n}\n\nenum WatermarkStatus {\n disabled\n processing\n ready\n failed\n}\n\nenum WatermarkFileStatus {\n pending\n processing\n completed\n failed\n}\n\nenum QuotaScopeMode {\n all_members\n each_member\n selected_members\n}\n\nenum QuotaPeriod {\n one_hour @map(\"1hour\")\n five_hours @map(\"5hour\")\n one_day @map(\"1day\")\n seven_days @map(\"7day\")\n}\n\nenum QuotaResourceType {\n agent_total_tokens\n agent_cost\n agent_mcp_call_count\n agent_bash_call_count\n agent_tool_call_count\n}\n\nenum KanbanTaskStatus {\n TODO\n READY\n IN_PROGRESS\n BLOCKED\n IN_REVIEW\n DONE\n}\n\nenum KanbanTaskPriority {\n LOW\n MEDIUM\n HIGH\n URGENT\n}\n\nenum KanbanTaskEventType {\n CREATED\n STATUS_CHANGED\n ASSIGNED\n UNASSIGNED\n COMMENTED\n CHANGES_REQUESTED\n BLOCKED\n UNBLOCKED\n PRIORITY_CHANGED\n GOAL_CHANGED\n DEPENDENCY_ADDED\n DEPENDENCY_REMOVED\n}\n\n// ----------------------------------------------------------------------\n// Models\n// ----------------------------------------------------------------------\n\nmodel User {\n id String @id @default(ulid())\n type UserType @default(human)\n name String\n email String @unique\n emailVerified Boolean @default(false) @map(\"email_verified\")\n image String?\n password String?\n /// [AgentSettings]\n agentSettings Json? @map(\"agent_settings\")\n guestEmail String? @map(\"guest_email\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n assets Asset[] @relation(\"UserToAsset\")\n authTokens AuthToken[] @relation(\"UserToAuthToken\")\n tasks Task[] @relation(\"UserToTask\")\n teamMembers TeamMember[] @relation(\"UserToTeamMember\")\n comments AssetComment[] @relation(\"UserToAssetComment\")\n completionChangedComments AssetComment[] @relation(\"UserToAssetCommentCompletionChanged\")\n commentReactions AssetCommentReaction[] @relation(\"UserToAssetCommentReaction\")\n createdInvites Invite[] @relation(\"UserToInvite\")\n createdNotifications Notification[] @relation(\"UserToCreatedNotification\")\n notifications Notification[] @relation(\"UserToNotification\")\n sessions Session[]\n accounts Account[]\n agent Agent?\n agentSessions AgentSession[]\n userMetadata UserMetadata[] @relation(\"UserToUserMetadata\")\n collections Collection[] @relation(\"UserToCollection\")\n shareLinks ShareLink[] @relation(\"UserToShareLink\")\n apiTokens ApiToken[] @relation(\"UserToApiToken\")\n aiUsages AiUsage[] @relation(\"UserToAiUsage\")\n auditLogs AuditLog[] @relation(\"UserToAuditLog\")\n quotaRecords QuotaRecord[] @relation(\"UserToQuotaRecord\")\n kanbanTasksCreated KanbanTask[] @relation(\"KanbanTaskCreator\")\n kanbanTasksReported KanbanTask[] @relation(\"KanbanTaskReporter\")\n kanbanTasksAssigned KanbanTask[] @relation(\"KanbanTaskAssignee\")\n kanbanGoalsCreated KanbanGoal[] @relation(\"UserToKanbanGoal\")\n kanbanTaskComments KanbanTaskComment[]\n kanbanTaskEvents KanbanTaskEvent[]\n recentFiles RecentFileItem[]\n\n @@map(\"users\")\n}\n\nmodel Session {\n id String @id @default(ulid())\n expiresAt DateTime @map(\"expires_at\")\n token String @unique\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n ipAddress String? @map(\"ip_address\")\n userAgent String? @map(\"user_agent\")\n userId String @map(\"user_id\")\n user User @relation(fields: [userId], references: [id], onDelete: Cascade)\n\n @@map(\"sessions\")\n}\n\nmodel Account {\n id String @id @default(ulid())\n accountId String @map(\"account_id\")\n providerId String @map(\"provider_id\")\n userId String @map(\"user_id\")\n user User @relation(fields: [userId], references: [id], onDelete: Cascade)\n accessToken String? @map(\"access_token\")\n refreshToken String? @map(\"refresh_token\")\n idToken String? @map(\"id_token\")\n accessTokenExpiresAt DateTime? @map(\"access_token_expires_at\")\n refreshTokenExpiresAt DateTime? @map(\"refresh_token_expires_at\")\n scope String?\n password String?\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@map(\"accounts\")\n}\n\nmodel Verification {\n id String @id @default(ulid())\n identifier String\n value String\n expiresAt DateTime @map(\"expires_at\")\n createdAt DateTime? @default(now()) @map(\"created_at\")\n updatedAt DateTime? @updatedAt @map(\"updated_at\")\n\n @@map(\"verifications\")\n}\n\nmodel AuthToken {\n id String @id @default(ulid())\n accessToken String @unique @map(\"access_token\")\n refreshToken String @unique @map(\"refresh_token\")\n accessTokenExpiresAt DateTime @map(\"access_token_expires_at\")\n refreshTokenExpiresAt DateTime @map(\"refresh_token_expires_at\")\n\n userId String @map(\"user_id\")\n user User @relation(\"UserToAuthToken\", fields: [userId], references: [id])\n\n @@map(\"auth_tokens\")\n}\n\nmodel Team {\n id String @id @default(ulid())\n name String\n /// [Settings]\n settings Json? @default(\"{}\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n rootFolderId String? @unique @map(\"root_folder_id\")\n rootFolder Asset? @relation(\"TeamToRootFolder\", fields: [rootFolderId], references: [id])\n\n members TeamMember[] @relation(\"TeamToTeamMember\")\n projects Project[] @relation(\"TeamToProject\")\n metadataFields MetadataField[] @relation(\"TeamToMetadataField\")\n invites Invite[] @relation(\"TeamToInvite\")\n notifications Notification[] @relation(\"TeamToNotification\")\n userMetadata UserMetadata[] @relation(\"TeamToUserMetadata\")\n providers Provider[] @relation(\"TeamToProvider\")\n skills Skill[] @relation(\"TeamToSkill\")\n mcpServers McpServer[] @relation(\"TeamToMcpServer\")\n sandbox Sandbox? @relation(\"TeamToSandbox\")\n agents Agent[] @relation(\"TeamToAgent\")\n aiUsages AiUsage[] @relation(\"TeamToAiUsage\")\n auditLogs AuditLog[] @relation(\"TeamToAuditLog\")\n watermarkTemplates WatermarkTemplate[] @relation(\"TeamToWatermarkTemplate\")\n quotaRules QuotaRule[] @relation(\"TeamToQuotaRule\")\n quotaRecords QuotaRecord[] @relation(\"TeamToQuotaRecord\")\n kanbanGoals KanbanGoal[] @relation(\"TeamToKanbanGoal\")\n kanbanTasks KanbanTask[] @relation(\"TeamToKanbanTask\")\n\n @@map(\"teams\")\n}\n\nmodel Sandbox {\n id String @id @default(ulid())\n networkSandboxEnabled Boolean @default(false) @map(\"network_sandbox_enabled\")\n allowedDomains String[] @default([\"npmjs.org\", \"*.npmjs.org\", \"registry.npmjs.org\", \"registry.yarnpkg.com\", \"pypi.org\", \"*.pypi.org\", \"github.com\", \"*.github.com\", \"api.github.com\", \"raw.githubusercontent.com\"])\n pendingDomains String[] @default([]) @map(\"pending_domains\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n teamId String @unique @map(\"team_id\")\n team Team @relation(\"TeamToSandbox\", fields: [teamId], references: [id], onDelete: Cascade)\n\n @@map(\"sandboxes\")\n}\n\nmodel Skill {\n id String @id @default(ulid())\n name String\n description String?\n /// [SkillConfig]\n config Json? @default(\"{}\")\n assetId String @map(\"asset_id\")\n hash String @map(\"hash\")\n permission TeamMemberRole @default(reviewer)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToSkill\", fields: [teamId], references: [id], onDelete: Cascade)\n\n agentSkills AgentSkill[]\n\n @@unique([teamId, name])\n @@map(\"skills\")\n}\n\nmodel TeamMember {\n id String @id @default(ulid())\n role TeamMemberRole\n scope TeamMemberScope @default(team)\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToTeamMember\", fields: [teamId], references: [id])\n\n userId String @map(\"user_id\")\n user User @relation(\"UserToTeamMember\", fields: [userId], references: [id], onDelete: Cascade)\n\n projectMembers ProjectMember[] @relation(\"TeamMemberToProjectMember\")\n lastReadNotificationId String? @unique @map(\"last_read_notification_id\")\n lastReadNotification Notification? @relation(\"TeamMemberToLastReadNotification\", fields: [lastReadNotificationId], references: [id])\n\n @@unique([teamId, userId], name: \"teamIdUserId\")\n @@map(\"team_members\")\n}\n\nmodel Project {\n id String @id @default(ulid())\n name String\n coverImageKey String? @map(\"cover_image_key\")\n hasJpegCover Boolean @default(false) @map(\"has_jpeg_cover\")\n /// [MetadataOverrides]\n metadataOverrides Json? @map(\"metadata_overrides\")\n enableNotification Boolean @default(true) @map(\"enable_notification\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToProject\", fields: [teamId], references: [id])\n\n rootFolderId String? @unique @map(\"root_folder_id\")\n rootFolder Asset? @relation(\"ProjectToRootFolder\", fields: [rootFolderId], references: [id])\n\n shareRootId String? @unique @map(\"share_root_id\")\n shareRoot Asset? @relation(\"ProjectToShareRoot\", fields: [shareRootId], references: [id])\n\n members ProjectMember[] @relation(\"ProjectToProjectMember\")\n assets Asset[] @relation(\"ProjectToAsset\")\n metadataFields MetadataField[] @relation(\"ProjectToMetadataField\")\n invites Invite[] @relation(\"ProjectToInvite\")\n notifications Notification[] @relation(\"ProjectToNotification\")\n shareLinks ShareLink[] @relation(\"ProjectToShareLink\")\n collections Collection[] @relation(\"ProjectToCollection\")\n auditLogs AuditLog[] @relation(\"ProjectToAuditLog\")\n kanbanTasks KanbanTask[] @relation(\"ProjectToKanbanTask\")\n recentFiles RecentFileItem[]\n\n @@index([createdAt])\n @@index([updatedAt])\n @@map(\"projects\")\n}\n\nmodel ProjectMember {\n id String @id @default(ulid())\n role ProjectMemberRole\n\n projectId String @map(\"project_id\")\n project Project @relation(\"ProjectToProjectMember\", fields: [projectId], references: [id], onDelete: Cascade)\n\n teamMemberId String @map(\"team_member_id\")\n teamMember TeamMember @relation(\"TeamMemberToProjectMember\", fields: [teamMemberId], references: [id])\n\n @@unique([projectId, teamMemberId], name: \"projectIdTeamMemberId\")\n @@map(\"project_members\")\n}\n\nmodel ShareLink {\n id String @id @default(ulid())\n name String\n expireAt DateTime? @map(\"expire_at\")\n password String?\n isDisabled Boolean @default(false) @map(\"is_disabled\")\n allowDownload Boolean @default(true) @map(\"allow_download\")\n defaultSortOrder String? @map(\"default_sort_order\")\n viewMode String? @map(\"view_mode\")\n /// [ShareLinkFieldVisibility]\n fieldVisibility Json? @map(\"field_visibility\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n projectId String @map(\"project_id\")\n project Project @relation(\"ProjectToShareLink\", fields: [projectId], references: [id], onDelete: Cascade)\n\n rootFolderId String @unique @map(\"root_folder_id\")\n rootFolder Asset @relation(\"ShareLinkToRootFolder\", fields: [rootFolderId], references: [id])\n\n creatorId String? @map(\"creator_id\")\n creator User? @relation(\"UserToShareLink\", fields: [creatorId], references: [id])\n\n watermarkConfigId String? @map(\"watermark_config_id\")\n watermarkStatus WatermarkStatus @default(disabled) @map(\"watermark_status\")\n watermarkConfig WatermarkConfig? @relation(fields: [watermarkConfigId], references: [id], onDelete: SetNull)\n\n @@map(\"share_links\")\n}\n\nmodel WatermarkConfig {\n id String @id @default(ulid())\n /// [WatermarkConfigSpec]\n config Json\n hash String @unique\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n shareLinks ShareLink[]\n watermarkFiles WatermarkFile[]\n\n @@map(\"watermark_configs\")\n}\n\nmodel WatermarkTemplate {\n id String @id @default(ulid())\n name String\n /// [WatermarkConfigSpec]\n config Json\n teamId String? @map(\"team_id\")\n team Team? @relation(\"TeamToWatermarkTemplate\", fields: [teamId], references: [id], onDelete: Cascade)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@index([teamId])\n @@map(\"watermark_templates\")\n}\n\nmodel WatermarkFile {\n id String @id @default(ulid())\n assetId String @map(\"asset_id\")\n watermarkConfigId String @map(\"watermark_config_id\")\n /// [MediaInfo]\n media Json?\n status WatermarkFileStatus @default(pending)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n asset Asset @relation(\"AssetToWatermarkFile\", fields: [assetId], references: [id], onDelete: Cascade)\n watermarkConfig WatermarkConfig @relation(fields: [watermarkConfigId], references: [id], onDelete: Cascade)\n\n @@unique([assetId, watermarkConfigId])\n @@index([watermarkConfigId])\n @@map(\"watermark_files\")\n}\n\nmodel Asset {\n id String @id @default(ulid())\n name String @default(\"\")\n nameNgram String[] @default([]) @map(\"name_ngram\")\n type AssetType\n mediaType String? @map(\"media_type\")\n fileCount Int @default(0) @map(\"file_count\")\n sizeByte BigInt @default(0) @map(\"size_byte\")\n status AssetStatus\n transcodeTaskId String? @map(\"transcode_task_id\")\n uploadId String? @map(\"upload_id\")\n /// [MediaInfo]\n media Json?\n hasJpegPreview Boolean @default(false) @map(\"has_jpeg_preview\")\n isDeleted Boolean @default(false) @map(\"is_deleted\")\n deletedAt DateTime? @map(\"deleted_at\")\n sortIndex String? @map(\"sort_index\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n parentId String? @map(\"parent_id\")\n parent Asset? @relation(\"AssetChildren\", fields: [parentId], references: [id])\n children Asset[] @relation(\"AssetChildren\")\n\n targetId String? @map(\"target_id\")\n target Asset? @relation(\"SymlinkTarget\", fields: [targetId], references: [id])\n symlinks Asset[] @relation(\"SymlinkTarget\")\n\n storageKeyId String? @map(\"storage_key_id\")\n storageKey StorageKey? @relation(fields: [storageKeyId], references: [id])\n\n metadataValues AssetMetadataValue[] @relation(\"AssetToMetadataValues\")\n\n creatorId String? @map(\"creator_id\")\n creator User? @relation(\"UserToAsset\", fields: [creatorId], references: [id])\n\n agentId String? @map(\"agent_id\")\n agent Agent? @relation(\"AgentToAsset\", fields: [agentId], references: [id], onDelete: SetNull)\n\n taskId String? @map(\"task_id\")\n task Task? @relation(\"TaskToAsset\", fields: [taskId], references: [id])\n\n projectId String? @map(\"project_id\")\n project Project? @relation(\"ProjectToAsset\", fields: [projectId], references: [id])\n\n comments AssetComment[] @relation(\"AssetToComment\")\n commentAttachments AssetCommentAttachment[] @relation(\"AssetToCommentAttachment\")\n notifications Notification[] @relation(\"AssetToNotification\")\n embeddings AssetEmbedding[] @relation(\"AssetToEmbedding\")\n\n teamRootFolder Team? @relation(\"TeamToRootFolder\")\n projectRootFolder Project? @relation(\"ProjectToRootFolder\")\n projectShareRoot Project? @relation(\"ProjectToShareRoot\")\n shareLinkRootFolder ShareLink? @relation(\"ShareLinkToRootFolder\")\n agentSessions AgentSession[] @relation(\"AssetToAgentSession\")\n watermarkFiles WatermarkFile[] @relation(\"AssetToWatermarkFile\")\n agentMd AssetAgentMd? @relation(\"AssetToAgentMd\")\n kanbanTargetTasks KanbanTask[] @relation(\"KanbanTaskTargetFolder\")\n kanbanTasks KanbanTaskAsset[]\n recentFiles RecentFileItem[]\n\n @@unique([parentId, targetId], name: \"parentIdTargetId\")\n @@index([type])\n @@index([status])\n @@index([createdAt])\n @@index([updatedAt])\n @@index([sortIndex])\n @@index([isDeleted])\n @@index([deletedAt])\n @@index([agentId])\n @@index([name], name: \"assets_name_idx\")\n @@index([nameNgram], type: Gin)\n @@map(\"assets\")\n}\n\nmodel StorageKey {\n id String @id @default(ulid())\n key String @unique\n status StorageKeyStatus @default(active)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n assets Asset[]\n\n @@map(\"storage_keys\")\n}\n\nmodel AssetMetadataValue {\n id String @id @default(ulid())\n assetId String @map(\"asset_id\")\n fieldKey String @map(\"field_key\") // key from MetadataField\n\n stringValue String? @map(\"string_value\")\n numberValue Float? @map(\"number_value\")\n booleanValue Boolean? @map(\"boolean_value\")\n jsonValue Json? @map(\"json_value\")\n dateValue DateTime? @map(\"date_value\")\n\n asset Asset @relation(\"AssetToMetadataValues\", fields: [assetId], references: [id], onDelete: Cascade)\n\n @@unique([assetId, fieldKey])\n @@index([numberValue])\n @@index([stringValue])\n @@index([booleanValue])\n @@index([dateValue])\n @@index([jsonValue], type: Gin)\n @@map(\"asset_metadata_values\")\n}\n\nmodel AssetAgentMd {\n assetId String @id @map(\"asset_id\")\n content String @db.Text\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n asset Asset @relation(\"AssetToAgentMd\", fields: [assetId], references: [id], onDelete: Cascade)\n\n @@map(\"asset_agentmd\")\n}\n\nmodel AssetComment {\n id String @id @default(ulid())\n message String?\n /// [AnnotationList]\n annotation Json?\n second Float?\n sessionId String? @map(\"session_id\")\n session AgentSession? @relation(fields: [sessionId], references: [id], onDelete: SetNull)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n assetId String @map(\"asset_id\")\n asset Asset @relation(\"AssetToComment\", fields: [assetId], references: [id], onDelete: Cascade)\n\n creatorId String? @map(\"creator_id\")\n creator User? @relation(\"UserToAssetComment\", fields: [creatorId], references: [id])\n\n isCompleted Boolean @default(false) @map(\"is_completed\")\n completionLastChangedById String? @map(\"completion_last_changed_by_id\")\n completionLastChangedBy User? @relation(\"UserToAssetCommentCompletionChanged\", fields: [completionLastChangedById], references: [id])\n\n replyToId String? @map(\"reply_to_id\")\n replyTo AssetComment? @relation(\"CommentReplies\", fields: [replyToId], references: [id], onDelete: Cascade)\n replies AssetComment[] @relation(\"CommentReplies\")\n\n attachments AssetCommentAttachment[] @relation(\"CommentToAttachment\")\n reactions AssetCommentReaction[] @relation(\"CommentToReaction\")\n\n @@index([assetId])\n @@map(\"asset_comments\")\n}\n\nmodel AssetCommentAttachment {\n id String @id @default(ulid())\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n commentId String @map(\"comment_id\")\n comment AssetComment @relation(\"CommentToAttachment\", fields: [commentId], references: [id], onDelete: Cascade)\n\n assetId String @map(\"asset_id\")\n asset Asset @relation(\"AssetToCommentAttachment\", fields: [assetId], references: [id], onDelete: Cascade)\n\n @@map(\"asset_comment_attachments\")\n}\n\nmodel AssetCommentReaction {\n id String @id @default(ulid())\n createdAt DateTime @default(now()) @map(\"created_at\")\n\n commentId String @map(\"comment_id\")\n comment AssetComment @relation(\"CommentToReaction\", fields: [commentId], references: [id], onDelete: Cascade)\n\n userId String @map(\"user_id\")\n user User @relation(\"UserToAssetCommentReaction\", fields: [userId], references: [id], onDelete: Cascade)\n\n code String @db.VarChar(32)\n\n @@unique([commentId, userId, code])\n @@index([commentId])\n @@map(\"asset_comment_reactions\")\n}\n\nmodel AssetEmbedding {\n id String @id @default(ulid())\n embedding Unsupported(\"vector(1536)\")?\n startTime Float? @map(\"start_time\")\n endTime Float? @map(\"end_time\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n assetId String @map(\"asset_id\")\n asset Asset @relation(\"AssetToEmbedding\", fields: [assetId], references: [id], onDelete: Cascade)\n\n @@index([embedding], name: \"AssetEmbedding_embedding_idx\")\n @@map(\"asset_embeddings\")\n}\n\nmodel Invite {\n id String @id @default(ulid())\n code String @unique\n role InviteRole?\n used Boolean @default(false)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToInvite\", fields: [teamId], references: [id])\n\n projectId String? @map(\"project_id\")\n project Project? @relation(\"ProjectToInvite\", fields: [projectId], references: [id], onDelete: Cascade)\n\n inviterId String @map(\"inviter_id\")\n inviter User @relation(\"UserToInvite\", fields: [inviterId], references: [id])\n\n @@map(\"invites\")\n}\n\nmodel MetadataField {\n id String @id @default(ulid())\n key String @unique\n scope MetadataFieldScope?\n /// [FieldConfig]\n config Json?\n readOnly Boolean @default(false) @map(\"read_only\")\n description String @default(\"\")\n\n teamId String? @map(\"team_id\")\n team Team? @relation(\"TeamToMetadataField\", fields: [teamId], references: [id])\n\n projectId String? @map(\"project_id\")\n project Project? @relation(\"ProjectToMetadataField\", fields: [projectId], references: [id], onDelete: Cascade)\n\n @@map(\"metadata_fields\")\n}\n\nmodel Notification {\n id String @id @default(ulid())\n type NotificationType?\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToNotification\", fields: [teamId], references: [id])\n\n projectId String? @map(\"project_id\")\n project Project? @relation(\"ProjectToNotification\", fields: [projectId], references: [id], onDelete: Cascade)\n\n creatorId String? @map(\"creator_id\")\n creator User? @relation(\"UserToCreatedNotification\", fields: [creatorId], references: [id])\n\n assetId String? @map(\"asset_id\")\n asset Asset? @relation(\"AssetToNotification\", fields: [assetId], references: [id], onDelete: Cascade)\n\n taskId String? @map(\"task_id\")\n task Task? @relation(\"TaskToNotification\", fields: [taskId], references: [id])\n\n kanbanTaskId String? @map(\"kanban_task_id\")\n kanbanTask KanbanTask? @relation(\"KanbanTaskToNotification\", fields: [kanbanTaskId], references: [id], onDelete: Cascade)\n\n userId String? @map(\"user_id\")\n user User? @relation(\"UserToNotification\", fields: [userId], references: [id])\n\n emailStatus NotificationEmailStatus @default(pending) @map(\"email_status\")\n\n readByMembers TeamMember? @relation(\"TeamMemberToLastReadNotification\")\n\n @@index([kanbanTaskId])\n @@index([emailStatus, createdAt])\n @@map(\"notifications\")\n}\n\nmodel SystemSettings {\n id String @id @default(ulid())\n key String @unique\n /// [SystemSettingsValue]\n value Json?\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@index([key])\n @@map(\"system_settings\")\n}\n\nmodel Task {\n id String @id @default(ulid())\n type TaskType?\n status TaskStatus @default(pending)\n name String?\n total Int?\n uploaded Int @default(0)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n creatorId String? @map(\"creator_id\")\n creator User? @relation(\"UserToTask\", fields: [creatorId], references: [id])\n\n assets Asset[] @relation(\"TaskToAsset\")\n notifications Notification[] @relation(\"TaskToNotification\")\n\n @@map(\"tasks\")\n}\n\nmodel WorkflowTask {\n id String @id @default(ulid())\n uid String @default(uuid()) @db.Uuid\n teamId String? @map(\"team_id\")\n projectId String? @map(\"project_id\")\n assetId String @map(\"asset_id\")\n type WorkflowTaskType?\n status WorkflowTaskStatus?\n /// [WorkflowTaskPayload]\n payload Json?\n /// [WorkflowTaskOutput]\n output Json?\n heartbeat DateTime?\n inputTokens Int @default(0) @map(\"input_tokens\")\n outputTokens Int @default(0) @map(\"output_tokens\")\n model String?\n sessionId String? @map(\"session_id\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@index([status, heartbeat])\n @@index([assetId, type])\n @@index([teamId])\n @@index([projectId])\n @@index([type])\n @@index([sessionId])\n @@map(\"workflow_tasks\")\n}\n\nenum AgentType {\n chat\n autofill\n embedding\n}\n\nenum AgentSessionType {\n comment\n chat\n naming\n}\n\nmodel Agent {\n id String @id\n user User @relation(fields: [id], references: [id], onDelete: Cascade)\n type AgentType\n enabled Boolean @default(true)\n permission TeamMemberRole @default(reviewer)\n soul String? @db.Text\n providerId String? @map(\"provider_id\")\n provider Provider? @relation(\"ProviderToAgent\", fields: [providerId], references: [id], onDelete: SetNull)\n modelId String? @map(\"model_id\")\n modelRef Model? @relation(\"ModelToAgent\", fields: [modelId], references: [id], onDelete: SetNull)\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToAgent\", fields: [teamId], references: [id], onDelete: Cascade)\n\n /// [AgentConfig]\n config Json\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n agentSessions AgentSession[]\n skills AgentSkill[]\n mcpServers AgentMcpServer[]\n assets Asset[] @relation(\"AgentToAsset\")\n auditLogs AuditLog[] @relation(\"AgentToAuditLog\")\n\n @@map(\"agents\")\n}\n\nmodel AgentSkill {\n id String @id @default(ulid())\n agentId String @map(\"agent_id\")\n agent Agent @relation(fields: [agentId], references: [id], onDelete: Cascade)\n skillId String @map(\"skill_id\")\n skill Skill @relation(fields: [skillId], references: [id], onDelete: Cascade)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@unique([agentId, skillId])\n @@map(\"agent_skills\")\n}\n\nmodel McpServer {\n id String @id @default(ulid())\n name String\n description String?\n instructions String?\n url String\n transport McpTransport @default(streamable_http)\n /// [McpServerAuthConfig]\n authConfig Json? @default(\"{}\")\n /// [McpServerConfig]\n config Json? @default(\"{}\")\n permission TeamMemberRole @default(reviewer)\n /// [McpToolInfo[]]\n tools Json? @default(\"[]\")\n status String @default(\"not_connected\")\n lastError String? @map(\"last_error\")\n lastConnectedAt DateTime? @map(\"last_connected_at\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToMcpServer\", fields: [teamId], references: [id], onDelete: Cascade)\n\n credential McpServerCredential?\n agentMcpServers AgentMcpServer[]\n\n @@map(\"mcp_servers\")\n}\n\n// Join table: which agents get which MCP servers (mirrors AgentSkill).\nmodel AgentMcpServer {\n id String @id @default(ulid())\n agentId String @map(\"agent_id\")\n agent Agent @relation(fields: [agentId], references: [id], onDelete: Cascade)\n mcpServerId String @map(\"mcp_server_id\")\n mcpServer McpServer @relation(fields: [mcpServerId], references: [id], onDelete: Cascade)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@unique([agentId, mcpServerId])\n @@map(\"agent_mcp_servers\")\n}\n\nmodel McpServerCredential {\n id String @id @default(ulid())\n serverId String @unique @map(\"server_id\")\n server McpServer @relation(fields: [serverId], references: [id], onDelete: Cascade)\n serverUrl String @map(\"server_url\")\n /// [McpStoredTokens]\n tokens Json?\n /// [McpStoredClientInfo]\n clientInfo Json?\n codeVerifier String? @map(\"code_verifier\")\n oauthState String? @map(\"oauth_state\")\n /// [McpPendingAuth]\n pendingAuth Json? @map(\"pending_auth\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@map(\"mcp_server_credentials\")\n}\n\nenum McpTransport {\n streamable_http\n sse\n}\n\nmodel AgentSession {\n id String @id @default(ulid())\n agentId String @map(\"agent_id\")\n agent Agent @relation(fields: [agentId], references: [id], onDelete: Cascade)\n userId String? @map(\"user_id\")\n user User? @relation(fields: [userId], references: [id], onDelete: SetNull)\n cwd String\n leafId String? @map(\"leaf_id\")\n assetId String? @map(\"asset_id\")\n asset Asset? @relation(\"AssetToAgentSession\", fields: [assetId], references: [id], onDelete: SetNull)\n userCommentId String? @map(\"user_comment_id\")\n type AgentSessionType @default(comment)\n name String?\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n entries AgentSessionEntry[]\n comments AssetComment[]\n\n @@index([type])\n @@map(\"agent_sessions\")\n}\n\nmodel AgentSessionEntry {\n id String @id // Uses ULID generated by pi-coding-agent\n sessionId String? @map(\"session_id\")\n session AgentSession? @relation(fields: [sessionId], references: [id], onDelete: Cascade)\n assetId String? @map(\"asset_id\")\n type String?\n parentId String? @map(\"parent_id\")\n /// [PiSessionEntryData]\n data Json?\n createdAt DateTime @default(now()) @map(\"created_at\")\n\n @@index([sessionId])\n @@index([parentId])\n @@index([assetId])\n @@map(\"agent_session_entries\")\n}\n\nmodel UserMetadata {\n id String @id @default(ulid())\n key String\n /// [UserMetadataValue]\n value Json\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n userId String @map(\"user_id\")\n user User @relation(\"UserToUserMetadata\", fields: [userId], references: [id], onDelete: Cascade)\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToUserMetadata\", fields: [teamId], references: [id], onDelete: Cascade)\n\n @@unique([userId, teamId, key], name: \"userIdTeamIdKey\")\n @@map(\"user_metadata\")\n}\n\nmodel Model {\n id String @id @default(ulid())\n modelId String @map(\"model_id\")\n name String @default(\"\")\n /// [ModelConfig]\n config Json\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n providerId String @map(\"provider_id\")\n provider Provider @relation(\"ProviderToModel\", fields: [providerId], references: [id], onDelete: Cascade)\n\n agents Agent[] @relation(\"ModelToAgent\")\n\n @@unique([providerId, modelId])\n @@map(\"models\")\n}\n\nmodel Provider {\n id String @id @default(ulid())\n name String\n isBuiltin Boolean @default(false) @map(\"is_builtin\")\n /// [ProviderConfig]\n config Json\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToProvider\", fields: [teamId], references: [id], onDelete: Cascade)\n\n models Model[] @relation(\"ProviderToModel\")\n agents Agent[] @relation(\"ProviderToAgent\")\n\n @@unique([teamId, name])\n @@map(\"providers\")\n}\n\nmodel Collection {\n id String @id @default(ulid())\n name String\n /// [CollectionFilter]\n filter Json\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n projectId String @map(\"project_id\")\n project Project @relation(\"ProjectToCollection\", fields: [projectId], references: [id], onDelete: Cascade)\n\n creatorId String? @map(\"creator_id\")\n creator User? @relation(\"UserToCollection\", fields: [creatorId], references: [id])\n\n @@index([projectId, createdAt(sort: Desc)])\n @@map(\"collections\")\n}\n\nmodel ApiToken {\n id String @id @default(ulid())\n token String @unique @default(ulid())\n name String\n userId String @map(\"user_id\")\n user User @relation(\"UserToApiToken\", fields: [userId], references: [id], onDelete: Cascade)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@map(\"api_tokens\")\n}\n\nmodel AiUsage {\n id String @id @default(ulid())\n teamId String @map(\"team_id\")\n userId String? @map(\"user_id\")\n periodStart DateTime @map(\"period_start\")\n inputTokens BigInt @default(0) @map(\"input_tokens\")\n outputTokens BigInt @default(0) @map(\"output_tokens\")\n cacheReadTokens BigInt @default(0) @map(\"cache_read_tokens\")\n totalTokens BigInt @default(0) @map(\"total_tokens\")\n cost Float @default(0) @map(\"cost\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n team Team @relation(\"TeamToAiUsage\", fields: [teamId], references: [id], onDelete: Cascade)\n user User? @relation(\"UserToAiUsage\", fields: [userId], references: [id], onDelete: SetNull)\n\n @@unique([teamId, userId, periodStart])\n @@index([teamId, periodStart])\n @@index([teamId, userId, periodStart])\n @@map(\"ai_usages\")\n}\n\nmodel AuditLog {\n id String @id @default(ulid())\n action String\n teamId String @map(\"team_id\")\n userId String? @map(\"user_id\")\n agentId String? @map(\"agent_id\")\n projectId String? @map(\"project_id\")\n itemId String? @map(\"item_id\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n\n team Team @relation(\"TeamToAuditLog\", fields: [teamId], references: [id], onDelete: Cascade)\n user User? @relation(\"UserToAuditLog\", fields: [userId], references: [id], onDelete: SetNull)\n agent Agent? @relation(\"AgentToAuditLog\", fields: [agentId], references: [id], onDelete: SetNull)\n project Project? @relation(\"ProjectToAuditLog\", fields: [projectId], references: [id], onDelete: SetNull)\n\n @@index([teamId, id(sort: Desc)])\n @@index([userId])\n @@index([agentId])\n @@index([action])\n @@index([itemId])\n @@map(\"audit_logs\")\n}\n\nmodel QuotaRule {\n id String @id @default(ulid())\n teamId String @map(\"team_id\")\n scopeMode QuotaScopeMode @map(\"scope_mode\")\n role TeamMemberRole? @map(\"role\")\n /// [QuotaUserIds]\n userIds Json? @map(\"user_ids\")\n resource QuotaResourceType @map(\"resource\")\n /// [QuotaResourceData]\n resourceData Json? @map(\"resource_data\")\n limit Float @map(\"limit\")\n period QuotaPeriod @map(\"period\")\n enabled Boolean @default(true) @map(\"enabled\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n team Team @relation(\"TeamToQuotaRule\", fields: [teamId], references: [id], onDelete: Cascade)\n records QuotaRecord[] @relation(\"QuotaRuleToRecord\")\n\n @@index([teamId, enabled])\n @@index([teamId, resource])\n @@map(\"quota_rules\")\n}\n\nmodel QuotaRecord {\n id String @id @default(ulid())\n ruleId String @map(\"rule_id\")\n teamId String @map(\"team_id\")\n userId String? @map(\"user_id\")\n periodStart DateTime? @map(\"period_start\")\n periodEnd DateTime? @map(\"period_end\")\n consumed Float @default(0) @map(\"consumed\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n rule QuotaRule @relation(\"QuotaRuleToRecord\", fields: [ruleId], references: [id], onDelete: Cascade)\n team Team @relation(\"TeamToQuotaRecord\", fields: [teamId], references: [id], onDelete: Cascade)\n user User? @relation(\"UserToQuotaRecord\", fields: [userId], references: [id], onDelete: Cascade)\n\n @@unique([ruleId, userId])\n @@index([teamId, userId])\n @@index([ruleId])\n @@map(\"quota_records\")\n}\n\nmodel KanbanGoal {\n id String @id @default(ulid())\n title String\n description String? @db.Text\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToKanbanGoal\", fields: [teamId], references: [id], onDelete: Cascade)\n creatorId String? @map(\"creator_id\")\n creator User? @relation(\"UserToKanbanGoal\", fields: [creatorId], references: [id], onDelete: SetNull)\n tasks KanbanTask[]\n\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@index([teamId])\n @@map(\"kanban_goals\")\n}\n\nmodel KanbanTask {\n id String @id @default(ulid())\n title String\n description String? @db.Text\n isAgentTask Boolean @default(false) @map(\"is_agent_task\")\n status KanbanTaskStatus @default(TODO)\n priority KanbanTaskPriority @default(MEDIUM)\n\n startDate DateTime? @map(\"start_date\")\n dueDate DateTime? @map(\"due_date\")\n startedAt DateTime? @map(\"started_at\")\n completedAt DateTime? @map(\"completed_at\")\n\n goalId String? @map(\"goal_id\")\n goal KanbanGoal? @relation(fields: [goalId], references: [id], onDelete: SetNull)\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToKanbanTask\", fields: [teamId], references: [id], onDelete: Cascade)\n projectId String? @map(\"project_id\")\n project Project? @relation(\"ProjectToKanbanTask\", fields: [projectId], references: [id], onDelete: Cascade)\n\n creatorId String @map(\"creator_id\")\n creator User @relation(\"KanbanTaskCreator\", fields: [creatorId], references: [id])\n reporterId String? @map(\"reporter_id\")\n reporter User? @relation(\"KanbanTaskReporter\", fields: [reporterId], references: [id])\n assigneeId String? @map(\"assignee_id\")\n assignee User? @relation(\"KanbanTaskAssignee\", fields: [assigneeId], references: [id])\n\n targetFolderId String? @map(\"target_folder_id\")\n targetFolder Asset? @relation(\"KanbanTaskTargetFolder\", fields: [targetFolderId], references: [id], onDelete: SetNull)\n\n dependencies KanbanTaskLink[] @relation(\"ChildLinks\")\n dependents KanbanTaskLink[] @relation(\"ParentLinks\")\n assets KanbanTaskAsset[]\n\n comments KanbanTaskComment[]\n events KanbanTaskEvent[]\n notifications Notification[] @relation(\"KanbanTaskToNotification\")\n\n sortIndex String? @map(\"sort_index\")\n\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@index([teamId, status])\n @@index([teamId, status, sortIndex])\n @@index([teamId, isAgentTask, status])\n @@index([teamId, goalId, status])\n @@index([teamId, assigneeId, status])\n @@index([projectId, status])\n @@index([sortIndex])\n @@map(\"kanban_tasks\")\n}\n\nmodel KanbanTaskLink {\n parentId String @map(\"parent_id\")\n childId String @map(\"child_id\")\n parent KanbanTask @relation(\"ParentLinks\", fields: [parentId], references: [id], onDelete: Cascade)\n child KanbanTask @relation(\"ChildLinks\", fields: [childId], references: [id], onDelete: Cascade)\n\n createdAt DateTime @default(now()) @map(\"created_at\")\n\n @@id([parentId, childId])\n @@index([childId])\n @@map(\"kanban_task_links\")\n}\n\nmodel KanbanTaskAsset {\n taskId String @map(\"task_id\")\n assetId String @map(\"asset_id\")\n task KanbanTask @relation(fields: [taskId], references: [id], onDelete: Cascade)\n asset Asset @relation(fields: [assetId], references: [id], onDelete: Cascade)\n\n createdAt DateTime @default(now()) @map(\"created_at\")\n\n @@id([taskId, assetId])\n @@index([assetId])\n @@map(\"kanban_task_assets\")\n}\n\nmodel KanbanTaskComment {\n id String @id @default(ulid())\n taskId String @map(\"task_id\")\n task KanbanTask @relation(fields: [taskId], references: [id], onDelete: Cascade)\n authorId String @map(\"author_id\")\n author User @relation(fields: [authorId], references: [id])\n body String @db.Text\n /// [KanbanCommentAttachmentList]\n attachments Json?\n\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@index([taskId, createdAt])\n @@map(\"kanban_task_comments\")\n}\n\nmodel KanbanTaskEvent {\n id String @id @default(ulid())\n taskId String @map(\"task_id\")\n task KanbanTask @relation(fields: [taskId], references: [id], onDelete: Cascade)\n actorId String? @map(\"actor_id\")\n actor User? @relation(fields: [actorId], references: [id])\n type KanbanTaskEventType\n fromStatus KanbanTaskStatus? @map(\"from_status\")\n toStatus KanbanTaskStatus? @map(\"to_status\")\n /// [KanbanEventPayload]\n data Json?\n\n createdAt DateTime @default(now()) @map(\"created_at\")\n\n @@index([taskId, createdAt])\n @@index([actorId, createdAt])\n @@map(\"kanban_task_events\")\n}\n\nmodel RecentFileItem {\n id String @id @default(ulid())\n userId String @map(\"user_id\")\n projectId String @map(\"project_id\")\n assetId String @map(\"asset_id\")\n viewedAt DateTime @default(now()) @map(\"viewed_at\")\n\n user User @relation(fields: [userId], references: [id], onDelete: Cascade)\n project Project @relation(fields: [projectId], references: [id], onDelete: Cascade)\n asset Asset @relation(fields: [assetId], references: [id], onDelete: Cascade)\n\n @@unique([userId, projectId, assetId], name: \"userIdProjectIdAssetId\")\n @@index([userId, projectId, viewedAt(sort: Desc)])\n @@index([assetId])\n @@map(\"recent_file_items\")\n}\n", + "inlineSchema": "generator client {\n provider = \"prisma-client\"\n output = \"../src/generated/prisma\"\n binaryTargets = [\"native\", \"linux-musl-openssl-3.0.x\"]\n previewFeatures = [\"postgresqlExtensions\"]\n}\n\ngenerator json {\n provider = \"prisma-json-types-generator\"\n allowAny = false\n}\n\ndatasource db {\n provider = \"postgresql\"\n extensions = [vector]\n}\n\n// ----------------------------------------------------------------------\n// Enums\n// ----------------------------------------------------------------------\n\nenum UserType {\n human\n agent\n}\n\nenum AssetType {\n folder\n file\n share\n root\n attachment\n version_stack\n share_root\n symlink\n}\n\nenum AssetStatus {\n uploading\n uploaded\n processing\n processed\n failed\n trashed\n pending_purge\n}\n\nenum StorageKeyStatus {\n active\n purging\n}\n\nenum InviteRole {\n editor\n reviewer\n}\n\nenum MetadataFieldScope {\n SYSTEM\n TEAM\n PROJECT\n}\n\nenum NotificationType {\n comment_created\n reply_created\n mention\n successful_file_uploaded\n metadata_field_updated_status\n new_user_join_team\n new_user_join_project\n kanban_task_created\n kanban_task_assigned\n kanban_task_status_updated\n kanban_task_updated\n kanban_task_deleted\n kanban_task_comment_created\n}\n\nenum NotificationEmailStatus {\n pending\n processing\n processed\n failed\n}\n\nenum ProjectMemberRole {\n owner\n editor\n reviewer\n}\n\nenum TaskType {\n upload\n}\n\nenum TaskStatus {\n pending\n uploading\n completed\n failed\n}\n\nenum TeamMemberRole {\n owner\n editor\n reviewer\n}\n\nenum TeamMemberScope {\n team\n project\n}\n\nenum WorkflowTaskType {\n transcode\n transcode_video\n transcode_image\n transcode_pdf\n transcode_pdf_pages\n transcode_screenshot\n transcode_image_annotation\n transcode_watermark\n ai_metadata_autofill\n chat\n ai_embedding\n query_embedding_for_search\n agent_tool_call // @deprecated: Agent tools now execute directly in-process via Core services\n kanban_agent_run\n}\n\nenum WorkflowTaskStatus {\n pending\n processing\n completed\n failed\n}\n\nenum WatermarkStatus {\n disabled\n processing\n ready\n failed\n}\n\nenum WatermarkFileStatus {\n pending\n processing\n completed\n failed\n}\n\nenum QuotaScopeMode {\n all_members\n each_member\n selected_members\n}\n\nenum QuotaPeriod {\n one_hour @map(\"1hour\")\n five_hours @map(\"5hour\")\n one_day @map(\"1day\")\n seven_days @map(\"7day\")\n}\n\nenum QuotaResourceType {\n agent_total_tokens\n agent_cost\n agent_mcp_call_count\n agent_bash_call_count\n agent_tool_call_count\n}\n\nenum KanbanTaskStatus {\n TODO\n READY\n IN_PROGRESS\n BLOCKED\n IN_REVIEW\n DONE\n}\n\nenum KanbanTaskPriority {\n LOW\n MEDIUM\n HIGH\n URGENT\n}\n\nenum KanbanTaskEventType {\n CREATED\n STATUS_CHANGED\n ASSIGNED\n UNASSIGNED\n COMMENTED\n CHANGES_REQUESTED\n BLOCKED\n UNBLOCKED\n PRIORITY_CHANGED\n GOAL_CHANGED\n DEPENDENCY_ADDED\n DEPENDENCY_REMOVED\n}\n\n// ----------------------------------------------------------------------\n// Models\n// ----------------------------------------------------------------------\n\nmodel User {\n id String @id @default(ulid())\n type UserType @default(human)\n name String\n email String @unique\n emailVerified Boolean @default(false) @map(\"email_verified\")\n image String?\n password String?\n /// [AgentSettings]\n agentSettings Json? @map(\"agent_settings\")\n guestEmail String? @map(\"guest_email\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n assets Asset[] @relation(\"UserToAsset\")\n authTokens AuthToken[] @relation(\"UserToAuthToken\")\n tasks Task[] @relation(\"UserToTask\")\n teamMembers TeamMember[] @relation(\"UserToTeamMember\")\n comments AssetComment[] @relation(\"UserToAssetComment\")\n completionChangedComments AssetComment[] @relation(\"UserToAssetCommentCompletionChanged\")\n commentReactions AssetCommentReaction[] @relation(\"UserToAssetCommentReaction\")\n createdInvites Invite[] @relation(\"UserToInvite\")\n createdNotifications Notification[] @relation(\"UserToCreatedNotification\")\n notifications Notification[] @relation(\"UserToNotification\")\n sessions Session[]\n accounts Account[]\n agent Agent?\n agentSessions AgentSession[]\n userMetadata UserMetadata[] @relation(\"UserToUserMetadata\")\n collections Collection[] @relation(\"UserToCollection\")\n shareLinks ShareLink[] @relation(\"UserToShareLink\")\n apiTokens ApiToken[] @relation(\"UserToApiToken\")\n aiUsages AiUsage[] @relation(\"UserToAiUsage\")\n auditLogs AuditLog[] @relation(\"UserToAuditLog\")\n quotaRecords QuotaRecord[] @relation(\"UserToQuotaRecord\")\n kanbanTasksCreated KanbanTask[] @relation(\"KanbanTaskCreator\")\n kanbanTasksReported KanbanTask[] @relation(\"KanbanTaskReporter\")\n kanbanTasksAssigned KanbanTask[] @relation(\"KanbanTaskAssignee\")\n kanbanGoalsCreated KanbanGoal[] @relation(\"UserToKanbanGoal\")\n kanbanTaskComments KanbanTaskComment[]\n kanbanTaskEvents KanbanTaskEvent[]\n recentFiles RecentFileItem[]\n\n @@map(\"users\")\n}\n\nmodel Session {\n id String @id @default(ulid())\n expiresAt DateTime @map(\"expires_at\")\n token String @unique\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n ipAddress String? @map(\"ip_address\")\n userAgent String? @map(\"user_agent\")\n userId String @map(\"user_id\")\n user User @relation(fields: [userId], references: [id], onDelete: Cascade)\n\n @@map(\"sessions\")\n}\n\nmodel Account {\n id String @id @default(ulid())\n accountId String @map(\"account_id\")\n providerId String @map(\"provider_id\")\n userId String @map(\"user_id\")\n user User @relation(fields: [userId], references: [id], onDelete: Cascade)\n accessToken String? @map(\"access_token\")\n refreshToken String? @map(\"refresh_token\")\n idToken String? @map(\"id_token\")\n accessTokenExpiresAt DateTime? @map(\"access_token_expires_at\")\n refreshTokenExpiresAt DateTime? @map(\"refresh_token_expires_at\")\n scope String?\n password String?\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@map(\"accounts\")\n}\n\nmodel Verification {\n id String @id @default(ulid())\n identifier String\n value String\n expiresAt DateTime @map(\"expires_at\")\n createdAt DateTime? @default(now()) @map(\"created_at\")\n updatedAt DateTime? @updatedAt @map(\"updated_at\")\n\n @@map(\"verifications\")\n}\n\nmodel AuthToken {\n id String @id @default(ulid())\n accessToken String @unique @map(\"access_token\")\n refreshToken String @unique @map(\"refresh_token\")\n accessTokenExpiresAt DateTime @map(\"access_token_expires_at\")\n refreshTokenExpiresAt DateTime @map(\"refresh_token_expires_at\")\n\n userId String @map(\"user_id\")\n user User @relation(\"UserToAuthToken\", fields: [userId], references: [id])\n\n @@map(\"auth_tokens\")\n}\n\nmodel Team {\n id String @id @default(ulid())\n name String\n /// [Settings]\n settings Json? @default(\"{}\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n rootFolderId String? @unique @map(\"root_folder_id\")\n rootFolder Asset? @relation(\"TeamToRootFolder\", fields: [rootFolderId], references: [id])\n\n members TeamMember[] @relation(\"TeamToTeamMember\")\n projects Project[] @relation(\"TeamToProject\")\n metadataFields MetadataField[] @relation(\"TeamToMetadataField\")\n invites Invite[] @relation(\"TeamToInvite\")\n notifications Notification[] @relation(\"TeamToNotification\")\n userMetadata UserMetadata[] @relation(\"TeamToUserMetadata\")\n providers Provider[] @relation(\"TeamToProvider\")\n skills Skill[] @relation(\"TeamToSkill\")\n mcpServers McpServer[] @relation(\"TeamToMcpServer\")\n sandbox Sandbox? @relation(\"TeamToSandbox\")\n agents Agent[] @relation(\"TeamToAgent\")\n aiUsages AiUsage[] @relation(\"TeamToAiUsage\")\n auditLogs AuditLog[] @relation(\"TeamToAuditLog\")\n watermarkTemplates WatermarkTemplate[] @relation(\"TeamToWatermarkTemplate\")\n quotaRules QuotaRule[] @relation(\"TeamToQuotaRule\")\n quotaRecords QuotaRecord[] @relation(\"TeamToQuotaRecord\")\n kanbanGoals KanbanGoal[] @relation(\"TeamToKanbanGoal\")\n kanbanTasks KanbanTask[] @relation(\"TeamToKanbanTask\")\n\n @@map(\"teams\")\n}\n\nmodel Sandbox {\n id String @id @default(ulid())\n networkSandboxEnabled Boolean @default(false) @map(\"network_sandbox_enabled\")\n allowedDomains String[] @default([\"npmjs.org\", \"*.npmjs.org\", \"registry.npmjs.org\", \"registry.yarnpkg.com\", \"pypi.org\", \"*.pypi.org\", \"github.com\", \"*.github.com\", \"api.github.com\", \"raw.githubusercontent.com\"])\n pendingDomains String[] @default([]) @map(\"pending_domains\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n teamId String @unique @map(\"team_id\")\n team Team @relation(\"TeamToSandbox\", fields: [teamId], references: [id], onDelete: Cascade)\n\n @@map(\"sandboxes\")\n}\n\nmodel Skill {\n id String @id @default(ulid())\n name String\n description String?\n /// [SkillConfig]\n config Json? @default(\"{}\")\n assetId String @map(\"asset_id\")\n hash String @map(\"hash\")\n permission TeamMemberRole @default(reviewer)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToSkill\", fields: [teamId], references: [id], onDelete: Cascade)\n\n agentSkills AgentSkill[]\n\n @@unique([teamId, name])\n @@map(\"skills\")\n}\n\nmodel TeamMember {\n id String @id @default(ulid())\n role TeamMemberRole\n scope TeamMemberScope @default(team)\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToTeamMember\", fields: [teamId], references: [id])\n\n userId String @map(\"user_id\")\n user User @relation(\"UserToTeamMember\", fields: [userId], references: [id], onDelete: Cascade)\n\n projectMembers ProjectMember[] @relation(\"TeamMemberToProjectMember\")\n lastReadNotificationId String? @unique @map(\"last_read_notification_id\")\n lastReadNotification Notification? @relation(\"TeamMemberToLastReadNotification\", fields: [lastReadNotificationId], references: [id])\n\n @@unique([teamId, userId], name: \"teamIdUserId\")\n @@map(\"team_members\")\n}\n\nmodel Project {\n id String @id @default(ulid())\n name String\n coverImageKey String? @map(\"cover_image_key\")\n hasJpegCover Boolean @default(false) @map(\"has_jpeg_cover\")\n /// [MetadataOverrides]\n metadataOverrides Json? @map(\"metadata_overrides\")\n enableNotification Boolean @default(true) @map(\"enable_notification\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToProject\", fields: [teamId], references: [id])\n\n rootFolderId String? @unique @map(\"root_folder_id\")\n rootFolder Asset? @relation(\"ProjectToRootFolder\", fields: [rootFolderId], references: [id])\n\n shareRootId String? @unique @map(\"share_root_id\")\n shareRoot Asset? @relation(\"ProjectToShareRoot\", fields: [shareRootId], references: [id])\n\n members ProjectMember[] @relation(\"ProjectToProjectMember\")\n assets Asset[] @relation(\"ProjectToAsset\")\n metadataFields MetadataField[] @relation(\"ProjectToMetadataField\")\n invites Invite[] @relation(\"ProjectToInvite\")\n notifications Notification[] @relation(\"ProjectToNotification\")\n shareLinks ShareLink[] @relation(\"ProjectToShareLink\")\n collections Collection[] @relation(\"ProjectToCollection\")\n auditLogs AuditLog[] @relation(\"ProjectToAuditLog\")\n kanbanTasks KanbanTask[] @relation(\"ProjectToKanbanTask\")\n recentFiles RecentFileItem[]\n\n @@index([createdAt])\n @@index([updatedAt])\n @@map(\"projects\")\n}\n\nmodel ProjectMember {\n id String @id @default(ulid())\n role ProjectMemberRole\n\n projectId String @map(\"project_id\")\n project Project @relation(\"ProjectToProjectMember\", fields: [projectId], references: [id], onDelete: Cascade)\n\n teamMemberId String @map(\"team_member_id\")\n teamMember TeamMember @relation(\"TeamMemberToProjectMember\", fields: [teamMemberId], references: [id])\n\n @@unique([projectId, teamMemberId], name: \"projectIdTeamMemberId\")\n @@map(\"project_members\")\n}\n\nmodel ShareLink {\n id String @id @default(ulid())\n name String\n expireAt DateTime? @map(\"expire_at\")\n password String?\n isDisabled Boolean @default(false) @map(\"is_disabled\")\n allowDownload Boolean @default(true) @map(\"allow_download\")\n defaultSortOrder String? @map(\"default_sort_order\")\n viewMode String? @map(\"view_mode\")\n /// [ShareLinkFieldVisibility]\n fieldVisibility Json? @map(\"field_visibility\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n projectId String @map(\"project_id\")\n project Project @relation(\"ProjectToShareLink\", fields: [projectId], references: [id], onDelete: Cascade)\n\n rootFolderId String @unique @map(\"root_folder_id\")\n rootFolder Asset @relation(\"ShareLinkToRootFolder\", fields: [rootFolderId], references: [id])\n\n creatorId String? @map(\"creator_id\")\n creator User? @relation(\"UserToShareLink\", fields: [creatorId], references: [id])\n\n watermarkConfigId String? @map(\"watermark_config_id\")\n watermarkStatus WatermarkStatus @default(disabled) @map(\"watermark_status\")\n watermarkConfig WatermarkConfig? @relation(fields: [watermarkConfigId], references: [id], onDelete: SetNull)\n\n @@map(\"share_links\")\n}\n\nmodel WatermarkConfig {\n id String @id @default(ulid())\n /// [WatermarkConfigSpec]\n config Json\n hash String @unique\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n shareLinks ShareLink[]\n watermarkFiles WatermarkFile[]\n\n @@map(\"watermark_configs\")\n}\n\nmodel WatermarkTemplate {\n id String @id @default(ulid())\n name String\n /// [WatermarkConfigSpec]\n config Json\n teamId String? @map(\"team_id\")\n team Team? @relation(\"TeamToWatermarkTemplate\", fields: [teamId], references: [id], onDelete: Cascade)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@index([teamId])\n @@map(\"watermark_templates\")\n}\n\nmodel WatermarkFile {\n id String @id @default(ulid())\n assetId String @map(\"asset_id\")\n watermarkConfigId String @map(\"watermark_config_id\")\n /// [MediaInfo]\n media Json?\n status WatermarkFileStatus @default(pending)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n asset Asset @relation(\"AssetToWatermarkFile\", fields: [assetId], references: [id], onDelete: Cascade)\n watermarkConfig WatermarkConfig @relation(fields: [watermarkConfigId], references: [id], onDelete: Cascade)\n\n @@unique([assetId, watermarkConfigId])\n @@index([watermarkConfigId])\n @@map(\"watermark_files\")\n}\n\nmodel Asset {\n id String @id @default(ulid())\n name String @default(\"\")\n nameNgram String[] @default([]) @map(\"name_ngram\")\n type AssetType\n mediaType String? @map(\"media_type\")\n fileCount Int @default(0) @map(\"file_count\")\n sizeByte BigInt @default(0) @map(\"size_byte\")\n status AssetStatus\n transcodeTaskId String? @map(\"transcode_task_id\")\n uploadId String? @map(\"upload_id\")\n /// [MediaInfo]\n media Json?\n hasJpegPreview Boolean @default(false) @map(\"has_jpeg_preview\")\n isDeleted Boolean @default(false) @map(\"is_deleted\")\n deletedAt DateTime? @map(\"deleted_at\")\n sortIndex String? @map(\"sort_index\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n parentId String? @map(\"parent_id\")\n parent Asset? @relation(\"AssetChildren\", fields: [parentId], references: [id])\n children Asset[] @relation(\"AssetChildren\")\n\n targetId String? @map(\"target_id\")\n target Asset? @relation(\"SymlinkTarget\", fields: [targetId], references: [id])\n symlinks Asset[] @relation(\"SymlinkTarget\")\n\n storageKeyId String? @map(\"storage_key_id\")\n storageKey StorageKey? @relation(fields: [storageKeyId], references: [id])\n\n metadataValues AssetMetadataValue[] @relation(\"AssetToMetadataValues\")\n\n creatorId String? @map(\"creator_id\")\n creator User? @relation(\"UserToAsset\", fields: [creatorId], references: [id])\n\n agentId String? @map(\"agent_id\")\n agent Agent? @relation(\"AgentToAsset\", fields: [agentId], references: [id], onDelete: SetNull)\n\n taskId String? @map(\"task_id\")\n task Task? @relation(\"TaskToAsset\", fields: [taskId], references: [id])\n\n projectId String? @map(\"project_id\")\n project Project? @relation(\"ProjectToAsset\", fields: [projectId], references: [id])\n\n comments AssetComment[] @relation(\"AssetToComment\")\n commentAttachments AssetCommentAttachment[] @relation(\"AssetToCommentAttachment\")\n notifications Notification[] @relation(\"AssetToNotification\")\n embeddings AssetEmbedding[] @relation(\"AssetToEmbedding\")\n\n teamRootFolder Team? @relation(\"TeamToRootFolder\")\n projectRootFolder Project? @relation(\"ProjectToRootFolder\")\n projectShareRoot Project? @relation(\"ProjectToShareRoot\")\n shareLinkRootFolder ShareLink? @relation(\"ShareLinkToRootFolder\")\n agentSessions AgentSession[] @relation(\"AssetToAgentSession\")\n watermarkFiles WatermarkFile[] @relation(\"AssetToWatermarkFile\")\n agentMd AssetAgentMd? @relation(\"AssetToAgentMd\")\n kanbanTargetTasks KanbanTask[] @relation(\"KanbanTaskTargetFolder\")\n kanbanTasks KanbanTaskAsset[]\n recentFiles RecentFileItem[]\n\n @@unique([parentId, targetId], name: \"parentIdTargetId\")\n @@index([type])\n @@index([status])\n @@index([createdAt])\n @@index([updatedAt])\n @@index([sortIndex])\n @@index([isDeleted])\n @@index([deletedAt])\n @@index([agentId])\n @@index([name], name: \"assets_name_idx\")\n @@index([nameNgram], type: Gin)\n @@map(\"assets\")\n}\n\nmodel StorageKey {\n id String @id @default(ulid())\n key String @unique\n status StorageKeyStatus @default(active)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n assets Asset[]\n\n @@map(\"storage_keys\")\n}\n\nmodel AssetMetadataValue {\n id String @id @default(ulid())\n assetId String @map(\"asset_id\")\n fieldKey String @map(\"field_key\") // key from MetadataField\n\n stringValue String? @map(\"string_value\")\n numberValue Float? @map(\"number_value\")\n booleanValue Boolean? @map(\"boolean_value\")\n jsonValue Json? @map(\"json_value\")\n dateValue DateTime? @map(\"date_value\")\n\n asset Asset @relation(\"AssetToMetadataValues\", fields: [assetId], references: [id], onDelete: Cascade)\n\n @@unique([assetId, fieldKey])\n @@index([numberValue])\n @@index([stringValue])\n @@index([booleanValue])\n @@index([dateValue])\n @@index([jsonValue], type: Gin)\n @@map(\"asset_metadata_values\")\n}\n\nmodel AssetAgentMd {\n assetId String @id @map(\"asset_id\")\n content String @db.Text\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n asset Asset @relation(\"AssetToAgentMd\", fields: [assetId], references: [id], onDelete: Cascade)\n\n @@map(\"asset_agentmd\")\n}\n\nmodel AssetComment {\n id String @id @default(ulid())\n message String?\n /// [AnnotationList]\n annotation Json?\n second Float?\n sessionId String? @map(\"session_id\")\n session AgentSession? @relation(fields: [sessionId], references: [id], onDelete: SetNull)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n assetId String @map(\"asset_id\")\n asset Asset @relation(\"AssetToComment\", fields: [assetId], references: [id], onDelete: Cascade)\n\n creatorId String? @map(\"creator_id\")\n creator User? @relation(\"UserToAssetComment\", fields: [creatorId], references: [id])\n\n isCompleted Boolean @default(false) @map(\"is_completed\")\n completionLastChangedById String? @map(\"completion_last_changed_by_id\")\n completionLastChangedBy User? @relation(\"UserToAssetCommentCompletionChanged\", fields: [completionLastChangedById], references: [id])\n\n replyToId String? @map(\"reply_to_id\")\n replyTo AssetComment? @relation(\"CommentReplies\", fields: [replyToId], references: [id], onDelete: Cascade)\n replies AssetComment[] @relation(\"CommentReplies\")\n\n attachments AssetCommentAttachment[] @relation(\"CommentToAttachment\")\n reactions AssetCommentReaction[] @relation(\"CommentToReaction\")\n\n @@index([assetId])\n @@map(\"asset_comments\")\n}\n\nmodel AssetCommentAttachment {\n id String @id @default(ulid())\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n commentId String @map(\"comment_id\")\n comment AssetComment @relation(\"CommentToAttachment\", fields: [commentId], references: [id], onDelete: Cascade)\n\n assetId String @map(\"asset_id\")\n asset Asset @relation(\"AssetToCommentAttachment\", fields: [assetId], references: [id], onDelete: Cascade)\n\n @@map(\"asset_comment_attachments\")\n}\n\nmodel AssetCommentReaction {\n id String @id @default(ulid())\n createdAt DateTime @default(now()) @map(\"created_at\")\n\n commentId String @map(\"comment_id\")\n comment AssetComment @relation(\"CommentToReaction\", fields: [commentId], references: [id], onDelete: Cascade)\n\n userId String @map(\"user_id\")\n user User @relation(\"UserToAssetCommentReaction\", fields: [userId], references: [id], onDelete: Cascade)\n\n code String @db.VarChar(32)\n\n @@unique([commentId, userId, code])\n @@index([commentId])\n @@map(\"asset_comment_reactions\")\n}\n\nmodel AssetEmbedding {\n id String @id @default(ulid())\n embedding Unsupported(\"vector(1536)\")?\n startTime Float? @map(\"start_time\")\n endTime Float? @map(\"end_time\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n assetId String @map(\"asset_id\")\n asset Asset @relation(\"AssetToEmbedding\", fields: [assetId], references: [id], onDelete: Cascade)\n\n @@index([embedding], name: \"AssetEmbedding_embedding_idx\")\n @@map(\"asset_embeddings\")\n}\n\nmodel Invite {\n id String @id @default(ulid())\n code String @unique\n role InviteRole?\n used Boolean @default(false)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToInvite\", fields: [teamId], references: [id])\n\n projectId String? @map(\"project_id\")\n project Project? @relation(\"ProjectToInvite\", fields: [projectId], references: [id], onDelete: Cascade)\n\n inviterId String @map(\"inviter_id\")\n inviter User @relation(\"UserToInvite\", fields: [inviterId], references: [id])\n\n @@map(\"invites\")\n}\n\nmodel MetadataField {\n id String @id @default(ulid())\n key String @unique\n scope MetadataFieldScope?\n /// [FieldConfig]\n config Json?\n readOnly Boolean @default(false) @map(\"read_only\")\n description String @default(\"\")\n\n teamId String? @map(\"team_id\")\n team Team? @relation(\"TeamToMetadataField\", fields: [teamId], references: [id])\n\n projectId String? @map(\"project_id\")\n project Project? @relation(\"ProjectToMetadataField\", fields: [projectId], references: [id], onDelete: Cascade)\n\n @@map(\"metadata_fields\")\n}\n\nmodel Notification {\n id String @id @default(ulid())\n type NotificationType?\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToNotification\", fields: [teamId], references: [id])\n\n projectId String? @map(\"project_id\")\n project Project? @relation(\"ProjectToNotification\", fields: [projectId], references: [id], onDelete: Cascade)\n\n creatorId String? @map(\"creator_id\")\n creator User? @relation(\"UserToCreatedNotification\", fields: [creatorId], references: [id])\n\n assetId String? @map(\"asset_id\")\n asset Asset? @relation(\"AssetToNotification\", fields: [assetId], references: [id], onDelete: Cascade)\n\n taskId String? @map(\"task_id\")\n task Task? @relation(\"TaskToNotification\", fields: [taskId], references: [id])\n\n kanbanTaskId String? @map(\"kanban_task_id\")\n kanbanTask KanbanTask? @relation(\"KanbanTaskToNotification\", fields: [kanbanTaskId], references: [id], onDelete: Cascade)\n\n userId String? @map(\"user_id\")\n user User? @relation(\"UserToNotification\", fields: [userId], references: [id])\n\n emailStatus NotificationEmailStatus @default(pending) @map(\"email_status\")\n\n readByMembers TeamMember? @relation(\"TeamMemberToLastReadNotification\")\n\n @@index([kanbanTaskId])\n @@index([emailStatus, createdAt])\n @@map(\"notifications\")\n}\n\nmodel SystemSettings {\n id String @id @default(ulid())\n key String @unique\n /// [SystemSettingsValue]\n value Json?\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@index([key])\n @@map(\"system_settings\")\n}\n\nmodel Task {\n id String @id @default(ulid())\n type TaskType?\n status TaskStatus @default(pending)\n name String?\n total Int?\n uploaded Int @default(0)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n creatorId String? @map(\"creator_id\")\n creator User? @relation(\"UserToTask\", fields: [creatorId], references: [id])\n\n assets Asset[] @relation(\"TaskToAsset\")\n notifications Notification[] @relation(\"TaskToNotification\")\n\n @@map(\"tasks\")\n}\n\nmodel WorkflowTask {\n id String @id @default(ulid())\n uid String @default(uuid()) @db.Uuid\n teamId String? @map(\"team_id\")\n projectId String? @map(\"project_id\")\n assetId String @map(\"asset_id\")\n type WorkflowTaskType?\n status WorkflowTaskStatus?\n /// [WorkflowTaskPayload]\n payload Json?\n /// [WorkflowTaskOutput]\n output Json?\n heartbeat DateTime?\n inputTokens Int @default(0) @map(\"input_tokens\")\n outputTokens Int @default(0) @map(\"output_tokens\")\n model String?\n sessionId String? @map(\"session_id\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@index([status, heartbeat])\n @@index([assetId, type])\n @@index([teamId])\n @@index([projectId])\n @@index([type])\n @@index([sessionId])\n @@map(\"workflow_tasks\")\n}\n\nenum AgentType {\n chat\n autofill\n embedding\n}\n\nenum AgentSessionType {\n comment\n chat\n naming\n}\n\nmodel Agent {\n id String @id\n user User @relation(fields: [id], references: [id], onDelete: Cascade)\n type AgentType\n enabled Boolean @default(true)\n permission TeamMemberRole @default(reviewer)\n soul String? @db.Text\n providerId String? @map(\"provider_id\")\n provider Provider? @relation(\"ProviderToAgent\", fields: [providerId], references: [id], onDelete: SetNull)\n modelId String? @map(\"model_id\")\n modelRef Model? @relation(\"ModelToAgent\", fields: [modelId], references: [id], onDelete: SetNull)\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToAgent\", fields: [teamId], references: [id], onDelete: Cascade)\n\n /// [AgentConfig]\n config Json\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n agentSessions AgentSession[]\n skills AgentSkill[]\n mcpServers AgentMcpServer[]\n assets Asset[] @relation(\"AgentToAsset\")\n auditLogs AuditLog[] @relation(\"AgentToAuditLog\")\n\n @@map(\"agents\")\n}\n\nmodel AgentSkill {\n id String @id @default(ulid())\n agentId String @map(\"agent_id\")\n agent Agent @relation(fields: [agentId], references: [id], onDelete: Cascade)\n skillId String @map(\"skill_id\")\n skill Skill @relation(fields: [skillId], references: [id], onDelete: Cascade)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@unique([agentId, skillId])\n @@map(\"agent_skills\")\n}\n\nmodel McpServer {\n id String @id @default(ulid())\n name String\n description String?\n instructions String?\n url String\n transport McpTransport @default(streamable_http)\n /// [McpServerAuthConfig]\n authConfig Json? @default(\"{}\")\n /// [McpServerConfig]\n config Json? @default(\"{}\")\n permission TeamMemberRole @default(reviewer)\n /// [McpToolInfo[]]\n tools Json? @default(\"[]\")\n status String @default(\"not_connected\")\n lastError String? @map(\"last_error\")\n lastConnectedAt DateTime? @map(\"last_connected_at\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToMcpServer\", fields: [teamId], references: [id], onDelete: Cascade)\n\n credential McpServerCredential?\n agentMcpServers AgentMcpServer[]\n\n @@map(\"mcp_servers\")\n}\n\n// Join table: which agents get which MCP servers (mirrors AgentSkill).\nmodel AgentMcpServer {\n id String @id @default(ulid())\n agentId String @map(\"agent_id\")\n agent Agent @relation(fields: [agentId], references: [id], onDelete: Cascade)\n mcpServerId String @map(\"mcp_server_id\")\n mcpServer McpServer @relation(fields: [mcpServerId], references: [id], onDelete: Cascade)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@unique([agentId, mcpServerId])\n @@map(\"agent_mcp_servers\")\n}\n\nmodel McpServerCredential {\n id String @id @default(ulid())\n serverId String @unique @map(\"server_id\")\n server McpServer @relation(fields: [serverId], references: [id], onDelete: Cascade)\n serverUrl String @map(\"server_url\")\n /// [McpStoredTokens]\n tokens Json?\n /// [McpStoredClientInfo]\n clientInfo Json?\n codeVerifier String? @map(\"code_verifier\")\n oauthState String? @map(\"oauth_state\")\n /// [McpPendingAuth]\n pendingAuth Json? @map(\"pending_auth\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@map(\"mcp_server_credentials\")\n}\n\nenum McpTransport {\n streamable_http\n sse\n}\n\nmodel AgentSession {\n id String @id @default(ulid())\n agentId String @map(\"agent_id\")\n agent Agent @relation(fields: [agentId], references: [id], onDelete: Cascade)\n userId String? @map(\"user_id\")\n user User? @relation(fields: [userId], references: [id], onDelete: SetNull)\n cwd String\n leafId String? @map(\"leaf_id\")\n assetId String? @map(\"asset_id\")\n asset Asset? @relation(\"AssetToAgentSession\", fields: [assetId], references: [id], onDelete: SetNull)\n userCommentId String? @map(\"user_comment_id\")\n type AgentSessionType @default(comment)\n name String?\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n entries AgentSessionEntry[]\n comments AssetComment[]\n\n @@index([type])\n @@map(\"agent_sessions\")\n}\n\nmodel AgentSessionEntry {\n id String @id // Uses ULID generated by pi-coding-agent\n sessionId String? @map(\"session_id\")\n session AgentSession? @relation(fields: [sessionId], references: [id], onDelete: Cascade)\n assetId String? @map(\"asset_id\")\n type String?\n parentId String? @map(\"parent_id\")\n /// [PiSessionEntryData]\n data Json?\n createdAt DateTime @default(now()) @map(\"created_at\")\n\n @@index([sessionId])\n @@index([parentId])\n @@index([assetId])\n @@map(\"agent_session_entries\")\n}\n\nmodel UserMetadata {\n id String @id @default(ulid())\n key String\n /// [UserMetadataValue]\n value Json\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n userId String @map(\"user_id\")\n user User @relation(\"UserToUserMetadata\", fields: [userId], references: [id], onDelete: Cascade)\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToUserMetadata\", fields: [teamId], references: [id], onDelete: Cascade)\n\n @@unique([userId, teamId, key], name: \"userIdTeamIdKey\")\n @@map(\"user_metadata\")\n}\n\nmodel Model {\n id String @id @default(ulid())\n modelId String @map(\"model_id\")\n name String @default(\"\")\n /// [ModelConfig]\n config Json\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n providerId String @map(\"provider_id\")\n provider Provider @relation(\"ProviderToModel\", fields: [providerId], references: [id], onDelete: Cascade)\n\n agents Agent[] @relation(\"ModelToAgent\")\n\n @@unique([providerId, modelId])\n @@map(\"models\")\n}\n\nmodel Provider {\n id String @id @default(ulid())\n name String\n isBuiltin Boolean @default(false) @map(\"is_builtin\")\n /// [ProviderConfig]\n config Json\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToProvider\", fields: [teamId], references: [id], onDelete: Cascade)\n\n models Model[] @relation(\"ProviderToModel\")\n agents Agent[] @relation(\"ProviderToAgent\")\n\n @@unique([teamId, name])\n @@map(\"providers\")\n}\n\nmodel Collection {\n id String @id @default(ulid())\n name String\n /// [CollectionFilter]\n filter Json\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n projectId String @map(\"project_id\")\n project Project @relation(\"ProjectToCollection\", fields: [projectId], references: [id], onDelete: Cascade)\n\n creatorId String? @map(\"creator_id\")\n creator User? @relation(\"UserToCollection\", fields: [creatorId], references: [id])\n\n @@index([projectId, createdAt(sort: Desc)])\n @@map(\"collections\")\n}\n\nmodel ApiToken {\n id String @id @default(ulid())\n token String @unique @default(ulid())\n name String\n userId String @map(\"user_id\")\n user User @relation(\"UserToApiToken\", fields: [userId], references: [id], onDelete: Cascade)\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@map(\"api_tokens\")\n}\n\nmodel AiUsage {\n id String @id @default(ulid())\n teamId String @map(\"team_id\")\n userId String? @map(\"user_id\")\n periodStart DateTime @map(\"period_start\")\n inputTokens BigInt @default(0) @map(\"input_tokens\")\n outputTokens BigInt @default(0) @map(\"output_tokens\")\n cacheReadTokens BigInt @default(0) @map(\"cache_read_tokens\")\n totalTokens BigInt @default(0) @map(\"total_tokens\")\n cost Float @default(0) @map(\"cost\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n team Team @relation(\"TeamToAiUsage\", fields: [teamId], references: [id], onDelete: Cascade)\n user User? @relation(\"UserToAiUsage\", fields: [userId], references: [id], onDelete: SetNull)\n\n @@unique([teamId, userId, periodStart])\n @@index([teamId, periodStart])\n @@index([teamId, userId, periodStart])\n @@map(\"ai_usages\")\n}\n\nmodel AuditLog {\n id String @id @default(ulid())\n action String\n teamId String @map(\"team_id\")\n userId String? @map(\"user_id\")\n agentId String? @map(\"agent_id\")\n projectId String? @map(\"project_id\")\n itemId String? @map(\"item_id\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n\n team Team @relation(\"TeamToAuditLog\", fields: [teamId], references: [id], onDelete: Cascade)\n user User? @relation(\"UserToAuditLog\", fields: [userId], references: [id], onDelete: SetNull)\n agent Agent? @relation(\"AgentToAuditLog\", fields: [agentId], references: [id], onDelete: SetNull)\n project Project? @relation(\"ProjectToAuditLog\", fields: [projectId], references: [id], onDelete: SetNull)\n\n @@index([teamId, id(sort: Desc)])\n @@index([userId])\n @@index([agentId])\n @@index([action])\n @@index([itemId])\n @@map(\"audit_logs\")\n}\n\nmodel QuotaRule {\n id String @id @default(ulid())\n teamId String @map(\"team_id\")\n scopeMode QuotaScopeMode @map(\"scope_mode\")\n role TeamMemberRole? @map(\"role\")\n /// [QuotaUserIds]\n userIds Json? @map(\"user_ids\")\n resource QuotaResourceType @map(\"resource\")\n /// [QuotaResourceData]\n resourceData Json? @map(\"resource_data\")\n limit Float @map(\"limit\")\n period QuotaPeriod @map(\"period\")\n enabled Boolean @default(true) @map(\"enabled\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n team Team @relation(\"TeamToQuotaRule\", fields: [teamId], references: [id], onDelete: Cascade)\n records QuotaRecord[] @relation(\"QuotaRuleToRecord\")\n\n @@index([teamId, enabled])\n @@index([teamId, resource])\n @@map(\"quota_rules\")\n}\n\nmodel QuotaRecord {\n id String @id @default(ulid())\n ruleId String @map(\"rule_id\")\n teamId String @map(\"team_id\")\n userId String? @map(\"user_id\")\n periodStart DateTime? @map(\"period_start\")\n periodEnd DateTime? @map(\"period_end\")\n consumed Float @default(0) @map(\"consumed\")\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n rule QuotaRule @relation(\"QuotaRuleToRecord\", fields: [ruleId], references: [id], onDelete: Cascade)\n team Team @relation(\"TeamToQuotaRecord\", fields: [teamId], references: [id], onDelete: Cascade)\n user User? @relation(\"UserToQuotaRecord\", fields: [userId], references: [id], onDelete: Cascade)\n\n @@unique([ruleId, userId])\n @@index([teamId, userId])\n @@index([ruleId])\n @@map(\"quota_records\")\n}\n\nmodel KanbanGoal {\n id String @id @default(ulid())\n title String\n description String? @db.Text\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToKanbanGoal\", fields: [teamId], references: [id], onDelete: Cascade)\n creatorId String? @map(\"creator_id\")\n creator User? @relation(\"UserToKanbanGoal\", fields: [creatorId], references: [id], onDelete: SetNull)\n tasks KanbanTask[]\n\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@index([teamId])\n @@map(\"kanban_goals\")\n}\n\nmodel KanbanTask {\n id String @id @default(ulid())\n title String\n description String? @db.Text\n isAgentTask Boolean @default(false) @map(\"is_agent_task\")\n status KanbanTaskStatus @default(TODO)\n priority KanbanTaskPriority @default(MEDIUM)\n\n startDate DateTime? @map(\"start_date\")\n dueDate DateTime? @map(\"due_date\")\n startedAt DateTime? @map(\"started_at\")\n completedAt DateTime? @map(\"completed_at\")\n\n goalId String? @map(\"goal_id\")\n goal KanbanGoal? @relation(fields: [goalId], references: [id], onDelete: SetNull)\n\n teamId String @map(\"team_id\")\n team Team @relation(\"TeamToKanbanTask\", fields: [teamId], references: [id], onDelete: Cascade)\n projectId String? @map(\"project_id\")\n project Project? @relation(\"ProjectToKanbanTask\", fields: [projectId], references: [id], onDelete: Cascade)\n\n creatorId String @map(\"creator_id\")\n creator User @relation(\"KanbanTaskCreator\", fields: [creatorId], references: [id])\n reporterId String? @map(\"reporter_id\")\n reporter User? @relation(\"KanbanTaskReporter\", fields: [reporterId], references: [id])\n assigneeId String? @map(\"assignee_id\")\n assignee User? @relation(\"KanbanTaskAssignee\", fields: [assigneeId], references: [id])\n\n targetFolderId String? @map(\"target_folder_id\")\n targetFolder Asset? @relation(\"KanbanTaskTargetFolder\", fields: [targetFolderId], references: [id], onDelete: SetNull)\n\n dependencies KanbanTaskLink[] @relation(\"ChildLinks\")\n dependents KanbanTaskLink[] @relation(\"ParentLinks\")\n assets KanbanTaskAsset[]\n\n comments KanbanTaskComment[]\n events KanbanTaskEvent[]\n notifications Notification[] @relation(\"KanbanTaskToNotification\")\n\n sortIndex String? @map(\"sort_index\")\n\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@index([teamId, status])\n @@index([teamId, status, sortIndex])\n @@index([teamId, isAgentTask, status])\n @@index([teamId, goalId, status])\n @@index([teamId, assigneeId, status])\n @@index([projectId, status])\n @@index([sortIndex])\n @@map(\"kanban_tasks\")\n}\n\nmodel KanbanTaskLink {\n parentId String @map(\"parent_id\")\n childId String @map(\"child_id\")\n parent KanbanTask @relation(\"ParentLinks\", fields: [parentId], references: [id], onDelete: Cascade)\n child KanbanTask @relation(\"ChildLinks\", fields: [childId], references: [id], onDelete: Cascade)\n\n createdAt DateTime @default(now()) @map(\"created_at\")\n\n @@id([parentId, childId])\n @@index([childId])\n @@map(\"kanban_task_links\")\n}\n\nmodel KanbanTaskAsset {\n taskId String @map(\"task_id\")\n assetId String @map(\"asset_id\")\n task KanbanTask @relation(fields: [taskId], references: [id], onDelete: Cascade)\n asset Asset @relation(fields: [assetId], references: [id], onDelete: Cascade)\n\n createdAt DateTime @default(now()) @map(\"created_at\")\n\n @@id([taskId, assetId])\n @@index([assetId])\n @@map(\"kanban_task_assets\")\n}\n\nmodel KanbanTaskComment {\n id String @id @default(ulid())\n taskId String @map(\"task_id\")\n task KanbanTask @relation(fields: [taskId], references: [id], onDelete: Cascade)\n authorId String @map(\"author_id\")\n author User @relation(fields: [authorId], references: [id])\n body String @db.Text\n /// [KanbanCommentAttachmentList]\n attachments Json?\n\n createdAt DateTime @default(now()) @map(\"created_at\")\n updatedAt DateTime @updatedAt @map(\"updated_at\")\n\n @@index([taskId, createdAt])\n @@map(\"kanban_task_comments\")\n}\n\nmodel KanbanTaskEvent {\n id String @id @default(ulid())\n taskId String @map(\"task_id\")\n task KanbanTask @relation(fields: [taskId], references: [id], onDelete: Cascade)\n actorId String? @map(\"actor_id\")\n actor User? @relation(fields: [actorId], references: [id])\n type KanbanTaskEventType\n fromStatus KanbanTaskStatus? @map(\"from_status\")\n toStatus KanbanTaskStatus? @map(\"to_status\")\n /// [KanbanEventPayload]\n data Json?\n\n createdAt DateTime @default(now()) @map(\"created_at\")\n\n @@index([taskId, createdAt])\n @@index([actorId, createdAt])\n @@map(\"kanban_task_events\")\n}\n\nmodel RecentFileItem {\n id String @id @default(ulid())\n userId String @map(\"user_id\")\n projectId String @map(\"project_id\")\n assetId String @map(\"asset_id\")\n viewedAt DateTime @default(now()) @map(\"viewed_at\")\n\n user User @relation(fields: [userId], references: [id], onDelete: Cascade)\n project Project @relation(fields: [projectId], references: [id], onDelete: Cascade)\n asset Asset @relation(fields: [assetId], references: [id], onDelete: Cascade)\n\n @@unique([userId, projectId, assetId], name: \"userIdProjectIdAssetId\")\n @@index([userId, projectId, viewedAt(sort: Desc)])\n @@index([assetId])\n @@map(\"recent_file_items\")\n}\n", "runtimeDataModel": { "models": {}, "enums": {}, diff --git a/packages/db/src/prisma-json-types.ts b/packages/db/src/prisma-json-types.ts index e9d45ee8..aa8893d4 100644 --- a/packages/db/src/prisma-json-types.ts +++ b/packages/db/src/prisma-json-types.ts @@ -209,6 +209,7 @@ declare global { original: OriginalInfo | null isHls?: boolean hls?: HlsInfo + error?: string } // ---------------------------------------------------------------------- diff --git a/packages/dtos/src/asset.ts b/packages/dtos/src/asset.ts index 99ec59d3..97b801aa 100644 --- a/packages/dtos/src/asset.ts +++ b/packages/dtos/src/asset.ts @@ -145,6 +145,7 @@ export const assetInfoSchema = z.object({ .optional(), proxyType: z.enum(['image', 'video', 'audio', 'pdf']).nullable().optional(), metadata: mediaMetadataSchema.optional(), + error: z.string().optional(), }) .optional(), ancestorFolders: z.array(ancestorFolderSchema).optional(), diff --git a/packages/e2e/workflow/transcode-video.test.ts b/packages/e2e/workflow/transcode-video.test.ts index 50d36047..f3c7424a 100644 --- a/packages/e2e/workflow/transcode-video.test.ts +++ b/packages/e2e/workflow/transcode-video.test.ts @@ -1111,5 +1111,71 @@ describe.each(['local', 'temporal'] as const)( ) expect(masterObj.buffer.toString('utf-8')).toContain('480p/index.m3u8') }, 60000) + + it('should transition both task and asset to failed status with media.error when transcoding fails', async () => { + const team = await prisma.team.create({ + data: { name: 'E2E Failed Transcode Team' }, + }) + + const project = await prisma.project.create({ + data: { name: 'E2E Failed Transcode Project', teamId: team.id }, + }) + + const storageKey = await prisma.storageKey.create({ + data: { key: 'projects/e2e/corrupt-video.mp4' }, + }) + + const asset = await prisma.asset.create({ + data: { + name: 'corrupt-video.mp4', + type: 'file', + status: 'uploaded', + mediaType: 'video/mp4', + projectId: project.id, + storageKeyId: storageKey.id, + }, + }) + + const corruptBuffer = Buffer.from('not a valid mp4 media stream at all') + await s3Service.putObject( + 'shumai-e2e-test-bucket-transcode', + 'projects/e2e/corrupt-video.mp4', + corruptBuffer, + corruptBuffer.length, + 'video/mp4', + ) + + const task = await prisma.workflowTask.create({ + data: { + type: 'transcode_video', + status: 'pending', + assetId: asset.id, + projectId: project.id, + teamId: team.id, + payload: { + projectId: project.id, + transcode: { + videoStrategy: 'best_match', + }, + }, + }, + }) + + await expect(workflowService.executeWait(task, 45000)).rejects.toThrow() + + const failedTask = await prisma.workflowTask.findUnique({ + where: { id: task.id }, + }) + expect(failedTask?.status).toBe('failed') + + const updatedAsset = await prisma.asset.findUnique({ + where: { id: asset.id }, + }) + expect(updatedAsset?.status).toBe(AssetStatus.failed) + + const media = updatedAsset?.media as PrismaJson.MediaInfo + expect(media?.error).toBeDefined() + expect(media?.error?.length).toBeGreaterThan(0) + }, 45000) }, ) diff --git a/packages/transcode/src/workflows/common.ts b/packages/transcode/src/workflows/common.ts index 5469d505..0bd8204f 100644 --- a/packages/transcode/src/workflows/common.ts +++ b/packages/transcode/src/workflows/common.ts @@ -38,14 +38,31 @@ export async function completeTask( }) } -export async function failTask(workerQueue: string, taskId: string, err: unknown) { - const { updateTaskStatusActivity } = getActivities() +export async function failTask( + workerQueue: string, + taskId: string, + err: unknown, + assetId?: string, +) { + const { updateTaskStatusActivity, updateAssetStatusActivity } = getActivities() if (workerQueue) { + const errorMsg = err instanceof Error ? err.message : String(err) await executeActivity(workerQueue, updateTaskStatusActivity, { taskId, status: 'failed', - output: { error: err instanceof Error ? err.message : String(err) }, + output: { error: errorMsg }, }) + if (assetId) { + try { + await executeActivity(workerQueue, updateAssetStatusActivity, { + assetId, + status: 'failed', + error: errorMsg, + }) + } catch (assetErr) { + console.error('Failed to update asset status to failed:', assetErr) + } + } } } diff --git a/packages/transcode/src/workflows/transcode-image.ts b/packages/transcode/src/workflows/transcode-image.ts index b346e658..44d12887 100644 --- a/packages/transcode/src/workflows/transcode-image.ts +++ b/packages/transcode/src/workflows/transcode-image.ts @@ -12,6 +12,7 @@ import { export async function transcodeImageWorkflow(task: WorkflowTask): Promise { let tmpDir: string | undefined let workerQueue = '' + let mediaProcessed = false try { workerQueue = await getWorkerQueueAndStartTask(task) @@ -90,6 +91,7 @@ export async function transcodeImageWorkflow(task: WorkflowTask): Promise assetId: asset.id, status: 'processed', }) + mediaProcessed = true await executeActivity(workerQueue, createEmbeddingTaskIfEnabledActivity, { assetId: asset.id, @@ -106,7 +108,7 @@ export async function transcodeImageWorkflow(task: WorkflowTask): Promise await completeTask(workerQueue, task.id) } catch (err) { console.error(`transcodeImageWorkflow failed for task ${task.id}:`, err) - await failTask(workerQueue, task.id, err) + await failTask(workerQueue, task.id, err, mediaProcessed ? undefined : task.assetId) throw err } finally { await cleanupTmpDir(workerQueue, tmpDir) diff --git a/packages/transcode/src/workflows/transcode-pdf.ts b/packages/transcode/src/workflows/transcode-pdf.ts index c45f4759..63b3bf2a 100644 --- a/packages/transcode/src/workflows/transcode-pdf.ts +++ b/packages/transcode/src/workflows/transcode-pdf.ts @@ -12,6 +12,7 @@ import { export async function transcodePdfWorkflow(task: WorkflowTask): Promise { let tmpDir: string | undefined let workerQueue = '' + let mediaProcessed = false try { workerQueue = await getWorkerQueueAndStartTask(task) @@ -101,6 +102,7 @@ export async function transcodePdfWorkflow(task: WorkflowTask): Promise { assetId: asset.id, status: 'processed', }) + mediaProcessed = true await executeActivity(workerQueue, createEmbeddingTaskIfEnabledActivity, { assetId: asset.id, @@ -117,7 +119,7 @@ export async function transcodePdfWorkflow(task: WorkflowTask): Promise { await completeTask(workerQueue, task.id) } catch (err) { console.error(`transcodePdfWorkflow failed for task ${task.id}:`, err) - await failTask(workerQueue, task.id, err) + await failTask(workerQueue, task.id, err, mediaProcessed ? undefined : task.assetId) throw err } finally { await cleanupTmpDir(workerQueue, tmpDir) diff --git a/packages/transcode/src/workflows/transcode-video.test.ts b/packages/transcode/src/workflows/transcode-video.test.ts index 35b80b80..ac2bbf7e 100644 --- a/packages/transcode/src/workflows/transcode-video.test.ts +++ b/packages/transcode/src/workflows/transcode-video.test.ts @@ -874,4 +874,129 @@ describe('transcodeVideoWorkflow', () => { ) }) }) + + it('should mark task and asset as failed when an activity fails', async () => { + const task: WorkflowTask = { + id: 'task-fail', + assetId: 'asset-fail', + type: WorkflowTaskType.transcode_video, + status: WorkflowTaskStatus.pending, + sessionId: null, + output: null, + payload: { + projectId: 'proj-1', + transcode: { videoStrategy: 'best_match' }, + }, + createdAt: new Date(), + updatedAt: new Date(), + heartbeat: null, + teamId: 'team-1', + projectId: 'proj-1', + uid: 'task-uid', + model: null, + inputTokens: 0, + outputTokens: 0, + } + + mockActivities.getAssetActivity.mockResolvedValue({ + id: 'asset-fail', + name: 'fail.mp4', + storageKey: { key: 'files/asset-fail/fail.mp4' }, + status: AssetStatus.uploading, + }) + + mockActivities.getMediaInfoActivity.mockRejectedValue(new Error('FFprobe failed to read media')) + + await expect(transcodeVideoWorkflow(task)).rejects.toThrow('FFprobe failed to read media') + + expect(mockActivities.updateTaskStatusActivity).toHaveBeenCalledWith({ + taskId: 'task-fail', + status: 'failed', + output: { error: 'FFprobe failed to read media' }, + }) + + expect(mockActivities.updateAssetStatusActivity).toHaveBeenCalledWith({ + assetId: 'asset-fail', + status: 'failed', + error: 'FFprobe failed to read media', + }) + }) + + it('should mark task as failed but keep asset as processed when post-transcode activity fails', async () => { + const task: WorkflowTask = { + id: 'task-post-fail', + assetId: 'asset-post-fail', + type: WorkflowTaskType.transcode_video, + status: WorkflowTaskStatus.pending, + sessionId: null, + output: null, + payload: { + projectId: 'proj-1', + transcode: { videoStrategy: 'best_match' }, + }, + createdAt: new Date(), + updatedAt: new Date(), + heartbeat: null, + teamId: 'team-1', + projectId: 'proj-1', + uid: 'task-uid', + model: null, + inputTokens: 0, + outputTokens: 0, + } + + mockActivities.getAssetActivity.mockResolvedValue({ + id: 'asset-post-fail', + name: 'video.mp4', + storageKey: { key: 'files/asset-post-fail/video.mp4' }, + status: AssetStatus.uploading, + mediaType: 'video/mp4', + }) + + mockActivities.getMediaInfoActivity.mockResolvedValue({ + proxyType: 'video', + metadata: { + originalWidth: 1920, + originalHeight: 1080, + duration: 10, + frameRate: 30, + totalFrames: 300, + startTimecode: '00:00:00:00', + bitRate: 1000, + hasAudio: false, + format: {}, + }, + videoTranscodes: [], + imageTranscodes: [], + }) + + mockActivities.transcodeVideoActivity.mockResolvedValue({ + key: 'v.mp4', + width: 1920, + height: 1080, + }) + + mockActivities.createEmbeddingTaskIfEnabledActivity.mockRejectedValue( + new Error('Embedding creation failed'), + ) + + await expect(transcodeVideoWorkflow(task)).rejects.toThrow('Embedding creation failed') + + expect(mockActivities.updateTaskStatusActivity).toHaveBeenCalledWith({ + taskId: 'task-post-fail', + status: 'failed', + output: { error: 'Embedding creation failed' }, + }) + + expect(mockActivities.updateAssetStatusActivity).toHaveBeenCalledWith({ + assetId: 'asset-post-fail', + status: 'processed', + }) + + expect(mockActivities.updateAssetStatusActivity).not.toHaveBeenCalledWith( + expect.objectContaining({ + status: 'failed', + }), + ) + }) }) diff --git a/packages/transcode/src/workflows/transcode-video.ts b/packages/transcode/src/workflows/transcode-video.ts index e4fc9d7b..f6ff416b 100644 --- a/packages/transcode/src/workflows/transcode-video.ts +++ b/packages/transcode/src/workflows/transcode-video.ts @@ -17,6 +17,7 @@ import { export async function transcodeVideoWorkflow(task: WorkflowTask): Promise { let tmpDir: string | undefined let workerQueue = '' + let mediaProcessed = false try { workerQueue = await getWorkerQueueAndStartTask(task) @@ -265,6 +266,7 @@ export async function transcodeVideoWorkflow(task: WorkflowTask): Promise assetId: asset.id, status: 'processed', }) + mediaProcessed = true await executeActivity(workerQueue, createEmbeddingTaskIfEnabledActivity, { assetId: asset.id, @@ -281,7 +283,7 @@ export async function transcodeVideoWorkflow(task: WorkflowTask): Promise await completeTask(workerQueue, task.id) } catch (err) { console.error(`transcodeVideoWorkflow failed for task ${task.id}:`, err) - await failTask(workerQueue, task.id, err) + await failTask(workerQueue, task.id, err, mediaProcessed ? undefined : task.assetId) throw err } finally { await cleanupTmpDir(workerQueue, tmpDir) diff --git a/packages/webui/components/file-browser/file-card.test.tsx b/packages/webui/components/file-browser/file-card.test.tsx index faf49032..0f738cd1 100644 --- a/packages/webui/components/file-browser/file-card.test.tsx +++ b/packages/webui/components/file-browser/file-card.test.tsx @@ -382,4 +382,63 @@ describe('FileCard', () => { // The duration badge appears once processing is done. expect(screen.getByText('00:10')).toBeTruthy() }) + + it('renders failed state with alert icon and shows creator at bottom when status is failed without a preview', () => { + const failedItem: AssetInfo = { + ...fileItem, + status: 'failed', + creator: { id: 'u1', name: 'Alice' }, + } as AssetInfo + + renderComponent({ item: failedItem }) + + expect(screen.queryByTestId('file-card-preparing-circle')).toBeNull() + const failedState = screen.getByTestId('file-card-failed-state') + expect(failedState).toBeTruthy() + expect(screen.getByText(/Processing failed|处理失败/i)).toBeTruthy() + expect(screen.getByText(/Alice/i)).toBeTruthy() + }) + + it('renders thumbnail with failed badge in top-right corner, shows error in tooltip on hover, and shows creator at bottom', () => { + vi.useFakeTimers() + const failedItemWithPreview: AssetInfo = { + ...fileItem, + status: 'failed', + creator: { id: 'u1', name: 'Alice' }, + media: { + error: 'FFmpeg transcode failed: exit code 1', + }, + preview: { + proxyType: 'video', + thumbnailUrl: 'https://example.com/poster.webp', + duration: 10, + }, + } as AssetInfo + + renderComponent({ item: failedItemWithPreview }) + + const media = screen.getByTestId('file-card-preview-media') + expect(media.className).not.toContain('animate-pulse') + const badge = screen.getByTestId('file-card-failed-badge') + expect(badge).toBeTruthy() + expect(badge.textContent).toMatch(/Transcoding Failed|转码失败/i) + expect(badge.querySelector('svg')).toBeNull() + + // Failed badge is in the top-right container + const rightTopContainer = badge.closest('.absolute.right-2.top-2') + expect(rightTopContainer).toBeTruthy() + + // Creator is still shown at the bottom of the card + expect(screen.getByText(/Alice/i)).toBeTruthy() + + // Hovering the badge reveals the error message in tooltip + fireEvent.pointerMove(badge, { pointerType: 'mouse' }) + act(() => { + vi.advanceTimersByTime(200) + }) + const tooltip = screen.getByRole('tooltip') + expect(tooltip).toBeTruthy() + expect(tooltip.textContent).toContain('FFmpeg transcode failed: exit code 1') + vi.useRealTimers() + }) }) diff --git a/packages/webui/components/file-browser/file-card.tsx b/packages/webui/components/file-browser/file-card.tsx index ef3c6b82..a2e5da03 100644 --- a/packages/webui/components/file-browser/file-card.tsx +++ b/packages/webui/components/file-browser/file-card.tsx @@ -27,6 +27,7 @@ import { cn } from '@/ui/lib/utils' import { useUploadStore } from '@/ui/stores/upload' import { useDraggable, useDroppable } from '@dnd-kit/react' import { + AlertCircle, Clock, Download, Edit, @@ -131,15 +132,21 @@ export function FileCard({ enabled: shouldPoll, refetchInterval: (query: unknown) => { const data = (query as { state: { data: { status?: string } } }).state.data - return data?.status === 'processed' ? false : 1000 + return data?.status === 'processed' || data?.status === 'failed' || data?.status === 'error' + ? false + : 1000 }, }) const displayItem = useMemo(() => { - if (item.status === 'processed' || item.status === 'error') { + if (item.status === 'processed' || item.status === 'error' || item.status === 'failed') { return item } - if (polledItem?.status === 'processed' || polledItem?.status === 'error') { + if ( + polledItem?.status === 'processed' || + polledItem?.status === 'error' || + polledItem?.status === 'failed' + ) { return polledItem } return polledItem || item @@ -263,10 +270,11 @@ export function FileCard({ // A preview (poster thumbnail and/or sprite) can be available before transcoding finishes, // since the poster/sprite are generated and persisted ahead of the proxy transcodes. const hasPreview = Boolean(displayItem.preview?.thumbnailUrl || displayItem.preview?.spriteUrl) + const isFailed = displayItem.status === 'failed' const isProcessing = displayItem.status === 'processing' || displayItem.status === 'uploaded' // While uploading/transcoding, the creator row is replaced by a short status label so the real - // date/author only appears once the asset is ready. + // date/author only appears once the asset is ready or failed. const statusText = displayItem.status === 'uploading' ? m.uploading() @@ -274,6 +282,8 @@ export function FileCard({ ? m.preparing() : null + const failedErrorMessage = displayItem.media?.error || m.processing_failed() + const previewBadges = daysLeft !== null || (typeof displayItem.commentsCount === 'number' && displayItem.commentsCount > 0) ? ( @@ -322,7 +332,7 @@ export function FileCard({ showDropFeedback && 'border-primary outline-1 outline-primary', )} > -
+
{}} @@ -351,6 +361,27 @@ export function FileCard({ displayItem.versionStack.versions.length} )} + {isFailed && ( + + + + + {m.transcoding_failed()} + + + + {failedErrorMessage} + + + + )}
@@ -364,7 +395,7 @@ export function FileCard({ data-testid="file-card-preview-media" className={cn('h-full w-full', isProcessing && 'animate-pulse')} > - +
{previewBadges} @@ -374,7 +405,17 @@ export function FileCard({ {m.failed_to_upload()}
- ) : displayItem.status === 'processing' || displayItem.status === 'uploaded' ? ( + ) : isFailed ? ( +
+ + + {m.processing_failed()} + +
+ ) : isProcessing ? (
{/* Same geometry as the upload progress ring, but empty inside and no percentage. */} -

+

{statusText ?? creatorText}

diff --git a/packages/webui/components/file-browser/file-list-item.test.tsx b/packages/webui/components/file-browser/file-list-item.test.tsx index d772e07c..b7bda69a 100644 --- a/packages/webui/components/file-browser/file-list-item.test.tsx +++ b/packages/webui/components/file-browser/file-list-item.test.tsx @@ -134,4 +134,17 @@ describe('FileListItem', () => { expect(onDoubleClick).toHaveBeenCalled() }) + + it('renders (Processing failed) label when status is failed', () => { + const failedItem: AssetInfo = { + ...mockItem, + status: 'failed', + } as AssetInfo + + renderComponent({ item: failedItem }) + + const failedLabel = screen.getByTestId('file-list-item-failed') + expect(failedLabel).toBeTruthy() + expect(failedLabel.textContent).toMatch(/Processing failed|处理失败/i) + }) }) diff --git a/packages/webui/components/file-browser/file-list-item.tsx b/packages/webui/components/file-browser/file-list-item.tsx index 35be1ba0..62561e72 100644 --- a/packages/webui/components/file-browser/file-list-item.tsx +++ b/packages/webui/components/file-browser/file-list-item.tsx @@ -1,9 +1,10 @@ import type { AssetInfo, FieldValueInfo } from '@shumai/dtos' import { client } from '@/ui/api/client' +import { m } from '@/ui/paraglide/messages.js' import { useQuery } from '@tanstack/react-query' import { useDraggable } from '@dnd-kit/react' -import { File, Folder, MoreVertical, AudioLines } from 'lucide-react' +import { AlertCircle, File, Folder, MoreVertical, AudioLines } from 'lucide-react' import React, { useEffect, useMemo, useRef, useState } from 'react' import { cn } from '@/ui/lib/utils' import { formatSize } from '@/ui/lib/format' @@ -90,15 +91,21 @@ export function FileListItem({ enabled: shouldPoll, refetchInterval: (query: unknown) => { const data = (query as { state: { data: { status?: string } } }).state.data - return data?.status === 'processed' ? false : 1000 + return data?.status === 'processed' || data?.status === 'failed' || data?.status === 'error' + ? false + : 1000 }, }) const displayItem = useMemo(() => { - if (item.status === 'processed' || item.status === 'error') { + if (item.status === 'processed' || item.status === 'error' || item.status === 'failed') { return item } - if (polledItem?.status === 'processed' || polledItem?.status === 'error') { + if ( + polledItem?.status === 'processed' || + polledItem?.status === 'error' || + polledItem?.status === 'failed' + ) { return polledItem } return polledItem || item @@ -215,6 +222,8 @@ export function FileListItem({
{displayItem.status === 'uploading' ? ( + ) : displayItem.status === 'failed' && !displayItem.preview?.thumbnailUrl ? ( + ) : displayItem.preview?.thumbnailUrl ? ( {displayItem.status === 'error' && ( - (Failed to upload) + {m.failed_to_upload_parenthesized()} + + )} + {displayItem.status === 'failed' && ( + + {m.processing_failed_parenthesized()} )} diff --git a/packages/webui/components/viewers/default/default-viewer.test.tsx b/packages/webui/components/viewers/default/default-viewer.test.tsx new file mode 100644 index 00000000..61717f6f --- /dev/null +++ b/packages/webui/components/viewers/default/default-viewer.test.tsx @@ -0,0 +1,46 @@ +// @vitest-environment happy-dom +import { cleanup, render, screen } from '@testing-library/react' +import React from 'react' +import { afterEach, describe, expect, it, vi } from 'vitest' +import { DefaultViewer } from './default-viewer' +import type { AssetInfo } from '@shumai/dtos' + +vi.mock('@/ui/paraglide/messages.js', () => ({ + m: new Proxy({}, { get: () => () => '' }), +})) + +describe('DefaultViewer', () => { + afterEach(() => { + cleanup() + }) + it('renders failed state when file status is failed', () => { + const file = { + id: 'failed-doc', + name: 'failed.docx', + status: 'failed', + media: { + error: 'PDF generation failed', + }, + } as unknown as AssetInfo + + render() + expect(screen.getByTestId('default-viewer-failed-state')).toBeDefined() + expect(screen.getByText('PDF generation failed')).toBeDefined() + }) + + it('renders standard download view when file is not failed', () => { + const file = { + id: 'file-1', + name: 'archive.zip', + status: 'processed', + sizeByte: 1024, + media: { + original: { key: 'raw/archive.zip' }, + }, + } as unknown as AssetInfo + + render() + expect(screen.queryByTestId('default-viewer-failed-state')).toBeNull() + expect(screen.getByText('Download')).toBeDefined() + }) +}) diff --git a/packages/webui/components/viewers/default/default-viewer.tsx b/packages/webui/components/viewers/default/default-viewer.tsx index f55ca920..567ad22a 100644 --- a/packages/webui/components/viewers/default/default-viewer.tsx +++ b/packages/webui/components/viewers/default/default-viewer.tsx @@ -1,5 +1,6 @@ import { client } from '@/ui/api/client' -import { Download } from 'lucide-react' +import { m } from '@/ui/paraglide/messages.js' +import { Download, AlertCircle } from 'lucide-react' import React, { useImperativeHandle } from 'react' import { FileViewerProps, MediaController } from '../types' @@ -37,12 +38,40 @@ export const DefaultViewer = React.forwardRef( } } + const isFailed = file.status === 'failed' + const errorMessage = file.media?.error + return (
{children} -
-

Preview unavailable

+
+ {isFailed ? ( +
+ +
+

+ {m.media_processing_failed()} +

+

+ {m.media_processing_failed_desc()} +

+ {errorMessage && ( +
+ {errorMessage} +
+ )} +
+
+ ) : ( +

Preview unavailable

+ )}
diff --git a/packages/webui/components/viewers/video/video-viewer.test.tsx b/packages/webui/components/viewers/video/video-viewer.test.tsx index 04d685b0..307c67f4 100644 --- a/packages/webui/components/viewers/video/video-viewer.test.tsx +++ b/packages/webui/components/viewers/video/video-viewer.test.tsx @@ -791,4 +791,20 @@ describe('VideoViewer', () => { vi.useRealTimers() } }) + + it('renders failed state when file has no media and status is failed', () => { + const failedVideo = { + id: 'failed-video', + name: 'failed-video.mp4', + proxyType: 'video', + status: 'failed', + media: { + error: 'Transcoding failed due to server error', + }, + } as unknown as AssetInfo + + const { getByTestId, getByText } = render() + expect(getByTestId('video-viewer-failed-state')).toBeDefined() + expect(getByText('Transcoding failed due to server error')).toBeDefined() + }) }) diff --git a/packages/webui/components/viewers/video/video-viewer.tsx b/packages/webui/components/viewers/video/video-viewer.tsx index d9ea1235..03791e86 100644 --- a/packages/webui/components/viewers/video/video-viewer.tsx +++ b/packages/webui/components/viewers/video/video-viewer.tsx @@ -1,6 +1,7 @@ import { client } from '@/ui/api/client' +import { m } from '@/ui/paraglide/messages.js' import { cn } from '@/ui/lib/utils' -import { Play, AudioLines, Loader2 } from 'lucide-react' +import { Play, AudioLines, Loader2, AlertCircle } from 'lucide-react' import React, { useCallback, useEffect, useRef, useState, useImperativeHandle } from 'react' import Hls from 'hls.js' import { useFramePlayer } from './use-frame-player' @@ -958,9 +959,34 @@ const VideoViewer = React.forwardRef( const isMobile = useIsMobile() if (!hasMedia) { + if (data.status === 'failed') { + const errorMessage = data.media?.error + return ( +
+ +
+

+ {m.media_processing_failed()} +

+

{m.media_processing_failed_desc()}

+ {errorMessage && ( +
+ {errorMessage} +
+ )} +
+
+ ) + } return (
-

Media is not available.

+

{m.media_not_available()}

) } diff --git a/packages/webui/messages/en.json b/packages/webui/messages/en.json index 70166420..d3fd8716 100644 --- a/packages/webui/messages/en.json +++ b/packages/webui/messages/en.json @@ -783,6 +783,12 @@ "failed_to_upload": "Failed to upload", "by": "by", "failed_to_upload_parenthesized": "(Failed to upload)", + "processing_failed": "Processing failed", + "processing_failed_parenthesized": "(Processing failed)", + "transcoding_failed": "Transcoding Failed", + "status_failed": "Failed", + "media_processing_failed": "Media processing failed", + "media_processing_failed_desc": "An error occurred while processing this media file. You can still download the original file.", "n_items_count": "{count} Item(s)", "name_column": "Name", "size_column": "Size", diff --git a/packages/webui/messages/zh.json b/packages/webui/messages/zh.json index e5084c7a..ffe1b9cb 100644 --- a/packages/webui/messages/zh.json +++ b/packages/webui/messages/zh.json @@ -783,6 +783,12 @@ "failed_to_upload": "上传失败", "by": "由", "failed_to_upload_parenthesized": "(上传失败)", + "processing_failed": "处理失败", + "processing_failed_parenthesized": "(处理失败)", + "transcoding_failed": "转码失败", + "status_failed": "失败", + "media_processing_failed": "媒体处理失败", + "media_processing_failed_desc": "处理此媒体文件时发生错误。您仍可以下载原始文件。", "n_items_count": "{count} 个项目", "name_column": "名称", "size_column": "大小", diff --git a/packages/workflow-core/src/activities/task.test.ts b/packages/workflow-core/src/activities/task.test.ts index 68ff685a..ca18410d 100644 --- a/packages/workflow-core/src/activities/task.test.ts +++ b/packages/workflow-core/src/activities/task.test.ts @@ -48,6 +48,72 @@ describe('Task Activities', () => { expect(updated?.status).toBe(AssetStatus.processing) }) + it('should update asset status to failed and store truncated error message in media', async () => { + const asset = await prisma.asset.create({ + data: { + name: 'test-fail.mp4', + storageKey: { create: { key: 'test-fail.mp4' } }, + status: AssetStatus.processing, + type: 'file', + media: { + original: null, + videoTranscodes: [], + imageTranscodes: [], + duration: 10, + filesize: 1000, + frames: 300, + finishedAt: '', + metadata: null, + }, + }, + }) + + const longError = 'x'.repeat(600) + await updateAssetStatusActivity({ + assetId: asset.id, + status: AssetStatus.failed, + error: longError, + }) + + const updated = await prisma.asset.findUnique({ where: { id: asset.id } }) + expect(updated?.status).toBe(AssetStatus.failed) + const media = updated?.media as PrismaJson.MediaInfo + expect(media?.error).toBe('x'.repeat(500)) + expect(media?.duration).toBe(10) + }) + + it('should NOT overwrite processed status or inject error when asset is already processed', async () => { + const asset = await prisma.asset.create({ + data: { + name: 'already-processed.mp4', + storageKey: { create: { key: 'already-processed.mp4' } }, + status: AssetStatus.processed, + type: 'file', + media: { + original: null, + videoTranscodes: [], + imageTranscodes: [], + duration: 10, + filesize: 1000, + frames: 300, + finishedAt: '2026-01-01T00:00:00Z', + metadata: null, + }, + }, + }) + + await updateAssetStatusActivity({ + assetId: asset.id, + status: AssetStatus.failed, + error: 'Some post-transcode error', + }) + + const updated = await prisma.asset.findUnique({ where: { id: asset.id } }) + expect(updated?.status).toBe(AssetStatus.processed) + const media = updated?.media as PrismaJson.MediaInfo + expect(media?.error).toBeUndefined() + }) + it('should NOT overwrite trashed status when asset is soft-deleted (isDeleted: true)', async () => { const asset = await prisma.asset.create({ data: { diff --git a/packages/workflow-core/src/activities/task.ts b/packages/workflow-core/src/activities/task.ts index 2ccd23d2..17152389 100644 --- a/packages/workflow-core/src/activities/task.ts +++ b/packages/workflow-core/src/activities/task.ts @@ -82,9 +82,34 @@ export async function updateTaskStatusActivity(params: UpdateTaskStatusParams): export interface UpdateAssetStatusParams { assetId: string status: AssetStatus + error?: string } export async function updateAssetStatusActivity(params: UpdateAssetStatusParams): Promise { + if (params.status === AssetStatus.failed) { + const asset = await prisma.asset.findUnique({ + where: { id: params.assetId }, + select: { media: true, status: true }, + }) + // Never overwrite an asset that has already completed media processing + if (asset?.status === AssetStatus.processed) { + return + } + const data: Prisma.AssetUpdateInput = { status: params.status } + if (params.error !== undefined) { + const existingMedia = (asset?.media as PrismaJson.MediaInfo | null) || {} + data.media = { + ...existingMedia, + error: params.error.slice(0, 500), + } as PrismaJson.MediaInfo + } + await prisma.asset.updateMany({ + where: { id: params.assetId, isDeleted: false, status: { not: AssetStatus.processed } }, + data, + }) + return + } + await prisma.asset.updateMany({ where: { id: params.assetId, isDeleted: false }, data: { status: params.status },