@reconcrap/boss-recommend-mcp 2.0.45 → 2.0.47

package/src/domains/recommend/index.js

@@ -1,10 +1,10 @@
-export * from "./constants.js";
-export * from "./roots.js";
-export * from "./filters.js";
-export * from "./cards.js";
-export * from "./detail.js";
-export * from "./actions.js";
-export * from "./jobs.js";
-export * from "./scopes.js";
-export * from "./refresh.js";
-export * from "./run-service.js";
+export * from "./constants.js";
+export * from "./roots.js";
+export * from "./filters.js";
+export * from "./cards.js";
+export * from "./detail.js";
+export * from "./actions.js";
+export * from "./jobs.js";
+export * from "./scopes.js";
+export * from "./refresh.js";
+export * from "./run-service.js";

package/src/domains/recommend/jobs.js

@@ -1,263 +1,316 @@
-import {
-  clickNodeCenter,
-  getAttributesMap,
-  getNodeBox,
-  getOuterHTML,
-  pressKey,
-  querySelectorAll,
-  sleep,
-  waitForSelector
-} from "../../core/browser/index.js";
-import {
-  htmlToText,
-  normalizeText
-} from "../../core/screening/index.js";
-
-export const RECOMMEND_JOB_SELECTORS = Object.freeze({
-  trigger: ".job-selecter-wrap, [class*=\"job-selecter-wrap\"], .ui-dropmenu",
-  option: ".job-selecter-options .job-item, .job-list .job-item, .job-item",
-  current: ".job-selecter-options .job-item.curr, .job-list .job-item.curr, .job-item.curr"
-});
-
-function normalizeJobText(value) {
-  return normalizeText(value).replace(/\s+/g, "");
-}
-
-function stripSalaryText(label) {
-  return normalizeText(label)
-    .replace(/\s*[（(]\s*(?:\d+(?:-\d+)?K|面议|\d+-\d+元\/天)\s*[）)]\s*$/i, "")
-    .replace(/\s+(?:\d+(?:-\d+)?K|面议|\d+-\d+元\/天)\s*$/i, "")
-    .trim();
-}
-
-function trimSalarySuffix(label) {
-  return stripSalaryText(label);
-}
-
-export function jobLabelMatches(optionLabel, targetLabel) {
-  const option = normalizeJobText(optionLabel);
-  const target = normalizeJobText(targetLabel);
-  const optionWithoutSalary = normalizeJobText(stripSalaryText(optionLabel));
-  const targetWithoutSalary = normalizeJobText(stripSalaryText(targetLabel));
-  if (!option || !target) return false;
-  return option === target
-    || option.startsWith(target)
-    || optionWithoutSalary === target
-    || option === targetWithoutSalary
-    || optionWithoutSalary === targetWithoutSalary;
-}
-
-function isVisibleBox(box) {
-  return Boolean(box && box.rect.width > 4 && box.rect.height > 4);
-}
-
-async function readJobOption(client, nodeId, index) {
-  const [attributes, outerHTML] = await Promise.all([
-    getAttributesMap(client, nodeId),
-    getOuterHTML(client, nodeId)
-  ]);
-  const label = normalizeText(htmlToText(outerHTML));
-  let box = null;
-  try {
-    box = await getNodeBox(client, nodeId);
-  } catch {}
-  const className = attributes.class || "";
-  return {
-    node_id: nodeId,
-    index,
-    label,
-    label_without_salary: trimSalarySuffix(label),
-    class_name: className,
-    current: /\bcurr\b|\bactive\b|\bselected\b/.test(className),
-    visible: isVisibleBox(box),
-    center: box?.center || null,
-    rect: box?.rect || null
-  };
-}
-
-export async function findRecommendJobTrigger(client, frameNodeId) {
-  const nodeIds = await querySelectorAll(client, frameNodeId, RECOMMEND_JOB_SELECTORS.trigger);
-  for (const nodeId of nodeIds) {
-    try {
-      const box = await getNodeBox(client, nodeId);
-      if (isVisibleBox(box)) {
-        return {
-          node_id: nodeId,
-          center: box.center,
-          rect: box.rect
-        };
-      }
-    } catch {}
-  }
-  return null;
-}
-
-export async function waitForRecommendJobTrigger(client, frameNodeId, {
-  timeoutMs = 8000,
-  intervalMs = 250
-} = {}) {
-  const started = Date.now();
-  while (Date.now() - started <= timeoutMs) {
-    const trigger = await findRecommendJobTrigger(client, frameNodeId);
-    if (trigger) return trigger;
-    await sleep(intervalMs);
-  }
-  return null;
-}
-
-export async function openRecommendJobDropdown(client, frameNodeId, {
-  timeoutMs = 4000,
-  triggerTimeoutMs = Math.max(8000, timeoutMs),
-  triggerIntervalMs = 250
-} = {}) {
-  const trigger = await waitForRecommendJobTrigger(client, frameNodeId, {
-    timeoutMs: triggerTimeoutMs,
-    intervalMs: triggerIntervalMs
-  });
-  if (!trigger) {
-    throw new Error("Recommend job trigger was not found");
-  }
-
-  let optionNodeId = await waitForSelector(client, frameNodeId, RECOMMEND_JOB_SELECTORS.option, {
-    timeoutMs: 300,
-    intervalMs: 100
-  });
-  if (optionNodeId) {
-    const options = await listRecommendJobOptions(client, frameNodeId, { openDropdown: false });
-    if (options.some((option) => option.visible)) {
-      return {
-        opened: true,
-        already_open: true,
-        trigger,
-        options
-      };
-    }
-  }
-
-  await clickNodeCenter(client, trigger.node_id);
-  optionNodeId = await waitForSelector(client, frameNodeId, RECOMMEND_JOB_SELECTORS.option, {
-    timeoutMs,
-    intervalMs: 200
-  });
-  if (!optionNodeId) {
-    throw new Error("Recommend job dropdown did not mount options after trigger click");
-  }
-  const options = await listRecommendJobOptions(client, frameNodeId, { openDropdown: false });
-  return {
-    opened: true,
-    already_open: false,
-    trigger,
-    options
-  };
-}
-
-export async function listRecommendJobOptions(client, frameNodeId, {
-  openDropdown = true
-} = {}) {
-  if (openDropdown) {
-    await openRecommendJobDropdown(client, frameNodeId);
-  }
-
-  const nodeIds = await querySelectorAll(client, frameNodeId, RECOMMEND_JOB_SELECTORS.option);
-  const options = [];
-  const seen = new Set();
-  for (let index = 0; index < nodeIds.length; index += 1) {
-    const nodeId = nodeIds[index];
-    if (seen.has(nodeId)) continue;
-    seen.add(nodeId);
-    const option = await readJobOption(client, nodeId, index);
-    if (!option.label) continue;
-    if (option.label.length > 120) continue;
-    options.push(option);
-  }
-  return options;
-}
-
-export async function closeRecommendJobDropdown(client) {
-  await pressKey(client, "Escape", {
-    code: "Escape",
-    windowsVirtualKeyCode: 27,
-    nativeVirtualKeyCode: 27
-  });
-  await sleep(300);
-}
-
-export async function selectRecommendJob(client, frameNodeId, {
-  jobLabel = "",
-  settleMs = 6000,
-  dropdownTimeoutMs = Math.max(8000, settleMs)
-} = {}) {
-  const target = normalizeText(jobLabel);
-  if (!target) {
-    return {
-      requested: "",
-      selected: false,
-      reason: "no_job_requested",
-      options: []
-    };
-  }
-
-  const opened = await openRecommendJobDropdown(client, frameNodeId, {
-    timeoutMs: dropdownTimeoutMs,
-    triggerTimeoutMs: dropdownTimeoutMs
-  });
-  const options = opened.options.length
-    ? opened.options
-    : await listRecommendJobOptions(client, frameNodeId, { openDropdown: false });
-  const visibleOptions = options.filter((option) => option.visible);
-  const match = visibleOptions.find((option) => jobLabelMatches(option.label, target))
-    || options.find((option) => jobLabelMatches(option.label, target));
-
-  if (!match) {
-    await closeRecommendJobDropdown(client);
-    return {
-      requested: target,
-      selected: false,
-      reason: "job_not_found",
-      options: options.map(compactJobOption)
-    };
-  }
-
-  if (match.current) {
-    await closeRecommendJobDropdown(client);
-    return {
-      requested: target,
-      selected: true,
-      already_current: true,
-      selected_option: compactJobOption(match),
-      options: options.map(compactJobOption)
-    };
-  }
-
-  if (!match.center) {
-    await closeRecommendJobDropdown(client);
-    throw new Error(`Matched recommend job has no clickable center: ${match.label}`);
-  }
-
-  const clickedBox = await clickNodeCenter(client, match.node_id);
-  if (settleMs > 0) await sleep(settleMs);
-  return {
-    requested: target,
-    selected: true,
-    already_current: false,
-    selected_option: compactJobOption(match),
-    click_box: {
-      center: clickedBox.center,
-      rect: clickedBox.rect
-    },
-    options: options.map(compactJobOption)
-  };
-}
-
-function compactJobOption(option) {
-  return {
-    label: option.label,
-    label_without_salary: option.label_without_salary,
-    current: Boolean(option.current),
-    visible: Boolean(option.visible),
-    class_name: option.class_name,
-    node_id: option.node_id,
-    center: option.center,
-    rect: option.rect
-  };
-}
+import {
+  clickNodeCenter,
+  DETERMINISTIC_CLICK_OPTIONS,
+  getAttributesMap,
+  getNodeBox,
+  getOuterHTML,
+  pressKey,
+  querySelectorAll,
+  sleep
+} from "../../core/browser/index.js";
+import {
+  htmlToText,
+  normalizeText
+} from "../../core/screening/index.js";
+
+export const RECOMMEND_JOB_SELECTORS = Object.freeze({
+  trigger: ".job-selecter-wrap, [class*=\"job-selecter-wrap\"], .ui-dropmenu",
+  option: ".job-selecter-options .job-item, .job-list .job-item, .job-item",
+  current: ".job-selecter-options .job-item.curr, .job-list .job-item.curr, .job-item.curr"
+});
+
+function normalizeJobText(value) {
+  return normalizeText(value).replace(/\s+/g, "");
+}
+
+function stripSalaryText(label) {
+  return normalizeText(label)
+    .replace(/\s*[（(]\s*(?:\d+(?:-\d+)?K|面议|\d+-\d+元\/天)\s*[）)]\s*$/i, "")
+    .replace(/\s+(?:\d+(?:-\d+)?K|面议|\d+-\d+元\/天)\s*$/i, "")
+    .trim();
+}
+
+function trimSalarySuffix(label) {
+  return stripSalaryText(label);
+}
+
+export function jobLabelMatches(optionLabel, targetLabel) {
+  const option = normalizeJobText(optionLabel);
+  const target = normalizeJobText(targetLabel);
+  const optionWithoutSalary = normalizeJobText(stripSalaryText(optionLabel));
+  const targetWithoutSalary = normalizeJobText(stripSalaryText(targetLabel));
+  if (!option || !target) return false;
+  return option === target
+    || option.startsWith(target)
+    || optionWithoutSalary === target
+    || option === targetWithoutSalary
+    || optionWithoutSalary === targetWithoutSalary;
+}
+
+function isVisibleBox(box) {
+  return Boolean(box && box.rect.width > 4 && box.rect.height > 4);
+}
+
+async function readJobOption(client, nodeId, index) {
+  const [attributes, outerHTML] = await Promise.all([
+    getAttributesMap(client, nodeId),
+    getOuterHTML(client, nodeId)
+  ]);
+  const label = normalizeText(htmlToText(outerHTML));
+  let box = null;
+  try {
+    box = await getNodeBox(client, nodeId);
+  } catch {}
+  const className = attributes.class || "";
+  return {
+    node_id: nodeId,
+    index,
+    label,
+    label_without_salary: trimSalarySuffix(label),
+    class_name: className,
+    current: /\bcurr\b|\bactive\b|\bselected\b/.test(className),
+    visible: isVisibleBox(box),
+    center: box?.center || null,
+    rect: box?.rect || null
+  };
+}
+
+export async function findRecommendJobTrigger(client, frameNodeId) {
+  const nodeIds = await querySelectorAll(client, frameNodeId, RECOMMEND_JOB_SELECTORS.trigger);
+  for (const nodeId of nodeIds) {
+    try {
+      const box = await getNodeBox(client, nodeId);
+      if (isVisibleBox(box)) {
+        return {
+          node_id: nodeId,
+          center: box.center,
+          rect: box.rect
+        };
+      }
+    } catch {}
+  }
+  return null;
+}
+
+export async function waitForRecommendJobTrigger(client, frameNodeId, {
+  timeoutMs = 8000,
+  intervalMs = 250
+} = {}) {
+  const started = Date.now();
+  while (Date.now() - started <= timeoutMs) {
+    const trigger = await findRecommendJobTrigger(client, frameNodeId);
+    if (trigger) return trigger;
+    await sleep(intervalMs);
+  }
+  return null;
+}
+
+export async function openRecommendJobDropdown(client, frameNodeId, {
+  timeoutMs = 4000,
+  triggerTimeoutMs = Math.max(8000, timeoutMs),
+  triggerIntervalMs = 250,
+  dismissBeforeOpen = true,
+  maxAttempts = 3
+} = {}) {
+  const trigger = await waitForRecommendJobTrigger(client, frameNodeId, {
+    timeoutMs: triggerTimeoutMs,
+    intervalMs: triggerIntervalMs
+  });
+  if (!trigger) {
+    throw new Error("Recommend job trigger was not found");
+  }
+
+  const alreadyOpen = await waitForVisibleRecommendJobOptions(client, frameNodeId, {
+    timeoutMs: 300,
+    intervalMs: 100
+  });
+  if (alreadyOpen.visible_options.length) {
+    return {
+      opened: true,
+      already_open: true,
+      trigger,
+      options: alreadyOpen.options
+    };
+  }
+
+  const attempts = [];
+  const attemptLimit = Math.max(1, Math.floor(Number(maxAttempts) || 1));
+  if (dismissBeforeOpen) {
+    await closeRecommendJobDropdown(client);
+  }
+  for (let attempt = 1; attempt <= attemptLimit; attempt += 1) {
+    if (attempt > 1) await closeRecommendJobDropdown(client);
+    const triggerBox = await clickNodeCenter(client, trigger.node_id, DETERMINISTIC_CLICK_OPTIONS);
+    const opened = await waitForVisibleRecommendJobOptions(client, frameNodeId, {
+      timeoutMs,
+      intervalMs: 200
+    });
+    attempts.push({
+      attempt,
+      trigger_box: triggerBox,
+      option_count: opened.options.length,
+      visible_option_count: opened.visible_options.length
+    });
+    if (opened.visible_options.length) {
+      return {
+        opened: true,
+        already_open: false,
+        trigger,
+        options: opened.options,
+        attempts
+      };
+    }
+  }
+  const error = new Error("Recommend job dropdown did not expose visible options after trigger click");
+  error.job_dropdown_attempts = attempts;
+  throw error;
+}
+
+async function waitForVisibleRecommendJobOptions(client, frameNodeId, {
+  timeoutMs = 4000,
+  intervalMs = 200
+} = {}) {
+  const started = Date.now();
+  let lastOptions = [];
+  while (Date.now() - started <= timeoutMs) {
+    lastOptions = await listRecommendJobOptions(client, frameNodeId, { openDropdown: false });
+    const visibleOptions = lastOptions.filter((option) => option.visible);
+    if (visibleOptions.length) {
+      return {
+        options: lastOptions,
+        visible_options: visibleOptions
+      };
+    }
+    await sleep(intervalMs);
+  }
+  return {
+    options: lastOptions,
+    visible_options: []
+  };
+}
+
+export async function listRecommendJobOptions(client, frameNodeId, {
+  openDropdown = true
+} = {}) {
+  if (openDropdown) {
+    await openRecommendJobDropdown(client, frameNodeId);
+  }
+
+  const nodeIds = await querySelectorAll(client, frameNodeId, RECOMMEND_JOB_SELECTORS.option);
+  const options = [];
+  const seen = new Set();
+  for (let index = 0; index < nodeIds.length; index += 1) {
+    const nodeId = nodeIds[index];
+    if (seen.has(nodeId)) continue;
+    seen.add(nodeId);
+    const option = await readJobOption(client, nodeId, index);
+    if (!option.label) continue;
+    if (option.label.length > 120) continue;
+    options.push(option);
+  }
+  return options;
+}
+
+export async function closeRecommendJobDropdown(client) {
+  if (typeof client?.Input?.dispatchKeyEvent !== "function") {
+    return {
+      ok: false,
+      reason: "dispatch_key_unavailable"
+    };
+  }
+  await pressKey(client, "Escape", {
+    code: "Escape",
+    windowsVirtualKeyCode: 27,
+    nativeVirtualKeyCode: 27
+  });
+  await sleep(300);
+  return {
+    ok: true,
+    reason: "escape"
+  };
+}
+
+export async function selectRecommendJob(client, frameNodeId, {
+  jobLabel = "",
+  settleMs = 6000,
+  dropdownTimeoutMs = Math.max(8000, settleMs)
+} = {}) {
+  const target = normalizeText(jobLabel);
+  if (!target) {
+    return {
+      requested: "",
+      selected: false,
+      reason: "no_job_requested",
+      options: []
+    };
+  }
+
+  const opened = await openRecommendJobDropdown(client, frameNodeId, {
+    timeoutMs: dropdownTimeoutMs,
+    triggerTimeoutMs: dropdownTimeoutMs
+  });
+  const options = opened.options.length
+    ? opened.options
+    : await listRecommendJobOptions(client, frameNodeId, { openDropdown: false });
+  const visibleOptions = options.filter((option) => option.visible);
+  const hiddenMatches = options.filter((option) => !option.visible && jobLabelMatches(option.label, target));
+  const match = visibleOptions.find((option) => jobLabelMatches(option.label, target));
+
+  if (!match) {
+    await closeRecommendJobDropdown(client);
+    if (hiddenMatches.length) {
+      const error = new Error(`Matched recommend job has no visible clickable option: ${hiddenMatches[0].label}`);
+      error.hidden_job_matches = hiddenMatches.map(compactJobOption);
+      throw error;
+    }
+    return {
+      requested: target,
+      selected: false,
+      reason: "job_not_found",
+      options: options.map(compactJobOption)
+    };
+  }
+
+  if (match.current) {
+    await closeRecommendJobDropdown(client);
+    return {
+      requested: target,
+      selected: true,
+      already_current: true,
+      selected_option: compactJobOption(match),
+      options: options.map(compactJobOption)
+    };
+  }
+
+  if (!match.center) {
+    await closeRecommendJobDropdown(client);
+    throw new Error(`Matched recommend job has no clickable center: ${match.label}`);
+  }
+
+  const clickedBox = await clickNodeCenter(client, match.node_id, DETERMINISTIC_CLICK_OPTIONS);
+  if (settleMs > 0) await sleep(settleMs);
+  return {
+    requested: target,
+    selected: true,
+    already_current: false,
+    selected_option: compactJobOption(match),
+    click_box: {
+      center: clickedBox.center,
+      rect: clickedBox.rect
+    },
+    options: options.map(compactJobOption)
+  };
+}
+
+function compactJobOption(option) {
+  return {
+    label: option.label,
+    label_without_salary: option.label_without_salary,
+    current: Boolean(option.current),
+    visible: Boolean(option.visible),
+    class_name: option.class_name,
+    node_id: option.node_id,
+    center: option.center,
+    rect: option.rect
+  };
+}