From 8c53a45a2f4ff1b386d410a94a1ad7414d574cc5 Mon Sep 17 00:00:00 2001
From: Waleed Latif <walif6@gmail.com>
Date: Thu, 7 May 2026 10:35:16 -0700
Subject: [PATCH 1/3] fix(logs): relax fileSchema so execution logs with files
 render again

---
 .../log-details/components/file-download/file-download.tsx | 7 ++++---
 apps/sim/lib/api/contracts/logs.ts                         | 4 ++--
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/apps/sim/app/workspace/[workspaceId]/logs/components/log-details/components/file-download/file-download.tsx b/apps/sim/app/workspace/[workspaceId]/logs/components/log-details/components/file-download/file-download.tsx
index 23670cf2c02..59cddecf8bf 100644
--- a/apps/sim/app/workspace/[workspaceId]/logs/components/log-details/components/file-download/file-download.tsx
+++ b/apps/sim/app/workspace/[workspaceId]/logs/components/log-details/components/file-download/file-download.tsx
@@ -5,6 +5,7 @@ import { createLogger } from '@sim/logger'
 import { ArrowDown } from 'lucide-react'
 import { useRouter } from 'next/navigation'
 import { Button, Loader } from '@/components/emcn'
+import { cn } from '@/lib/core/utils/cn'
 import { extractWorkspaceIdFromExecutionKey, getViewerUrl } from '@/lib/uploads/utils/file-utils'
 
 const logger = createLogger('FileCards')
@@ -16,8 +17,8 @@ interface FileData {
   type: string
   key: string
   url: string
-  uploadedAt: string
-  expiresAt: string
+  uploadedAt?: string
+  expiresAt?: string
   storageProvider?: 's3' | 'blob' | 'local'
   bucketName?: string
 }
