monkvision · dlymonkai · Apr 7, 2025
diff --git a/documentation/src/utils/schemas.ts b/documentation/src/utils/schemas.ts
@@ -200,11 +200,18 @@ export const CreatePricingTaskOptionsSchema = z.object({
   methodology: z.string().optional(),
 });
 
+export const CreateWheelAnalysisTaskOptionsSchema = z.object({
+  name: z.literal(TaskName.WHEEL_ANALYSIS),
+  useLongShots: z.boolean(),
+  callbacks: z.array(TaskCallbackOptionsSchema).optional(),
+});
+
 export const InspectionCreateTaskSchema = z
   .nativeEnum(TaskName)
   .or(CreateDamageDetectionTaskOptionsSchema)
   .or(CreateHinlTaskOptionsSchema)
-  .or(CreatePricingTaskOptionsSchema);
+  .or(CreatePricingTaskOptionsSchema)
+  .or(CreateWheelAnalysisTaskOptionsSchema);
 
 export const AdditionalDataSchema = z.record(z.string(), z.unknown());
 

diff --git a/documentation/src/utils/schemas/createInspection.schema.ts b/documentation/src/utils/schemas/createInspection.schema.ts
@@ -28,11 +28,18 @@ export const CreatePricingTaskOptionsSchema = z.object({
   methodology: z.string().optional(),
 });
 
+export const CreateWheelAnalysisTaskOptionsSchema = z.object({
+  name: z.literal(TaskName.WHEEL_ANALYSIS),
+  useLongShots: z.boolean(),
+  callbacks: z.array(TaskCallbackOptionsSchema).optional(),
+});
+
 export const InspectionCreateTaskSchema = z
   .nativeEnum(TaskName)
   .or(CreateDamageDetectionTaskOptionsSchema)
   .or(CreateHinlTaskOptionsSchema)
-  .or(CreatePricingTaskOptionsSchema);
+  .or(CreatePricingTaskOptionsSchema)
+  .or(CreateWheelAnalysisTaskOptionsSchema);
 
 export const AdditionalDataSchema = z.record(z.string(), z.unknown());
 

