@transloadit/zod 4.4.1 → 5.0.0

package/dist/v4/assemblyStatus.js

@@ -1,4 +1,6 @@
+import { optionalWithV3Semantics } from "./lib/sdkZodOptional.js";
 import { z } from 'zod/v4';
+import { errorReasonSchema } from "./errorReason.js";
 import { fileAsSchema } from "./file.js";
 import { storedAssetSchema } from "./storageAsset.js";
 export const assemblyBusyCodeSchema = z.enum([
@@ -17,6 +19,7 @@ export const assemblyStatusOkCodeSchema = z.enum([
     // 'ASSEMBLY_FILE_ACCEPTED',
     // 'ASSEMBLY_FILE_RESERVED',
 ]);
+/** Runtime and stored errors, including historical codes omitted from API2's public catalog. */
 export const assemblyStatusErrCodeSchema = z.enum([
     'ADMIN_PERMISSIONS_REQUIRED',
     'AI_CHAT_VALIDATION',
@@ -82,6 +85,7 @@ export const assemblyStatusErrCodeSchema = z.enum([
     'AZURE_IMPORT_NOT_FOUND',
     'AZURE_IMPORT_VALIDATION',
     'AZURE_STORE_ACCESS_DENIED',
+    'AZURE_STORE_NOT_FOUND',
     'AZURE_STORE_VALIDATION',
     'BACKBLAZE_IMPORT_ACCESS_DENIED',
     'BACKBLAZE_IMPORT_FAILURE',
@@ -188,6 +192,8 @@ export const assemblyStatusErrCodeSchema = z.enum([
     'HTTP_IMPORT_FAILURE',
     'HTTP_IMPORT_NOT_FOUND',
     'HTTP_IMPORT_VALIDATION',
+    'HTTP_REQUEST_FAILURE',
+    'HTTP_REQUEST_VALIDATION',
     'IMAGE_BGREMOVE_VALIDATION',
     'IMAGE_COPYRIGHT_DETECT_DECLINED_FILE',
     'IMAGE_COPYRIGHT_DETECT_VALIDATION',
@@ -285,6 +291,7 @@ export const assemblyStatusErrCodeSchema = z.enum([
     'S3_STORE_URL_VERIFICATION_FAILURE',
     'S3_STORE_VALIDATION',
     'S3_STORE_WRONG_REGION',
+    'S3_WRONG_REGION',
     'SCRIPT_RUN_VALIDATION',
     'SERVER_403',
     'SERVER_404',
@@ -299,6 +306,7 @@ export const assemblyStatusErrCodeSchema = z.enum([
     'SLOT_COUNT_ERROR',
     'SLOT_COUNT_MISSING_PARAMS',
     'SPEECH_TRANSCRIBE_VALIDATION',
+    'STORAGE_GRANT_NOT_CREATED',
     'SUPABASE_IMPORT_ACCESS_DENIED',
     'SUPABASE_IMPORT_FAILURE',
     'SUPABASE_IMPORT_NOT_FOUND',
@@ -332,6 +340,7 @@ export const assemblyStatusErrCodeSchema = z.enum([
     'TIGRIS_STORE_WRONG_REGION',
     'TMP_FILE_DOWNLOAD_ERROR',
     'TOKEN_INVALID_CREDENTIALS',
+    'TRANSIENT_STORAGE_SERVICE_ERROR',
     'TRANSLOADIT_IMPORT_ACCESS_DENIED',
     'TRANSLOADIT_IMPORT_FAILURE',
     'TRANSLOADIT_IMPORT_NOT_FOUND',
@@ -360,6 +369,7 @@ export const assemblyStatusErrCodeSchema = z.enum([
     'VIDEO_SPLIT_VALIDATION',
     'VIDEO_SUBTITLE_VALIDATION',
     'VIDEO_THUMBS_INVALID_COUNT_VALUE',
+    'VIDEO_THUMBS_INVALID_FORMAT',
     'VIDEO_THUMBS_INVALID_INPUT',
     'VIDEO_THUMBS_VALIDATION',
     'VIMEO_IMPORT_ACCESS_DENIED',
@@ -381,57 +391,59 @@ export const assemblyStatusErrCodeSchema = z.enum([
     'YOUTUBE_STORE_PROBLEM_SENDING_FILE',
     'YOUTUBE_STORE_VALIDATION',
 ]);
+const metadataTextSchema = z.union([z.string(), z.number().finite()]);
 const assemblyStatusMetaSchema = z
     .object({
-    width: z.union([z.number(), z.null()]).optional(),
-    height: z.union([z.number(), z.null()]).optional(),
-    date_file_modified: z.string().nullable().optional(),
-    aspect_ratio: z.union([z.number(), z.string(), z.null()]).optional(),
-    has_clipping_path: z.boolean().optional(),
-    frame_count: z.union([z.number(), z.null()]).optional(),
-    colorspace: z.string().nullable().optional(),
-    has_transparency: z.boolean().nullable().optional(),
-    average_color: z.string().nullable().optional(),
-    svgViewBoxWidth: z.union([z.number(), z.null()]).optional(),
-    svgViewBoxHeight: z.union([z.number(), z.null()]).optional(),
-    date_recorded: z.union([z.string(), z.number()]).nullable().optional(),
-    date_file_created: z.string().nullable().optional(),
-    title: z.union([z.string(), z.number()]).nullable().optional(),
-    description: z.string().nullable().optional(),
-    duration: z.union([z.number(), z.null()]).optional(),
-    location: z.string().nullable().optional(),
-    city: z.string().nullable().optional(),
-    state: z.string().nullable().optional(),
-    rights: z.union([z.string(), z.number()]).nullable().optional(),
-    country: z.string().nullable().optional(),
-    country_code: z.string().nullable().optional(),
-    keywords: z
-        .union([z.string(), z.array(z.union([z.string(), z.number()]))])
-        .nullable()
-        .optional(),
-    aperture: z.union([z.number(), z.null()]).optional(),
-    exposure_compensation: z.union([z.number(), z.string()]).nullable().optional(),
-    exposure_mode: z.string().nullable().optional(),
-    exposure_time: z.union([z.number(), z.string()]).nullable().optional(),
-    flash: z.string().nullable().optional(),
-    focal_length: z.string().nullable().optional(),
-    f_number: z.union([z.number(), z.null()]).optional(),
-    iso: z.union([z.number(), z.null()]).optional(),
-    light_value: z.union([z.number(), z.null()]).optional(),
-    metering_mode: z.string().nullable().optional(),
-    shutter_speed: z.union([z.number(), z.string()]).nullable().optional(),
-    white_balance: z.string().nullable().optional(),
-    device_name: z.string().nullable().optional(),
-    device_vendor: z.string().nullable().optional(),
-    device_software: z.union([z.string(), z.number()]).nullable().optional(),
-    latitude: z.union([z.number(), z.null()]).optional(),
-    longitude: z.union([z.number(), z.null()]).optional(),
-    orientation: z.union([z.string(), z.number()]).nullable().optional(),
-    creator: z.string().nullable().optional(),
-    author: z.string().nullable().optional(),
-    copyright: z
+    thumbhash: storedAssetSchema.shape.thumbhash,
+    has_alpha: storedAssetSchema.shape.has_alpha,
+    width: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    height: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    date_file_modified: optionalWithV3Semantics(z.string().nullable()),
+    aspect_ratio: optionalWithV3Semantics(z.union([z.number(), z.string(), z.null()])),
+    has_clipping_path: optionalWithV3Semantics(z.boolean()),
+    frame_count: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    colorspace: optionalWithV3Semantics(z.string().nullable()),
+    has_transparency: optionalWithV3Semantics(z.boolean().nullable()),
+    average_color: optionalWithV3Semantics(z.string().nullable()),
+    svgViewBoxWidth: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    svgViewBoxHeight: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    date_recorded: optionalWithV3Semantics(z.union([z.string(), z.number()]).nullable()),
+    date_file_created: optionalWithV3Semantics(metadataTextSchema.nullable()),
+    title: optionalWithV3Semantics(z.union([z.string(), z.number()]).nullable()),
+    description: optionalWithV3Semantics(metadataTextSchema.nullable()),
+    duration: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    location: optionalWithV3Semantics(z.string().nullable()),
+    city: optionalWithV3Semantics(z.string().nullable()),
+    state: optionalWithV3Semantics(z.string().nullable()),
+    rights: optionalWithV3Semantics(z.union([z.string(), z.number()]).nullable()),
+    country: optionalWithV3Semantics(z.string().nullable()),
+    country_code: optionalWithV3Semantics(z.string().nullable()),
+    keywords: optionalWithV3Semantics(z
+        .union([metadataTextSchema, z.array(z.union([z.string(), z.number(), z.boolean()]))])
+        .nullable()),
+    aperture: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    exposure_compensation: optionalWithV3Semantics(z.union([z.number(), z.string()]).nullable()),
+    exposure_mode: optionalWithV3Semantics(z.string().nullable()),
+    exposure_time: optionalWithV3Semantics(z.union([z.number(), z.string()]).nullable()),
+    flash: optionalWithV3Semantics(z.string().nullable()),
+    focal_length: optionalWithV3Semantics(z.string().nullable()),
+    f_number: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    iso: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    light_value: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    metering_mode: optionalWithV3Semantics(z.string().nullable()),
+    shutter_speed: optionalWithV3Semantics(z.union([z.number(), z.string()]).nullable()),
+    white_balance: optionalWithV3Semantics(z.string().nullable()),
+    device_name: optionalWithV3Semantics(metadataTextSchema.nullable()),
+    device_vendor: optionalWithV3Semantics(z.string().nullable()),
+    device_software: optionalWithV3Semantics(z.union([z.string(), z.number()]).nullable()),
+    latitude: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    longitude: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    orientation: optionalWithV3Semantics(z.union([z.string(), z.number()]).nullable()),
+    creator: optionalWithV3Semantics(z.union([metadataTextSchema, z.array(z.string())]).nullable()),
+    author: optionalWithV3Semantics(metadataTextSchema.nullable()),
+    copyright: optionalWithV3Semantics(z
         .union([
-        z.string(),
+        metadataTextSchema,
         z
             .object({
             licenses: z.array(z.unknown()),
@@ -441,15 +453,14 @@ const assemblyStatusMetaSchema = z
         })
             .catchall(z.unknown()),
     ])
-        .nullable()
-        .optional(),
-    copyright_notice: z.union([z.string(), z.number()]).nullable().optional(),
-    dominant_colors: z.array(z.string()).nullable().optional(),
-    xp_title: z.string().nullable().optional(),
-    xp_comment: z.string().nullable().optional(),
-    xp_keywords: z.string().nullable().optional(),
-    xp_subject: z.string().nullable().optional(),
-    recognized_text: z
+        .nullable()),
+    copyright_notice: optionalWithV3Semantics(z.union([z.string(), z.number()]).nullable()),
+    dominant_colors: optionalWithV3Semantics(z.array(z.string()).nullable()),
+    xp_title: optionalWithV3Semantics(metadataTextSchema.nullable()),
+    xp_comment: optionalWithV3Semantics(z.string().nullable()),
+    xp_keywords: optionalWithV3Semantics(metadataTextSchema.nullable()),
+    xp_subject: optionalWithV3Semantics(z.string().nullable()),
+    recognized_text: optionalWithV3Semantics(z
         .union([
         z.array(z.string()),
         z.array(z
@@ -458,373 +469,373 @@ const assemblyStatusMetaSchema = z
             boundingPolygon: z.array(z.object({ x: z.number(), y: z.number() })),
         })
             .catchall(z.unknown())),
-    ])
-        .optional(),
-    descriptions: z
-        .array(z.union([z.string(), z.object({ name: z.string(), confidence: z.number() }).catchall(z.unknown())]))
-        .optional(),
-    framerate: z.union([z.number(), z.null()]).optional(),
-    mean_volume: z.union([z.number(), z.null()]).optional(),
-    video_bitrate: z.union([z.number(), z.null()]).optional(),
-    overall_bitrate: z.union([z.number(), z.null()]).optional(),
-    video_codec: z.string().nullable().optional(),
-    audio_bitrate: z.union([z.number(), z.null()]).optional(),
-    audio_samplerate: z.union([z.number(), z.null()]).optional(),
-    audio_channels: z.union([z.number(), z.null()]).optional(),
-    audio_channel_layout: z.union([z.string(), z.null()]).optional(),
-    audio_sample_format: z.union([z.string(), z.null()]).optional(),
-    audio_profile: z.union([z.string(), z.null()]).optional(),
-    audio_codec: z.union([z.string(), z.null()]).optional(),
-    num_audio_streams: z.union([z.number(), z.null()]).optional(),
-    num_video_streams: z.union([z.number(), z.null()]).optional(),
-    num_subtitles: z.union([z.number(), z.null()]).optional(),
-    bit_depth: z.union([z.number(), z.null()]).optional(),
-    seekable: z.union([z.boolean(), z.null()]).optional(),
-    interlaced: z.boolean().nullable().optional(),
-    field_order: z.string().nullable().optional(),
-    interlace_detection: z
+    ])),
+    descriptions: optionalWithV3Semantics(z
+        .array(z.union([z.string(), z.object({ name: z.string(), confidence: z.number() }).catchall(z.unknown())]))),
+    framerate: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    mean_volume: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    video_bitrate: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    overall_bitrate: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    video_codec: optionalWithV3Semantics(z.string().nullable()),
+    audio_bitrate: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    audio_samplerate: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    audio_channels: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    audio_channel_layout: optionalWithV3Semantics(z.union([z.string(), z.null()])),
+    audio_sample_format: optionalWithV3Semantics(z.union([z.string(), z.null()])),
+    audio_profile: optionalWithV3Semantics(z.union([z.string(), z.null()])),
+    audio_codec: optionalWithV3Semantics(z.union([z.string(), z.null()])),
+    num_audio_streams: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    num_video_streams: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    num_subtitles: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    bit_depth: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    seekable: optionalWithV3Semantics(z.union([z.boolean(), z.null()])),
+    interlaced: optionalWithV3Semantics(z.boolean().nullable()),
+    field_order: optionalWithV3Semantics(z.string().nullable()),
+    interlace_detection: optionalWithV3Semantics(z
         .object({
-        sampled_frames: z.number().optional(),
-        tff: z.number().optional(),
-        bff: z.number().optional(),
-        progressive: z.number().optional(),
-        undetermined: z.number().optional(),
-        confidence: z.number().optional(),
-        method: z.string().optional(),
-        ffprobe_field_order: z.string().nullable().optional(),
+        sampled_frames: optionalWithV3Semantics(z.number()),
+        tff: optionalWithV3Semantics(z.number()),
+        bff: optionalWithV3Semantics(z.number()),
+        progressive: optionalWithV3Semantics(z.number()),
+        undetermined: optionalWithV3Semantics(z.number()),
+        confidence: optionalWithV3Semantics(z.number()),
+        method: optionalWithV3Semantics(z.string()),
+        ffprobe_field_order: optionalWithV3Semantics(z.string().nullable()),
     })
         .catchall(z.unknown())
-        .nullable()
-        .optional(),
-    pixel_format: z.union([z.string(), z.null()]).optional(),
-    reference_count: z.union([z.number(), z.null()]).optional(),
-    time_base: z.union([z.string(), z.null()]).optional(),
-    streams: z
+        .nullable()),
+    pixel_format: optionalWithV3Semantics(z.union([z.string(), z.null()])),
+    reference_count: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    time_base: optionalWithV3Semantics(z.union([z.string(), z.null()])),
+    streams: optionalWithV3Semantics(z
         .union([
         z.object({
-            video: z.array(z.unknown()).optional(),
-            audio: z.array(z.unknown()).optional(),
-            subtitle: z.array(z.unknown()).optional(),
+            video: optionalWithV3Semantics(z.array(z.unknown())),
+            audio: optionalWithV3Semantics(z.array(z.unknown())),
+            subtitle: optionalWithV3Semantics(z.array(z.unknown())),
         }),
         z.null(),
-    ])
-        .optional(),
-    rotation: z.union([z.number(), z.null()]).optional(),
-    album: z.string().nullable().optional(),
-    comment: z.string().nullable().optional(),
-    year: z.union([z.string(), z.number()]).nullable().optional(),
-    encoding_profile: z.string().nullable().optional(),
-    encoding_level: z.string().nullable().optional(),
-    has_artwork: z.union([z.boolean(), z.null()]).optional(),
-    has_alpha_channel: z.boolean().nullable().optional(),
-    beats_per_minute: z.union([z.number(), z.null()]).optional(),
-    genre: z.union([z.string(), z.number()]).nullable().optional(),
-    artist: z.string().nullable().optional(),
-    performer: z.string().nullable().optional(),
-    lyrics: z.string().nullable().optional(),
-    band: z.string().nullable().optional(),
-    disc: z.union([z.string(), z.number()]).nullable().optional(),
-    track: z.union([z.string(), z.number()]).nullable().optional(),
-    turbo: z.boolean().nullable().optional(),
-    encoder: z.string().nullable().optional(),
-    thumb_index: z.number().nullable().optional(),
-    thumb_offset: z
+    ])),
+    rotation: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    album: optionalWithV3Semantics(metadataTextSchema.nullable()),
+    comment: optionalWithV3Semantics(z.string().nullable()),
+    year: optionalWithV3Semantics(z.union([z.string(), z.number()]).nullable()),
+    encoding_profile: optionalWithV3Semantics(z.string().nullable()),
+    encoding_level: optionalWithV3Semantics(z.string().nullable()),
+    has_artwork: optionalWithV3Semantics(z.union([z.boolean(), z.null()])),
+    has_alpha_channel: optionalWithV3Semantics(z.boolean().nullable()),
+    beats_per_minute: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    genre: optionalWithV3Semantics(z.union([z.string(), z.number()]).nullable()),
+    artist: optionalWithV3Semantics(metadataTextSchema.nullable()),
+    performer: optionalWithV3Semantics(z.string().nullable()),
+    lyrics: optionalWithV3Semantics(z.string().nullable()),
+    band: optionalWithV3Semantics(z.string().nullable()),
+    disc: optionalWithV3Semantics(z.union([z.string(), z.number()]).nullable()),
+    track: optionalWithV3Semantics(z.union([z.string(), z.number()]).nullable()),
+    turbo: optionalWithV3Semantics(z.boolean().nullable()),
+    encoder: optionalWithV3Semantics(z.string().nullable()),
+    thumb_index: optionalWithV3Semantics(z.number().nullable()),
+    thumb_offset: optionalWithV3Semantics(z
         .preprocess((val) => (typeof val === 'string' ? Number.parseInt(val, 10) : val), z.number())
-        .nullable()
-        .optional(),
-    page_count: z.union([z.number(), z.null()]).optional(),
-    page_size: z.string().nullable().optional(),
-    producer: z.string().nullable().optional(),
-    create_date: z.string().nullable().optional(),
-    modify_date: z.union([z.string(), z.number()]).nullable().optional(),
-    colortransfer: z.string().nullable().optional(),
-    colorprimaries: z.string().nullable().optional(),
-    archive_directory: z.string().nullable().optional(),
-    relative_path: z.string().nullable().optional(),
-    segment_index: z.number().nullable().optional(),
-    starts_at: z.string().nullable().optional(),
-    ends_at: z.string().nullable().optional(),
-    resolution: z.string().nullable().optional(),
-    bandwidth: z.number().nullable().optional(),
-    closed_captions: z.boolean().nullable().optional(),
-    codecs: z.string().nullable().optional(),
-    storage_url: z.string().optional(),
-    version_id: z.string().optional(),
-    faces: z
+        .nullable()),
+    page_count: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    page_size: optionalWithV3Semantics(z.string().nullable()),
+    producer: optionalWithV3Semantics(z.string().nullable()),
+    create_date: optionalWithV3Semantics(metadataTextSchema.nullable()),
+    modify_date: optionalWithV3Semantics(z.union([z.string(), z.number()]).nullable()),
+    colortransfer: optionalWithV3Semantics(z.string().nullable()),
+    colorprimaries: optionalWithV3Semantics(z.string().nullable()),
+    archive_directory: optionalWithV3Semantics(z.string().nullable()),
+    relative_path: optionalWithV3Semantics(z.string().nullable()),
+    segment_index: optionalWithV3Semantics(z.number().nullable()),
+    starts_at: optionalWithV3Semantics(z.string().nullable()),
+    ends_at: optionalWithV3Semantics(z.string().nullable()),
+    resolution: optionalWithV3Semantics(z.string().nullable()),
+    bandwidth: optionalWithV3Semantics(z.number().nullable()),
+    closed_captions: optionalWithV3Semantics(z.boolean().nullable()),
+    codecs: optionalWithV3Semantics(z.string().nullable()),
+    storage_url: optionalWithV3Semantics(z.string()),
+    version_id: optionalWithV3Semantics(z.string()),
+    faces: optionalWithV3Semantics(z
         .array(z
         .object({
         x1: z.number(),
         y1: z.number(),
         x2: z.number(),
         y2: z.number(),
-        confidence: z.number().optional(),
+        confidence: optionalWithV3Semantics(z.number()),
         width: z.number(),
         height: z.number(),
     })
         .catchall(z.unknown()))
-        .nullable()
-        .optional(),
-    reason: z.string().optional(),
-    step: z.string().optional(),
-    previousStep: z.string().optional(),
-    exitCode: z.number().nullable().optional(),
-    exitSignal: z.string().nullable().optional(),
-    stdout: z.string().optional(),
-    stderr: z.string().optional(),
-    cmd: z.union([z.string(), z.array(z.union([z.string(), z.number()]))]).optional(),
-    worker: z.string().optional(),
-    word_count: z.union([z.number(), z.null()]).optional(),
-    character_count: z.union([z.number(), z.null()]).optional(),
-    character_count_with_spaces: z.union([z.number(), z.null()]).optional(),
-    line_count: z.union([z.number(), z.null()]).optional(),
-    paragraph_count: z.union([z.number(), z.null()]).optional(),
+        .nullable()),
+    reason: optionalWithV3Semantics(z.string()),
+    step: optionalWithV3Semantics(z.string()),
+    previousStep: optionalWithV3Semantics(z.string()),
+    exitCode: optionalWithV3Semantics(z.number().nullable()),
+    exitSignal: optionalWithV3Semantics(z.string().nullable()),
+    stdout: optionalWithV3Semantics(z.string()),
+    stderr: optionalWithV3Semantics(z.string()),
+    cmd: optionalWithV3Semantics(z.union([z.string(), z.array(z.union([z.string(), z.number()]))])),
+    worker: optionalWithV3Semantics(z.string()),
+    word_count: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    character_count: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    character_count_with_spaces: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    line_count: optionalWithV3Semantics(z.union([z.number(), z.null()])),
+    paragraph_count: optionalWithV3Semantics(z.union([z.number(), z.null()])),
 })
     .catchall(z.unknown());
 // Need to export the schema itself for assemblyStatusForTests.ts
 export { assemblyStatusMetaSchema };
 const hlsNestedMetaSchema = z.object({
-    relative_path: z.string().optional(),
-    duration: z.number().optional(),
-    width: z.number().optional(),
-    height: z.number().optional(),
-    framerate: z.number().optional(),
-    overall_bitrate: z.number().optional(),
-    aspect_ratio: z.number().optional(),
-    video_codec: z.string().optional(),
-    audio_samplerate: z.number().optional(),
-    audio_channels: z.number().optional(),
-    num_audio_streams: z.number().optional(),
-    audio_codec: z.string().optional(),
-    seekable: z.boolean().optional(),
-    date_file_modified: z.string().optional(),
-    encoding_profile: z.string().optional(),
-    encoding_level: z.string().optional(),
-    has_artwork: z.boolean().optional(),
-    has_alpha_channel: z.boolean().optional(),
-    version_id: z.string().optional(),
+    relative_path: optionalWithV3Semantics(z.string()),
+    duration: optionalWithV3Semantics(z.number()),
+    width: optionalWithV3Semantics(z.number()),
+    height: optionalWithV3Semantics(z.number()),
+    framerate: optionalWithV3Semantics(z.number()),
+    overall_bitrate: optionalWithV3Semantics(z.number()),
+    aspect_ratio: optionalWithV3Semantics(z.number()),
+    video_codec: optionalWithV3Semantics(z.string()),
+    audio_samplerate: optionalWithV3Semantics(z.number()),
+    audio_channels: optionalWithV3Semantics(z.number()),
+    num_audio_streams: optionalWithV3Semantics(z.number()),
+    audio_codec: optionalWithV3Semantics(z.string()),
+    seekable: optionalWithV3Semantics(z.boolean()),
+    date_file_modified: optionalWithV3Semantics(z.string()),
+    encoding_profile: optionalWithV3Semantics(z.string()),
+    encoding_level: optionalWithV3Semantics(z.string()),
+    has_artwork: optionalWithV3Semantics(z.boolean()),
+    has_alpha_channel: optionalWithV3Semantics(z.boolean()),
+    version_id: optionalWithV3Semantics(z.string()),
 });
 const hlsPlaylistSchema = z.object({
-    name: z.union([z.string(), z.number()]).optional(),
-    content: z.string().optional(),
-    relative_path: z.string().optional(),
-    stream: z.string().optional(),
-    meta: hlsNestedMetaSchema.optional(),
+    name: optionalWithV3Semantics(z.union([z.string(), z.number()])),
+    content: optionalWithV3Semantics(z.string()),
+    relative_path: optionalWithV3Semantics(z.string()),
+    stream: optionalWithV3Semantics(z.string()),
+    meta: optionalWithV3Semantics(hlsNestedMetaSchema),
 });
 export const assemblyStatusUploadSchema = z
     .object({
     id: z.string(),
-    asset_id: storedAssetSchema.shape.asset_id.optional(),
-    version_id: storedAssetSchema.shape.version_id.optional(),
-    workspace: storedAssetSchema.shape.workspace.optional(),
+    // Historical asset identifiers predate the canonical Storage catalog ID format.
+    asset_id: optionalWithV3Semantics(z.string()),
+    asset_version: optionalWithV3Semantics(z.number().finite()),
+    version_id: optionalWithV3Semantics(storedAssetSchema.shape.version_id),
+    workspace: optionalWithV3Semantics(storedAssetSchema.shape.workspace),
     sha256: storedAssetSchema.shape.sha256,
-    name: z.string(),
-    basename: z.string(),
+    thumbhash: storedAssetSchema.shape.thumbhash,
+    has_alpha: storedAssetSchema.shape.has_alpha,
+    name: z.string().nullable(),
+    basename: z.string().nullable(),
     ext: z.string(),
     size: z.number(),
     mime: z.string().nullable(),
     type: z.string().nullable(),
     field: z.string().nullable(),
-    md5hash: z.string().nullable(),
+    // Persisted uploads predate several fields emitted by current uploaders.
+    md5hash: optionalWithV3Semantics(z.string().nullable()),
     original_id: z.union([z.string(), z.array(z.string().nullable())]),
-    original_basename: z.string(),
-    original_name: z.string(),
-    original_path: z.string(),
-    original_md5hash: z.string().nullable(),
-    from_batch_import: z.boolean(),
-    is_tus_file: z.boolean(),
-    tus_upload_url: z.string().nullable(),
+    original_basename: optionalWithV3Semantics(z.string().nullable()),
+    original_name: optionalWithV3Semantics(z.string().nullable()),
+    original_path: optionalWithV3Semantics(z.string()),
+    original_md5hash: optionalWithV3Semantics(z.string().nullable()),
+    from_batch_import: optionalWithV3Semantics(z.boolean()),
+    is_tus_file: optionalWithV3Semantics(z.boolean()),
+    tus_upload_url: optionalWithV3Semantics(z.string().nullable()),
     url: z.string().nullable(),
-    ssl_url: z.string().nullable(),
+    ssl_url: optionalWithV3Semantics(z.string().nullable()),
     meta: assemblyStatusMetaSchema,
-    user_meta: z.record(z.string(), z.unknown()).optional(),
-    as: fileAsSchema.optional(),
-    is_temp_url: z.boolean().optional(),
-    queue: z.string().nullable().optional(),
-    queue_time: z.number().optional(),
-    exec_time: z.number().optional(),
-    import_url: z.string().optional(),
-    cost: z.union([z.number(), z.null()]).optional(),
+    user_meta: optionalWithV3Semantics(z.record(z.string(), z.unknown())),
+    as: optionalWithV3Semantics(fileAsSchema),
+    is_temp_url: optionalWithV3Semantics(z.boolean()),
+    queue: optionalWithV3Semantics(z.string().nullable()),
+    queue_time: optionalWithV3Semantics(z.number()),
+    exec_time: optionalWithV3Semantics(z.number()),
+    import_url: optionalWithV3Semantics(z.string()),
+    cost: optionalWithV3Semantics(z.union([z.number(), z.null()])),
 })
     .catchall(z.unknown());
-export const assemblyStatusUploadsSchema = z.array(assemblyStatusUploadSchema);
+// Reservations have an original ID before an upload ID or extracted metadata is available.
+const assemblyStatusIntermediateUploadSchema = assemblyStatusUploadSchema
+    .partial()
+    .extend({ id: optionalWithV3Semantics(z.never()) })
+    .required({ original_id: true });
+export const assemblyStatusUploadsSchema = z.array(z.union([assemblyStatusUploadSchema, assemblyStatusIntermediateUploadSchema]));
 export const assemblyStatusResultSchema = z
     .object({
-    id: z.string().optional(),
-    asset_id: z.string().optional(),
-    version_id: storedAssetSchema.shape.version_id.optional(),
-    workspace: storedAssetSchema.shape.workspace.optional(),
+    id: optionalWithV3Semantics(z.string()),
+    asset_id: optionalWithV3Semantics(z.string()),
+    asset_version: optionalWithV3Semantics(z.number().finite()),
+    version_id: optionalWithV3Semantics(storedAssetSchema.shape.version_id),
+    workspace: optionalWithV3Semantics(storedAssetSchema.shape.workspace),
     sha256: storedAssetSchema.shape.sha256,
-    basename: z.string().nullable().optional(),
-    field: z.string().nullable().optional(),
-    md5hash: z.string().nullable().optional(),
-    original_id: z.union([z.string(), z.array(z.string().nullable())]).optional(),
-    original_basename: z.string().nullable().optional(),
-    original_path: z.string().nullable().optional(),
-    original_md5hash: z.string().nullable().optional(),
-    from_batch_import: z.boolean().optional(),
-    is_tus_file: z.boolean().optional(),
-    tus_upload_url: z.string().nullable().optional(),
-    is_temp_url: z.boolean().optional(),
-    cost: z.number().nullable().optional(),
-    duration_human: z.string().nullable().optional(),
-    duration: z.number().nullable().optional(),
-    exec_time: z.number().nullable().optional(),
-    ext: z.string().nullable().optional(),
-    filepath: z.string().nullable().optional(),
-    path: z.string().nullable().optional(),
-    height: z.number().nullable().optional(),
-    meta: assemblyStatusMetaSchema.nullable().optional(),
-    mime: z.string().nullable().optional(),
-    name: z.string().nullable().optional(),
-    original_name: z.string().nullable().optional(),
-    preview: z.string().nullable().optional(),
-    queue_time: z.number().nullable().optional(),
-    queue: z.string().nullable().optional(),
-    size_human: z.string().nullable().optional(),
-    size: z.number().nullable().optional(),
-    ssl_url: z.string().nullable().optional(),
-    type: z.string().nullable().optional(),
-    url: z.string().nullable().optional(),
-    user_meta: z.record(z.string(), z.union([z.string(), z.number()]))
-        .nullable()
-        .optional(),
-    width: z.number().nullable().optional(),
-    as: fileAsSchema.optional(),
-    queueTime: z.number().nullable().optional(),
-    execTime: z.number().nullable().optional(),
-    import_url: z.string().optional(),
-    signed_url: z.string().optional(),
-    signed_ssl_url: z.string().optional(),
-    ios_url: z.string().optional(),
-    streaming_url: z.string().optional(),
-    remote_path: z.string().optional(),
-    playlists: z.array(hlsPlaylistSchema).optional(),
-    hls_url: z.string().optional(),
-    forcedFileExt: z.string().optional(),
+    thumbhash: storedAssetSchema.shape.thumbhash,
+    has_alpha: storedAssetSchema.shape.has_alpha,
+    basename: optionalWithV3Semantics(z.string().nullable()),
+    field: optionalWithV3Semantics(z.string().nullable()),
+    md5hash: optionalWithV3Semantics(z.string().nullable()),
+    original_id: optionalWithV3Semantics(z.union([z.string(), z.array(z.string().nullable())])),
+    original_basename: optionalWithV3Semantics(z.string().nullable()),
+    original_path: optionalWithV3Semantics(z.string().nullable()),
+    original_md5hash: optionalWithV3Semantics(z.string().nullable()),
+    from_batch_import: optionalWithV3Semantics(z.boolean()),
+    is_tus_file: optionalWithV3Semantics(z.boolean()),
+    tus_upload_url: optionalWithV3Semantics(z.string().nullable()),
+    is_temp_url: optionalWithV3Semantics(z.boolean()),
+    cost: optionalWithV3Semantics(z.number().nullable()),
+    duration_human: optionalWithV3Semantics(z.string().nullable()),
+    duration: optionalWithV3Semantics(z.number().nullable()),
+    exec_time: optionalWithV3Semantics(z.number().nullable()),
+    ext: optionalWithV3Semantics(z.string().nullable()),
+    filepath: optionalWithV3Semantics(z.string().nullable()),
+    path: optionalWithV3Semantics(z.string().nullable()),
+    height: optionalWithV3Semantics(z.number().nullable()),
+    meta: optionalWithV3Semantics(assemblyStatusMetaSchema.nullable()),
+    mime: optionalWithV3Semantics(z.string().nullable()),
+    name: optionalWithV3Semantics(z.string().nullable()),
+    original_name: optionalWithV3Semantics(z.string().nullable()),
+    preview: optionalWithV3Semantics(z.string().nullable()),
+    queue_time: optionalWithV3Semantics(z.number().nullable()),
+    queue: optionalWithV3Semantics(z.string().nullable()),
+    size_human: optionalWithV3Semantics(z.string().nullable()),
+    size: optionalWithV3Semantics(z.number().nullable()),
+    ssl_url: optionalWithV3Semantics(z.string().nullable()),
+    type: optionalWithV3Semantics(z.string().nullable()),
+    url: optionalWithV3Semantics(z.string().nullable()),
+    user_meta: optionalWithV3Semantics(z.record(z.string(), z.unknown()).nullable()),
+    width: optionalWithV3Semantics(z.number().nullable()),
+    as: optionalWithV3Semantics(fileAsSchema),
+    queueTime: optionalWithV3Semantics(z.number().nullable()),
+    execTime: optionalWithV3Semantics(z.number().nullable()),
+    import_url: optionalWithV3Semantics(z.string()),
+    signed_url: optionalWithV3Semantics(z.string()),
+    signed_ssl_url: optionalWithV3Semantics(z.string()),
+    ios_url: optionalWithV3Semantics(z.string()),
+    streaming_url: optionalWithV3Semantics(z.string()),
+    remote_path: optionalWithV3Semantics(z.string()),
+    playlists: optionalWithV3Semantics(z.array(hlsPlaylistSchema)),
+    hls_url: optionalWithV3Semantics(z.string()),
+    forcedFileExt: optionalWithV3Semantics(z.string()),
     // Robot-specific metadata added at runtime by /vimeo/import
-    vimeo: z
+    vimeo: optionalWithV3Semantics(z
         .object({
         title: z.string(),
         uri: z.string(),
-    })
-        .optional(),
+    })),
 })
     .catchall(z.unknown());
 export const assemblyStatusResultsSchema = z.record(z.string(), z.array(assemblyStatusResultSchema));
 // Define a more specific schema for debuginfo if its structure is known
 export const debugInfoSchema = z
     .object({
-    err: z.unknown().optional(), // Or a more specific error type if known
-    screenshot_ssl_url: z.string().optional(),
-    screenshot_filepath: z.string().optional(),
-    screenshot_s3_url: z.string().optional(), // Add s3 URL field
-    console_filepath: z.string().optional(),
-    console_ssl_url: z.string().optional(), // Add console SSL URL field
-    console_s3_url: z.string().optional(), // Add console s3 URL field
+    err: optionalWithV3Semantics(z.unknown()), // Or a more specific error type if known
+    screenshot_ssl_url: optionalWithV3Semantics(z.string()),
+    screenshot_filepath: optionalWithV3Semantics(z.string()),
+    screenshot_s3_url: optionalWithV3Semantics(z.string()), // Add s3 URL field
+    console_filepath: optionalWithV3Semantics(z.string()),
+    console_ssl_url: optionalWithV3Semantics(z.string()), // Add console SSL URL field
+    console_s3_url: optionalWithV3Semantics(z.string()), // Add console s3 URL field
 })
     .catchall(z.unknown());
 export const assemblyStatusBaseSchema = z.object({
-    message: z.string().optional(),
-    admin_cmd: z.unknown().optional(),
-    assemblyId: z.string().optional(),
-    assembly_id: z.string().optional(),
-    parent_id: z.string().nullable().optional(),
-    account_id: z.string().optional(),
-    account_name: z.string().nullable().optional(),
-    account_slug: z.string().nullable().optional(),
-    api_auth_key_id: z.string().nullable().optional(),
-    template_id: z.string().nullable().optional(),
-    template_name: z.string().nullable().optional(),
-    instance: z.string().optional(),
-    region: z.string().optional(),
-    assembly_url: z.string().optional(),
-    assembly_ssl_url: z.string().optional(),
-    uppyserver_url: z.string().optional(),
-    companion_url: z.string().optional(),
-    websocket_url: z.string().optional(),
-    update_stream_url: z.string().optional(),
-    tus_url: z.string().optional(),
-    bytes_received: z.number().optional(),
-    bytes_expected: z.number().optional(),
-    upload_duration: z.number().optional(),
-    client_agent: z.string().nullable().optional(),
-    client_ip: z.string().nullable().optional(),
-    client_referer: z.string().nullable().optional(),
-    transloadit_client: z.string().nullable().optional(),
-    start_date: z.string().optional(),
-    upload_meta_data_extracted: z.boolean().optional(),
-    warnings: z
+    message: optionalWithV3Semantics(z.string()),
+    admin_cmd: optionalWithV3Semantics(z.unknown()),
+    assemblyId: optionalWithV3Semantics(z.string()),
+    assembly_id: optionalWithV3Semantics(z.string()),
+    parent_id: optionalWithV3Semantics(z.string().nullable()),
+    account_id: optionalWithV3Semantics(z.string().nullable()),
+    account_name: optionalWithV3Semantics(z.string().nullable()),
+    account_slug: optionalWithV3Semantics(z.string().nullable()),
+    api_auth_key_id: optionalWithV3Semantics(z.string().nullable()),
+    template_id: optionalWithV3Semantics(z.string().nullable()),
+    template_name: optionalWithV3Semantics(z.string().nullable()),
+    instance: optionalWithV3Semantics(z.string().nullable()),
+    region: optionalWithV3Semantics(z.string()),
+    assembly_url: optionalWithV3Semantics(z.string().nullable()),
+    assembly_ssl_url: optionalWithV3Semantics(z.string().nullable()),
+    uppyserver_url: optionalWithV3Semantics(z.string().nullable()),
+    companion_url: optionalWithV3Semantics(z.string().nullable()),
+    websocket_url: optionalWithV3Semantics(z.string().nullable()),
+    update_stream_url: optionalWithV3Semantics(z.string().nullable()),
+    tus_url: optionalWithV3Semantics(z.string()),
+    bytes_received: optionalWithV3Semantics(z.number()),
+    bytes_expected: optionalWithV3Semantics(z.number()),
+    upload_duration: optionalWithV3Semantics(z.number()),
+    client_agent: optionalWithV3Semantics(z.string().nullable()),
+    client_ip: optionalWithV3Semantics(z.string().nullable()),
+    client_referer: optionalWithV3Semantics(z.string().nullable()),
+    transloadit_client: optionalWithV3Semantics(z.string().nullable()),
+    start_date: optionalWithV3Semantics(z.string()),
+    upload_meta_data_extracted: optionalWithV3Semantics(z.boolean()),
+    warnings: optionalWithV3Semantics(z
         .array(z
         .object({ level: z.literal('notice').or(z.literal('warning')), msg: z.string() })
-        .catchall(z.unknown()))
-        .optional(),
-    is_infinite: z.boolean().optional(),
-    error: z.undefined().optional(),
-    has_dupe_jobs: z.boolean().optional(),
-    execution_start: z.string().nullable().optional(),
-    execution_duration: z.number().nullable().optional(),
-    queue_duration: z.number().optional(),
-    jobs_queue_duration: z.number().optional(),
-    notify_start: z.string().nullable().optional(),
-    notify_url: z.string().nullable().optional(),
-    notify_status: z.string().nullable().optional(),
-    notify_response_code: z.number().nullable().optional(),
-    notify_response_data: z.string().nullable().optional(),
-    notify_error: z.string().nullable().optional(),
-    notify_duration: z.number().nullable().optional(),
-    last_job_completed: z.string().nullable().optional(),
-    fields: z.record(z.string(), z.unknown()).optional(),
-    running_jobs: z.array(z.string()).optional(),
-    bytes_usage: z.number().optional(),
-    usage_tags: z.string().optional(),
-    executing_jobs: z.array(z.string()).optional(),
-    started_jobs: z.array(z.string()).optional(),
-    parent_assembly_status: z.unknown().nullable().optional(),
-    params: z.string().nullable().optional(),
-    template: z.string().nullable().optional(),
-    merged_params: z.string().nullable().optional(),
-    num_input_files: z.number().optional(),
-    uploads: assemblyStatusUploadsSchema.optional(),
-    results: assemblyStatusResultsSchema.optional(),
-    build_id: z.string().optional(),
-    expected_tus_uploads: z.number().optional(),
-    started_tus_uploads: z.number().optional(),
-    finished_tus_uploads: z.number().optional(),
-    virusname: z.string().optional(),
-    tus_uploads: z
+        .catchall(z.unknown()))),
+    is_infinite: optionalWithV3Semantics(z.boolean()),
+    error: optionalWithV3Semantics(z.undefined()),
+    has_dupe_jobs: optionalWithV3Semantics(z.boolean()),
+    execution_start: optionalWithV3Semantics(z.string().nullable()),
+    execution_duration: optionalWithV3Semantics(z.number().nullable()),
+    queue_duration: optionalWithV3Semantics(z.number()),
+    jobs_queue_duration: optionalWithV3Semantics(z.number()),
+    notify_start: optionalWithV3Semantics(z.string().nullable()),
+    notify_url: optionalWithV3Semantics(z.string().nullable()),
+    notify_status: optionalWithV3Semantics(z.string().nullable()),
+    notify_response_code: optionalWithV3Semantics(z.number().nullable()),
+    notify_response_data: optionalWithV3Semantics(z.string().nullable()),
+    notify_error: optionalWithV3Semantics(z.string().nullable()),
+    notify_duration: optionalWithV3Semantics(z.number().nullable()),
+    last_job_completed: optionalWithV3Semantics(z.string().nullable()),
+    fields: optionalWithV3Semantics(z.record(z.string(), z.unknown())),
+    running_jobs: optionalWithV3Semantics(z.array(z.string())),
+    bytes_usage: optionalWithV3Semantics(z.number().nullable()),
+    usage_tags: optionalWithV3Semantics(z.string()),
+    executing_jobs: optionalWithV3Semantics(z.array(z.string())),
+    started_jobs: optionalWithV3Semantics(z.array(z.string())),
+    parent_assembly_status: optionalWithV3Semantics(z.unknown().nullable()),
+    params: optionalWithV3Semantics(z.string().nullable()),
+    template: optionalWithV3Semantics(z.string().nullable()),
+    merged_params: optionalWithV3Semantics(z.string().nullable()),
+    num_input_files: optionalWithV3Semantics(z.number()),
+    uploads: optionalWithV3Semantics(assemblyStatusUploadsSchema),
+    results: optionalWithV3Semantics(assemblyStatusResultsSchema),
+    build_id: optionalWithV3Semantics(z.string()),
+    expected_tus_uploads: optionalWithV3Semantics(z.number()),
+    started_tus_uploads: optionalWithV3Semantics(z.number()),
+    finished_tus_uploads: optionalWithV3Semantics(z.number()),
+    virusname: optionalWithV3Semantics(z.string()),
+    tus_uploads: optionalWithV3Semantics(z
         .array(z
         .object({
         filename: z.string(),
         fieldname: z.string(),
-        user_meta: z.record(z.string(), z.unknown()).optional(),
+        user_meta: optionalWithV3Semantics(z.record(z.string(), z.unknown())),
         size: z.number(),
         offset: z.number(),
         finished: z.boolean(),
         upload_url: z.string(),
-        local_path: z.string().optional(),
+        local_path: optionalWithV3Semantics(z.string()),
     })
-        .catchall(z.unknown()))
-        .optional(),
-    debuginfo: debugInfoSchema.optional(),
-    step: z.string().optional(),
-    previousStep: z.string().optional(),
-    worker: z.string().optional(),
-    info: z
+        .catchall(z.unknown()))),
+    debuginfo: optionalWithV3Semantics(debugInfoSchema),
+    step: optionalWithV3Semantics(z.string()),
+    previousStep: optionalWithV3Semantics(z.string()),
+    worker: optionalWithV3Semantics(z.string()),
+    info: optionalWithV3Semantics(z
         .object({
-        retryIn: z.number().optional(),
-    })
-        .optional(),
-    ignored_errors: z
+        retryIn: optionalWithV3Semantics(z.number()),
+    })),
+    ignored_errors: optionalWithV3Semantics(z
         .array(z
         .object({
-        step: z.string().optional(),
-        phase: z.string(),
-        error: z.string(),
-        message: z.string(),
+        step: optionalWithV3Semantics(z.string().nullable()),
+        phase: optionalWithV3Semantics(z.string()),
+        error: optionalWithV3Semantics(z.unknown()),
+        message: optionalWithV3Semantics(z.string()),
     })
-        .catchall(z.unknown()))
-        .optional(),
-    ignored_error_count: z.number().optional(),
+        .catchall(z.unknown()))),
+    ignored_error_count: optionalWithV3Semantics(z.number()),
 });
 export const assemblyStatusBusySchema = z
     .object({
@@ -840,34 +851,34 @@ export const assemblyStatusOkSchema = assemblyStatusBaseSchema
     ok: assemblyStatusOkCodeSchema,
 })
     .catchall(z.unknown());
-export const assemblyStatusErrSchema = assemblyStatusBaseSchema
-    .extend({
+const assemblyStatusErrorFields = z.object({
     error: assemblyStatusErrCodeSchema,
-    ok: z.null().optional(),
-    retries: z.number().optional(),
-    numRetries: z.number().optional(),
-    reason: z.string().optional(),
-    step: z.string().optional(),
-    previousStep: z.string().optional(),
-    file: z.string().optional(),
-    name: z.string().optional(),
-    path: z.string().optional(),
-    exitCode: z.number().nullable().optional(),
-    exitSignal: z.string().nullable().optional(),
-    stdout: z.string().optional(),
-    stderr: z.string().optional(),
-    cmd: z.union([z.string(), z.array(z.union([z.string(), z.number()]))]).optional(),
-    admin_cmd: z.union([z.string(), z.array(z.union([z.string(), z.number()]))]).optional(),
-    is_private_address: z.boolean().optional(),
-    playwright_error_code: z.string().optional(),
-    url: z.string().optional(),
-    url_host: z.string().nullable().optional(),
-    worker: z.string().optional(),
-    headers: z.record(z.string(), z.unknown()).optional(),
-    retryable: z.boolean().optional(),
-    err: z.unknown().optional(),
-})
-    .catchall(z.unknown());
+    ok: optionalWithV3Semantics(z.null()),
+    retries: optionalWithV3Semantics(z.number()),
+    numRetries: optionalWithV3Semantics(z.number()),
+    reason: optionalWithV3Semantics(errorReasonSchema),
+    step: optionalWithV3Semantics(z.string()),
+    previousStep: optionalWithV3Semantics(z.string()),
+    file: optionalWithV3Semantics(z.string()),
+    name: optionalWithV3Semantics(z.string()),
+    path: optionalWithV3Semantics(z.string()),
+    exitCode: optionalWithV3Semantics(z.number().nullable()),
+    exitSignal: optionalWithV3Semantics(z.string().nullable()),
+    stdout: optionalWithV3Semantics(z.string()),
+    stderr: optionalWithV3Semantics(z.string()),
+    cmd: optionalWithV3Semantics(z.union([z.string(), z.array(z.union([z.string(), z.number()]))])),
+    admin_cmd: optionalWithV3Semantics(z.union([z.string(), z.array(z.union([z.string(), z.number()]))])),
+    is_private_address: optionalWithV3Semantics(z.boolean()),
+    playwright_error_code: optionalWithV3Semantics(z.string()),
+    url: optionalWithV3Semantics(z.string()),
+    url_host: optionalWithV3Semantics(z.string().nullable()),
+    worker: optionalWithV3Semantics(z.string()),
+    headers: optionalWithV3Semantics(z.record(z.string(), z.unknown())),
+    retryable: optionalWithV3Semantics(z.boolean()),
+    response_code: optionalWithV3Semantics(z.number().finite().nullable()),
+    err: optionalWithV3Semantics(z.unknown()),
+});
+export const assemblyStatusErrSchema = assemblyStatusBaseSchema.extend(assemblyStatusErrorFields.shape).catchall(z.unknown());
 // Represents a low-level system error not mapped to standard assembly errors.
 // Happened in Assemblies:
 // - 13ca71f3b8714859b48ec11e49be10f1
@@ -877,17 +888,14 @@ export const assemblyStatusErrSchema = assemblyStatusBaseSchema
 // - dfa372cef24a420092f1be42af6d1df1
 // - e975612bc76e4738b759d1b36bc527f1
 // All for Workspace: 6f86325febd14de4bfb38cbd04ee1f39
-export const assemblyStatusSysErrSchema = assemblyStatusBaseSchema
-    .extend({
-    // Changed from .object()
-    // No 'ok' or 'error' discriminator
+const assemblyStatusSysErrFields = z.object({
+    // No 'ok' or 'error' discriminator.
     errno: z.number(),
     code: z.string(),
     syscall: z.string(),
-    path: z.string().optional(), // Path might be present
-    // Consider adding other potential sys error fields if observed later
-})
-    .catchall(z.unknown());
+    path: optionalWithV3Semantics(z.string()),
+});
+export const assemblyStatusSysErrSchema = assemblyStatusBaseSchema.extend(assemblyStatusSysErrFields.shape).catchall(z.unknown());
 // Final schema defined lazily to handle recursion
 // We break up inference to avoid:
 // error TS7056: The inferred type of this node exceeds the maximum length the compiler will serialize. An explicit type annotation is needed.
@@ -1017,27 +1025,27 @@ export function hasOkPartial(assembly) {
 export const assemblyIndexItemSchema = z
     .object({
     id: z.string(), // Likely always present for a list item
-    parent_id: assemblyStatusBaseSchema.shape.parent_id.optional(),
-    account_id: assemblyStatusBaseSchema.shape.account_id.unwrap().optional(),
-    template_id: assemblyStatusBaseSchema.shape.template_id.optional(),
-    instance: assemblyStatusBaseSchema.shape.instance.unwrap().optional(),
-    notify_url: assemblyStatusBaseSchema.shape.notify_url.optional(),
-    redirect_url: z.string().nullable().optional(),
-    files: z.string().nullable().optional(), // JSON stringified list metadata; replay rows omit it
-    warning_count: z.number().optional(),
-    execution_duration: assemblyStatusBaseSchema.shape.execution_duration.optional(),
-    execution_start: assemblyStatusBaseSchema.shape.execution_start.optional(),
-    region: assemblyStatusBaseSchema.shape.region.optional(),
-    num_input_files: assemblyStatusBaseSchema.shape.num_input_files.optional(),
-    bytes_usage: assemblyStatusBaseSchema.shape.bytes_usage.optional(),
-    bytes_expected: assemblyStatusBaseSchema.shape.bytes_expected.optional(),
-    bytes_received: assemblyStatusBaseSchema.shape.bytes_received.optional(),
-    upload_duration: assemblyStatusBaseSchema.shape.upload_duration.optional(),
-    ok: assemblyStatusOkCodeSchema.nullable().optional(),
-    error: assemblyStatusErrCodeSchema.nullable().optional(),
+    parent_id: optionalWithV3Semantics(assemblyStatusBaseSchema.shape.parent_id),
+    account_id: optionalWithV3Semantics(assemblyStatusBaseSchema.shape.account_id.unwrap()),
+    template_id: optionalWithV3Semantics(assemblyStatusBaseSchema.shape.template_id),
+    instance: optionalWithV3Semantics(assemblyStatusBaseSchema.shape.instance.unwrap()),
+    notify_url: optionalWithV3Semantics(assemblyStatusBaseSchema.shape.notify_url),
+    redirect_url: optionalWithV3Semantics(z.string().nullable()),
+    files: optionalWithV3Semantics(z.string().nullable()), // JSON stringified list metadata; replay rows omit it
+    warning_count: optionalWithV3Semantics(z.number()),
+    execution_duration: optionalWithV3Semantics(assemblyStatusBaseSchema.shape.execution_duration),
+    execution_start: optionalWithV3Semantics(assemblyStatusBaseSchema.shape.execution_start),
+    region: optionalWithV3Semantics(assemblyStatusBaseSchema.shape.region),
+    num_input_files: optionalWithV3Semantics(assemblyStatusBaseSchema.shape.num_input_files),
+    bytes_usage: optionalWithV3Semantics(assemblyStatusBaseSchema.shape.bytes_usage),
+    bytes_expected: optionalWithV3Semantics(assemblyStatusBaseSchema.shape.bytes_expected),
+    bytes_received: optionalWithV3Semantics(assemblyStatusBaseSchema.shape.bytes_received),
+    upload_duration: optionalWithV3Semantics(assemblyStatusBaseSchema.shape.upload_duration),
+    ok: optionalWithV3Semantics(assemblyStatusOkCodeSchema.nullable()),
+    error: optionalWithV3Semantics(assemblyStatusErrCodeSchema.nullable()),
     created: z.string(),
-    created_ts: z.number().optional(),
-    template_name: z.string().nullable().optional(),
+    created_ts: optionalWithV3Semantics(z.number()),
+    template_name: optionalWithV3Semantics(z.string().nullable()),
 })
     .catchall(z.unknown());
 export const assemblyIndexSchema = z.array(assemblyIndexItemSchema);