@freqhole/api-client 0.3.11 → 0.3.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@freqhole/api-client",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "type": "module",
   "repository": {
     "type": "git",

package/src/codegen/routes.ts

@@ -132,6 +132,7 @@ export const routes = {
     enqueue_bulk_enrichment: { method: 'POST', path: '/api/music/albums/enrichment/bulk', req: s.BulkEnrichmentRequestSchema, resp: s.BulkEnrichmentResponseSchema, auth: { type: 'role', role: 'admin' } as const },
     enqueue_lastfm_album_detail: { method: 'POST', path: '/api/music/albums/lastfm/enqueue', req: s.EnqueueLastFmAlbumDetailRequestSchema, resp: s.EnqueueLastFmAlbumDetailResponseSchema, auth: { type: 'role', role: 'admin' } as const },
     enqueue_mb_album_search: { method: 'POST', path: '/api/music/albums/mb-search/enqueue', req: s.EnqueueMbAlbumSearchRequestSchema, resp: s.EnqueueMbAlbumSearchResponseSchema, auth: { type: 'role', role: 'admin' } as const },
+    enqueue_repair_library_images: { method: 'POST', path: '/api/music/maintenance/repair-library-images/enqueue', req: s.EnqueueRepairLibraryImagesRequestSchema, resp: s.EnqueueRepairLibraryImagesResponseSchema, auth: { type: 'role', role: 'admin' } as const },
     entity_taxons_batch: { method: 'POST', path: '/api/music/entities/taxons', req: s.EntityTaxonsBatchRequestSchema, resp: s.EntityTaxonsBatchResponseSchema, auth: { type: 'authenticated' } as const },
     era_albums: { method: 'POST', path: '/api/music/relations/era-albums', req: s.EraAlbumsRequestSchema, resp: s.EraAlbumsResponseSchema, auth: { type: 'authenticated' } as const },
     era_bins: { method: 'POST', path: '/api/music/relations/era-bins', req: s.EraBinsRequestSchema, resp: s.EraBinsResponseSchema, auth: { type: 'authenticated' } as const },
@@ -219,9 +220,10 @@ export const routes = {
     stream_blob: { method: 'GET', path: '/api/blobs/{id}', req: null, resp: null, auth: { type: 'authenticated' } as const },
     suggestions: { method: 'POST', path: '/api/music/suggestions', req: s.SuggestionsRequestSchema, resp: s.SuggestionsResponseSchema, auth: { type: 'authenticated' } as const },
     sync_album: { method: 'POST', path: '/api/sync/album', req: s.SyncAlbumRequestSchema, resp: s.SyncAlbumResponseSchema, auth: { type: 'role', role: 'member' } as const },
+    sync_job_notify: { method: 'POST', path: '/api/sync/job-notify', req: s.SyncJobNotifySchema, resp: z.boolean(), auth: { type: 'public' } as const },
     sync_playlist: { method: 'POST', path: '/api/sync/playlist', req: s.SyncPlaylistRequestSchema, resp: s.SyncPlaylistResponseSchema, auth: { type: 'role', role: 'member' } as const },
-    sync_song_by_blake3: { method: 'POST', path: '/api/sync/song-by-blake3', req: s.SyncSongByBlake3RequestSchema, resp: s.SyncSongByBlake3ResponseSchema, auth: { type: 'role', role: 'member' } as const },
-    synced_sha256s: { method: 'GET', path: '/api/sync/sha256s', req: null, resp: z.string().array(), auth: { type: 'role', role: 'member' } as const },
+    sync_song_by_blake3: { method: 'POST', path: '/api/sync/song-by-blake3', req: s.SyncSongByBlake3RequestSchema, resp: s.SyncJobQueuedResponseSchema, auth: { type: 'role', role: 'member' } as const },
+    synced_blake3s: { method: 'GET', path: '/api/sync/blake3s', req: null, resp: z.string().array(), auth: { type: 'role', role: 'member' } as const },
     top_albums: { method: 'POST', path: '/api/analytics/top-albums', req: s.TopAlbumsRequestSchema, resp: s.TopAlbumSchema.array(), auth: { type: 'authenticated' } as const },
     top_artists: { method: 'POST', path: '/api/analytics/top-artists', req: s.TopArtistsRequestSchema, resp: s.TopArtistSchema.array(), auth: { type: 'authenticated' } as const },
     top_songs: { method: 'POST', path: '/api/analytics/top-songs', req: s.TopSongsRequestSchema, resp: s.TopSongSchema.array(), auth: { type: 'authenticated' } as const },
@@ -270,7 +272,7 @@ export const routes = {
     query_videos: { method: 'POST', path: '/api/video/videos/query', req: s.QueryVideosRequestSchema, resp: s.VideosQueryResultSchema, auth: { type: 'authenticated' } as const },
     recently_added_videos: { method: 'POST', path: '/api/video/relations/recently-added-videos', req: s.RecentlyAddedVideosRequestSchema, resp: s.RecentlyAddedVideosResponseSchema, auth: { type: 'authenticated' } as const },
     reprocess_video: { method: 'POST', path: '/api/video/videos/reprocess', req: s.ReprocessVideoRequestSchema, resp: s.ReprocessVideoResultSchema, auth: { type: 'role', role: 'admin' } as const },
-    sync_video_by_blake3: { method: 'POST', path: '/api/sync/video-by-blake3', req: s.SyncVideoByBlake3RequestSchema, resp: s.SyncVideoByBlake3ResponseSchema, auth: { type: 'role', role: 'member' } as const },
+    sync_video_by_blake3: { method: 'POST', path: '/api/sync/video-by-blake3', req: s.SyncVideoByBlake3RequestSchema, resp: s.SyncJobQueuedResponseSchema, auth: { type: 'role', role: 'member' } as const },
     unassigned_videos: { method: 'POST', path: '/api/video/relations/unassigned-videos', req: s.UnassignedVideosRequestSchema, resp: s.UnassignedVideosResponseSchema, auth: { type: 'authenticated' } as const },
     update_video_season: { method: 'POST', path: '/api/video/seasons/update', req: s.UpdateVideoSeasonRequestSchema, resp: s.VideoSeasonSchema, auth: { type: 'role', role: 'admin' } as const },
     update_video_series: { method: 'POST', path: '/api/video/series/update', req: s.UpdateVideoSeriesRequestSchema, resp: s.VideoSeriesSchema, auth: { type: 'role', role: 'admin' } as const },

package/src/codegen/schema.ts

@@ -1336,7 +1336,6 @@ export type BioSource = z.infer<typeof BioSourceSchema>;
 
 export const BlobMetadataResponseSchema = z.object({
   id: z.string(),
-  sha256: z.string(),
   size: z.number().nullish(),
   mime: z.string().nullish(),
   filename: z.string().nullish(),
@@ -1462,7 +1461,7 @@ export const CreateArtistRequestSchema = z.object({
 export type CreateArtistRequest = z.infer<typeof CreateArtistRequestSchema>;
 
 export const CreateJobRequestSchema = z.object({
-  job_type: z.union([z.literal('ScanDirectory'), z.literal('RescanDirectories'), z.literal('ProcessFile'), z.literal('ProcessDirectory'), z.literal('FetchMedia'), z.literal('PreCheckFetch'), z.literal('ConvertWebp'), z.literal('ImportMusic'), z.literal('ImportVideo'), z.literal('TranscodeVideo'), z.literal('MbAlbumSearch'), z.literal('MbAlbumDetail'), z.literal('LastFmAlbumDetail'), z.literal('LastFmArtistDetail'), z.literal('AudioDbAlbumDetail'), z.literal('AudioDbArtistDetail'), z.literal('AlbumEnrichmentPipeline'), z.literal('AutoApplyAlbumEnrichment')]),
+  job_type: z.union([z.literal('ScanDirectory'), z.literal('RescanDirectories'), z.literal('ProcessFile'), z.literal('ProcessDirectory'), z.literal('FetchMedia'), z.literal('PreCheckFetch'), z.literal('ConvertWebp'), z.literal('ImportMusic'), z.literal('ImportVideo'), z.literal('TranscodeVideo'), z.literal('MbAlbumSearch'), z.literal('MbAlbumDetail'), z.literal('LastFmAlbumDetail'), z.literal('LastFmArtistDetail'), z.literal('AudioDbAlbumDetail'), z.literal('AudioDbArtistDetail'), z.literal('AlbumEnrichmentPipeline'), z.literal('AutoApplyAlbumEnrichment'), z.literal('SyncSongByBlake3'), z.literal('SyncVideoByBlake3'), z.literal('RepairLibraryImages')]),
   session_id: z.string().nullish(),
   parameters: z.any(),
   max_retries: z.number().nullish(),
@@ -1716,6 +1715,23 @@ export const EnqueueMbAlbumSearchResponseSchema = z.object({
 });
 export type EnqueueMbAlbumSearchResponse = z.infer<typeof EnqueueMbAlbumSearchResponseSchema>;
 
+export const EnqueueRepairLibraryImagesRequestSchema = z.object({
+  dry_run: z.boolean(),
+  scan_directory: z.string().nullish(),
+  options: z.object({
+  backfill_waveforms: z.boolean(),
+  backfill_embedded_art: z.boolean(),
+  backfill_directory_art: z.boolean(),
+  remove_overapplied: z.boolean()
+})
+});
+export type EnqueueRepairLibraryImagesRequest = z.infer<typeof EnqueueRepairLibraryImagesRequestSchema>;
+
+export const EnqueueRepairLibraryImagesResponseSchema = z.object({
+  job_id: z.string()
+});
+export type EnqueueRepairLibraryImagesResponse = z.infer<typeof EnqueueRepairLibraryImagesResponseSchema>;
+
 export const EnrichmentLogEntrySchema = z.object({
   at: z.number(),
   step: z.string(),
@@ -1927,7 +1943,7 @@ export const ErrorDetailSchema = z.object({
 export type ErrorDetail = z.infer<typeof ErrorDetailSchema>;
 
 export const EventFilterSchema = z.object({
-  kinds: z.array(z.union([z.literal('ScanDirectory'), z.literal('RescanDirectories'), z.literal('ProcessFile'), z.literal('ProcessDirectory'), z.literal('FetchMedia'), z.literal('PreCheckFetch'), z.literal('ConvertWebp'), z.literal('ImportMusic'), z.literal('ImportVideo'), z.literal('TranscodeVideo'), z.literal('MbAlbumSearch'), z.literal('MbAlbumDetail'), z.literal('LastFmAlbumDetail'), z.literal('LastFmArtistDetail'), z.literal('AudioDbAlbumDetail'), z.literal('AudioDbArtistDetail'), z.literal('AlbumEnrichmentPipeline'), z.literal('AutoApplyAlbumEnrichment')])).nullish(),
+  kinds: z.array(z.union([z.literal('ScanDirectory'), z.literal('RescanDirectories'), z.literal('ProcessFile'), z.literal('ProcessDirectory'), z.literal('FetchMedia'), z.literal('PreCheckFetch'), z.literal('ConvertWebp'), z.literal('ImportMusic'), z.literal('ImportVideo'), z.literal('TranscodeVideo'), z.literal('MbAlbumSearch'), z.literal('MbAlbumDetail'), z.literal('LastFmAlbumDetail'), z.literal('LastFmArtistDetail'), z.literal('AudioDbAlbumDetail'), z.literal('AudioDbArtistDetail'), z.literal('AlbumEnrichmentPipeline'), z.literal('AutoApplyAlbumEnrichment'), z.literal('SyncSongByBlake3'), z.literal('SyncVideoByBlake3'), z.literal('RepairLibraryImages')])).nullish(),
   job_ids: z.array(z.string()).nullish(),
   session_ids: z.array(z.string()).nullish(),
   entity_refs: z.array(z.union([z.object({
@@ -2190,7 +2206,6 @@ export const FavoriteItemSchema = z.union([z.intersection(z.object({
 }).nullish(),
   media_blob: z.object({
   id: z.string(),
-  sha256: z.string(),
   size: z.number().nullish(),
   mime: z.string().nullish(),
   source_client_id: z.string().nullish(),
@@ -2582,7 +2597,6 @@ export const FavoriteSongResultSchema = z.object({
 }).nullish(),
   media_blob: z.object({
   id: z.string(),
-  sha256: z.string(),
   size: z.number().nullish(),
   mime: z.string().nullish(),
   source_client_id: z.string().nullish(),
@@ -3093,16 +3107,13 @@ export const GetVideoSeriesRequestSchema = z.object({
 export type GetVideoSeriesRequest = z.infer<typeof GetVideoSeriesRequestSchema>;
 
 export const HasBlobsRequestSchema = z.object({
-  blake3s: z.array(z.string()),
-  sha256s: z.array(z.string())
+  blake3s: z.array(z.string())
 });
 export type HasBlobsRequest = z.infer<typeof HasBlobsRequestSchema>;
 
 export const HasBlobsResponseSchema = z.object({
   blake3s_present: z.array(z.string()),
-  blake3s_missing: z.array(z.string()),
-  sha256s_present: z.array(z.string()),
-  sha256s_missing: z.array(z.string())
+  blake3s_missing: z.array(z.string())
 });
 export type HasBlobsResponse = z.infer<typeof HasBlobsResponseSchema>;
 
@@ -3131,7 +3142,7 @@ export type ImageMetadata = z.infer<typeof ImageMetadataSchema>;
 export const ImageUploadResponseSchema = z.object({
   blob_id: z.string(),
   job_id: z.string(),
-  sha256: z.string(),
+  blake3: z.string(),
   size: z.number(),
   mime: z.string(),
   existing: z.boolean(),
@@ -3170,7 +3181,7 @@ export type IngestRemoteImageRequest = z.infer<typeof IngestRemoteImageRequestSc
 
 export const IngestRemoteImageResponseSchema = z.object({
   blob_id: z.string(),
-  sha256: z.string(),
+  blake3: z.string(),
   size: z.number(),
   mime: z.string(),
   deduped: z.boolean()
@@ -3182,7 +3193,7 @@ export const JobEventSchema = z.union([z.object({
   session_id: z.string(),
   complete: z.number(),
   total: z.number(),
-  topic: z.union([z.literal('ScanDirectory'), z.literal('RescanDirectories'), z.literal('ProcessFile'), z.literal('ProcessDirectory'), z.literal('FetchMedia'), z.literal('PreCheckFetch'), z.literal('ConvertWebp'), z.literal('ImportMusic'), z.literal('ImportVideo'), z.literal('TranscodeVideo'), z.literal('MbAlbumSearch'), z.literal('MbAlbumDetail'), z.literal('LastFmAlbumDetail'), z.literal('LastFmArtistDetail'), z.literal('AudioDbAlbumDetail'), z.literal('AudioDbArtistDetail'), z.literal('AlbumEnrichmentPipeline'), z.literal('AutoApplyAlbumEnrichment')]),
+  topic: z.union([z.literal('ScanDirectory'), z.literal('RescanDirectories'), z.literal('ProcessFile'), z.literal('ProcessDirectory'), z.literal('FetchMedia'), z.literal('PreCheckFetch'), z.literal('ConvertWebp'), z.literal('ImportMusic'), z.literal('ImportVideo'), z.literal('TranscodeVideo'), z.literal('MbAlbumSearch'), z.literal('MbAlbumDetail'), z.literal('LastFmAlbumDetail'), z.literal('LastFmArtistDetail'), z.literal('AudioDbAlbumDetail'), z.literal('AudioDbArtistDetail'), z.literal('AlbumEnrichmentPipeline'), z.literal('AutoApplyAlbumEnrichment'), z.literal('SyncSongByBlake3'), z.literal('SyncVideoByBlake3'), z.literal('RepairLibraryImages')]),
   entity_ref: z.union([z.object({
   kind: z.literal('album'),
   id: z.string()
@@ -3198,7 +3209,7 @@ export const JobEventSchema = z.union([z.object({
   job_id: z.string(),
   from: z.union([z.literal('pending'), z.literal('running'), z.literal('completed'), z.literal('failed'), z.literal('cancelled')]).nullish(),
   to: z.union([z.literal('pending'), z.literal('running'), z.literal('completed'), z.literal('failed'), z.literal('cancelled')]),
-  topic: z.union([z.literal('ScanDirectory'), z.literal('RescanDirectories'), z.literal('ProcessFile'), z.literal('ProcessDirectory'), z.literal('FetchMedia'), z.literal('PreCheckFetch'), z.literal('ConvertWebp'), z.literal('ImportMusic'), z.literal('ImportVideo'), z.literal('TranscodeVideo'), z.literal('MbAlbumSearch'), z.literal('MbAlbumDetail'), z.literal('LastFmAlbumDetail'), z.literal('LastFmArtistDetail'), z.literal('AudioDbAlbumDetail'), z.literal('AudioDbArtistDetail'), z.literal('AlbumEnrichmentPipeline'), z.literal('AutoApplyAlbumEnrichment')]),
+  topic: z.union([z.literal('ScanDirectory'), z.literal('RescanDirectories'), z.literal('ProcessFile'), z.literal('ProcessDirectory'), z.literal('FetchMedia'), z.literal('PreCheckFetch'), z.literal('ConvertWebp'), z.literal('ImportMusic'), z.literal('ImportVideo'), z.literal('TranscodeVideo'), z.literal('MbAlbumSearch'), z.literal('MbAlbumDetail'), z.literal('LastFmAlbumDetail'), z.literal('LastFmArtistDetail'), z.literal('AudioDbAlbumDetail'), z.literal('AudioDbArtistDetail'), z.literal('AlbumEnrichmentPipeline'), z.literal('AutoApplyAlbumEnrichment'), z.literal('SyncSongByBlake3'), z.literal('SyncVideoByBlake3'), z.literal('RepairLibraryImages')]),
   entity_ref: z.union([z.object({
   kind: z.literal('album'),
   id: z.string()
@@ -3213,7 +3224,7 @@ export const JobEventSchema = z.union([z.object({
   job_id: z.string(),
   error_type: z.string(),
   message: z.string(),
-  topic: z.union([z.literal('ScanDirectory'), z.literal('RescanDirectories'), z.literal('ProcessFile'), z.literal('ProcessDirectory'), z.literal('FetchMedia'), z.literal('PreCheckFetch'), z.literal('ConvertWebp'), z.literal('ImportMusic'), z.literal('ImportVideo'), z.literal('TranscodeVideo'), z.literal('MbAlbumSearch'), z.literal('MbAlbumDetail'), z.literal('LastFmAlbumDetail'), z.literal('LastFmArtistDetail'), z.literal('AudioDbAlbumDetail'), z.literal('AudioDbArtistDetail'), z.literal('AlbumEnrichmentPipeline'), z.literal('AutoApplyAlbumEnrichment')]),
+  topic: z.union([z.literal('ScanDirectory'), z.literal('RescanDirectories'), z.literal('ProcessFile'), z.literal('ProcessDirectory'), z.literal('FetchMedia'), z.literal('PreCheckFetch'), z.literal('ConvertWebp'), z.literal('ImportMusic'), z.literal('ImportVideo'), z.literal('TranscodeVideo'), z.literal('MbAlbumSearch'), z.literal('MbAlbumDetail'), z.literal('LastFmAlbumDetail'), z.literal('LastFmArtistDetail'), z.literal('AudioDbAlbumDetail'), z.literal('AudioDbArtistDetail'), z.literal('AlbumEnrichmentPipeline'), z.literal('AutoApplyAlbumEnrichment'), z.literal('SyncSongByBlake3'), z.literal('SyncVideoByBlake3'), z.literal('RepairLibraryImages')]),
   entity_ref: z.union([z.object({
   kind: z.literal('album'),
   id: z.string()
@@ -3228,7 +3239,7 @@ export const JobEventSchema = z.union([z.object({
   job_id: z.string(),
   stage: z.string(),
   message: z.string().nullish(),
-  topic: z.union([z.literal('ScanDirectory'), z.literal('RescanDirectories'), z.literal('ProcessFile'), z.literal('ProcessDirectory'), z.literal('FetchMedia'), z.literal('PreCheckFetch'), z.literal('ConvertWebp'), z.literal('ImportMusic'), z.literal('ImportVideo'), z.literal('TranscodeVideo'), z.literal('MbAlbumSearch'), z.literal('MbAlbumDetail'), z.literal('LastFmAlbumDetail'), z.literal('LastFmArtistDetail'), z.literal('AudioDbAlbumDetail'), z.literal('AudioDbArtistDetail'), z.literal('AlbumEnrichmentPipeline'), z.literal('AutoApplyAlbumEnrichment')]),
+  topic: z.union([z.literal('ScanDirectory'), z.literal('RescanDirectories'), z.literal('ProcessFile'), z.literal('ProcessDirectory'), z.literal('FetchMedia'), z.literal('PreCheckFetch'), z.literal('ConvertWebp'), z.literal('ImportMusic'), z.literal('ImportVideo'), z.literal('TranscodeVideo'), z.literal('MbAlbumSearch'), z.literal('MbAlbumDetail'), z.literal('LastFmAlbumDetail'), z.literal('LastFmArtistDetail'), z.literal('AudioDbAlbumDetail'), z.literal('AudioDbArtistDetail'), z.literal('AlbumEnrichmentPipeline'), z.literal('AutoApplyAlbumEnrichment'), z.literal('SyncSongByBlake3'), z.literal('SyncVideoByBlake3'), z.literal('RepairLibraryImages')]),
   entity_ref: z.union([z.object({
   kind: z.literal('album'),
   id: z.string()
@@ -3236,11 +3247,12 @@ export const JobEventSchema = z.union([z.object({
   kind: z.literal('artist'),
   id: z.string()
 })]).nullish(),
-  created_by: z.string().nullish()
+  created_by: z.string().nullish(),
+  details: z.any().nullish()
 }), z.object({
   kind: z.literal('completed'),
   session_id: z.string(),
-  topic: z.union([z.literal('ScanDirectory'), z.literal('RescanDirectories'), z.literal('ProcessFile'), z.literal('ProcessDirectory'), z.literal('FetchMedia'), z.literal('PreCheckFetch'), z.literal('ConvertWebp'), z.literal('ImportMusic'), z.literal('ImportVideo'), z.literal('TranscodeVideo'), z.literal('MbAlbumSearch'), z.literal('MbAlbumDetail'), z.literal('LastFmAlbumDetail'), z.literal('LastFmArtistDetail'), z.literal('AudioDbAlbumDetail'), z.literal('AudioDbArtistDetail'), z.literal('AlbumEnrichmentPipeline'), z.literal('AutoApplyAlbumEnrichment')]),
+  topic: z.union([z.literal('ScanDirectory'), z.literal('RescanDirectories'), z.literal('ProcessFile'), z.literal('ProcessDirectory'), z.literal('FetchMedia'), z.literal('PreCheckFetch'), z.literal('ConvertWebp'), z.literal('ImportMusic'), z.literal('ImportVideo'), z.literal('TranscodeVideo'), z.literal('MbAlbumSearch'), z.literal('MbAlbumDetail'), z.literal('LastFmAlbumDetail'), z.literal('LastFmArtistDetail'), z.literal('AudioDbAlbumDetail'), z.literal('AudioDbArtistDetail'), z.literal('AlbumEnrichmentPipeline'), z.literal('AutoApplyAlbumEnrichment'), z.literal('SyncSongByBlake3'), z.literal('SyncVideoByBlake3'), z.literal('RepairLibraryImages')]),
   entity_ref: z.union([z.object({
   kind: z.literal('album'),
   id: z.string()
@@ -3278,7 +3290,7 @@ export type JobResponse = z.infer<typeof JobResponseSchema>;
 export const JobStateSnapshotSchema = z.object({
   job_id: z.string(),
   session_id: z.string().nullish(),
-  job_type: z.union([z.literal('ScanDirectory'), z.literal('RescanDirectories'), z.literal('ProcessFile'), z.literal('ProcessDirectory'), z.literal('FetchMedia'), z.literal('PreCheckFetch'), z.literal('ConvertWebp'), z.literal('ImportMusic'), z.literal('ImportVideo'), z.literal('TranscodeVideo'), z.literal('MbAlbumSearch'), z.literal('MbAlbumDetail'), z.literal('LastFmAlbumDetail'), z.literal('LastFmArtistDetail'), z.literal('AudioDbAlbumDetail'), z.literal('AudioDbArtistDetail'), z.literal('AlbumEnrichmentPipeline'), z.literal('AutoApplyAlbumEnrichment')]),
+  job_type: z.union([z.literal('ScanDirectory'), z.literal('RescanDirectories'), z.literal('ProcessFile'), z.literal('ProcessDirectory'), z.literal('FetchMedia'), z.literal('PreCheckFetch'), z.literal('ConvertWebp'), z.literal('ImportMusic'), z.literal('ImportVideo'), z.literal('TranscodeVideo'), z.literal('MbAlbumSearch'), z.literal('MbAlbumDetail'), z.literal('LastFmAlbumDetail'), z.literal('LastFmArtistDetail'), z.literal('AudioDbAlbumDetail'), z.literal('AudioDbArtistDetail'), z.literal('AlbumEnrichmentPipeline'), z.literal('AutoApplyAlbumEnrichment'), z.literal('SyncSongByBlake3'), z.literal('SyncVideoByBlake3'), z.literal('RepairLibraryImages')]),
   status: z.union([z.literal('pending'), z.literal('running'), z.literal('completed'), z.literal('failed'), z.literal('cancelled')]),
   entity_ref: z.union([z.object({
   kind: z.literal('album'),
@@ -3507,7 +3519,6 @@ export const ListFavoritesResponseSchema = z.object({
 }).nullish(),
   media_blob: z.object({
   id: z.string(),
-  sha256: z.string(),
   size: z.number().nullish(),
   mime: z.string().nullish(),
   source_client_id: z.string().nullish(),
@@ -4306,7 +4317,6 @@ export type MbUrl = z.infer<typeof MbUrlSchema>;
 
 export const MediaBlobSchema = z.object({
   id: z.string(),
-  sha256: z.string(),
   size: z.number().nullish(),
   mime: z.string().nullish(),
   source_client_id: z.string().nullish(),
@@ -4450,7 +4460,7 @@ export type MusicMetadataHints = z.infer<typeof MusicMetadataHintsSchema>;
 export const MusicUploadResponseSchema = z.object({
   blob_id: z.string(),
   job_id: z.string(),
-  sha256: z.string(),
+  blake3: z.string(),
   size: z.number(),
   mime: z.string(),
   existing: z.boolean(),
@@ -4893,7 +4903,6 @@ export const PlaylistSongResultSchema = z.object({
 }).nullish(),
   media_blob: z.object({
   id: z.string(),
-  sha256: z.string(),
   size: z.number().nullish(),
   mime: z.string().nullish(),
   source_client_id: z.string().nullish(),
@@ -5036,7 +5045,6 @@ export const PlaylistSongsQueryResultSchema = z.object({
 }).nullish(),
   media_blob: z.object({
   id: z.string(),
-  sha256: z.string(),
   size: z.number().nullish(),
   mime: z.string().nullish(),
   source_client_id: z.string().nullish(),
@@ -6037,6 +6045,47 @@ export const ReorderPlaylistSongsRequestSchema = z.object({
 });
 export type ReorderPlaylistSongsRequest = z.infer<typeof ReorderPlaylistSongsRequestSchema>;
 
+export const RepairLibraryImagesJobResultSchema = z.object({
+  totals: z.object({
+  songs_waveforms_backfilled: z.number(),
+  albums_thumbnails_backfilled: z.number(),
+  albums_thumbnails_removed_overapplied: z.number(),
+  albums_left_ambiguous: z.number(),
+  errors: z.array(z.object({
+  error_type: z.string(),
+  title: z.string(),
+  detail: z.string()
+}))
+}),
+  done: z.boolean(),
+  next_job_id: z.string().nullish()
+});
+export type RepairLibraryImagesJobResult = z.infer<typeof RepairLibraryImagesJobResultSchema>;
+
+export const RepairLibraryImagesOptionsSchema = z.object({
+  backfill_waveforms: z.boolean(),
+  backfill_embedded_art: z.boolean(),
+  backfill_directory_art: z.boolean(),
+  remove_overapplied: z.boolean()
+});
+export type RepairLibraryImagesOptions = z.infer<typeof RepairLibraryImagesOptionsSchema>;
+
+export const RepairLibraryImagesPhaseSchema = z.union([z.literal('Waveforms'), z.literal('Directories')]);
+export type RepairLibraryImagesPhase = z.infer<typeof RepairLibraryImagesPhaseSchema>;
+
+export const RepairLibraryImagesResultSchema = z.object({
+  songs_waveforms_backfilled: z.number(),
+  albums_thumbnails_backfilled: z.number(),
+  albums_thumbnails_removed_overapplied: z.number(),
+  albums_left_ambiguous: z.number(),
+  errors: z.array(z.object({
+  error_type: z.string(),
+  title: z.string(),
+  detail: z.string()
+}))
+});
+export type RepairLibraryImagesResult = z.infer<typeof RepairLibraryImagesResultSchema>;
+
 export const ReplaceAlbumsTagsRequestSchema = z.object({
   album_ids: z.array(z.string()),
   tag_ids: z.array(z.string())
@@ -6079,14 +6128,6 @@ export const RequeryOverrideSchema = z.object({
 });
 export type RequeryOverride = z.infer<typeof RequeryOverrideSchema>;
 
-export const RestartPolicySchema = z.object({
-  max_restarts: z.number(),
-  window_ms: z.number(),
-  initial_backoff_ms: z.number(),
-  max_backoff_ms: z.number()
-});
-export type RestartPolicy = z.infer<typeof RestartPolicySchema>;
-
 export const RevokeOwnInviteRequestSchema = z.object({
   code: z.string()
 });
@@ -6704,7 +6745,6 @@ export const SongQueryResultSchema = z.object({
 }).nullish(),
   media_blob: z.object({
   id: z.string(),
-  sha256: z.string(),
   size: z.number().nullish(),
   mime: z.string().nullish(),
   source_client_id: z.string().nullish(),
@@ -6874,7 +6914,6 @@ export const SongsQueryResultSchema = z.object({
 }).nullish(),
   media_blob: z.object({
   id: z.string(),
-  sha256: z.string(),
   size: z.number().nullish(),
   mime: z.string().nullish(),
   source_client_id: z.string().nullish(),
@@ -7015,9 +7054,8 @@ export const SyncAlbumRequestSchema = z.object({
   mb_release_id: z.string().nullish(),
   mb_release_group_id: z.string().nullish(),
   tags: z.array(z.string()),
-  images_base64: z.array(z.object({
-  content_sha256: z.string(),
-  data_base64: z.string().nullish(),
+  images: z.array(z.object({
+  blake3: z.string(),
   mime_type: z.string(),
   is_primary: z.boolean(),
   blob_type: z.string().nullish()
@@ -7032,28 +7070,52 @@ export const SyncAlbumResponseSchema = z.object({
   artist_id: z.string(),
   existing: z.boolean(),
   images_linked: z.number(),
-  missing_image_sha256s: z.array(z.string())
+  missing_image_blake3s: z.array(z.string())
 });
 export type SyncAlbumResponse = z.infer<typeof SyncAlbumResponseSchema>;
 
 export const SyncImageRefSchema = z.object({
-  content_sha256: z.string(),
-  data_base64: z.string().nullish(),
+  blake3: z.string(),
   mime_type: z.string(),
   is_primary: z.boolean(),
   blob_type: z.string().nullish()
 });
 export type SyncImageRef = z.infer<typeof SyncImageRefSchema>;
 
+export const SyncJobNotifySchema = z.object({
+  job_id: z.string(),
+  domain: z.string(),
+  blake3: z.string(),
+  title: z.string(),
+  success: z.boolean(),
+  error: z.string().nullish()
+});
+export type SyncJobNotify = z.infer<typeof SyncJobNotifySchema>;
+
+export const SyncJobQueuedResponseSchema = z.object({
+  job_id: z.string(),
+  artist_id: z.string().nullish()
+});
+export type SyncJobQueuedResponse = z.infer<typeof SyncJobQueuedResponseSchema>;
+
+export const SyncPlaylistMemberSchema = z.object({
+  kind: z.string(),
+  blake3: z.string()
+});
+export type SyncPlaylistMember = z.infer<typeof SyncPlaylistMemberSchema>;
+
 export const SyncPlaylistRequestSchema = z.object({
   source_remote_id: z.string().nullish(),
+  source_node_id: z.string().nullish(),
   remote_playlist_id: z.string(),
   title: z.string(),
   description: z.string().nullish(),
-  song_blake3s: z.array(z.string()),
+  members: z.array(z.object({
+  kind: z.string(),
+  blake3: z.string()
+})),
   images: z.array(z.object({
-  content_sha256: z.string(),
-  data_base64: z.string().nullish(),
+  blake3: z.string(),
   mime_type: z.string(),
   is_primary: z.boolean(),
   blob_type: z.string().nullish()
@@ -7064,17 +7126,17 @@ export type SyncPlaylistRequest = z.infer<typeof SyncPlaylistRequestSchema>;
 
 export const SyncPlaylistResponseSchema = z.object({
   playlist_id: z.string(),
-  songs_added: z.number(),
-  missing_song_blake3s: z.array(z.string()),
+  members_added: z.number(),
+  missing_member_blake3s: z.array(z.string()),
   song_stubs_created: z.number(),
   images_linked: z.number(),
-  missing_image_sha256s: z.array(z.string())
+  missing_image_blake3s: z.array(z.string())
 });
 export type SyncPlaylistResponse = z.infer<typeof SyncPlaylistResponseSchema>;
 
 export const SyncSongByBlake3RequestSchema = z.object({
   blake3: z.string(),
-  sha256: z.string(),
+  node_id: z.string().nullish(),
   size: z.number().nullish(),
   filename: z.string(),
   source_node_id: z.string(),
@@ -7093,15 +7155,13 @@ export const SyncSongByBlake3RequestSchema = z.object({
   metadata: z.string().nullish(),
   genre_name: z.string().nullish(),
   song_images: z.array(z.object({
-  content_sha256: z.string(),
-  data_base64: z.string().nullish(),
+  blake3: z.string(),
   mime_type: z.string(),
   is_primary: z.boolean(),
   blob_type: z.string().nullish()
 })),
   album_images: z.array(z.object({
-  content_sha256: z.string(),
-  data_base64: z.string().nullish(),
+  blake3: z.string(),
   mime_type: z.string(),
   is_primary: z.boolean(),
   blob_type: z.string().nullish()
@@ -7113,18 +7173,18 @@ export type SyncSongByBlake3Request = z.infer<typeof SyncSongByBlake3RequestSche
 export const SyncSongByBlake3ResponseSchema = z.object({
   song_id: z.string(),
   media_blob_id: z.string(),
+  artist_id: z.string(),
   file_path: z.string(),
-  sha256: z.string(),
   blake3: z.string(),
   existing: z.boolean(),
   images_linked: z.number(),
-  missing_image_sha256s: z.array(z.string())
+  missing_image_blake3s: z.array(z.string())
 });
 export type SyncSongByBlake3Response = z.infer<typeof SyncSongByBlake3ResponseSchema>;
 
 export const SyncVideoByBlake3RequestSchema = z.object({
   blake3: z.string(),
-  sha256: z.string().nullish(),
+  node_id: z.string().nullish(),
   size: z.number().nullish(),
   filename: z.string(),
   source_node_id: z.string(),
@@ -7142,22 +7202,19 @@ export const SyncVideoByBlake3RequestSchema = z.object({
   season_title: z.string().nullish(),
   parent_blake3: z.string().nullish(),
   video_images: z.array(z.object({
-  content_sha256: z.string(),
-  data_base64: z.string().nullish(),
+  blake3: z.string(),
   mime_type: z.string(),
   is_primary: z.boolean(),
   blob_type: z.string().nullish()
 })),
   series_images: z.array(z.object({
-  content_sha256: z.string(),
-  data_base64: z.string().nullish(),
+  blake3: z.string(),
   mime_type: z.string(),
   is_primary: z.boolean(),
   blob_type: z.string().nullish()
 })),
   season_images: z.array(z.object({
-  content_sha256: z.string(),
-  data_base64: z.string().nullish(),
+  blake3: z.string(),
   mime_type: z.string(),
   is_primary: z.boolean(),
   blob_type: z.string().nullish()
@@ -7174,7 +7231,7 @@ export const SyncVideoByBlake3ResponseSchema = z.object({
   season_id: z.string().nullish(),
   existing: z.boolean(),
   images_linked: z.number(),
-  missing_image_sha256s: z.array(z.string())
+  missing_image_blake3s: z.array(z.string())
 });
 export type SyncVideoByBlake3Response = z.infer<typeof SyncVideoByBlake3ResponseSchema>;
 
@@ -8075,7 +8132,7 @@ export type VideoSeriesSearchResult = z.infer<typeof VideoSeriesSearchResultSche
 export const VideoUploadResponseSchema = z.object({
   blob_id: z.string(),
   job_id: z.string(),
-  sha256: z.string(),
+  blake3: z.string(),
   size: z.number(),
   mime: z.string(),
   existing: z.boolean(),

package/src/domains/music.ts

@@ -1460,6 +1460,22 @@ export function createMusicMethods(call: CallFn) {
       );
     },
 
+    // enqueue a whole-library image repair job (admin only): backfills
+    // missing song waveforms / album thumbnails, and cleans up
+    // directory-sourced images that got over-applied across unrelated
+    // albums. returns the job id so the caller can poll status.
+    enqueueRepairLibraryImages: (params: s.EnqueueRepairLibraryImagesRequest) => {
+      return call(
+        "music",
+        "enqueue_repair_library_images",
+        routes.music.enqueue_repair_library_images.resp,
+        routes.music.enqueue_repair_library_images.req,
+        routes.music.enqueue_repair_library_images.method,
+        routes.music.enqueue_repair_library_images.path,
+        params,
+      );
+    },
+
     // download a remote image url and link it to an album or artist
     // (phase 14.6). dedups by sha256.
     ingestRemoteImage: (params: s.IngestRemoteImageRequest) => {
@@ -1779,15 +1795,15 @@ export function createMusicMethods(call: CallFn) {
       );
     },
 
-    // get the list of sha256 hashes known to this server for sync checks
-    syncedSha256s: () => {
+    // get the list of blake3 hashes known to this server for sync checks
+    syncedBlake3s: () => {
       return call(
         "music",
-        "synced_sha256s",
-        routes.music.synced_sha256s.resp,
-        routes.music.synced_sha256s.req,
-        routes.music.synced_sha256s.method,
-        routes.music.synced_sha256s.path,
+        "synced_blake3s",
+        routes.music.synced_blake3s.resp,
+        routes.music.synced_blake3s.req,
+        routes.music.synced_blake3s.method,
+        routes.music.synced_blake3s.path,
         undefined,
       );
     },