@reconcrap/boss-recommend-mcp 2.0.6 → 2.0.8

package/README.md

@@ -98,6 +98,8 @@ boss-recommend-mcp list-jobs --slow-live --port 9222
 - 不会对每位候选人重复确认
 - 推荐页详情处理完成后，会强制关闭详情页并确认已关闭
 - 简历提取优先使用 Network 响应；没有可解析 Network CV 时，回退到完整滚动截图序列再交给多模态模型判断
+- recommend / search / chat 正式运行默认全部使用 `screening-config.json` 配置的 LLM 筛选；deterministic/local scorer 只保留给明确测试场景，必须显式传 `debug_test_mode=true` 且 `screening_mode=deterministic` 或 `use_llm=false`。
+- `detail_limit=0`、`no_filter`、`filter_enabled=false`、后置动作 dry-run、chat 求简历 dry-run 等调试路径不会在正式 live run 默认启用；需要测试时必须显式传 `debug_test_mode=true`。
 - 提供显式运维自愈工具：只在手动调用 `run_recommend_self_heal` 时运行，不会接入正常 run / doctor / preflight 自动链路
 - 运行前会自动做依赖体检（Node.js、Python、Pillow、`chrome-remote-interface`、`ws`），缺失时会在 `doctor` 与流水线失败诊断中明确提示
 - 若 preflight 失败，返回 `diagnostics.recovery`（含有序修复步骤与 `agent_prompt`），可直接交给 AI agent 自动按顺序安装依赖

package/package.json

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

package/src/chat-mcp.js

