@reconcrap/boss-recommend-mcp 2.1.20 → 2.1.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recommend-mcp",
-  "version": "2.1.20",
+  "version": "2.1.21",
   "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
   "keywords": [
     "boss",

package/src/core/browser/index.js

@@ -462,6 +462,9 @@ export function createHumanRestController({
   shortRestProbability = 0.08,
   shortRestMinMs = 3000,
   shortRestMaxMs = 7000,
+  perCandidateRestEnabled = false,
+  perCandidateRestMinMs = 0,
+  perCandidateRestMaxMs = 0,
   batchThresholdBase = 25,
   batchThresholdJitter = 8,
   batchRestMinMs = 15000,
@@ -470,7 +473,10 @@ export function createHumanRestController({
   const nextRandom = normalizeRandom(random);
   const readNow = typeof nowFn === "function" ? nowFn : Date.now;
   const normalizedRestLevel = normalizeHumanRestLevel(restLevel);
-  const budgetProfile = (shortRestEnabled !== false || batchRestEnabled !== false)
+  const perCandidateMinMs = Math.max(0, Number(perCandidateRestMinMs) || 0);
+  const perCandidateMaxMs = Math.max(perCandidateMinMs, Number(perCandidateRestMaxMs) || perCandidateMinMs);
+  const perCandidateEnabled = enabled === true && perCandidateRestEnabled === true && perCandidateMaxMs > 0;
+  const budgetProfile = !perCandidateEnabled && (shortRestEnabled !== false || batchRestEnabled !== false)
     ? HUMAN_REST_LEVEL_PROFILES[normalizedRestLevel] || null
     : null;
   const nextBudgetRestInterval = () => budgetProfile
@@ -479,6 +485,9 @@ export function createHumanRestController({
   const state = {
     enabled: enabled === true,
     rest_level: normalizedRestLevel,
+    per_candidate_rest_enabled: perCandidateEnabled,
+    per_candidate_rest_min_ms: perCandidateMinMs,
+    per_candidate_rest_max_ms: perCandidateMaxMs,
     short_rest_enabled: enabled === true && shortRestEnabled !== false,
     batch_rest_enabled: enabled === true && batchRestEnabled !== false,
     rest_counter: 0,
@@ -569,6 +578,40 @@ export function createHumanRestController({
     }
     const sleeper = typeof sleepFn === "function" ? sleepFn : sleep;
     updateActiveElapsed();
+    if (state.per_candidate_rest_enabled) {
+      state.rest_counter += 1;
+      state.processed_count += 1;
+      state.candidates_since_last_rest += 1;
+      const pauseMs = Math.round(randomBetween(
+        nextRandom,
+        state.per_candidate_rest_min_ms,
+        state.per_candidate_rest_max_ms
+      ));
+      await sleeper(pauseMs);
+      state.rest_count += 1;
+      state.total_rest_ms += pauseMs;
+      state.last_active_at_ms = Number(readNow()) || state.last_active_at_ms;
+      const event = {
+        kind: "per_candidate_rest",
+        rest_level: normalizedRestLevel,
+        pause_ms: pauseMs,
+        processed_since_last_rest: state.candidates_since_last_rest
+      };
+      state.candidates_since_last_rest = 0;
+      return {
+        enabled: true,
+        rested: true,
+        pause_ms: pauseMs,
+        rest_level: normalizedRestLevel,
+        rest_counter: state.rest_counter,
+        rest_threshold: state.rest_threshold,
+        processed_count: state.processed_count,
+        active_elapsed_ms: state.active_elapsed_ms,
+        rest_count: state.rest_count,
+        total_rest_ms: state.total_rest_ms,
+        events: [event]
+      };
+    }
     if (budgetProfile) {
       const budgetEvent = await takeBudgetBreakIfNeeded(sleeper);
       const pauseMs = budgetEvent?.pause_ms || 0;

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

@@ -88,11 +88,13 @@ import {
   makeForbiddenChatResumeNavigationError,
   recoverChatShell
 } from "./page-guard.js";
-import { getChatRoots } from "./roots.js";
-
-const DETAIL_SOURCES = new Set(["cascade", "network", "dom", "image"]);
-
-function normalizeDetailSource(value) {
+import { getChatRoots } from "./roots.js";
+
+const DETAIL_SOURCES = new Set(["cascade", "network", "dom", "image"]);
+const CHAT_COLLECT_CV_PER_CANDIDATE_REST_MIN_MS = 5000;
+const CHAT_COLLECT_CV_PER_CANDIDATE_REST_MAX_MS = 8000;
+
+function normalizeDetailSource(value) {
   const normalized = String(value || "").trim().toLowerCase();
   return DETAIL_SOURCES.has(normalized) ? normalized : "cascade";
 }
@@ -939,13 +941,18 @@ export async function runChatWorkflow({
   humanBehavior = null
 } = {}, runControl) {
   if (!client) throw new Error("runChatWorkflow requires a guarded CDP client");
-  const effectiveHumanBehavior = normalizeHumanBehaviorOptions(humanBehavior, {
-    legacyEnabled: humanRestEnabled === true || llmConfig?.humanRestEnabled === true
-  });
-  const effectiveHumanRestEnabled = effectiveHumanBehavior.restEnabled;
-  configureHumanInteraction(client, {
-    enabled: effectiveHumanBehavior.enabled,
-    clickMovementEnabled: effectiveHumanBehavior.clickMovement,
+  const effectiveHumanBehavior = normalizeHumanBehaviorOptions(humanBehavior, {
+    legacyEnabled: humanRestEnabled === true || llmConfig?.humanRestEnabled === true
+  });
+  const normalizedDetailSource = normalizeDetailSource(detailSource);
+  const normalizedScreeningMode = normalizeText(criteria) ? normalizeScreeningMode(screeningMode) : "collect_cv";
+  const collectCvOnly = normalizedScreeningMode === "collect_cv" || !normalizeText(criteria);
+  const useLlmScreening = normalizedScreeningMode === "llm" && !collectCvOnly;
+  const collectCvPerCandidateRestEnabled = collectCvOnly && effectiveHumanBehavior.enabled;
+  const effectiveHumanRestEnabled = effectiveHumanBehavior.restEnabled || collectCvPerCandidateRestEnabled;
+  configureHumanInteraction(client, {
+    enabled: effectiveHumanBehavior.enabled,
+    clickMovementEnabled: effectiveHumanBehavior.clickMovement,
     textEntryEnabled: effectiveHumanBehavior.textEntry,
     safeClickPointEnabled: effectiveHumanBehavior.clickMovement,
     actionCooldownEnabled: effectiveHumanBehavior.actionCooldown
@@ -954,13 +961,12 @@ export async function runChatWorkflow({
     enabled: effectiveHumanRestEnabled,
     shortRestEnabled: effectiveHumanBehavior.shortRest,
     batchRestEnabled: effectiveHumanBehavior.batchRest,
-    restLevel: effectiveHumanBehavior.restLevel
+    restLevel: effectiveHumanBehavior.restLevel,
+    perCandidateRestEnabled: collectCvPerCandidateRestEnabled,
+    perCandidateRestMinMs: CHAT_COLLECT_CV_PER_CANDIDATE_REST_MIN_MS,
+    perCandidateRestMaxMs: CHAT_COLLECT_CV_PER_CANDIDATE_REST_MAX_MS
   });
-  const normalizedDetailSource = normalizeDetailSource(detailSource);
-  const normalizedScreeningMode = normalizeText(criteria) ? normalizeScreeningMode(screeningMode) : "collect_cv";
-  const collectCvOnly = normalizedScreeningMode === "collect_cv" || !normalizeText(criteria);
-  const useLlmScreening = normalizedScreeningMode === "llm" && !collectCvOnly;
-  const processedLimit = Math.max(1, Number(maxCandidates) || 1);
+  const processedLimit = Math.max(1, Number(maxCandidates) || 1);
   const passTarget = Number.isFinite(Number(targetPassCount)) && Number(targetPassCount) > 0
     ? Number(targetPassCount)
     : null;
@@ -1177,11 +1183,14 @@ export async function runChatWorkflow({
       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,
-      human_rest_ms: humanRestController.getState().total_rest_ms,
+      human_behavior_profile: effectiveHumanBehavior.profile,
+      human_rest_level: effectiveHumanBehavior.restLevel,
+      human_rest_enabled: effectiveHumanRestEnabled,
+      human_rest_per_candidate_enabled: collectCvPerCandidateRestEnabled,
+      human_rest_per_candidate_min_ms: collectCvPerCandidateRestEnabled ? CHAT_COLLECT_CV_PER_CANDIDATE_REST_MIN_MS : null,
+      human_rest_per_candidate_max_ms: collectCvPerCandidateRestEnabled ? CHAT_COLLECT_CV_PER_CANDIDATE_REST_MAX_MS : null,
+      human_rest_count: humanRestController.getState().rest_count,
+      human_rest_ms: humanRestController.getState().total_rest_ms,
       last_human_event: lastHumanEvent
     });
     runControl.setPhase("chat:done");
@@ -1239,10 +1248,20 @@ export async function runChatWorkflow({
     screening_mode: normalizedScreeningMode,
     unique_seen: compactInfiniteListState(listState).seen_count,
     scroll_count: 0,
-    context_recoveries: contextRecoveryAttempts,
-    viewport_checks: viewportGuard.getStats().checks,
-    viewport_recoveries: viewportGuard.getStats().recoveries
-  });
+    context_recoveries: contextRecoveryAttempts,
+    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_per_candidate_enabled: collectCvPerCandidateRestEnabled,
+    human_rest_per_candidate_min_ms: collectCvPerCandidateRestEnabled ? CHAT_COLLECT_CV_PER_CANDIDATE_REST_MIN_MS : null,
+    human_rest_per_candidate_max_ms: collectCvPerCandidateRestEnabled ? CHAT_COLLECT_CV_PER_CANDIDATE_REST_MAX_MS : null,
+    human_rest_count: humanRestController.getState().rest_count,
+    human_rest_ms: humanRestController.getState().total_rest_ms,
+    last_human_event: lastHumanEvent
+  });
 
   while (
     results.length < processedLimit
@@ -2027,11 +2046,14 @@ export async function runChatWorkflow({
       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,
-      human_rest_ms: humanRestController.getState().total_rest_ms,
+      human_behavior_profile: effectiveHumanBehavior.profile,
+      human_rest_level: effectiveHumanBehavior.restLevel,
+      human_rest_enabled: effectiveHumanRestEnabled,
+      human_rest_per_candidate_enabled: collectCvPerCandidateRestEnabled,
+      human_rest_per_candidate_min_ms: collectCvPerCandidateRestEnabled ? CHAT_COLLECT_CV_PER_CANDIDATE_REST_MIN_MS : null,
+      human_rest_per_candidate_max_ms: collectCvPerCandidateRestEnabled ? CHAT_COLLECT_CV_PER_CANDIDATE_REST_MAX_MS : null,
+      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,
       last_candidate_key: candidateKey,
@@ -2071,10 +2093,11 @@ export async function runChatWorkflow({
         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,
+          human_rest_enabled: effectiveHumanRestEnabled,
+          human_rest_level: effectiveHumanBehavior.restLevel,
+          human_rest_per_candidate_enabled: collectCvPerCandidateRestEnabled,
+          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
@@ -2175,12 +2198,14 @@ export function createChatRunService({
     if (!client) throw new Error("startChatRun requires a guarded CDP client");
     const normalizedDetailSource = normalizeDetailSource(detailSource);
     const normalizedScreeningMode = normalizeText(criteria) ? normalizeScreeningMode(screeningMode) : "collect_cv";
-    const processedLimit = Math.max(1, Number(maxCandidates) || 1);
-    const normalizedDetailLimit = detailLimit == null ? processedLimit : Math.max(0, Number(detailLimit) || 0);
-    const effectiveHumanBehavior = normalizeHumanBehaviorOptions(humanBehavior, {
-      legacyEnabled: humanRestEnabled === true || llmConfig?.humanRestEnabled === true
-    });
-    const effectiveHumanRestEnabled = effectiveHumanBehavior.restEnabled;
+    const collectCvOnly = normalizedScreeningMode === "collect_cv" || !normalizeText(criteria);
+    const processedLimit = Math.max(1, Number(maxCandidates) || 1);
+    const normalizedDetailLimit = detailLimit == null ? processedLimit : Math.max(0, Number(detailLimit) || 0);
+    const effectiveHumanBehavior = normalizeHumanBehaviorOptions(humanBehavior, {
+      legacyEnabled: humanRestEnabled === true || llmConfig?.humanRestEnabled === true
+    });
+    const collectCvPerCandidateRestEnabled = collectCvOnly && effectiveHumanBehavior.enabled;
+    const effectiveHumanRestEnabled = effectiveHumanBehavior.restEnabled || collectCvPerCandidateRestEnabled;
     return manager.startRun({
       runId,
       name,
@@ -2206,10 +2231,10 @@ export function createChatRunService({
         llm_configured: Boolean(llmConfig),
         llm_timeout_ms: llmTimeoutMs,
         llm_image_limit: llmImageLimit,
-        llm_image_detail: llmImageDetail,
-        max_image_pages: maxImagePages,
-        image_wheel_delta_y: imageWheelDeltaY,
-        list_max_scrolls: listMaxScrolls,
+        llm_image_detail: llmImageDetail,
+        max_image_pages: maxImagePages,
+        image_wheel_delta_y: imageWheelDeltaY,
+        list_max_scrolls: listMaxScrolls,
         list_stable_signature_limit: listStableSignatureLimit,
         list_wheel_delta_y: listWheelDeltaY,
         list_settle_ms: listSettleMs,
@@ -2221,7 +2246,9 @@ export function createChatRunService({
         human_behavior: effectiveHumanBehavior,
         human_rest_level: effectiveHumanBehavior.restLevel,
         human_rest_enabled: effectiveHumanRestEnabled,
-        cv_collection_mode: normalizedScreeningMode === "collect_cv"
+        human_rest_per_candidate_enabled: collectCvPerCandidateRestEnabled,
+        human_rest_per_candidate_min_ms: collectCvPerCandidateRestEnabled ? CHAT_COLLECT_CV_PER_CANDIDATE_REST_MIN_MS : null,
+        human_rest_per_candidate_max_ms: collectCvPerCandidateRestEnabled ? CHAT_COLLECT_CV_PER_CANDIDATE_REST_MAX_MS : null
       },
       progress: {
         card_count: 0,
@@ -2239,10 +2266,13 @@ export function createChatRunService({
         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,
-        human_rest_count: 0,
+        human_behavior_profile: effectiveHumanBehavior.profile,
+        human_rest_level: effectiveHumanBehavior.restLevel,
+        human_rest_enabled: effectiveHumanRestEnabled,
+        human_rest_per_candidate_enabled: collectCvPerCandidateRestEnabled,
+        human_rest_per_candidate_min_ms: collectCvPerCandidateRestEnabled ? CHAT_COLLECT_CV_PER_CANDIDATE_REST_MIN_MS : null,
+        human_rest_per_candidate_max_ms: collectCvPerCandidateRestEnabled ? CHAT_COLLECT_CV_PER_CANDIDATE_REST_MAX_MS : null,
+        human_rest_count: 0,
         human_rest_ms: 0,
         last_human_event: null
       },