@reconcrap/boss-recommend-mcp 1.3.39 → 2.0.0

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

@@ -0,0 +1,219 @@
+export const CV_ACQUISITION_MODE_UNKNOWN = "unknown";
+export const CV_ACQUISITION_MODE_NETWORK = "network";
+export const CV_ACQUISITION_MODE_IMAGE = "image";
+
+export const NETWORK_RESUME_WAIT_MS = 4200;
+export const NETWORK_RESUME_RETRY_WAIT_MS = 2000;
+export const NETWORK_RESUME_IMAGE_MODE_GRACE_MS = 1000;
+
+const VALID_MODES = new Set([
+  CV_ACQUISITION_MODE_UNKNOWN,
+  CV_ACQUISITION_MODE_NETWORK,
+  CV_ACQUISITION_MODE_IMAGE
+]);
+
+function normalizeMode(mode) {
+  const normalized = String(mode || "").trim().toLowerCase();
+  return VALID_MODES.has(normalized) ? normalized : CV_ACQUISITION_MODE_UNKNOWN;
+}
+
+function positiveNumber(value, fallback) {
+  const parsed = Number(value);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+
+function nowIso() {
+  return new Date().toISOString();
+}
+
+export function createCvAcquisitionState({
+  mode = CV_ACQUISITION_MODE_UNKNOWN
+} = {}) {
+  return {
+    schema_version: 1,
+    mode: normalizeMode(mode),
+    attempts: 0,
+    network_hits: 0,
+    image_fallbacks: 0,
+    misses: 0,
+    last_result: null,
+    history: []
+  };
+}
+
+export function getCvNetworkWaitPlan(state = {}, {
+  networkWaitMs = NETWORK_RESUME_WAIT_MS,
+  networkRetryWaitMs = NETWORK_RESUME_RETRY_WAIT_MS,
+  imageModeGraceMs = NETWORK_RESUME_IMAGE_MODE_GRACE_MS
+} = {}) {
+  const modeBefore = normalizeMode(state?.mode);
+  if (modeBefore === CV_ACQUISITION_MODE_IMAGE) {
+    return {
+      schema_version: 1,
+      mode_before: modeBefore,
+      reason: "previous_image_mode_short_network_grace",
+      initial_wait_ms: positiveNumber(imageModeGraceMs, NETWORK_RESUME_IMAGE_MODE_GRACE_MS),
+      retry_wait_ms: 0
+    };
+  }
+
+  return {
+    schema_version: 1,
+    mode_before: modeBefore,
+    reason: "network_primary_full_wait",
+    initial_wait_ms: positiveNumber(networkWaitMs, NETWORK_RESUME_WAIT_MS),
+    retry_wait_ms: positiveNumber(networkRetryWaitMs, NETWORK_RESUME_RETRY_WAIT_MS)
+  };
+}
+
+export async function waitForCvNetworkEvents(waitForNetworkEvents, recorder, {
+  waitPlan = getCvNetworkWaitPlan(),
+  minCount = 1,
+  requireLoaded = true,
+  intervalMs = 120
+} = {}) {
+  if (typeof waitForNetworkEvents !== "function") {
+    throw new Error("waitForCvNetworkEvents requires a domain wait function");
+  }
+  const started = Date.now();
+  const stages = [];
+
+  const initial = await waitForNetworkEvents(recorder, {
+    minCount,
+    requireLoaded,
+    timeoutMs: waitPlan.initial_wait_ms,
+    intervalMs
+  });
+  stages.push({
+    stage: "initial",
+    ...compactNetworkWait(initial)
+  });
+
+  if (!initial.ok && waitPlan.retry_wait_ms > 0) {
+    const retry = await waitForNetworkEvents(recorder, {
+      minCount,
+      requireLoaded,
+      timeoutMs: waitPlan.retry_wait_ms,
+      intervalMs
+    });
+    stages.push({
+      stage: "retry",
+      ...compactNetworkWait(retry)
+    });
+  }
+
+  const last = stages[stages.length - 1] || {};
+  return {
+    ok: stages.some((stage) => stage.ok),
+    elapsed_ms: Date.now() - started,
+    count: Math.max(...stages.map((stage) => Number(stage.count) || 0), 0),
+    total_event_count: last.total_event_count ?? last.count ?? 0,
+    wait_plan: waitPlan,
+    stages
+  };
+}
+
+export function countParsedNetworkProfiles(detailResult = {}) {
+  return (detailResult?.parsed_network_profiles || []).filter((item) => item?.ok).length;
+}
+
+export function hasParsedNetworkProfile(detailResult = {}) {
+  return countParsedNetworkProfiles(detailResult) > 0;
+}
+
+export function summarizeImageEvidence(imageEvidence = null) {
+  if (!imageEvidence) return null;
+  return {
+    source: imageEvidence.source || "",
+    screenshot_count: imageEvidence.screenshot_count || 0,
+    unique_screenshot_count: imageEvidence.unique_screenshot_count || 0,
+    file_paths: imageEvidence.file_paths || [],
+    first_clip: imageEvidence.screenshots?.[0]?.clip || imageEvidence.clip || null
+  };
+}
+
+export function recordCvNetworkHit(state, {
+  reason = "parsed_network_profile",
+  parsedNetworkProfileCount = 0,
+  waitResult = null
+} = {}) {
+  return recordCvAcquisitionResult(state, {
+    source: CV_ACQUISITION_MODE_NETWORK,
+    reason,
+    parsed_network_profile_count: parsedNetworkProfileCount,
+    wait_result: waitResult
+  });
+}
+
+export function recordCvImageFallback(state, {
+  reason = "network_miss_image_fallback",
+  parsedNetworkProfileCount = 0,
+  waitResult = null,
+  imageEvidence = null
+} = {}) {
+  return recordCvAcquisitionResult(state, {
+    source: CV_ACQUISITION_MODE_IMAGE,
+    reason,
+    parsed_network_profile_count: parsedNetworkProfileCount,
+    wait_result: waitResult,
+    image_evidence: summarizeImageEvidence(imageEvidence)
+  });
+}
+
+export function recordCvNetworkMiss(state, {
+  reason = "network_miss",
+  parsedNetworkProfileCount = 0,
+  waitResult = null
+} = {}) {
+  return recordCvAcquisitionResult(state, {
+    source: "miss",
+    reason,
+    parsed_network_profile_count: parsedNetworkProfileCount,
+    wait_result: waitResult
+  });
+}
+
+export function compactCvAcquisitionState(state = {}) {
+  return {
+    mode: normalizeMode(state.mode),
+    attempts: Number(state.attempts) || 0,
+    network_hits: Number(state.network_hits) || 0,
+    image_fallbacks: Number(state.image_fallbacks) || 0,
+    misses: Number(state.misses) || 0,
+    last_result: state.last_result || null
+  };
+}
+
+function recordCvAcquisitionResult(state, result) {
+  if (!state || typeof state !== "object") {
+    throw new Error("CV acquisition state is required");
+  }
+  const recorded = {
+    schema_version: 1,
+    recorded_at: nowIso(),
+    ...result
+  };
+  state.attempts = (Number(state.attempts) || 0) + 1;
+  if (result.source === CV_ACQUISITION_MODE_NETWORK) {
+    state.mode = CV_ACQUISITION_MODE_NETWORK;
+    state.network_hits = (Number(state.network_hits) || 0) + 1;
+  } else if (result.source === CV_ACQUISITION_MODE_IMAGE) {
+    state.mode = CV_ACQUISITION_MODE_IMAGE;
+    state.image_fallbacks = (Number(state.image_fallbacks) || 0) + 1;
+  } else {
+    state.misses = (Number(state.misses) || 0) + 1;
+  }
+  state.last_result = recorded;
+  if (!Array.isArray(state.history)) state.history = [];
+  state.history.push(recorded);
+  return compactCvAcquisitionState(state);
+}
+
+function compactNetworkWait(waitResult = {}) {
+  return {
+    ok: Boolean(waitResult?.ok),
+    elapsed_ms: waitResult?.elapsed_ms || 0,
+    count: waitResult?.count || 0,
+    total_event_count: waitResult?.total_event_count ?? waitResult?.events?.length ?? 0
+  };
+}

package/src/core/greet-quota/index.js

@@ -0,0 +1,54 @@
+import { normalizeText } from "../screening/index.js";
+
+export const GREET_CREDITS_EXHAUSTED_CODE = "GREET_CREDITS_EXHAUSTED";
+
+function coerceQuota(quota) {
+  if (!quota || typeof quota !== "object") return null;
+  return {
+    found: Boolean(quota.found),
+    text: normalizeText(quota.text),
+    numerator: Number.isFinite(Number(quota.numerator)) ? Number(quota.numerator) : null,
+    denominator: Number.isFinite(Number(quota.denominator)) ? Number(quota.denominator) : null,
+    exhausted: Boolean(quota.exhausted)
+  };
+}
+
+export function parseGreetQuota(label = "") {
+  const text = normalizeText(label);
+  const match = text.match(/立即沟通\s*[\(（]\s*(\d+)\s*[/／]\s*(\d+)\s*[\)）]/);
+  if (!match) {
+    return {
+      found: false,
+      text,
+      numerator: null,
+      denominator: null,
+      exhausted: false
+    };
+  }
+  const numerator = Number(match[1]);
+  const denominator = Number(match[2]);
+  return {
+    found: true,
+    text,
+    numerator,
+    denominator,
+    exhausted: numerator > denominator
+  };
+}
+
+export function normalizeGreetQuotaSource(source = "") {
+  return coerceQuota(source) || parseGreetQuota(source);
+}
+
+export function assertGreetQuotaAvailable(source = "") {
+  const quota = normalizeGreetQuotaSource(source);
+  if (quota.exhausted) {
+    const error = new Error(
+      `Greet credits exhausted according to Boss quota text: ${quota.numerator}/${quota.denominator}`
+    );
+    error.code = GREET_CREDITS_EXHAUSTED_CODE;
+    error.greet_quota = quota;
+    throw error;
+  }
+  return quota;
+}