@@ -308,8 +308,15 @@ function ensureChatRunArtifacts(snapshot) {
   if (meta) meta.checkpointPath = artifacts.checkpoint_path;
 
   const summary = snapshot?.summary && typeof snapshot.summary === "object" ? snapshot.summary : null;
-  if (summary) {
-    const rows = Array.isArray(summary.results) ? summary.results : [];
+  const checkpointResults = Array.isArray(checkpoint.results) ? checkpoint.results : [];
+  const artifactSummary = summary || (checkpointResults.length ? {
+    domain: "chat",
+    partial: true,
+    partial_reason: snapshot?.status || snapshot?.state || "non_terminal",
+    results: checkpointResults
+  } : null);
+  if (artifactSummary) {
+    const rows = Array.isArray(artifactSummary.results) ? artifactSummary.results : [];
     writeChatLegacyCsvAtomic(artifacts.output_csv, rows, snapshot, meta);
     writeJsonAtomic(artifacts.report_json, {
       run_id: snapshot.runId || snapshot.run_id,
@@ -318,7 +325,7 @@ function ensureChatRunArtifacts(snapshot) {
       progress: snapshot.progress || {},
       context: snapshot.context || {},
       checkpoint,
-      summary,
+      summary: artifactSummary,
       generated_at: new Date().toISOString()
     });
     if (meta) {
@@ -335,6 +342,12 @@ function buildLegacyChatResult(snapshot) {
   const artifacts = ensureChatRunArtifacts(snapshot);
   const meta = getChatRunMeta(snapshot.runId);
   const summary = snapshot.summary && typeof snapshot.summary === "object" ? snapshot.summary : null;
+  const checkpoint = snapshot.checkpoint && typeof snapshot.checkpoint === "object" ? snapshot.checkpoint : {};
+  const resultRows = Array.isArray(summary?.results)
+    ? summary.results
+    : Array.isArray(checkpoint.results)
+      ? checkpoint.results
+      : [];
   const progress = normalizeLegacyProgress(snapshot.progress, summary);
   return {
     run_id: snapshot.runId,
@@ -358,7 +371,7 @@ function buildLegacyChatResult(snapshot) {
     completed_at: snapshot.completedAt || null,
     duration_sec: secondsBetween(snapshot.startedAt, snapshot.completedAt),
     error: snapshot.error || null,
-    results: Array.isArray(summary?.results) ? summary.results : []
+    results: resultRows
   };
 }
 
@@ -788,16 +801,31 @@ function shouldRequestChatResume(args = {}) {
   );
 }
 
-function shouldUseChatLlm(args = {}, shouldRequestResume = false) {
-  if (args.use_llm === false) return false;
-  return (
-    args.use_llm === true
-    || shouldRequestResume
-    || parseNonNegativeInteger(args.detail_limit, 0) > 0
-  );
+function isDebugTestMode(args = {}) {
+  return args.debug_test_mode === true || args.allow_debug_test_mode === true;
+}
+
+function normalizeScreeningModeArg(args = {}) {
+  const raw = normalizeText(args.screening_mode || args.screeningMode || "");
+  if (args.use_llm === false) return "deterministic";
+  return ["deterministic", "local", "local_scorer"].includes(raw.toLowerCase())
+    ? "deterministic"
+    : "llm";
+}
+
+function collectChatDebugTestOptions(args = {}) {
+  const reasons = [];
+  if (normalizeScreeningModeArg(args) === "deterministic") reasons.push("deterministic_screening");
+  if (parseNonNegativeInteger(args.detail_limit, null) === 0) reasons.push("detail_limit=0");
+  if (args.dry_run === true || args.dry_run_request_cv === true) reasons.push("dry_run_request_cv");
+  return reasons;
+}
+
+function shouldUseChatLlm(args = {}) {
+  return normalizeScreeningModeArg(args) !== "deterministic";
 }
 
-function getRunOptions(args, normalized, session, { workspaceRoot = "" } = {}) {
+function getRunOptions(args, normalized, session, { workspaceRoot = "", configResolution = null } = {}) {
   const slowLive = args.slow_live === true;
   const isAllTarget = normalized.publicTargetCount === "all";
   const processedLimit = parsePositiveInteger(
@@ -805,8 +833,8 @@ function getRunOptions(args, normalized, session, { workspaceRoot = "" } = {}) {
     isAllTarget ? CHAT_ALL_MAX_CANDIDATES : CHAT_ALL_MAX_CANDIDATES
   );
   const shouldRequestResume = shouldRequestChatResume(args);
-  const useLlm = shouldUseChatLlm(args, shouldRequestResume);
-  const configResolution = useLlm ? resolveBossScreeningConfig(workspaceRoot) : { ok: false };
+  const useLlm = shouldUseChatLlm(args);
+  const resolvedConfig = configResolution || (useLlm ? resolveBossScreeningConfig(workspaceRoot) : { ok: false });
   return {
     client: session.client,
     targetUrl: CHAT_TARGET_URL,
@@ -832,17 +860,19 @@ function getRunOptions(args, normalized, session, { workspaceRoot = "" } = {}) {
     resumeDomTimeoutMs: slowLive ? 120000 : 60000,
     maxImagePages: parsePositiveInteger(args.max_image_pages, 8),
     imageWheelDeltaY: parsePositiveInteger(args.image_wheel_delta_y, 650),
-    llmConfig: configResolution.ok ? {
-      ...configResolution.config
+    llmConfig: resolvedConfig.ok ? {
+      ...resolvedConfig.config
     } : null,
     llmTimeoutMs: parsePositiveInteger(args.llm_timeout_ms, slowLive ? 180000 : 120000),
     llmImageLimit: parsePositiveInteger(args.llm_image_limit, 8),
     llmImageDetail: normalizeText(args.llm_image_detail) || "high",
+    screeningMode: normalizeScreeningModeArg(args),
     listMaxScrolls: parsePositiveInteger(args.list_max_scrolls, 200),
     listStableSignatureLimit: parsePositiveInteger(args.list_stable_signature_limit, 2),
     listWheelDeltaY: parsePositiveInteger(args.list_wheel_delta_y, 850),
     listSettleMs: parsePositiveInteger(args.list_settle_ms, slowLive ? 1800 : 1200),
     listFallbackPoint: null,
+    imageOutputDir: resolveBossConfiguredOutputDir("", getChatRunsDir()),
     name: "mcp-boss-chat-run"
   };
 }
@@ -905,7 +935,19 @@ async function startBossChatRunInternal(args = {}, { workspaceRoot = "" } = {})
   }
 
   const shouldRequestResume = shouldRequestChatResume(args);
-  const useLlm = shouldUseChatLlm(args, shouldRequestResume);
+  const useLlm = shouldUseChatLlm(args);
+  const debugTestOptions = collectChatDebugTestOptions(args);
+  if (debugTestOptions.length && !isDebugTestMode(args)) {
+    return {
+      status: "FAILED",
+      error: {
+        code: "DEBUG_TEST_MODE_REQUIRED",
+        message: `这些参数属于调试/测试路径，正式 live run 不会默认启用：${debugTestOptions.join(", ")}。如确需测试，请显式传 debug_test_mode=true。`,
+        retryable: false
+      },
+      debug_test_options: debugTestOptions
+    };
+  }
   const configResolution = useLlm ? resolveBossScreeningConfig(workspaceRoot) : null;
   if (useLlm && !configResolution?.ok) {
     return {
@@ -948,7 +990,7 @@ async function startBossChatRunInternal(args = {}, { workspaceRoot = "" } = {})
 
   let started;
   try {
-    started = chatRunService.startChatRun(getRunOptions(args, normalized, session, { workspaceRoot }));
+    started = chatRunService.startChatRun(getRunOptions(args, normalized, session, { workspaceRoot, configResolution }));
   } catch (error) {
     await session.close?.();
     return {

package/src/core/boss-cards/index.js

@@ -0,0 +1,199 @@
+import { htmlToText, normalizeText } from "../screening/index.js";
+
+function uniqueTexts(values = []) {
+  return Array.from(new Set(values.map((value) => normalizeText(value)).filter(Boolean)));
+}
+
+function classList(value = "") {
+  return String(value || "").split(/\s+/).map((item) => item.trim()).filter(Boolean);
+}
+
+function hasAllClasses(classValue = "", requiredClasses = []) {
+  const classes = classList(classValue);
+  return requiredClasses.every((required) => classes.includes(required));
+}
+
+function findClassAttributeIndex(html = "", requiredClasses = [], startIndex = 0) {
+  const regex = /class=(["'])(.*?)\1/gi;
+  regex.lastIndex = Math.max(0, Number(startIndex) || 0);
+  let match;
+  while ((match = regex.exec(String(html || "")))) {
+    if (hasAllClasses(match[2], requiredClasses)) return match.index;
+  }
+  return -1;
+}
+
+function sectionByClasses(html = "", startClasses = [], endClassGroups = []) {
+  const source = String(html || "");
+  const classIndex = findClassAttributeIndex(source, startClasses);
+  if (classIndex < 0) return "";
+  const start = Math.max(0, source.lastIndexOf("<", classIndex));
+  let end = source.length;
+  for (const group of endClassGroups) {
+    const found = findClassAttributeIndex(source, group, classIndex + 1);
+    if (found >= 0) {
+      const tagStart = source.lastIndexOf("<", found);
+      end = Math.min(end, tagStart >= 0 ? tagStart : found);
+    }
+  }
+  return source.slice(start, end);
+}
+
+function textFromHtmlFragment(fragment = "") {
+  return normalizeText(htmlToText(fragment).replace(/\n+/g, " "));
+}
+
+function stripNameSuffixes(value = "") {
+  return normalizeText(value)
+    .replace(/\s*(在线|刚刚活跃|今日活跃|本周活跃|本月活跃)$/u, "")
+    .trim();
+}
+
+function extractFirstSpanWithClass(html = "", className = "") {
+  const regex = /<span\b[^>]*class=(["'])(.*?)\1[^>]*>([\s\S]*?)<\/span>/gi;
+  let match;
+  while ((match = regex.exec(String(html || "")))) {
+    if (classList(match[2]).includes(className)) {
+      return textFromHtmlFragment(match[3]);
+    }
+  }
+  return "";
+}
+
+function extractSpanTexts(fragment = "") {
+  const values = [];
+  const regex = /<span\b[^>]*>([\s\S]*?)<\/span>/gi;
+  let match;
+  while ((match = regex.exec(String(fragment || "")))) {
+    values.push(textFromHtmlFragment(match[1]));
+  }
+  return uniqueTexts(values);
+}
+
+function extractDivTextsWithClasses(fragment = "", requiredClasses = []) {
+  const values = [];
+  const regex = /<div\b[^>]*class=(["'])(.*?)\1[^>]*>([\s\S]*?)<\/div>/gi;
+  let match;
+  while ((match = regex.exec(String(fragment || "")))) {
+    if (hasAllClasses(match[2], requiredClasses)) {
+      values.push(extractSpanTexts(match[3]));
+    }
+  }
+  return values.filter((items) => items.length);
+}
+
+function parseAgeValue(value = "") {
+  const match = normalizeText(value).match(/^(\d{2})岁$/u);
+  if (!match) return null;
+  const age = Number.parseInt(match[1], 10);
+  return Number.isFinite(age) ? age : null;
+}
+
+function parseDegreeValue(value = "") {
+  const normalized = normalizeText(value);
+  const match = normalized.match(/博士|硕士|本科|大专|专科|高中|中专\/中技|中专|中技|初中及以下/u);
+  return match ? match[0] : "";
+}
+
+function isSalaryLike(value = "") {
+  const normalized = normalizeText(value);
+  return Boolean(
+    /^(?:面议|薪资面议)$/i.test(normalized)
+    || /^\d+(?:\.\d+)?(?:\s*-\s*\d+(?:\.\d+)?)?\s*[kK](?:\s*[·xX*]\s*\d+\s*薪?)?$/.test(normalized)
+    || /^\d+\s*-\s*\d+\s*元\s*\/\s*天$/.test(normalized)
+  );
+}
+
+function extractSalary(html = "") {
+  const section = sectionByClasses(html, ["salary-wrap"], [
+    ["name-wrap"],
+    ["col-2"]
+  ]);
+  return extractSpanTexts(section).find(isSalaryLike) || "";
+}
+
+function extractBaseInfo(html = "") {
+  const section = sectionByClasses(html, ["base-info"], [
+    ["expect-wrap"],
+    ["geek-desc"],
+    ["timeline-wrap"]
+  ]);
+  const parts = extractSpanTexts(section);
+  return {
+    parts,
+    age: parts.map(parseAgeValue).find((value) => value != null) ?? null,
+    degree: parts.map(parseDegreeValue).find(Boolean) || ""
+  };
+}
+
+function extractFirstTimelineContent(html = "", timelineClass = "") {
+  const section = sectionByClasses(html, ["timeline-wrap", timelineClass], [
+    timelineClass === "work-exps" ? ["timeline-wrap", "edu-exps"] : ["card-btns"],
+    ["action-wrap"]
+  ]);
+  const contentRows = extractDivTextsWithClasses(section, ["join-text-wrap", "content"]);
+  return contentRows[0] || [];
+}
+
+function extractTagTexts(html = "") {
+  const tags = [];
+  const regex = /<span\b[^>]*class=(["'])(.*?)\1[^>]*>([\s\S]*?)<\/span>/gi;
+  let match;
+  while ((match = regex.exec(String(html || "")))) {
+    if (classList(match[2]).includes("tag-item")) {
+      tags.push(textFromHtmlFragment(match[3]));
+    }
+  }
+  return uniqueTexts(tags);
+}
+
+export function parseBossCandidateCardFieldsFromHtml(html = "") {
+  const name = stripNameSuffixes(extractFirstSpanWithClass(html, "name"));
+  const baseInfo = extractBaseInfo(html);
+  const work = extractFirstTimelineContent(html, "work-exps");
+  const education = extractFirstTimelineContent(html, "edu-exps");
+  const educationDegree = education.map(parseDegreeValue).find(Boolean) || "";
+  return {
+    identity: {
+      name: name && !isSalaryLike(name) ? name : "",
+      current_company: work[0] || "",
+      current_position: work[1] || "",
+      school: education[0] || "",
+      major: education[1] || "",
+      degree: educationDegree || baseInfo.degree || "",
+      age: baseInfo.age
+    },
+    salary: extractSalary(html),
+    base_info: baseInfo.parts,
+    work,
+    education,
+    tags: extractTagTexts(html)
+  };
+}
+
+export function mergeBossCandidateCardFields(candidate, outerHTML = "", {
+  metadataKey = "boss_card_fields"
+} = {}) {
+  const parsed = parseBossCandidateCardFieldsFromHtml(outerHTML);
+  const identity = { ...(candidate.identity || {}) };
+  for (const [key, value] of Object.entries(parsed.identity || {})) {
+    if (value !== "" && value !== null && value !== undefined) {
+      identity[key] = value;
+    }
+  }
+  return {
+    ...candidate,
+    identity,
+    tags: uniqueTexts([...(candidate.tags || []), ...(parsed.tags || [])]),
+    metadata: {
+      ...(candidate.metadata || {}),
+      [metadataKey]: {
+        salary: parsed.salary || "",
+        base_info: parsed.base_info || [],
+        work: parsed.work || [],
+        education: parsed.education || [],
+        tags: parsed.tags || []
+      }
+    }
+  };
+}

package/src/core/capture/index.js

@@ -163,11 +163,13 @@ export async function captureScrolledNodeScreenshots(client, nodeId, {
   metadata = {}
 } = {}) {
   if (!nodeId) throw new Error("captureScrolledNodeScreenshots requires nodeId");
+  const sequenceStarted = Date.now();
   const screenshots = [];
   let consecutiveDuplicates = 0;
   let previousHash = "";
 
   for (let index = 0; index < Math.max(1, Number(maxScreenshots) || 1); index += 1) {
+    const captureStarted = Date.now();
     const box = await getNodeBox(client, nodeId);
     const clip = withPadding(box.rect, padding);
     const captureOptions = {
@@ -202,6 +204,7 @@ export async function captureScrolledNodeScreenshots(client, nodeId, {
       format,
       mime_type: `image/${format === "jpeg" ? "jpeg" : "png"}`,
       byte_length: buffer.length,
+      elapsed_ms: Date.now() - captureStarted,
       file_path: outputPath,
       sha256: hash,
       duplicate_of_previous: Boolean(duplicateOfPrevious),
@@ -238,6 +241,7 @@ export async function captureScrolledNodeScreenshots(client, nodeId, {
     source: "image-scroll-sequence",
     captured_at: nowIso(),
     node_id: nodeId,
+    elapsed_ms: Date.now() - sequenceStarted,
     screenshot_count: screenshots.length,
     unique_screenshot_count: new Set(screenshots.map((item) => item.sha256)).size,
     file_paths: screenshots.map((item) => item.file_path).filter(Boolean),

package/src/core/cv-acquisition/index.js

@@ -125,6 +125,7 @@ export function summarizeImageEvidence(imageEvidence = null) {
   if (!imageEvidence) return null;
   return {
     source: imageEvidence.source || "",
+    elapsed_ms: imageEvidence.elapsed_ms || 0,
     screenshot_count: imageEvidence.screenshot_count || 0,
     unique_screenshot_count: imageEvidence.unique_screenshot_count || 0,
     file_paths: imageEvidence.file_paths || [],

package/src/core/reporting/legacy-csv.js

@@ -227,8 +227,17 @@ function pickCandidate(row = {}) {
 
 function timingValue(row = {}, ...keys) {
   const timings = row.timings || row.timing || {};
+  const detail = row.detail || {};
+  const acquisition = detail.cv_acquisition || {};
+  const fallbackByKey = {
+    network_cv_wait_ms: acquisition.network_wait?.elapsed_ms,
+    screenshot_capture_ms: acquisition.image_evidence?.elapsed_ms || detail.image_evidence?.elapsed_ms,
+    dom_fallback_ms: acquisition.content_wait?.elapsed_ms,
+    close_detail_ms: detail.close_result?.elapsed_ms,
+    post_action_ms: row.post_action?.elapsed_ms
+  };
   for (const key of keys) {
-    const value = firstDefined(row[key], timings[key]);
+    const value = firstDefined(row[key], timings[key], fallbackByKey[key]);
     if (value !== "") return value;
   }
   return "";
@@ -284,8 +293,8 @@ export function legacyScreenResultRow(row = {}) {
     totalEvidence,
     totalEvidence,
     "",
-    row.error_code || error.code || error.name || "",
-    row.error_message || error.message || "",
+    row.error_code || error.code || error.name || (llm.error ? "LLM_SCREENING_ERROR" : ""),
+    row.error_message || error.message || llm.error || "",
     candidate.id || row.candidate_id || "",
     timingValue(row, "total_ms"),
     timingValue(row, "card_read_ms"),

package/src/core/run/timing.js

@@ -0,0 +1,33 @@
+import path from "node:path";
+
+export function addTiming(timings, key, value) {
+  if (!timings || !key) return;
+  const numeric = Number(value);
+  if (!Number.isFinite(numeric) || numeric < 0) return;
+  timings[key] = (Number(timings[key]) || 0) + Math.round(numeric);
+}
+
+export async function measureTiming(timings, key, task) {
+  const started = Date.now();
+  try {
+    return await task();
+  } finally {
+    addTiming(timings, key, Date.now() - started);
+  }
+}
+
+export function imageEvidenceFilePath({
+  imageOutputDir = "",
+  domain = "candidate",
+  runId = "",
+  index = 0,
+  extension = "png"
+} = {}) {
+  const dir = String(imageOutputDir || "").trim();
+  if (!dir) return "";
+  const safeDomain = String(domain || "candidate").replace(/[^\w.-]+/g, "_");
+  const safeRunId = String(runId || `${safeDomain}-run`).replace(/[^\w.-]+/g, "_");
+  const safeIndex = String((Number(index) || 0) + 1).padStart(3, "0");
+  const safeExt = String(extension || "png").replace(/^\./, "") || "png";
+  return path.join(dir, safeRunId, `${safeDomain}-candidate-${safeIndex}.${safeExt}`);
+}

package/src/core/screening/index.js

@@ -206,11 +206,52 @@ function parseDateLike(value) {
   return normalized;
 }
 
+function isLikelySalaryLine(value = "") {
+  const normalized = normalizeText(value);
+  return Boolean(
+    /^(?:面议|薪资面议)$/i.test(normalized)
+    || /^\d+(?:\.\d+)?(?:\s*-\s*\d+(?:\.\d+)?)?\s*[kK](?:\s*[·xX*]\s*\d+\s*薪?)?$/.test(normalized)
+    || /^\d+\s*-\s*\d+\s*元\s*\/\s*天$/.test(normalized)
+  );
+}
+
+function isLikelyStatusLine(value = "") {
+  const normalized = normalizeText(value);
+  return Boolean(
+    !normalized
+    || /^沟通|^收藏|^查看|^不合适/.test(normalized)
+    || /^(?:在线|刚刚活跃|今日活跃|本周活跃|本月活跃|继续沟通|打招呼)$/.test(normalized)
+  );
+}
+
+function stripLeadingSalaryToken(value = "") {
+  return normalizeText(value)
+    .replace(/^(?:面议|薪资面议)\s+/i, "")
+    .replace(/^\d+(?:\.\d+)?(?:\s*-\s*\d+(?:\.\d+)?)?\s*[kK](?:\s*[·xX*]\s*\d+\s*薪?)?\s+/, "")
+    .replace(/^\d+\s*-\s*\d+\s*元\s*\/\s*天\s+/, "")
+    .trim();
+}
+
+function stripTrailingStatusToken(value = "") {
+  return normalizeText(value)
+    .replace(/\s*(?:在线|刚刚活跃|今日活跃|本周活跃|本月活跃|继续沟通|打招呼)$/u, "")
+    .trim();
+}
+
+function cleanInferredNameLine(value = "") {
+  const withoutSalary = stripLeadingSalaryToken(value);
+  const withoutStatus = stripTrailingStatusToken(withoutSalary);
+  return withoutStatus && !isLikelyStatusLine(withoutStatus) && !isLikelySalaryLine(withoutStatus)
+    ? withoutStatus
+    : "";
+}
+
 function firstUsefulLine(lines) {
-  return lines.find((line) => {
-    const normalized = normalizeText(line);
-    return normalized && !/^沟通|^收藏|^查看|^不合适/.test(normalized);
-  }) || null;
+  for (const line of lines) {
+    const cleaned = cleanInferredNameLine(line);
+    if (cleaned) return cleaned;
+  }
+  return null;
 }
 
 function parseNetworkBodyText(networkBody = {}) {
@@ -834,7 +875,8 @@ export function normalizeCandidateProfile(input = {}) {
     || attrs.href
     || ""
   ) || null;
-  const inferredName = normalizeText(input.identity?.name || input.name || firstUsefulLine(lines) || "") || null;
+  const explicitName = cleanInferredNameLine(input.identity?.name || input.name || "");
+  const inferredName = explicitName || firstUsefulLine(lines) || null;
   const fullText = collectTextParts({
     ...input,
     text: rawText,
@@ -1003,6 +1045,54 @@ export function screenCandidate(candidateInput, criteria = {}) {
   };
 }
 
+export function compactScreeningLlmResult(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: Array.isArray(llmResult.evidence) ? llmResult.evidence.length : 0,
+    usage: llmResult.usage || null,
+    finish_reason: llmResult.finish_reason || null,
+    image_input_count: llmResult.image_input_count || 0,
+    error: llmResult.error || null,
+    screened_at: llmResult.screened_at || null
+  };
+}
+
+export function llmResultToScreening(llmResult, candidate) {
+  return {
+    status: llmResult?.passed ? "pass" : "fail",
+    passed: Boolean(llmResult?.passed),
+    score: llmResult?.passed ? 100 : 0,
+    reasons: llmResult?.error ? ["llm_invalid_response"] : [],
+    candidate
+  };
+}
+
+export function isRecoverableLlmScreeningError(error) {
+  return /(?:LLM response missing boolean passed decision|LLM response was not valid JSON)/i
+    .test(String(error?.message || error || ""));
+}
+
+export function createFailedLlmScreeningResult(error) {
+  return {
+    ok: false,
+    passed: false,
+    reason: "",
+    evidence: [],
+    cot: "",
+    decision_cot: "",
+    reasoning_content: "",
+    raw_model_output: "",
+    error: error?.message || String(error || "unknown"),
+    screened_at: nowIso()
+  };
+}
+
 export function buildScreeningLlmMessages({
   candidate,
   criteria,

package/src/domains/chat/cards.js

@@ -5,6 +5,7 @@ import {
   querySelectorAll,
   sleep
 } from "../../core/browser/index.js";
+import { mergeBossCandidateCardFields } from "../../core/boss-cards/index.js";
 import {
   htmlToText,
   normalizeCandidateProfile,
@@ -24,6 +25,12 @@ function firstCandidateId(attributes = {}) {
   ) || null;
 }
 
+function mergeChatCardFields(candidate, outerHTML = "") {
+  return mergeBossCandidateCardFields(candidate, outerHTML, {
+    metadataKey: "chat_card_fields"
+  });
+}
+
 export async function findChatCandidateNodeIds(client, rootNodeId, {
   selectors = CHAT_CARD_SELECTORS
 } = {}) {
@@ -97,7 +104,7 @@ export async function readChatCardCandidate(client, cardNodeId, {
     getAttributesMap(client, cardNodeId),
     getOuterHTML(client, cardNodeId)
   ]);
-  return normalizeCandidateProfile({
+  const candidate = normalizeCandidateProfile({
     domain: "chat",
     source,
     id: firstCandidateId(attributes),
@@ -110,6 +117,7 @@ export async function readChatCardCandidate(client, cardNodeId, {
       ...metadata
     }
   });
+  return mergeChatCardFields(candidate, outerHTML);
 }
 
 export async function readFirstChatCardCandidate(client, rootNodeId, options = {}) {