@reconcrap/boss-recommend-mcp 2.1.23 → 2.1.25

package/src/domains/chat/page-guard.js

@@ -1,122 +1,157 @@
-import {
-  getMainFrameUrl,
-  sleep,
-  waitForMainFrameUrl
-} from "../../core/browser/index.js";
-import {
-  buildChatSelfHealConfig,
-  resolveChatSelfHealRoots
-} from "../../core/self-heal/index.js";
-import {
-  createRecoverySettleError,
-  waitForMiniFreshStartSettle
-} from "../common/recovery-settle.js";
-import { CHAT_TARGET_URL } from "./constants.js";
-
-export const CHAT_FORBIDDEN_TOP_LEVEL_RESUME_CODE = "CHAT_FORBIDDEN_TOP_LEVEL_RESUME_NAVIGATION";
-
-export function isChatShellUrl(url = "") {
-  const value = String(url || "");
-  return /https?:\/\/[^/]*zhipin\.com\/web\/chat\/index(?:[/?#]|$)/i.test(value)
-    || /https?:\/\/[^/]*zhipin\.com\/web\/chat\/index$/i.test(value);
-}
-
-export function isForbiddenChatResumeTopLevelUrl(url = "") {
-  return /https?:\/\/[^/]*zhipin\.com\/web\/frame\/c-resume\/?/i.test(String(url || ""));
-}
-
-export async function getChatTopLevelState(client) {
-  let url = "";
-  let error = null;
-  try {
-    url = await getMainFrameUrl(client);
-  } catch (err) {
-    error = err?.message || String(err);
-  }
-  return {
-    url,
-    is_chat_shell: isChatShellUrl(url),
-    is_forbidden_resume_top_level: isForbiddenChatResumeTopLevelUrl(url),
-    error
-  };
-}
-
-export function makeForbiddenChatResumeNavigationError(pageState, message = "") {
-  const error = new Error(message || `Chat tab navigated to forbidden top-level resume URL: ${pageState?.url || "unknown"}`);
-  error.code = CHAT_FORBIDDEN_TOP_LEVEL_RESUME_CODE;
-  error.page_state = pageState || null;
-  return error;
-}
-
-export function isForbiddenChatResumeNavigationError(error) {
-  return error?.code === CHAT_FORBIDDEN_TOP_LEVEL_RESUME_CODE
-    || /CHAT_FORBIDDEN_TOP_LEVEL_RESUME_NAVIGATION/i.test(String(error?.message || error || ""));
-}
-
-export async function assertChatShellNotResumeTopLevel(client, {
-  context = "chat"
-} = {}) {
-  const state = await getChatTopLevelState(client);
-  if (state.is_forbidden_resume_top_level) {
-    throw makeForbiddenChatResumeNavigationError(
-      state,
-      `CHAT_FORBIDDEN_TOP_LEVEL_RESUME_NAVIGATION during ${context}: ${state.url}`
-    );
-  }
-  return state;
-}
-
-export async function recoverChatShell(client, {
-  targetUrl = CHAT_TARGET_URL,
-  timeoutMs = 60000,
-  intervalMs = 500,
-  forceNavigate = false,
-  settleMs = 1200,
-  settleAfterNavigate = false
-} = {}) {
-  const before = await getChatTopLevelState(client);
-  if (before.is_chat_shell && !forceNavigate) {
-    return {
-      recovered: false,
-      before,
-      after: before,
-      navigate_url: null,
-      force_navigate: false
-    };
-  }
-
-  const navigateResult = await client.Page.navigate({ url: targetUrl });
-  if (forceNavigate && settleMs > 0) {
-    await sleep(settleMs);
-  }
-  const waited = await waitForMainFrameUrl(client, isChatShellUrl, {
-    timeoutMs,
-    intervalMs
-  });
-  const after = await getChatTopLevelState(client);
-  let miniFreshStart = null;
-  if (after.is_chat_shell && settleAfterNavigate) {
-    miniFreshStart = await waitForMiniFreshStartSettle(client, {
-      domain: "chat",
-      timeoutMs,
-      intervalMs: Math.max(intervalMs, 800),
-      settleMs: Math.min(settleMs, 5000),
-      selfHealConfig: buildChatSelfHealConfig(),
-      resolveSelfHealRoots: resolveChatSelfHealRoots
-    });
-    if (!miniFreshStart.ok) {
-      throw createRecoverySettleError("chat", miniFreshStart);
-    }
-  }
-  return {
-    recovered: waited.ok && after.is_chat_shell,
-    refreshed: Boolean(forceNavigate && before.is_chat_shell && after.is_chat_shell),
-    before,
-    after,
-    mini_fresh_start: miniFreshStart,
-    wait: waited,
-    navigate_result: navigateResult || null,
-    navigate_url: targetUrl,
-    force_navigate: Boolean(forceNavigate)
-  };
-}
+import {
+  getMainFrameUrl,
+  sleep,
+  waitForMainFrameUrl
+} from "../../core/browser/index.js";
+import {
+  buildChatSelfHealConfig,
+  resolveChatSelfHealRoots
+} from "../../core/self-heal/index.js";
+import {
+  createRecoverySettleError,
+  waitForMiniFreshStartSettle
+} from "../common/recovery-settle.js";
+import { CHAT_TARGET_URL } from "./constants.js";
+
+export const CHAT_FORBIDDEN_TOP_LEVEL_RESUME_CODE = "CHAT_FORBIDDEN_TOP_LEVEL_RESUME_NAVIGATION";
+export const BOSS_SECURITY_VERIFICATION_REQUIRED_CODE = "BOSS_SECURITY_VERIFICATION_REQUIRED";
+
+export function isChatShellUrl(url = "") {
+  const value = String(url || "");
+  return /https?:\/\/[^/]*zhipin\.com\/web\/chat\/index(?:[/?#]|$)/i.test(value)
+    || /https?:\/\/[^/]*zhipin\.com\/web\/chat\/index$/i.test(value);
+}
+
+export function isForbiddenChatResumeTopLevelUrl(url = "") {
+  return /https?:\/\/[^/]*zhipin\.com\/web\/frame\/c-resume\/?/i.test(String(url || ""));
+}
+
+export function isBossSecurityVerificationUrl(url = "") {
+  return /https?:\/\/[^/]*zhipin\.com\/web\/passport\/zp\/verify\.html(?:[?#]|$)/i.test(String(url || ""));
+}
+
+export async function getChatTopLevelState(client) {
+  let url = "";
+  let error = null;
+  try {
+    url = await getMainFrameUrl(client);
+  } catch (err) {
+    error = err?.message || String(err);
+  }
+  return {
+    url,
+    is_chat_shell: isChatShellUrl(url),
+    is_forbidden_resume_top_level: isForbiddenChatResumeTopLevelUrl(url),
+    is_security_verification: isBossSecurityVerificationUrl(url),
+    error
+  };
+}
+
+export function makeBossSecurityVerificationRequiredError(pageState, context = "chat") {
+  const error = new Error(
+    `BOSS_SECURITY_VERIFICATION_REQUIRED during ${context}: ${pageState?.url || "unknown"}`
+  );
+  error.code = BOSS_SECURITY_VERIFICATION_REQUIRED_CODE;
+  error.requires_user_verification = true;
+  error.retryable = true;
+  error.page_state = pageState || null;
+  return error;
+}
+
+export function isBossSecurityVerificationRequiredError(error) {
+  return error?.code === BOSS_SECURITY_VERIFICATION_REQUIRED_CODE
+    || /BOSS_SECURITY_VERIFICATION_REQUIRED/i.test(String(error?.message || error || ""));
+}
+
+export function makeForbiddenChatResumeNavigationError(pageState, message = "") {
+  const error = new Error(message || `Chat tab navigated to forbidden top-level resume URL: ${pageState?.url || "unknown"}`);
+  error.code = CHAT_FORBIDDEN_TOP_LEVEL_RESUME_CODE;
+  error.page_state = pageState || null;
+  return error;
+}
+
+export function isForbiddenChatResumeNavigationError(error) {
+  return error?.code === CHAT_FORBIDDEN_TOP_LEVEL_RESUME_CODE
+    || /CHAT_FORBIDDEN_TOP_LEVEL_RESUME_NAVIGATION/i.test(String(error?.message || error || ""));
+}
+
+export async function assertChatShellNotResumeTopLevel(client, {
+  context = "chat"
+} = {}) {
+  const state = await getChatTopLevelState(client);
+  if (state.is_security_verification) {
+    throw makeBossSecurityVerificationRequiredError(state, context);
+  }
+  if (state.is_forbidden_resume_top_level) {
+    throw makeForbiddenChatResumeNavigationError(
+      state,
+      `CHAT_FORBIDDEN_TOP_LEVEL_RESUME_NAVIGATION during ${context}: ${state.url}`
+    );
+  }
+  return state;
+}
+
+export async function recoverChatShell(client, {
+  targetUrl = CHAT_TARGET_URL,
+  timeoutMs = 60000,
+  intervalMs = 500,
+  forceNavigate = false,
+  settleMs = 1200,
+  settleAfterNavigate = false
+} = {}) {
+  const before = await getChatTopLevelState(client);
+  if (before.is_security_verification) {
+    throw makeBossSecurityVerificationRequiredError(before, "chat_shell_recovery");
+  }
+  if (before.is_chat_shell && !forceNavigate) {
+    return {
+      recovered: false,
+      before,
+      after: before,
+      navigate_url: null,
+      force_navigate: false
+    };
+  }
+
+  const navigateResult = await client.Page.navigate({ url: targetUrl });
+  if (forceNavigate && settleMs > 0) {
+    await sleep(settleMs);
+  }
+  const waited = await waitForMainFrameUrl(
+    client,
+    (url) => isChatShellUrl(url) || isBossSecurityVerificationUrl(url),
+    {
+      timeoutMs,
+      intervalMs
+    }
+  );
+  const after = await getChatTopLevelState(client);
+  if (after.is_security_verification) {
+    throw makeBossSecurityVerificationRequiredError(after, "chat_shell_recovery");
+  }
+  let miniFreshStart = null;
+  if (after.is_chat_shell && settleAfterNavigate) {
+    miniFreshStart = await waitForMiniFreshStartSettle(client, {
+      domain: "chat",
+      timeoutMs,
+      intervalMs: Math.max(intervalMs, 800),
+      settleMs: Math.min(settleMs, 5000),
+      selfHealConfig: buildChatSelfHealConfig(),
+      resolveSelfHealRoots: resolveChatSelfHealRoots
+    });
+    if (!miniFreshStart.ok) {
+      throw createRecoverySettleError("chat", miniFreshStart);
+    }
+  }
+  return {
+    recovered: waited.ok && after.is_chat_shell,
+    refreshed: Boolean(forceNavigate && before.is_chat_shell && after.is_chat_shell),
+    before,
+    after,
+    mini_fresh_start: miniFreshStart,
+    wait: waited,
+    navigate_result: navigateResult || null,
+    navigate_url: targetUrl,
+    force_navigate: Boolean(forceNavigate)
+  };
+}

package/src/domains/chat/roots.js

@@ -1,56 +1,56 @@
-import {
-  getDocumentRoot,
-  querySelector,
-  sleep
-} from "../../core/browser/index.js";
-
-export async function getChatRoots(client) {
-  const topRoot = await getDocumentRoot(client);
-  return {
-    topRoot,
-    roots: [
-      { name: "top", nodeId: topRoot.nodeId }
-    ],
-    rootNodes: {
-      top: topRoot.nodeId
-    }
-  };
-}
-
-export async function waitForChatRoots(client, {
-  timeoutMs = 12000,
-  intervalMs = 300
-} = {}) {
-  const started = Date.now();
-  let lastState = null;
-  let lastError = null;
-  while (Date.now() - started <= timeoutMs) {
-    try {
-      lastState = await getChatRoots(client);
-      if (lastState?.rootNodes?.top) return lastState;
-    } catch (error) {
-      lastError = error;
-    }
-    await sleep(intervalMs);
-  }
-  if (lastError && !lastState) throw lastError;
-  return lastState;
-}
-
-export async function queryFirstAcrossChatRoots(client, roots, selectors) {
-  for (const root of roots) {
-    if (!root?.nodeId) continue;
-    for (const selector of selectors) {
-      const nodeId = await querySelector(client, root.nodeId, selector);
-      if (nodeId) {
-        return {
-          root: root.name,
-          root_node_id: root.nodeId,
-          selector,
-          node_id: nodeId
-        };
-      }
-    }
-  }
-  return null;
-}
+import {
+  getDocumentRoot,
+  querySelector,
+  sleep
+} from "../../core/browser/index.js";
+
+export async function getChatRoots(client) {
+  const topRoot = await getDocumentRoot(client);
+  return {
+    topRoot,
+    roots: [
+      { name: "top", nodeId: topRoot.nodeId }
+    ],
+    rootNodes: {
+      top: topRoot.nodeId
+    }
+  };
+}
+
+export async function waitForChatRoots(client, {
+  timeoutMs = 12000,
+  intervalMs = 300
+} = {}) {
+  const started = Date.now();
+  let lastState = null;
+  let lastError = null;
+  while (Date.now() - started <= timeoutMs) {
+    try {
+      lastState = await getChatRoots(client);
+      if (lastState?.rootNodes?.top) return lastState;
+    } catch (error) {
+      lastError = error;
+    }
+    await sleep(intervalMs);
+  }
+  if (lastError && !lastState) throw lastError;
+  return lastState;
+}
+
+export async function queryFirstAcrossChatRoots(client, roots, selectors) {
+  for (const root of roots) {
+    if (!root?.nodeId) continue;
+    for (const selector of selectors) {
+      const nodeId = await querySelector(client, root.nodeId, selector);
+      if (nodeId) {
+        return {
+          root: root.name,
+          root_node_id: root.nodeId,
+          selector,
+          node_id: nodeId
+        };
+      }
+    }
+  }
+  return null;
+}