@@ -220,7 +221,7 @@ export function FileDownload({
   return (
     <Button
       variant='ghost'
-      className={`h-7 px-2 text-xs ${className}`}
+      className={cn('h-7 px-2 text-xs', className)}
       onClick={handleDownload}
       disabled={isDownloading}
     >
diff --git a/apps/sim/lib/api/contracts/logs.ts b/apps/sim/lib/api/contracts/logs.ts
index 6e94720f91a..1fb9d3c777e 100644
--- a/apps/sim/lib/api/contracts/logs.ts
+++ b/apps/sim/lib/api/contracts/logs.ts
@@ -73,8 +73,8 @@ const fileSchema = z.object({
   type: z.string(),
   url: z.string(),
   key: z.string(),
-  uploadedAt: z.string(),
-  expiresAt: z.string(),
+  uploadedAt: z.string().optional(),
+  expiresAt: z.string().optional(),
   storageProvider: z.enum(['s3', 'blob', 'local']).optional(),
   bucketName: z.string().optional(),
 })

From 16ecff3237b9435e7ec507f088b999c5caad2c83 Mon Sep 17 00:00:00 2001
From: Waleed Latif <walif6@gmail.com>
Date: Thu, 7 May 2026 12:12:59 -0700
Subject: [PATCH 2/3] improvement(logs): align fileSchema with shared UserFile
 type

- contracts/logs.ts: replace local fileSchema with mediaUserFileSchema (the established UserFile boundary schema with .passthrough())
- file-download.tsx: drop local FileData interface, use UserFile from @/executor/types
---
 .../file-download/file-download.tsx           | 20 ++++---------------
 apps/sim/lib/api/contracts/logs.ts            | 16 ++-------------
 2 files changed, 6 insertions(+), 30 deletions(-)

diff --git a/apps/sim/app/workspace/[workspaceId]/logs/components/log-details/components/file-download/file-download.tsx b/apps/sim/app/workspace/[workspaceId]/logs/components/log-details/components/file-download/file-download.tsx
index 59cddecf8bf..9a2e09ce471 100644
--- a/apps/sim/app/workspace/[workspaceId]/logs/components/log-details/components/file-download/file-download.tsx
+++ b/apps/sim/app/workspace/[workspaceId]/logs/components/log-details/components/file-download/file-download.tsx
@@ -7,30 +7,18 @@ import { useRouter } from 'next/navigation'
 import { Button, Loader } from '@/components/emcn'
 import { cn } from '@/lib/core/utils/cn'
 import { extractWorkspaceIdFromExecutionKey, getViewerUrl } from '@/lib/uploads/utils/file-utils'
+import type { UserFile } from '@/executor/types'
 
 const logger = createLogger('FileCards')
 
-interface FileData {
-  id?: string
-  name: string
-  size: number
-  type: string
-  key: string
-  url: string
-  uploadedAt?: string
-  expiresAt?: string
-  storageProvider?: 's3' | 'blob' | 'local'
-  bucketName?: string
-}
-
 interface FileCardsProps {
-  files: FileData[]
+  files: UserFile[]
   isExecutionFile?: boolean
   workspaceId?: string
 }
 
 interface FileCardProps {
-  file: FileData
+  file: UserFile
   isExecutionFile?: boolean
   workspaceId?: string
 }
@@ -158,7 +146,7 @@ export function FileDownload({
   className,
   workspaceId,
 }: {
-  file: FileData
+  file: UserFile
   isExecutionFile?: boolean
   className?: string
   workspaceId?: string
diff --git a/apps/sim/lib/api/contracts/logs.ts b/apps/sim/lib/api/contracts/logs.ts
index 1fb9d3c777e..0f3cc93eaca 100644
--- a/apps/sim/lib/api/contracts/logs.ts
+++ b/apps/sim/lib/api/contracts/logs.ts
@@ -1,4 +1,5 @@
 import { z } from 'zod'
+import { mediaUserFileSchema } from '@/lib/api/contracts/tools/media/shared'
 import { defineRouteContract } from '@/lib/api/contracts/types'
 
 const comparisonOperatorSchema = z.enum(['=', '>', '<', '>=', '<=', '!='])
@@ -66,19 +67,6 @@ const workflowSummarySchema = z
   })
   .partial()
 
-const fileSchema = z.object({
-  id: z.string(),
-  name: z.string(),
-  size: z.number(),
-  type: z.string(),
-  url: z.string(),
-  key: z.string(),
-  uploadedAt: z.string().optional(),
-  expiresAt: z.string().optional(),
-  storageProvider: z.enum(['s3', 'blob', 'local']).optional(),
-  bucketName: z.string().optional(),
-})
-
 const tokenBreakdownSchema = z
   .object({
     total: z.number().optional(),
@@ -237,7 +225,7 @@ export const workflowLogSummarySchema = z.object({
 
 export const workflowLogDetailSchema = workflowLogSummarySchema.extend({
   executionData: executionDataDetailSchema,
-  files: z.array(fileSchema).nullable(),
+  files: z.array(mediaUserFileSchema).nullable(),
 })
 
 export type WorkflowLogSummary = z.output<typeof workflowLogSummarySchema>

From 409ea563ef09f49f875f6b2448a7da98da5b2372 Mon Sep 17 00:00:00 2001
From: Waleed Latif <walif6@gmail.com>
Date: Thu, 7 May 2026 12:35:43 -0700
Subject: [PATCH 3/3] improvement(contracts): promote userFileSchema to
 primitives
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Move the canonical UserFile boundary schema out of tools/media/shared.ts
(where it didn't belong — logs aren't media tools) into primitives.ts as
userFileSchema. Update logs, stt, and video contracts to import from the
shared primitive.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 apps/sim/lib/api/contracts/logs.ts            |  4 ++--
 apps/sim/lib/api/contracts/primitives.ts      | 20 +++++++++++++++++++
 .../lib/api/contracts/tools/media/shared.ts   | 13 ------------
 apps/sim/lib/api/contracts/tools/media/stt.ts |  5 +++--
 .../lib/api/contracts/tools/media/video.ts    |  5 +++--
 5 files changed, 28 insertions(+), 19 deletions(-)

diff --git a/apps/sim/lib/api/contracts/logs.ts b/apps/sim/lib/api/contracts/logs.ts
index 0f3cc93eaca..088d6044a40 100644
--- a/apps/sim/lib/api/contracts/logs.ts
+++ b/apps/sim/lib/api/contracts/logs.ts
@@ -1,5 +1,5 @@
 import { z } from 'zod'
-import { mediaUserFileSchema } from '@/lib/api/contracts/tools/media/shared'
+import { userFileSchema } from '@/lib/api/contracts/primitives'
 import { defineRouteContract } from '@/lib/api/contracts/types'
 
 const comparisonOperatorSchema = z.enum(['=', '>', '<', '>=', '<=', '!='])
@@ -225,7 +225,7 @@ export const workflowLogSummarySchema = z.object({
 
 export const workflowLogDetailSchema = workflowLogSummarySchema.extend({
   executionData: executionDataDetailSchema,
-  files: z.array(mediaUserFileSchema).nullable(),
+  files: z.array(userFileSchema).nullable(),
 })
 
 export type WorkflowLogSummary = z.output<typeof workflowLogSummarySchema>
diff --git a/apps/sim/lib/api/contracts/primitives.ts b/apps/sim/lib/api/contracts/primitives.ts
index a223c92683c..c7faa0b0d24 100644
--- a/apps/sim/lib/api/contracts/primitives.ts
+++ b/apps/sim/lib/api/contracts/primitives.ts
@@ -59,6 +59,26 @@ export const workflowIdSchema = z.string().min(1, 'Workflow ID is required')
  * Use `.optional()` / `.default(...)` at the call site, not here, so each
  * query field controls its own omission/default semantics.
  */
+/**
+ * Canonical boundary schema for `UserFile` (`apps/sim/executor/types.ts`) — the
+ * shape produced by the executor and persisted in `workflowExecutionLogs.files`,
+ * forwarded through tool inputs, and rendered in the logs UI. `.passthrough()`
+ * tolerates legacy/extra fields on stored rows (e.g. `uploadedAt`, `expiresAt`,
+ * `storageProvider`) without rejecting the whole payload.
+ */
+export const userFileSchema = z
+  .object({
+    id: z.string().optional().default(''),
+    name: z.string().min(1),
+    url: z.string().optional().default(''),
+    size: z.coerce.number().nonnegative(),
+    type: z.string().optional().default('application/octet-stream'),
+    key: z.string().min(1),
+    context: z.string().optional(),
+    base64: z.string().optional(),
+  })
+  .passthrough()
+
 export const booleanQueryFlagSchema = z.preprocess(
   (value) => {
     if (typeof value === 'boolean') return value
diff --git a/apps/sim/lib/api/contracts/tools/media/shared.ts b/apps/sim/lib/api/contracts/tools/media/shared.ts
index 36315d6936a..30f2122ce0e 100644
--- a/apps/sim/lib/api/contracts/tools/media/shared.ts
+++ b/apps/sim/lib/api/contracts/tools/media/shared.ts
@@ -3,19 +3,6 @@ import { z } from 'zod'
 export const AWS_REGION_PATTERN =
   /^(eu-isoe|us-isob|us-iso|us-gov|af|ap|ca|cn|eu|il|me|mx|sa|us)-(central|north|northeast|northwest|south|southeast|southwest|east|west)-\d{1,2}$/
 
-export const mediaUserFileSchema = z
-  .object({
-    id: z.string().optional().default(''),
-    name: z.string().min(1),
-    url: z.string().optional().default(''),
-    size: z.coerce.number().nonnegative(),
-    type: z.string().optional().default('application/octet-stream'),
-    key: z.string().min(1),
-    context: z.string().optional(),
-    base64: z.string().optional(),
-  })
-  .passthrough()
-
 export const toolJsonResponseSchema = z
   .object({
     success: z.boolean().optional(),
diff --git a/apps/sim/lib/api/contracts/tools/media/stt.ts b/apps/sim/lib/api/contracts/tools/media/stt.ts
index b7d7ad4ac32..015e3eaf4e7 100644
--- a/apps/sim/lib/api/contracts/tools/media/stt.ts
+++ b/apps/sim/lib/api/contracts/tools/media/stt.ts
@@ -1,11 +1,12 @@
 import { z } from 'zod'
-import { mediaUserFileSchema, toolJsonResponseSchema } from '@/lib/api/contracts/tools/media/shared'
+import { userFileSchema } from '@/lib/api/contracts/primitives'
+import { toolJsonResponseSchema } from '@/lib/api/contracts/tools/media/shared'
 import { defineRouteContract } from '@/lib/api/contracts/types'
 
 export const sttProviders = ['whisper', 'deepgram', 'elevenlabs', 'assemblyai', 'gemini'] as const
 const MISSING_STT_FIELDS_ERROR = 'Missing required fields: provider and apiKey'
 
-export const sttUserFileSchema = mediaUserFileSchema.extend({
+export const sttUserFileSchema = userFileSchema.extend({
   type: z.string().optional().default(''),
 })
 
diff --git a/apps/sim/lib/api/contracts/tools/media/video.ts b/apps/sim/lib/api/contracts/tools/media/video.ts
index d823285a281..edeb44e1288 100644
--- a/apps/sim/lib/api/contracts/tools/media/video.ts
+++ b/apps/sim/lib/api/contracts/tools/media/video.ts
@@ -1,5 +1,6 @@
 import { z } from 'zod'
-import { mediaUserFileSchema, toolJsonResponseSchema } from '@/lib/api/contracts/tools/media/shared'
+import { userFileSchema } from '@/lib/api/contracts/primitives'
+import { toolJsonResponseSchema } from '@/lib/api/contracts/tools/media/shared'
 import { defineRouteContract } from '@/lib/api/contracts/types'
 
 export const videoProviders = ['runway', 'veo', 'luma', 'minimax', 'falai'] as const
@@ -19,7 +20,7 @@ export const videoToolBodySchema = z
     duration: z.coerce.number().optional(),
     aspectRatio: z.string().optional(),
     resolution: z.string().optional(),
-    visualReference: mediaUserFileSchema.optional(),
+    visualReference: userFileSchema.optional(),
     cameraControl: z.unknown().optional(),
     endpoint: z.string().optional(),
     promptOptimizer: z.boolean().optional(),