@reconcrap/boss-recommend-mcp 2.0.7 → 2.0.9

package/src/domains/chat/run-service.js

@@ -24,6 +24,11 @@ import {
 } from "../../core/infinite-list/index.js";
 import { createViewportRunGuard } from "../../core/self-heal/index.js";
 import { createRunLifecycleManager } from "../../core/run/index.js";
+import {
+  addTiming,
+  imageEvidenceFilePath,
+  measureTiming
+} from "../../core/run/timing.js";
 import {
   callScreeningLlm,
   normalizeText,
@@ -369,7 +374,8 @@ export async function runChatWorkflow({
   listStableSignatureLimit = 2,
   listWheelDeltaY = 850,
   listSettleMs = 1200,
-  listFallbackPoint = null
+  listFallbackPoint = null,
+  imageOutputDir = ""
 } = {}, runControl) {
   if (!client) throw new Error("runChatWorkflow requires a guarded CDP client");
   const normalizedDetailSource = normalizeDetailSource(detailSource);
@@ -584,6 +590,8 @@ export async function runChatWorkflow({
       || results.filter((item) => item.screening?.passed).length < passTarget
     )
   ) {
+    const candidateStarted = Date.now();
+    const timings = {};
     await runControl.waitIfPaused();
     runControl.throwIfCanceled();
     runControl.setPhase("chat:candidate");
@@ -596,7 +604,7 @@ export async function runChatWorkflow({
       continue;
     }
 
-    const nextCandidateResult = await getNextInfiniteListCandidate({
+    const nextCandidateResult = await measureTiming(timings, "card_read_ms", () => getNextInfiniteListCandidate({
       client,
       state: listState,
       maxScrolls: listMaxScrolls,
@@ -623,7 +631,7 @@ export async function runChatWorkflow({
           visible_index: visibleIndex
         }
       })
-    });
+    }));
     if (!nextCandidateResult.ok) {
       const endTopLevelState = await getChatTopLevelState(client);
       if (!endTopLevelState.is_chat_shell) {
@@ -665,11 +673,11 @@ export async function runChatWorkflow({
 
         detailStep = "select_candidate";
         networkRecorder.clear();
-        const selected = await selectFreshChatCandidate(client, {
+        const selected = await measureTiming(timings, "candidate_click_ms", () => selectFreshChatCandidate(client, {
           cardNodeId,
           candidate: cardCandidate,
           timeoutMs: onlineResumeButtonTimeoutMs
-        });
+        }));
         if (selected.ready?.forbidden_top_level_navigation) {
           throw makeForbiddenChatResumeNavigationError(selected.ready.top_level_state);
         }
@@ -696,13 +704,13 @@ export async function runChatWorkflow({
         if (!detailResult) {
           detailStep = "open_online_resume";
           networkRecorder.clear();
-          const openedResume = await openChatOnlineResume(client, {
+          const openedResume = await measureTiming(timings, "detail_open_ms", () => openChatOnlineResume(client, {
             timeoutMs: readyTimeoutMs
-          });
+          }));
           const waitPlan = getCvNetworkWaitPlan(cvAcquisitionState);
           detailStep = "wait_network";
           const networkWait = ["network", "cascade"].includes(normalizedDetailSource)
-            ? await waitForCvNetworkEvents(
+            ? await measureTiming(timings, "network_cv_wait_ms", () => waitForCvNetworkEvents(
                 waitForChatProfileNetworkEvents,
                 networkRecorder,
                 {
@@ -711,8 +719,11 @@ export async function runChatWorkflow({
                   requireLoaded: true,
                   intervalMs: 200
                 }
-              )
+              ))
             : null;
+          if (networkWait?.elapsed_ms != null) {
+            timings.network_cv_wait_ms = Math.round(Number(networkWait.elapsed_ms) || 0);
+          }
           let contentWait = {
             ok: false,
             skipped: false,
@@ -741,8 +752,11 @@ export async function runChatWorkflow({
                 resumeNetworkEvents
               ),
               targetUrl,
-              closeResume: false
+              closeResume: false,
+              networkParseRetryMs: waitPlan.mode_before === "image" ? 500 : 2200,
+              networkParseIntervalMs: 250
             });
+            addTiming(timings, "late_network_retry_ms", detailResult.network_parse_retry_elapsed_ms);
             parsedNetworkProfileCount = countParsedNetworkProfiles(detailResult);
             if (parsedNetworkProfileCount > 0) {
               contentWait = {
@@ -759,10 +773,10 @@ export async function runChatWorkflow({
 
           if (!detailResult) {
             detailStep = "wait_resume_content";
-            contentWait = await waitForChatResumeContent(client, {
+            contentWait = await measureTiming(timings, "dom_fallback_ms", () => waitForChatResumeContent(client, {
               timeoutMs: resumeDomTimeoutMs,
               intervalMs: 300
-            });
+            }));
             resumeState = contentWait.resume_state || openedResume.resume_state;
             resumeHtml = contentWait.resume_html || null;
             resumeNetworkEvents = networkRecorder.events.slice();
@@ -778,8 +792,11 @@ export async function runChatWorkflow({
                 resumeNetworkEvents
               ),
               targetUrl,
-              closeResume: false
+              closeResume: false,
+              networkParseRetryMs: waitPlan.mode_before === "image" ? 500 : 2200,
+              networkParseIntervalMs: 250
             });
+            addTiming(timings, "late_network_retry_ms", detailResult.network_parse_retry_elapsed_ms);
             parsedNetworkProfileCount = countParsedNetworkProfiles(detailResult);
           }
 
@@ -792,11 +809,25 @@ export async function runChatWorkflow({
           if (shouldCaptureImage) {
             if (captureNodeId) {
               detailStep = "capture_image_fallback";
-              imageEvidence = await captureScrolledNodeScreenshots(client, captureNodeId, {
+              imageEvidence = await measureTiming(timings, "screenshot_capture_ms", () => captureScrolledNodeScreenshots(client, captureNodeId, {
+                filePath: imageEvidenceFilePath({
+                  imageOutputDir,
+                  domain: "chat",
+                  runId: runControl?.runId,
+                  index,
+                  extension: "jpg"
+                }),
+                format: "jpeg",
+                quality: 72,
+                optimize: true,
+                resizeMaxWidth: 1100,
+                captureViewport: true,
                 padding: 8,
                 maxScreenshots: maxImagePages,
                 wheelDeltaY: imageWheelDeltaY,
-                settleMs: 1200,
+                settleMs: 350,
+                duplicateStopCount: 1,
+                skipDuplicateScreenshots: true,
                 metadata: {
                   domain: "chat",
                   capture_mode: "scroll_sequence",
@@ -806,7 +837,7 @@ export async function runChatWorkflow({
                   run_candidate_index: index,
                   candidate_key: candidateKey
                 }
-              });
+              }));
               source = "image";
               recordCvImageFallback(cvAcquisitionState, {
                 parsedNetworkProfileCount,
@@ -819,7 +850,7 @@ export async function runChatWorkflow({
                   llmResult = createMissingLlmConfigResult();
                 } else {
                   try {
-                    llmResult = await callScreeningLlm({
+                    llmResult = await measureTiming(timings, "vision_model_ms", () => callScreeningLlm({
                       candidate: detailResult.candidate,
                       criteria,
                       config: llmConfig,
@@ -827,7 +858,7 @@ export async function runChatWorkflow({
                       imageEvidence,
                       maxImages: llmImageLimit,
                       imageDetail: llmImageDetail
-                    });
+                    }));
                   } catch (error) {
                     llmResult = createFailedLlmResult(error);
                   }
@@ -861,7 +892,10 @@ export async function runChatWorkflow({
               llmResult = createMissingLlmConfigResult();
             } else {
               try {
-                llmResult = await callScreeningLlm({
+                const llmTimingKey = imageEvidence?.file_paths?.length
+                  ? "vision_model_ms"
+                  : "text_model_ms";
+                llmResult = await measureTiming(timings, llmTimingKey, () => callScreeningLlm({
                   candidate: detailResult.candidate,
                   criteria,
                   config: llmConfig,
@@ -869,7 +903,7 @@ export async function runChatWorkflow({
                   imageEvidence,
                   maxImages: llmImageLimit,
                   imageDetail: llmImageDetail
-                });
+                }));
               } catch (error) {
                 llmResult = createFailedLlmResult(error);
               }
@@ -879,7 +913,7 @@ export async function runChatWorkflow({
           let closeResult = null;
           if (closeResume) {
             detailStep = "close_resume_modal";
-            closeResult = await closeChatResumeModal(client);
+            closeResult = await measureTiming(timings, "close_detail_ms", () => closeChatResumeModal(client));
           }
           detailResult.close_result = closeResult;
           detailResult.image_evidence = imageEvidence;
@@ -927,14 +961,14 @@ export async function runChatWorkflow({
         cardOnlyLlmResult = createMissingLlmConfigResult();
       } else {
         try {
-          cardOnlyLlmResult = await callScreeningLlm({
+          cardOnlyLlmResult = await measureTiming(timings, "text_model_ms", () => callScreeningLlm({
             candidate: screeningCandidate,
             criteria,
             config: llmConfig,
             timeoutMs: llmTimeoutMs,
             maxImages: llmImageLimit,
             imageDetail: llmImageDetail
-          });
+          }));
         } catch (error) {
           cardOnlyLlmResult = createFailedLlmResult(error);
         }
@@ -954,10 +988,10 @@ export async function runChatWorkflow({
         : screenCandidate(screeningCandidate, { criteria });
     let postAction = null;
     if (requestResumeForPassed && screening.passed) {
-      postAction = await requestChatResumeForPassedCandidate(client, {
+      postAction = await measureTiming(timings, "post_action_ms", () => requestChatResumeForPassedCandidate(client, {
         greetingText,
         dryRun: dryRunRequestCv
-      });
+      }));
       if (postAction?.requested) requestSatisfiedCount += 1;
       if (postAction?.skipped) requestSkippedCount += 1;
       if (postAction?.requested && !postAction?.skipped) requestedCount += 1;
@@ -965,6 +999,7 @@ export async function runChatWorkflow({
         throw new Error(`REQUEST_CV_NOT_VERIFIED:${postAction?.reason || "unknown"}`);
       }
     }
+    timings.total_ms = Date.now() - candidateStarted;
     const compactResult = {
       index,
       candidate_key: candidateKey,
@@ -974,7 +1009,8 @@ export async function runChatWorkflow({
       llm_screening: detailResult ? null : compactLlmResult(cardOnlyLlmResult),
       screening: compactScreening(screening),
       post_action: postAction,
-      pre_action_state: preActionState
+      pre_action_state: preActionState,
+      timings
     };
     results.push(compactResult);
     markInfiniteListCandidateProcessed(listState, candidateKey, {
@@ -1006,6 +1042,7 @@ export async function runChatWorkflow({
       last_candidate_key: candidateKey,
       last_score: screening.score
     });
+    const checkpointStarted = Date.now();
     runControl.checkpoint({
       results,
       last_candidate: {
@@ -1020,9 +1057,13 @@ export async function runChatWorkflow({
         llm_screening: compactLlmResult(effectiveLlmResult)
       }
     });
+    addTiming(compactResult.timings, "checkpoint_save_ms", Date.now() - checkpointStarted);
 
     if (delayMs > 0) {
+      const sleepStarted = Date.now();
       await runControl.sleep(delayMs);
+      addTiming(compactResult.timings, "sleep_ms", Date.now() - sleepStarted);
+      compactResult.timings.total_ms = Date.now() - candidateStarted;
     }
   }
 
@@ -1095,6 +1136,7 @@ export function createChatRunService({
     listWheelDeltaY = 850,
     listSettleMs = 1200,
     listFallbackPoint = null,
+    imageOutputDir = "",
     name = "chat-domain-run"
   } = {}) {
     if (!client) throw new Error("startChatRun requires a guarded CDP client");
@@ -1130,7 +1172,8 @@ export function createChatRunService({
         list_wheel_delta_y: listWheelDeltaY,
         list_settle_ms: listSettleMs,
         list_fallback_point: listFallbackPoint,
-        online_resume_button_timeout_ms: onlineResumeButtonTimeoutMs
+        online_resume_button_timeout_ms: onlineResumeButtonTimeoutMs,
+        image_output_dir: imageOutputDir || ""
       },
       progress: {
         card_count: 0,
@@ -1180,7 +1223,8 @@ export function createChatRunService({
         listStableSignatureLimit,
         listWheelDeltaY,
         listSettleMs,
-        listFallbackPoint
+        listFallbackPoint,
+        imageOutputDir
       }, runControl)
     });
   }

package/src/domains/recommend/cards.js

@@ -6,6 +6,10 @@ import {
   querySelectorAll,
   sleep
 } from "../../core/browser/index.js";
+import {
+  mergeBossCandidateCardFields,
+  parseBossCandidateCardFieldsFromHtml
+} from "../../core/boss-cards/index.js";
 import {
   htmlToText,
   normalizeCandidateFromHtml,
@@ -24,6 +28,16 @@ function normalizeRefreshButtonLabel(outerHTML = "") {
   return normalizeText(htmlToText(outerHTML)).replace(/\s+/g, "");
 }
 
+export function parseRecommendCardFieldsFromHtml(html = "") {
+  return parseBossCandidateCardFieldsFromHtml(html);
+}
+
+function enrichRecommendCardCandidate(candidate, outerHTML = "") {
+  return mergeBossCandidateCardFields(candidate, outerHTML, {
+    metadataKey: "recommend_card_fields"
+  });
+}
+
 function isRefreshButtonLabel(label = "") {
   const normalized = String(label || "").trim();
   if (!normalized || normalized.length > 80) return false;
@@ -91,7 +105,7 @@ export async function readRecommendCardCandidate(client, cardNodeId, {
     getAttributesMap(client, cardNodeId),
     getOuterHTML(client, cardNodeId)
   ]);
-  return normalizeCandidateFromHtml({
+  const candidate = normalizeCandidateFromHtml({
     domain: "recommend",
     source,
     html: outerHTML,
@@ -102,6 +116,7 @@ export async function readRecommendCardCandidate(client, cardNodeId, {
       ...metadata
     }
   });
+  return enrichRecommendCardCandidate(candidate, outerHTML);
 }
 
 export async function readFirstRecommendCardCandidate(client, frameNodeId, options = {}) {

package/src/domains/recommend/detail.js

@@ -279,15 +279,25 @@ export async function openRecommendCardDetail(client, cardNodeId, {
   timeoutMs = 12000,
   scrollIntoView = true
 } = {}) {
+  const started = Date.now();
+  const clickStarted = Date.now();
   const cardBox = await clickNodeCenter(client, cardNodeId, { scrollIntoView });
+  const candidateClickMs = Date.now() - clickStarted;
+  const detailStarted = Date.now();
   const detailState = await waitForRecommendDetail(client, { timeoutMs });
+  const detailOpenMs = Date.now() - detailStarted;
   if (!detailState?.popup && !detailState?.resumeIframe) {
     throw new Error("Candidate detail did not open or no known detail selectors mounted");
   }
 
   return {
     card_box: cardBox,
-    detail_state: detailState
+    detail_state: detailState,
+    timings: {
+      candidate_click_ms: candidateClickMs,
+      detail_open_ms: detailOpenMs,
+      open_total_ms: Date.now() - started
+    }
   };
 }
 
@@ -477,31 +487,40 @@ export async function extractRecommendDetailCandidate(client, {
   detailState,
   networkEvents = [],
   targetUrl = "",
-  closeDetail = true
+  closeDetail = true,
+  networkParseRetryMs = 1800,
+  networkParseIntervalMs = 250
 } = {}) {
-  await sleep(1000);
-  const networkBodies = await readRecommendDetailNetworkBodies(client, networkEvents);
   const detailHtml = await readRecommendDetailHtml(client, detailState);
   const detailText = [
     detailHtml.popupText,
     detailHtml.resumeText
   ].filter(Boolean).join("\n\n");
 
-  const detailCandidateResult = buildScreeningCandidateFromDetail({
-    cardCandidate,
-    detailText,
-    networkBodies,
-    metadata: {
-      target_url: targetUrl,
-      card_node_id: cardNodeId,
-      detail_popup_selector: detailState?.popup?.selector || null,
-      detail_popup_root: detailState?.popup?.root || null,
-      resume_iframe_selector: detailState?.resumeIframe?.selector || null,
-      resume_iframe_root: detailState?.resumeIframe?.root || null,
-      resume_iframe_document_node_id: detailHtml.resumeIframeDocumentNodeId,
-      detail_html_errors: detailHtml.errors || []
-    }
-  });
+  const parseStarted = Date.now();
+  let networkBodies = [];
+  let detailCandidateResult = null;
+  do {
+    networkBodies = await readRecommendDetailNetworkBodies(client, networkEvents);
+    detailCandidateResult = buildScreeningCandidateFromDetail({
+      cardCandidate,
+      detailText,
+      networkBodies,
+      metadata: {
+        target_url: targetUrl,
+        card_node_id: cardNodeId,
+        detail_popup_selector: detailState?.popup?.selector || null,
+        detail_popup_root: detailState?.popup?.root || null,
+        resume_iframe_selector: detailState?.resumeIframe?.selector || null,
+        resume_iframe_root: detailState?.resumeIframe?.root || null,
+        resume_iframe_document_node_id: detailHtml.resumeIframeDocumentNodeId,
+        detail_html_errors: detailHtml.errors || []
+      }
+    });
+    if (detailCandidateResult.parsed_network_profiles.some((item) => item.ok)) break;
+    if (Date.now() - parseStarted >= Math.max(0, Number(networkParseRetryMs) || 0)) break;
+    await sleep(Math.max(50, Number(networkParseIntervalMs) || 250));
+  } while (true);
 
   let closeResult = null;
   if (closeDetail) {
@@ -512,6 +531,8 @@ export async function extractRecommendDetailCandidate(client, {
     candidate: detailCandidateResult.candidate,
     parsed_network_profiles: detailCandidateResult.parsed_network_profiles,
     network_bodies: networkBodies,
+    network_parse_retry_elapsed_ms: Date.now() - parseStarted,
+    network_event_count: networkEvents.length,
     detail: {
       popup_text: detailHtml.popupText,
       resume_text: detailHtml.resumeText,

package/src/domains/recommend/run-service.js

@@ -1,4 +1,9 @@
 import { createRunLifecycleManager } from "../../core/run/index.js";
+import {
+  addTiming,
+  imageEvidenceFilePath,
+  measureTiming
+} from "../../core/run/timing.js";
 import { captureScrolledNodeScreenshots } from "../../core/capture/index.js";
 import { sleep } from "../../core/browser/index.js";
 import { GREET_CREDITS_EXHAUSTED_CODE } from "../../core/greet-quota/index.js";
@@ -377,7 +382,8 @@ export async function runRecommendWorkflow({
   llmConfig = null,
   llmTimeoutMs = 120000,
   llmImageLimit = 8,
-  llmImageDetail = "high"
+  llmImageDetail = "high",
+  imageOutputDir = ""
 } = {}, runControl) {
   if (!client) throw new Error("runRecommendWorkflow requires a guarded CDP client");
   const normalizedFilter = normalizeFilter(filter);
@@ -520,12 +526,14 @@ export async function runRecommendWorkflow({
   });
 
   while (results.length < limit) {
+    const candidateStarted = Date.now();
+    const timings = {};
     await runControl.waitIfPaused();
     runControl.throwIfCanceled();
     runControl.setPhase("recommend:candidate");
     rootState = await ensureRecommendViewport(rootState, "candidate_loop");
 
-    const nextCandidateResult = await getNextInfiniteListCandidate({
+    const nextCandidateResult = await measureTiming(timings, "card_read_ms", () => getNextInfiniteListCandidate({
       client,
       state: listState,
       maxScrolls: listMaxScrolls,
@@ -552,7 +560,7 @@ export async function runRecommendWorkflow({
           visible_index: visibleIndex
         }
       })
-    });
+    }));
     if (!nextCandidateResult.ok) {
       listEndReason = nextCandidateResult.reason || "list_exhausted";
       if (
@@ -644,11 +652,13 @@ export async function runRecommendWorkflow({
         targetUrl,
         maxAttempts: 2
       });
+      addTiming(timings, "candidate_click_ms", openedDetail.timings?.candidate_click_ms);
+      addTiming(timings, "detail_open_ms", openedDetail.timings?.detail_open_ms);
       cardNodeId = openedDetail.card_node_id || cardNodeId;
       cardCandidate = openedDetail.card_candidate || cardCandidate;
       screeningCandidate = cardCandidate;
       const waitPlan = getCvNetworkWaitPlan(cvAcquisitionState);
-      const networkWait = await waitForCvNetworkEvents(
+      const networkWait = await measureTiming(timings, "network_cv_wait_ms", () => waitForCvNetworkEvents(
         waitForRecommendDetailNetworkEvents,
         networkRecorder,
         {
@@ -657,15 +667,21 @@ export async function runRecommendWorkflow({
           requireLoaded: true,
           intervalMs: 120
         }
-      );
+      ));
+      if (networkWait?.elapsed_ms != null) {
+        timings.network_cv_wait_ms = Math.round(Number(networkWait.elapsed_ms) || 0);
+      }
       detailResult = await extractRecommendDetailCandidate(client, {
         cardCandidate,
         cardNodeId,
         detailState: openedDetail.detail_state,
         networkEvents: networkRecorder.events,
         targetUrl,
-        closeDetail: false
+        closeDetail: false,
+        networkParseRetryMs: waitPlan.mode_before === "image" ? 500 : 2200,
+        networkParseIntervalMs: 250
       });
+      addTiming(timings, "late_network_retry_ms", detailResult.network_parse_retry_elapsed_ms);
 
       const parsedNetworkProfileCount = countParsedNetworkProfiles(detailResult);
       let source = "network";
@@ -680,11 +696,25 @@ export async function runRecommendWorkflow({
           || openedDetail.detail_state?.resumeIframe?.node_id
           || null;
         if (captureNodeId) {
-          imageEvidence = await captureScrolledNodeScreenshots(client, captureNodeId, {
+          imageEvidence = await measureTiming(timings, "screenshot_capture_ms", () => captureScrolledNodeScreenshots(client, captureNodeId, {
+            filePath: imageEvidenceFilePath({
+              imageOutputDir,
+              domain: "recommend",
+              runId: runControl?.runId,
+              index,
+              extension: "jpg"
+            }),
+            format: "jpeg",
+            quality: 72,
+            optimize: true,
+            resizeMaxWidth: 1100,
+            captureViewport: true,
             padding: 4,
             maxScreenshots: maxImagePages,
             wheelDeltaY: imageWheelDeltaY,
-            settleMs: 1200,
+            settleMs: 350,
+            duplicateStopCount: 1,
+            skipDuplicateScreenshots: true,
             metadata: {
               domain: "recommend",
               capture_mode: "scroll_sequence",
@@ -692,7 +722,7 @@ export async function runRecommendWorkflow({
               run_candidate_index: index,
               candidate_key: candidateKey
             }
-          });
+          }));
           source = "image";
           recordCvImageFallback(cvAcquisitionState, {
             parsedNetworkProfileCount,
@@ -730,7 +760,10 @@ export async function runRecommendWorkflow({
         llmResult = createMissingLlmConfigResult();
       } else {
         try {
-          llmResult = await callScreeningLlm({
+          const llmTimingKey = detailResult?.image_evidence?.file_paths?.length
+            ? "vision_model_ms"
+            : "text_model_ms";
+          llmResult = await measureTiming(timings, llmTimingKey, () => callScreeningLlm({
             candidate: screeningCandidate,
             criteria,
             config: llmConfig,
@@ -738,7 +771,7 @@ export async function runRecommendWorkflow({
             imageEvidence: detailResult?.image_evidence || null,
             maxImages: llmImageLimit,
             imageDetail: llmImageDetail
-          });
+          }));
         } catch (error) {
           llmResult = createFailedLlmScreeningResult(error);
         }
@@ -751,6 +784,7 @@ export async function runRecommendWorkflow({
     let actionDiscovery = null;
     let postActionResult = null;
     if (postActionEnabled && detailResult) {
+      const postActionStarted = Date.now();
       await runControl.waitIfPaused();
       runControl.throwIfCanceled();
       runControl.setPhase("recommend:post-action");
@@ -772,10 +806,12 @@ export async function runRecommendWorkflow({
       if (postActionResult.counted_as_greet && postActionResult.action_clicked) {
         greetCount += 1;
       }
+      addTiming(timings, "post_action_ms", Date.now() - postActionStarted);
     }
     if (detailResult && closeDetail) {
-      detailResult.close_result = await closeRecommendDetail(client);
+      detailResult.close_result = await measureTiming(timings, "close_detail_ms", () => closeRecommendDetail(client));
     }
+    timings.total_ms = Date.now() - candidateStarted;
     const compactResult = {
       index,
       candidate_key: candidateKey,
@@ -785,7 +821,8 @@ export async function runRecommendWorkflow({
       llm_screening: detailResult ? null : compactScreeningLlmResult(llmResult),
       screening: compactScreening(screening),
       action_discovery: compactActionDiscovery(actionDiscovery),
-      post_action: postActionResult
+      post_action: postActionResult,
+      timings
     };
     results.push(compactResult);
     markInfiniteListCandidateProcessed(listState, candidateKey, {
@@ -816,6 +853,7 @@ export async function runRecommendWorkflow({
       last_candidate_key: candidateKey,
       last_score: screening.score
     });
+    const checkpointStarted = Date.now();
     runControl.checkpoint({
       results,
       last_candidate: {
@@ -831,6 +869,7 @@ export async function runRecommendWorkflow({
         post_action: postActionResult
       }
     });
+    addTiming(compactResult.timings, "checkpoint_save_ms", Date.now() - checkpointStarted);
 
     if (postActionResult?.stop_run) {
       listEndReason = postActionResult.reason || "post_action_stop";
@@ -838,7 +877,10 @@ export async function runRecommendWorkflow({
     }
 
     if (delayMs > 0) {
+      const sleepStarted = Date.now();
       await runControl.sleep(delayMs);
+      addTiming(compactResult.timings, "sleep_ms", Date.now() - sleepStarted);
+      compactResult.timings.total_ms = Date.now() - candidateStarted;
     }
   }
 
@@ -912,6 +954,7 @@ export function createRecommendRunService({
     llmTimeoutMs = 120000,
     llmImageLimit = 8,
     llmImageDetail = "high",
+    imageOutputDir = "",
     name = "recommend-domain-run"
   } = {}) {
     if (!client) throw new Error("startRecommendRun requires a guarded CDP client");
@@ -955,7 +998,8 @@ export function createRecommendRunService({
         llm_configured: Boolean(llmConfig),
         llm_timeout_ms: llmTimeoutMs,
         llm_image_limit: llmImageLimit,
-        llm_image_detail: llmImageDetail
+        llm_image_detail: llmImageDetail,
+        image_output_dir: imageOutputDir || ""
       },
       progress: {
         card_count: 0,
@@ -1004,7 +1048,8 @@ export function createRecommendRunService({
         llmConfig,
         llmTimeoutMs,
         llmImageLimit,
-        llmImageDetail
+        llmImageDetail,
+        imageOutputDir
       }, runControl)
     });
   }