@reconcrap/boss-recommend-mcp 2.1.12 → 2.1.14

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

@@ -38,11 +38,13 @@ import {
   imageEvidenceFilePath,
   measureTiming
 } from "../../core/run/timing.js";
-import {
-  callScreeningLlm,
-  normalizeText,
-  screenCandidate
-} from "../../core/screening/index.js";
+import {
+  callScreeningLlm,
+  createFatalLlmRunError,
+  isFatalLlmProviderError,
+  normalizeText,
+  screenCandidate
+} from "../../core/screening/index.js";
 import {
   CHAT_BOTTOM_MARKER_SELECTORS,
   CHAT_CARD_SELECTORS,
@@ -104,23 +106,35 @@ function compactScreening(screening) {
 
 function compactLlmResult(llmResult) {
   if (!llmResult) return null;
-  return {
-    ok: Boolean(llmResult.ok),
-    provider: llmResult.provider || null,
-    passed: llmResult.passed,
-    cot: llmResult.cot || llmResult.decision_cot || "",
-    reasoning_content: llmResult.reasoning_content || "",
-    raw_model_output: llmResult.raw_model_output || "",
-    evidence_count: llmResult.evidence?.length || 0,
-    usage: llmResult.usage || null,
+  return {
+    ok: Boolean(llmResult.ok),
+    provider: llmResult.provider || null,
+    passed: llmResult.passed,
+    review_required: typeof llmResult.review_required === "boolean" ? llmResult.review_required : null,
+    cot: llmResult.cot || llmResult.decision_cot || "",
+    reasoning_content: llmResult.reasoning_content || "",
+    raw_model_output: llmResult.raw_model_output || "",
+    evidence_count: llmResult.evidence?.length || 0,
+    usage: llmResult.usage || null,
     finish_reason: llmResult.finish_reason || null,
-    image_input_count: llmResult.image_input_count || 0,
-    attempt_count: llmResult.attempt_count || 0,
-    fallback_count: llmResult.fallback_count || 0,
-    llm_model_failures: Array.isArray(llmResult.llm_model_failures) ? llmResult.llm_model_failures : [],
-    error: llmResult.error || null
-  };
-}
+    image_input_count: llmResult.image_input_count || 0,
+    attempt_count: llmResult.attempt_count || 0,
+    fallback_count: llmResult.fallback_count || 0,
+    llm_model_failures: Array.isArray(llmResult.llm_model_failures) ? llmResult.llm_model_failures : [],
+    screening_strategy: llmResult.screening_strategy || "",
+    fast_thinking_level: llmResult.fast_thinking_level || "",
+    verify_thinking_level: llmResult.verify_thinking_level || "",
+    verified: typeof llmResult.verified === "boolean" ? llmResult.verified : null,
+    verification_reason: llmResult.verification_reason || "",
+    decision_source: llmResult.decision_source || "",
+    fast_result: llmResult.fast_result || null,
+    verify_result: llmResult.verify_result || null,
+    error_code: llmResult.error_code || null,
+    fatal: Boolean(llmResult.fatal),
+    fatal_reason: llmResult.fatal_reason || "",
+    error: llmResult.error || null
+  };
+}
 
 function compactCandidate(candidate) {
   return {
@@ -339,9 +353,9 @@ function isRecoverableLlmScreeningError(error) {
 }
 
 function createFailedLlmResult(error) {
-  return {
-    ok: false,
-    passed: false,
+  return {
+    ok: false,
+    passed: false,
     reason: "",
     evidence: [],
     cot: "",
@@ -349,12 +363,15 @@ function createFailedLlmResult(error) {
     reasoning_content: "",
     raw_model_output: "",
     attempt_count: Number(error?.llm_attempt_count) || 0,
-    fallback_count: Array.isArray(error?.llm_model_failures) ? error.llm_model_failures.length : 0,
-    llm_model_failures: Array.isArray(error?.llm_model_failures) ? error.llm_model_failures : [],
-    error: error?.message || String(error || "unknown"),
-    screened_at: new Date().toISOString()
-  };
-}
+    fallback_count: Array.isArray(error?.llm_model_failures) ? error.llm_model_failures.length : 0,
+    llm_model_failures: Array.isArray(error?.llm_model_failures) ? error.llm_model_failures : [],
+    error_code: error?.code || null,
+    fatal: Boolean(isFatalLlmProviderError(error)),
+    fatal_reason: error?.llm_fatal_reason || "",
+    error: error?.message || String(error || "unknown"),
+    screened_at: new Date().toISOString()
+  };
+}
 
 function normalizeScreeningMode(value) {
   const normalized = String(value || "llm").trim().toLowerCase();
@@ -743,12 +760,12 @@ export async function runChatWorkflow({
     safeClickPointEnabled: effectiveHumanBehavior.clickMovement,
     actionCooldownEnabled: effectiveHumanBehavior.actionCooldown
   });
-  const humanRestController = createHumanRestController({
-    enabled: effectiveHumanRestEnabled,
-    shortRestEnabled: effectiveHumanBehavior.shortRest,
-    batchRestEnabled: effectiveHumanBehavior.batchRest,
-    restLevel: effectiveHumanBehavior.restLevel
-  });
+  const humanRestController = createHumanRestController({
+    enabled: effectiveHumanRestEnabled,
+    shortRestEnabled: effectiveHumanBehavior.shortRest,
+    batchRestEnabled: effectiveHumanBehavior.batchRest,
+    restLevel: effectiveHumanBehavior.restLevel
+  });
   const normalizedDetailSource = normalizeDetailSource(detailSource);
   const normalizedScreeningMode = normalizeScreeningMode(screeningMode);
   const useLlmScreening = normalizedScreeningMode !== "deterministic";
@@ -792,12 +809,12 @@ export async function runChatWorkflow({
   let requestedCount = 0;
   let requestSatisfiedCount = 0;
   let requestSkippedCount = 0;
-  let contextSetup = {};
-  let contextRecoveryAttempts = 0;
-  const candidateRecoveryCounts = new Map();
-  let lastHumanEvent = null;
-
-  function recordHumanEvent(event = null) {
+  let contextSetup = {};
+  let contextRecoveryAttempts = 0;
+  const candidateRecoveryCounts = new Map();
+  let lastHumanEvent = null;
+
+  function recordHumanEvent(event = null) {
     if (!event) return lastHumanEvent;
     lastHumanEvent = {
       at: new Date().toISOString(),
@@ -861,13 +878,13 @@ export async function runChatWorkflow({
     ...setup.contextSetup,
     initial_top_level_state: initialTopLevelState
   };
-  runControl.checkpoint({
-    chat_context: contextSetup
-  });
-
-  async function recoverAndReapplyChatContext(reason, error = null, {
-    forceRefresh = false
-  } = {}) {
+  runControl.checkpoint({
+    chat_context: contextSetup
+  });
+
+  async function recoverAndReapplyChatContext(reason, error = null, {
+    forceRefresh = false
+  } = {}) {
     runControl.setPhase("chat:recover_shell");
     contextRecoveryAttempts += 1;
     const shellRecovery = await recoverChatShell(client, {
@@ -967,12 +984,12 @@ export async function runChatWorkflow({
       context_recoveries: contextRecoveryAttempts,
       list_end_reason: listEndReason,
       viewport_checks: viewportGuard.getStats().checks,
-      viewport_recoveries: viewportGuard.getStats().recoveries,
-      human_behavior_enabled: effectiveHumanBehavior.enabled,
-      human_behavior_profile: effectiveHumanBehavior.profile,
-      human_rest_level: effectiveHumanBehavior.restLevel,
-      human_rest_enabled: effectiveHumanRestEnabled,
-      human_rest_count: humanRestController.getState().rest_count,
+      viewport_recoveries: viewportGuard.getStats().recoveries,
+      human_behavior_enabled: effectiveHumanBehavior.enabled,
+      human_behavior_profile: effectiveHumanBehavior.profile,
+      human_rest_level: effectiveHumanBehavior.restLevel,
+      human_rest_enabled: effectiveHumanRestEnabled,
+      human_rest_count: humanRestController.getState().rest_count,
       human_rest_ms: humanRestController.getState().total_rest_ms,
       last_human_event: lastHumanEvent
     });
@@ -997,10 +1014,10 @@ export async function runChatWorkflow({
       last_human_event: lastHumanEvent,
       list_end_reason: listEndReason,
       target_pass_count: passTarget,
-      process_until_list_end: Boolean(processUntilListEnd),
-      processed_limit: processedLimit,
-      detail_source: normalizedDetailSource,
-      processed: 0,
+      process_until_list_end: Boolean(processUntilListEnd),
+      processed_limit: processedLimit,
+      detail_source: normalizedDetailSource,
+      processed: 0,
       screened: 0,
       detail_opened: 0,
       llm_screened: 0,
@@ -1501,18 +1518,24 @@ export async function runChatWorkflow({
                   llmResult = createMissingLlmConfigResult();
                 } else {
                   try {
-                    llmResult = await measureTiming(timings, "vision_model_ms", () => callScreeningLlm({
-                      candidate: detailResult.candidate,
-                      criteria,
-                      config: llmConfig,
-                      timeoutMs: llmTimeoutMs,
+                    llmResult = await measureTiming(timings, "vision_model_ms", () => callScreeningLlm({
+                      candidate: detailResult.candidate,
+                      criteria,
+                      config: llmConfig,
+                      timeoutMs: llmTimeoutMs,
                       imageEvidence,
                       maxImages: llmImageLimit,
                       imageDetail: llmImageDetail
                     }));
-                  } catch (error) {
-                    llmResult = createFailedLlmResult(error);
-                  }
+                  } catch (error) {
+                    if (isFatalLlmProviderError(error)) {
+                      throw createFatalLlmRunError(error, {
+                        domain: "chat",
+                        candidate: detailResult.candidate
+                      });
+                    }
+                    llmResult = createFailedLlmResult(error);
+                  }
                 }
               }
             } else {
@@ -1574,18 +1597,24 @@ export async function runChatWorkflow({
                   const llmTimingKey = imageEvidence?.file_paths?.length
                     ? "vision_model_ms"
                     : "text_model_ms";
-                  llmResult = await measureTiming(timings, llmTimingKey, () => callScreeningLlm({
-                    candidate: detailResult.candidate,
-                    criteria,
-                    config: llmConfig,
+                  llmResult = await measureTiming(timings, llmTimingKey, () => callScreeningLlm({
+                    candidate: detailResult.candidate,
+                    criteria,
+                    config: llmConfig,
                     timeoutMs: llmTimeoutMs,
                     imageEvidence,
                     maxImages: llmImageLimit,
                     imageDetail: llmImageDetail
                   }));
-                } catch (error) {
-                  llmResult = createFailedLlmResult(error);
-                }
+                } catch (error) {
+                  if (isFatalLlmProviderError(error)) {
+                    throw createFatalLlmRunError(error, {
+                      domain: "chat",
+                      candidate: detailResult.candidate
+                    });
+                  }
+                  llmResult = createFailedLlmResult(error);
+                }
               }
             }
           }
@@ -1773,12 +1802,12 @@ export async function runChatWorkflow({
       context_recoveries: contextRecoveryAttempts,
       list_end_reason: listEndReason || null,
       viewport_checks: viewportGuard.getStats().checks,
-      viewport_recoveries: viewportGuard.getStats().recoveries,
-      human_behavior_enabled: effectiveHumanBehavior.enabled,
-      human_behavior_profile: effectiveHumanBehavior.profile,
-      human_rest_level: effectiveHumanBehavior.restLevel,
-      human_rest_enabled: effectiveHumanRestEnabled,
-      human_rest_count: humanRestController.getState().rest_count,
+      viewport_recoveries: viewportGuard.getStats().recoveries,
+      human_behavior_enabled: effectiveHumanBehavior.enabled,
+      human_behavior_profile: effectiveHumanBehavior.profile,
+      human_rest_level: effectiveHumanBehavior.restLevel,
+      human_rest_enabled: effectiveHumanRestEnabled,
+      human_rest_count: humanRestController.getState().rest_count,
       human_rest_ms: humanRestController.getState().total_rest_ms,
       last_human_event: lastHumanEvent,
       last_candidate_id: screeningCandidate.id || null,
@@ -1818,11 +1847,11 @@ export async function runChatWorkflow({
         compactResult.human_rest = restResult;
         addTiming(compactResult.timings, "human_rest_ms", restElapsed);
         compactResult.timings.total_ms = Date.now() - candidateStarted;
-        runControl.updateProgress({
-          human_rest_enabled: effectiveHumanRestEnabled,
-          human_rest_level: effectiveHumanBehavior.restLevel,
-          human_rest_count: humanRestController.getState().rest_count,
-          human_rest_ms: humanRestController.getState().total_rest_ms,
+        runControl.updateProgress({
+          human_rest_enabled: effectiveHumanRestEnabled,
+          human_rest_level: effectiveHumanBehavior.restLevel,
+          human_rest_count: humanRestController.getState().rest_count,
+          human_rest_ms: humanRestController.getState().total_rest_ms,
           human_rest_last: restResult,
           context_recoveries: contextRecoveryAttempts,
           last_human_event: lastHumanEvent
@@ -1855,10 +1884,10 @@ export async function runChatWorkflow({
     last_human_event: lastHumanEvent,
     list_end_reason: listEndReason || null,
     target_pass_count: passTarget,
-    process_until_list_end: Boolean(processUntilListEnd),
-    processed_limit: processedLimit,
-    detail_source: normalizedDetailSource,
-    processed: finalCounters.processed,
+    process_until_list_end: Boolean(processUntilListEnd),
+    processed_limit: processedLimit,
+    detail_source: normalizedDetailSource,
+    processed: finalCounters.processed,
     screened: finalCounters.screened,
     detail_opened: finalCounters.detail_opened,
     llm_screened: finalCounters.llm_screened,
@@ -1880,10 +1909,10 @@ export function createChatRunService({
 } = {}) {
   const manager = lifecycle || createRunLifecycleManager({ idPrefix, onSnapshot });
 
-  function startChatRun({
-    runId = "",
-    client,
-    targetUrl = CHAT_TARGET_URL,
+  function startChatRun({
+    runId = "",
+    client,
+    targetUrl = CHAT_TARGET_URL,
     job = "",
     startFrom = "all",
     criteria = "",
@@ -1929,10 +1958,10 @@ export function createChatRunService({
       legacyEnabled: humanRestEnabled === true || llmConfig?.humanRestEnabled === true
     });
     const effectiveHumanRestEnabled = effectiveHumanBehavior.restEnabled;
-    return manager.startRun({
-      runId,
-      name,
-      context: {
+    return manager.startRun({
+      runId,
+      name,
+      context: {
         domain: "chat",
         target_url: targetUrl,
         criteria_present: Boolean(criteria),
@@ -1962,13 +1991,13 @@ export function createChatRunService({
         list_settle_ms: listSettleMs,
         list_fallback_point: listFallbackPoint,
         online_resume_button_timeout_ms: onlineResumeButtonTimeoutMs,
-        image_output_dir: imageOutputDir || "",
-        human_behavior_enabled: effectiveHumanBehavior.enabled,
-        human_behavior_profile: effectiveHumanBehavior.profile,
-        human_behavior: effectiveHumanBehavior,
-        human_rest_level: effectiveHumanBehavior.restLevel,
-        human_rest_enabled: effectiveHumanRestEnabled
-      },
+        image_output_dir: imageOutputDir || "",
+        human_behavior_enabled: effectiveHumanBehavior.enabled,
+        human_behavior_profile: effectiveHumanBehavior.profile,
+        human_behavior: effectiveHumanBehavior,
+        human_rest_level: effectiveHumanBehavior.restLevel,
+        human_rest_enabled: effectiveHumanRestEnabled
+      },
       progress: {
         card_count: 0,
         target_count: targetPassCount || (processUntilListEnd ? "all" : processedLimit),
@@ -1983,11 +2012,11 @@ export function createChatRunService({
         requested: 0,
         request_satisfied: 0,
         request_skipped: 0,
-        context_recoveries: 0,
-        human_behavior_enabled: effectiveHumanBehavior.enabled,
-        human_behavior_profile: effectiveHumanBehavior.profile,
-        human_rest_level: effectiveHumanBehavior.restLevel,
-        human_rest_enabled: effectiveHumanRestEnabled,
+        context_recoveries: 0,
+        human_behavior_enabled: effectiveHumanBehavior.enabled,
+        human_behavior_profile: effectiveHumanBehavior.profile,
+        human_rest_level: effectiveHumanBehavior.restLevel,
+        human_rest_enabled: effectiveHumanRestEnabled,
         human_rest_count: 0,
         human_rest_ms: 0,
         last_human_event: null

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

@@ -38,13 +38,15 @@ import {
   resolveInfiniteListFallbackPoint
 } from "../../core/infinite-list/index.js";
 import { createViewportRunGuard } from "../../core/self-heal/index.js";
-import {
-  callScreeningLlm,
-  compactScreeningLlmResult,
-  createFailedLlmScreeningResult,
-  llmResultToScreening,
-  screenCandidate
-} from "../../core/screening/index.js";
+import {
+  callScreeningLlm,
+  compactScreeningLlmResult,
+  createFatalLlmRunError,
+  createFailedLlmScreeningResult,
+  isFatalLlmProviderError,
+  llmResultToScreening,
+  screenCandidate
+} from "../../core/screening/index.js";
 import {
   closeRecommendBlockingPanels,
   closeRecommendAvatarPreview,
@@ -906,8 +908,8 @@ export async function runRecommendWorkflow({
       recovery_reason: reason
     });
     return refreshResult;
-  }
-
+  }
+
   runControl.setPhase("recommend:cleanup");
   await closeRecommendDetail(client, { attemptsLimit: 2 });
   await closeRecommendAvatarPreview(client, { attemptsLimit: 2 });
@@ -1334,18 +1336,24 @@ export async function runRecommendWorkflow({
           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,
-            timeoutMs: llmTimeoutMs,
+          llmResult = await measureTiming(timings, llmTimingKey, () => callScreeningLlm({
+            candidate: screeningCandidate,
+            criteria,
+            config: llmConfig,
+            timeoutMs: llmTimeoutMs,
             imageEvidence: detailResult?.image_evidence || null,
             maxImages: llmImageLimit,
             imageDetail: llmImageDetail
           }));
-        } catch (error) {
-          llmResult = createFailedLlmScreeningResult(error);
-        }
+          } catch (error) {
+            if (isFatalLlmProviderError(error)) {
+              throw createFatalLlmRunError(error, {
+                domain: "recommend",
+                candidate: screeningCandidate
+              });
+            }
+            llmResult = createFailedLlmScreeningResult(error);
+          }
       }
       if (detailResult) detailResult.llm_result = llmResult;
     }
@@ -1532,7 +1540,7 @@ export async function runRecommendWorkflow({
     human_rest: humanRestController.getState(),
     last_human_event: lastHumanEvent,
     list_end_reason: listEndReason || null,
-    refresh_rounds: refreshRounds,
+    refresh_rounds: refreshRounds,
     refresh_attempts: refreshAttempts,
     context_recoveries: contextRecoveryAttempts,
     ...countRecommendResultStatuses(results, { greetCount }),

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

@@ -39,7 +39,9 @@ import { createViewportRunGuard } from "../../core/self-heal/index.js";
 import {
   callScreeningLlm,
   compactScreeningLlmResult,
+  createFatalLlmRunError,
   createFailedLlmScreeningResult,
+  isFatalLlmProviderError,
   llmResultToScreening,
   screenCandidate
 } from "../../core/screening/index.js";
@@ -1022,6 +1024,12 @@ export async function runRecruitWorkflow({
             imageDetail: llmImageDetail
           }));
         } catch (error) {
+          if (isFatalLlmProviderError(error)) {
+            throw createFatalLlmRunError(error, {
+              domain: "recruit",
+              candidate: screeningCandidate
+            });
+          }
           llmResult = createFailedLlmScreeningResult(error);
         }
       }