diff --git a/packages/inspection-capture-web/src/hooks/useUploadQueue.ts b/packages/inspection-capture-web/src/hooks/useUploadQueue.ts
@@ -1,4 +1,4 @@
-import { Queue, uniq, useQueue } from '@monkvision/common';
+import { Queue, uniq, useMonkState, useQueue } from '@monkvision/common';
 import { AddImageOptions, ImageUploadType, MonkApiConfig, useMonkApi } from '@monkvision/network';
 import {
   PhotoCaptureAppConfig,
@@ -133,6 +133,7 @@ function createAddImageOptions(
   enableThumbnail: boolean,
   additionalTasks?: PhotoCaptureAppConfig['additionalTasks'],
   compliance?: ComplianceOptions,
+  wheelAnalysisCloseUp?: boolean,
 ): AddImageOptions {
   if (upload.mode === CaptureMode.SIGHT) {
     return {
@@ -143,6 +144,7 @@ function createAddImageOptions(
       inspectionId,
       compliance,
       useThumbnailCaching: enableThumbnail,
+      wheelAnalysisCloseUp,
     };
   }
   if (upload.mode === CaptureMode.ADD_DAMAGE_PART_SELECT_SHOT) {
@@ -179,6 +181,11 @@ export function useUploadQueue({
   const { handleError } = useMonitoring();
   const siblingIdRef = useRef(0);
   const { addImage } = useMonkApi(apiConfig);
+  const { state } = useMonkState();
+
+  const wheelAnalysisCloseUp = state.tasks.find(
+    (task) => task.name === TaskName.WHEEL_ANALYSIS && task.wheelAnalysisCloseUp,
+  )?.wheelAnalysisCloseUp;
 
   return useQueue<PictureUpload>(async (upload: PictureUpload) => {
     if (upload.mode === CaptureMode.ADD_DAMAGE_1ST_SHOT) {
@@ -194,6 +201,7 @@ export function useUploadQueue({
           true,
           additionalTasks,
           complianceOptions,
+          wheelAnalysisCloseUp,
         ),
       );
       const uploadDurationMs = Date.now() - startTs;

diff --git a/packages/network/src/api/image/requests.ts b/packages/network/src/api/image/requests.ts
@@ -86,6 +86,8 @@ export interface AddBeautyShotImageOptions {
    * Additional options used to configure the compliance locally.
    */
   compliance?: ComplianceOptions;
+
+  wheelAnalysisCloseUp?: boolean;
 }
 
 /**
@@ -291,6 +293,7 @@ function createBeautyShotImageData(
         TaskName.IMAGES_OCR,
         TaskName.ODOMETER,
         TaskName.WARNING_LIGHTS,
+        TaskName.WHEEL_ANALYSIS,
       ].includes(task),
   ) as ApiImagePostTask[];
   tasks.push({
@@ -323,6 +326,25 @@ function createBeautyShotImageData(
       wait_for_result: true,
     });
   }
+  if (options.tasks.includes(TaskName.WHEEL_ANALYSIS)) {
+    const sightName = sights[options.sightId].wheelName;
+    if (options.wheelAnalysisCloseUp && !sightName) {
+      throw new Error('Wheel analysis task close-up requires a sight name.');
+    }
+    if (!options.wheelAnalysisCloseUp && sightName) {
+      throw new Error(
+        "Wheel analysis task long shoot can't be run on sight that contains sightName.",
+      );
+    }
+    if (options.wheelAnalysisCloseUp && sightName) {
+      tasks.push({
+        name: TaskName.WHEEL_ANALYSIS,
+        image_details: { wheel_name: sightName },
+      });
+    } else {
+      tasks.push(TaskName.WHEEL_ANALYSIS);
+    }
+  }
 
   const body: ApiImagePost = {
     acquisition: {

diff --git a/packages/network/src/api/inspection/mappers.ts b/packages/network/src/api/inspection/mappers.ts
@@ -5,6 +5,7 @@ import {
   CreateHinlTaskOptions,
   CreateInspectionOptions,
   CreatePricingTaskOptions,
+  CreateWheelAnalysisTaskOptions,
   CurrencyCode,
   CustomSeverityValue,
   Damage,
@@ -326,6 +327,11 @@ function mapTasks(response: ApiInspectionGet): { tasks: Task[]; taskIds: string[
       name: task.name as TaskName,
       status: task.status as ProgressStatus,
       images: task.images?.map((image) => image.image_id) ?? [],
+      ...(task.arguments?.['use_longshots'] !== undefined
+        ? {
+            wheelAnalysisCloseUp: !task.arguments['use_longshots'] as boolean,
+          }
+        : {}),
     });
   });
 
@@ -563,10 +569,20 @@ function getDamageDetectionOptions(
 function getWheelAnalysisOptions(
   options: CreateInspectionOptions,
 ): ApiWheelAnalysisTaskPostComponent | undefined {
-  return options.tasks.includes(TaskName.WHEEL_ANALYSIS)
+  if (options.tasks.includes(TaskName.WHEEL_ANALYSIS)) {
+    return {
+      status: ProgressStatus.NOT_STARTED,
+      use_longshots: true,
+    };
+  }
+  const taskOptions = options.tasks.find(
+    (task) => typeof task === 'object' && task.name === TaskName.WHEEL_ANALYSIS,
+  ) as CreateWheelAnalysisTaskOptions | undefined;
+  return taskOptions
     ? {
         status: ProgressStatus.NOT_STARTED,
-        use_longshots: true,
+        use_longshots: taskOptions.useLongShots,
+        callbacks: taskOptions.callbacks,
       }
     : undefined;
 }

diff --git a/packages/network/src/api/models/image.ts b/packages/network/src/api/models/image.ts
@@ -10,6 +10,7 @@ import {
   ApiImagesOCRTaskPost,
   ApiImagesOdometerTaskPost,
   ApiImagesWarningLightsTaskPost,
+  ApiImagesWheelAnalysisTaskPost,
 } from './task';
 
 export type ApiImageType = 'unknown' | 'beauty_shot' | 'close_up';
@@ -111,7 +112,8 @@ export type ApiImagePostTask =
   | ApiHinlTaskPost
   | ApiImagesOCRTaskPost
   | ApiImagesOdometerTaskPost
-  | ApiImagesWarningLightsTaskPost;
+  | ApiImagesWarningLightsTaskPost
+  | ApiImagesWheelAnalysisTaskPost;
 
 export interface ApiImagePost {
   acquisition: ApiAcquisition;

diff --git a/packages/network/src/api/models/task.ts b/packages/network/src/api/models/task.ts
@@ -1,4 +1,5 @@
 import { ApiPricingMethodology } from './pricingV2';
+import { ApiWheelType } from './wheelAnalysis';
 
 export interface ApiImageInTask {
   image_id: string;
@@ -57,6 +58,15 @@ export interface ApiImagesWarningLightsTaskPost {
   wait_for_result?: boolean;
 }
 
+export interface ApiWheelAnalysisImageDetails {
+  wheel_name: ApiWheelType;
+}
+
+export interface ApiImagesWheelAnalysisTaskPost {
+  name: 'wheel_analysis';
+  image_details: ApiWheelAnalysisImageDetails;
+}
+
 export type ApiTaskProgressStatus =
   | 'NOT_STARTED'
   | 'TODO'
@@ -71,6 +81,7 @@ export interface ApiTaskGet {
   images: ApiImageInTask[];
   name: ApiBusinessTaskName;
   status: ApiTaskProgressStatus;
+  arguments?: Record<string, unknown>;
 }
 
 export type ApiTasks = ApiTaskGet[];

diff --git a/packages/network/test/api/image/requests.test.ts b/packages/network/test/api/image/requests.test.ts
@@ -306,6 +306,7 @@ describe('Image requests', () => {
                 TaskName.IMAGES_OCR,
                 TaskName.ODOMETER,
                 TaskName.WARNING_LIGHTS,
+                TaskName.WHEEL_ANALYSIS,
               ].includes(task),
           ),
           {
@@ -328,6 +329,7 @@ describe('Image requests', () => {
             name: TaskName.WARNING_LIGHTS,
             wait_for_result: true,
           },
+          TaskName.WHEEL_ANALYSIS,
         ],
         additional_data: {
           sight_id: options.sightId,

diff --git a/packages/network/test/api/inspection/data/apiInspectionGet.data.ts b/packages/network/test/api/inspection/data/apiInspectionGet.data.ts
@@ -946,6 +946,7 @@ export default {
       name: 'wheel_analysis',
       status: 'DONE',
       images: ['6a5e9a4c-8752-c1e6-6a34-38338074eda1'],
+      wheelAnalysisCloseUp: false,
     },
   ],
   vehicles: [

diff --git a/packages/sights/research/data/fesc20/fesc20.json b/packages/sights/research/data/fesc20/fesc20.json
@@ -70,6 +70,7 @@
     "vehicle": "fesc20",
     "mirror_sight": "fesc20-raHPDUNm",
     "dev": true,
+    "wheel_name": "wheel_back_left",
     "tasks": ["wheel_analysis"]
   },
   "fesc20-5Ts1UkPT": {
@@ -96,6 +97,7 @@
     "vehicle": "fesc20",
     "mirror_sight": "fesc20-Tlu3sz8A",
     "dev": true,
+    "wheel_name": "wheel_back_right",
     "tasks": ["wheel_analysis"]
   },
   "fesc20-6GPUkfYn": {
@@ -335,6 +337,7 @@
     "vehicle": "fesc20",
     "mirror_sight": "fesc20-W6XrryMO",
     "dev": true,
+    "wheel_name": "wheel_front_left",
     "tasks": ["wheel_analysis"]
   },
   "fesc20-WMUaKDp1": {
@@ -419,6 +422,7 @@
     "vehicle": "fesc20",
     "mirror_sight": "fesc20-YPcJPAZE",
     "dev": true,
+    "wheel_name": "wheel_front_right",
     "tasks": ["wheel_analysis"]
   },
   "fesc20-dfICsfSV": {

diff --git a/packages/sights/research/data/ff150/ff150.json b/packages/sights/research/data/ff150/ff150.json
@@ -114,6 +114,7 @@
     "vehicle": "ff150",
     "mirror_sight": "ff150-7vyfzrVQ",
     "dev": true,
+    "wheel_name": "wheel_back_right",
     "tasks": ["wheel_analysis"]
   },
   "ff150-7UI3m9B3": {
@@ -155,6 +156,7 @@
     "vehicle": "ff150",
     "mirror_sight": "ff150-pNO26q4D",
     "dev": true,
+    "wheel_name": "wheel_front_right",
     "tasks": ["wheel_analysis"]
   },
   "ff150-BmXfb-qD": {
@@ -197,6 +199,7 @@
     "vehicle": "ff150",
     "mirror_sight": "ff150-jUBEKij0",
     "dev": true,
+    "wheel_name": "wheel_front_left",
     "tasks": ["wheel_analysis"]
   },
   "ff150-GOx2s_9L": {
@@ -419,6 +422,7 @@
     "vehicle": "ff150",
     "mirror_sight": "ff150-H3MCPESJ",
     "dev": true,
+    "wheel_name": "wheel_back_right",
     "tasks": ["wheel_analysis"]
   },
   "ff150-phbX7Bef": {

diff --git a/packages/sights/research/data/ffocus18/ffocus18.json b/packages/sights/research/data/ffocus18/ffocus18.json
@@ -175,6 +175,7 @@
     "vehicle": "ffocus18",
     "mirror_sight": "ffocus18-Eo0jqD_a",
     "dev": true,
+    "wheel_name": "wheel_front_right",
     "tasks": ["wheel_analysis"]
   },
   "ffocus18-L2UM_68Q": {
@@ -230,6 +231,7 @@
     "vehicle": "ffocus18",
     "mirror_sight": "ffocus18-JFX8WF9P",
     "dev": true,
+    "wheel_name": "wheel_back_right",
     "tasks": ["wheel_analysis"]
   },
   "ffocus18-QKfhXU7o": {
@@ -272,6 +274,7 @@
     "vehicle": "ffocus18",
     "mirror_sight": "ffocus18-tufa4FoL",
     "dev": true,
+    "wheel_name": "wheel_back_left",
     "tasks": ["wheel_analysis"]
   },
   "ffocus18-U3Bcfc2Q": {
@@ -543,6 +546,7 @@
     "vehicle": "ffocus18",
     "mirror_sight": "ffocus18-jkSlWpql",
     "dev": true,
+    "wheel_name": "wheel_front_left",
     "tasks": ["wheel_analysis"]
   },
   "ffocus18-yo9eBDW6": {

diff --git a/packages/sights/research/data/ftransit18/ftransit18.json b/packages/sights/research/data/ftransit18/ftransit18.json
@@ -39,6 +39,7 @@
     "vehicle": "ftransit18",
     "mirror_sight": "ftransit18-AuCXxG5o",
     "dev": true,
+    "wheel_name": "wheel_back_left",
     "tasks": ["wheel_analysis"]
   },
   "ftransit18-3dkU10af": {
@@ -96,6 +97,7 @@
     "vehicle": "ftransit18",
     "mirror_sight": "ftransit18-mGSvkRHz",
     "dev": true,
+    "wheel_name": "wheel_front_right",
     "tasks": ["wheel_analysis"]
   },
   "ftransit18-5SiNC94w": {
@@ -243,6 +245,7 @@
     "vehicle": "ftransit18",
     "mirror_sight": "ftransit18-yxw9gmyL",
     "dev": true,
+    "wheel_name": "wheel_back_right",
     "tasks": ["wheel_analysis"]
   },
   "ftransit18-TkXihCj4": {
@@ -299,6 +302,7 @@
     "vehicle": "ftransit18",
     "mirror_sight": "ftransit18-7qLSCnFP",
     "dev": true,
+    "wheel_name": "wheel_front_left",
     "tasks": ["wheel_analysis"]
   },
   "ftransit18-aA2K898S": {

diff --git a/packages/sights/research/data/haccord/haccord.json b/packages/sights/research/data/haccord/haccord.json
@@ -112,6 +112,7 @@
     "vehicle": "haccord",
     "mirror_sight": "haccord-boMeNVsC",
     "dev": true,
+    "wheel_name": "wheel_front_left",
     "tasks": ["wheel_analysis"]
   },
   "haccord-GdWvsqrm": {
@@ -184,6 +185,7 @@
     "vehicle": "haccord",
     "mirror_sight": "haccord-2v-2_QD5",
     "dev": true,
+    "wheel_name": "wheel_front_right",
     "tasks": ["wheel_analysis"]
   },
   "haccord-KvP-pm8L": {
@@ -226,6 +228,7 @@
     "vehicle": "haccord",
     "mirror_sight": "haccord-H_eRrLBl",
     "dev": true,
+    "wheel_name": "wheel_back_right",
     "tasks": ["wheel_analysis"]
   },
   "haccord-PGr3RzzP": {
@@ -299,6 +302,7 @@
     "vehicle": "haccord",
     "mirror_sight": "haccord-9fxMGSs6",
     "dev": true,
+    "wheel_name": "wheel_back_left",
     "tasks": ["wheel_analysis"]
   },
   "haccord-Z84erkMb": {