improvement(contracts): promote userFileSchema to primitives

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>

Author: waleedlatif1

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>

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

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(),

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(''),
 })
 

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(),