@wowok/agent-mcp 2.3.13 → 2.3.16

package/dist/customer/order-monitor.js

@@ -0,0 +1,327 @@
+import { CUSTOMER_INTELLIGENCE_VERSION } from "./types.js";
+const DEFAULT_THRESHOLDS = {
+    progress_stall_hours: 0,
+    compensation_drop_ratio: 0.3,
+    compensation_coverage_min: 1.0,
+    messenger_timeout_hours: 24,
+    review_window_closing_days: 3,
+    arb_window_closing_days: 3,
+};
+export function monitorOrder(ctx) {
+    const alerts = [];
+    const t = { ...DEFAULT_THRESHOLDS, ...(ctx.thresholds ?? {}) };
+    const cur = ctx.current;
+    if (cur.completed) {
+        alerts.push(...detectPostCompletionAlerts(cur, t));
+        return sortAlerts(alerts);
+    }
+    if (cur.refunded) {
+        alerts.push({
+            id: "refund_received",
+            category: "refund_received",
+            severity: "info",
+            title: "退款已到账",
+            message: `订单 ${cur.order_id} 已退款到账`,
+            timestamp: cur.now,
+            order_id: cur.order_id,
+            service_id: cur.service_id,
+        });
+        return sortAlerts(alerts);
+    }
+    alerts.push(...detectProgressStall(cur, ctx.previous, t));
+    alerts.push(...detectCompensationChange(cur, ctx.previous, t));
+    alerts.push(...detectMessengerTimeout(cur, t));
+    if (cur.pending_user_action) {
+        alerts.push({
+            id: "user_action_required",
+            category: "user_action_required",
+            severity: "info",
+            title: "等待用户操作",
+            message: `订单 ${cur.order_id} 已推进到节点 ${cur.current_node ?? "未知"}，需要您操作才能继续`,
+            action: "查看 Machine 节点要求并提交对应 Guard submission",
+            timestamp: cur.now,
+            order_id: cur.order_id,
+            service_id: cur.service_id,
+            node: cur.current_node,
+        });
+    }
+    return sortAlerts(alerts);
+}
+function detectProgressStall(cur, prev, t) {
+    const alerts = [];
+    if (!cur.current_node)
+        return alerts;
+    const stallSince = cur.last_progress_at ?? cur.created_at;
+    const stallMs = cur.now - stallSince;
+    const stallHours = stallMs / 3_600_000;
+    const expected = cur.expected_progress_hours ?? 24;
+    const threshold = t.progress_stall_hours > 0 ? t.progress_stall_hours : expected * 2;
+    if (stallHours > threshold) {
+        const severity = stallHours > threshold * 2 ? "critical" : "warning";
+        alerts.push({
+            id: "progress_stall",
+            category: "progress_stall",
+            severity,
+            title: severity === "critical" ? "订单严重停滞" : "订单推进停滞",
+            message: `订单已停留在节点 ${cur.current_node} 超过 ${Math.round(stallHours)} 小时（预期 ${expected} 小时）`,
+            action: severity === "critical"
+                ? "建议立即通过 Messenger 联系商家；若商家持续无响应，可考虑发起仲裁"
+                : "建议通过 Messenger 联系商家询问进度",
+            timestamp: cur.now,
+            order_id: cur.order_id,
+            service_id: cur.service_id,
+            node: cur.current_node,
+            metric: {
+                label: "停滞时长",
+                value: Math.round(stallHours),
+                threshold: Math.round(threshold),
+                unit: "小时",
+            },
+        });
+    }
+    if (prev && prev.previous_node === cur.current_node) {
+        const sincePrev = cur.now - prev.snapshot_at;
+        const sincePrevHours = sincePrev / 3_600_000;
+        if (sincePrevHours > expected) {
+            alerts.push({
+                id: "node_unchanged",
+                category: "progress_stall",
+                severity: "warning",
+                title: "节点未变化",
+                message: `自上次检查以来（${Math.round(sincePrevHours)} 小时），订单仍停留在 ${cur.current_node}`,
+                action: "确认是否为预期行为；如非预期，联系商家",
+                timestamp: cur.now,
+                order_id: cur.order_id,
+                service_id: cur.service_id,
+                node: cur.current_node,
+                metric: {
+                    label: "节点停留时长",
+                    value: Math.round(sincePrevHours),
+                    threshold: Math.round(expected),
+                    unit: "小时",
+                },
+            });
+        }
+    }
+    return alerts;
+}
+function detectCompensationChange(cur, prev, t) {
+    const alerts = [];
+    if (cur.compensation_balance === undefined)
+        return alerts;
+    if (cur.order_amount !== undefined && cur.order_amount > 0n) {
+        const ratio = Number((cur.compensation_balance * 100n) / cur.order_amount) / 100;
+        if (ratio < t.compensation_coverage_min) {
+            const severity = ratio < 0.5 ? "critical" : "warning";
+            alerts.push({
+                id: "compensation_insufficient",
+                category: "compensation_insufficient",
+                severity,
+                title: "赔偿金覆盖率不足",
+                message: `商家赔偿金仅覆盖订单金额的 ${Math.round(ratio * 100)}%（要求 ${Math.round(t.compensation_coverage_min * 100)}%）`,
+                action: "下单前要求商家补充赔偿金，或通过 Messenger 协商提高覆盖率",
+                timestamp: cur.now,
+                order_id: cur.order_id,
+                service_id: cur.service_id,
+                metric: {
+                    label: "赔偿金覆盖率",
+                    value: Math.round(ratio * 100),
+                    threshold: Math.round(t.compensation_coverage_min * 100),
+                    unit: "%",
+                },
+            });
+        }
+    }
+    if (prev && prev.previous_compensation_balance !== undefined) {
+        const prevBal = prev.previous_compensation_balance;
+        if (prevBal > 0n && cur.compensation_balance < prevBal) {
+            const dropRatio = Number((prevBal - cur.compensation_balance) * 100n / prevBal) / 100;
+            if (dropRatio >= t.compensation_drop_ratio) {
+                const severity = dropRatio >= 0.5 ? "critical" : "warning";
+                alerts.push({
+                    id: "compensation_drop",
+                    category: "compensation_drop",
+                    severity,
+                    title: "赔偿金余额显著下降",
+                    message: `商家赔偿金从 ${prevBal} 下降到 ${cur.compensation_balance}（下降 ${Math.round(dropRatio * 100)}%）`,
+                    action: "立即询问商家原因；若持续下降，可能表明商家正在处理其他订单的赔付，存在风险",
+                    timestamp: cur.now,
+                    order_id: cur.order_id,
+                    service_id: cur.service_id,
+                    metric: {
+                        label: "赔偿金下降比例",
+                        value: Math.round(dropRatio * 100),
+                        threshold: Math.round(t.compensation_drop_ratio * 100),
+                        unit: "%",
+                    },
+                });
+            }
+        }
+    }
+    return alerts;
+}
+function detectMessengerTimeout(cur, t) {
+    const alerts = [];
+    if (cur.has_messenger === false) {
+        alerts.push({
+            id: "no_messenger_channel",
+            category: "messenger_timeout",
+            severity: "info",
+            title: "商家无 Messenger 通道",
+            message: "商家未配置 Messenger，无法在线协商或售后",
+            action: "下单前确认其他联系方式；建议要求商家配置 Messenger",
+            timestamp: cur.now,
+            order_id: cur.order_id,
+            service_id: cur.service_id,
+        });
+        return alerts;
+    }
+    if (cur.last_user_message_at && !cur.last_merchant_reply_at) {
+        const unansweredMs = cur.now - cur.last_user_message_at;
+        const unansweredHours = unansweredMs / 3_600_000;
+        if (unansweredHours > t.messenger_timeout_hours) {
+            const severity = unansweredHours > t.messenger_timeout_hours * 2 ? "critical" : "warning";
+            alerts.push({
+                id: "messenger_unanswered",
+                category: "messenger_timeout",
+                severity,
+                title: "商家 Messenger 未回复",
+                message: `商家已 ${Math.round(unansweredHours)} 小时未回复您的 Messenger 消息`,
+                action: cur.has_arbitration
+                    ? "可考虑发起仲裁申请（仲裁窗口有限）"
+                    : "商家未配置仲裁，建议通过其他联系方式催促；若无回应，资金可能冻结",
+                timestamp: cur.now,
+                order_id: cur.order_id,
+                service_id: cur.service_id,
+                metric: {
+                    label: "未回复时长",
+                    value: Math.round(unansweredHours),
+                    threshold: Math.round(t.messenger_timeout_hours),
+                    unit: "小时",
+                },
+            });
+        }
+    }
+    if (cur.last_merchant_reply_at && cur.last_user_message_at &&
+        cur.last_user_message_at > cur.last_merchant_reply_at) {
+        const unansweredMs = cur.now - cur.last_user_message_at;
+        const unansweredHours = unansweredMs / 3_600_000;
+        if (unansweredHours > t.messenger_timeout_hours) {
+            alerts.push({
+                id: "messenger_re_unanswered",
+                category: "messenger_timeout",
+                severity: "warning",
+                title: "商家再次未回复",
+                message: `您 ${Math.round(unansweredHours)} 小时前的消息商家尚未回复`,
+                action: "可发送催促消息；若商家持续无响应，考虑仲裁",
+                timestamp: cur.now,
+                order_id: cur.order_id,
+                service_id: cur.service_id,
+                metric: {
+                    label: "再次未回复时长",
+                    value: Math.round(unansweredHours),
+                    threshold: Math.round(t.messenger_timeout_hours),
+                    unit: "小时",
+                },
+            });
+        }
+    }
+    return alerts;
+}
+function detectPostCompletionAlerts(cur, t) {
+    const alerts = [];
+    if (cur.review_window_days !== undefined && cur.review_window_days > 0) {
+        if (cur.review_window_days <= t.review_window_closing_days) {
+            alerts.push({
+                id: "review_window_closing",
+                category: "review_window",
+                severity: "info",
+                title: "评价窗口即将关闭",
+                message: `评价窗口将在 ${cur.review_window_days} 天后关闭`,
+                action: "尽快提交评价（如有证据可一并提交）",
+                timestamp: cur.now,
+                order_id: cur.order_id,
+                service_id: cur.service_id,
+                metric: {
+                    label: "剩余天数",
+                    value: cur.review_window_days,
+                    threshold: t.review_window_closing_days,
+                    unit: "天",
+                },
+            });
+        }
+        else {
+            alerts.push({
+                id: "review_reminder",
+                category: "review_window",
+                severity: "info",
+                title: "订单已完成",
+                message: `订单已完成，评价窗口剩余 ${cur.review_window_days} 天`,
+                action: "可提交评价帮助其他用户决策",
+                timestamp: cur.now,
+                order_id: cur.order_id,
+                service_id: cur.service_id,
+            });
+        }
+    }
+    if (cur.arb_window_days !== undefined && cur.arb_window_days > 0) {
+        if (cur.arb_window_days <= t.arb_window_closing_days) {
+            alerts.push({
+                id: "arb_window_closing",
+                category: "arb_window",
+                severity: "warning",
+                title: "仲裁申请窗口即将关闭",
+                message: `仲裁申请窗口将在 ${cur.arb_window_days} 天后关闭`,
+                action: "若有未解决争议，立即发起仲裁申请",
+                timestamp: cur.now,
+                order_id: cur.order_id,
+                service_id: cur.service_id,
+                metric: {
+                    label: "剩余天数",
+                    value: cur.arb_window_days,
+                    threshold: t.arb_window_closing_days,
+                    unit: "天",
+                },
+            });
+        }
+    }
+    return alerts;
+}
+export function sortAlerts(alerts) {
+    const rank = { critical: 3, warning: 2, info: 1 };
+    return [...alerts].sort((a, b) => rank[b.severity] - rank[a.severity]);
+}
+export function getCriticalAlerts(alerts) {
+    return alerts.filter((a) => a.severity === "critical");
+}
+export function getActionableAlerts(alerts) {
+    return alerts.filter((a) => a.severity === "critical" || a.severity === "warning");
+}
+export function summarizeAlerts(alerts) {
+    if (alerts.length === 0)
+        return "✅ 暂无告警，订单状态正常";
+    const critical = alerts.filter((a) => a.severity === "critical");
+    const warning = alerts.filter((a) => a.severity === "warning");
+    const info = alerts.filter((a) => a.severity === "info");
+    const parts = [];
+    if (critical.length > 0)
+        parts.push(`🔴 ${critical.length} 条严重告警`);
+    if (warning.length > 0)
+        parts.push(`🟠 ${warning.length} 条警告`);
+    if (info.length > 0)
+        parts.push(`ℹ️ ${info.length} 条提示`);
+    return parts.join("，");
+}
+export function isBlockingAlert(alert) {
+    return alert.severity === "critical";
+}
+export function alertsToReminders(alerts) {
+    return alerts.map((a) => ({
+        id: a.id,
+        priority: a.severity === "critical" ? "required"
+            : a.severity === "warning" ? "recommended"
+                : "info",
+        message: `${a.title}：${a.message}`,
+    }));
+}
+export { CUSTOMER_INTELLIGENCE_VERSION };

package/dist/customer/order-strategy.d.ts

@@ -0,0 +1,36 @@
+import type { InfoPuzzle, UserPreferences, GameStrategy, GameScenario } from "./types.js";
+import { CUSTOMER_INTELLIGENCE_VERSION } from "./types.js";
+export interface StrategyContext {
+    puzzle: InfoPuzzle;
+    prefs?: UserPreferences;
+    merchant_signals?: string[];
+}
+export interface StrategyRecommendation {
+    scenario: GameScenario;
+    strategy: GameStrategy;
+    confidence: number;
+    fallback?: string;
+    rationale: string;
+}
+export declare function recommendStrategy(scenario: GameScenario, ctx: StrategyContext): StrategyRecommendation;
+export declare function detectScenarios(puzzle: InfoPuzzle): GameScenario[];
+export declare function flowMigrationStrategy(puzzle: InfoPuzzle): {
+    strategy: string;
+    risk: "low" | "medium" | "high";
+    advice: string;
+};
+export declare function repeatGameStrategy(puzzle: InfoPuzzle, history: {
+    completed: number;
+    disputes: number;
+    refunds: number;
+}): {
+    strategy: string;
+    is_long_term_partner: boolean;
+    advice: string;
+};
+export declare function rightsProtectionStrategy(puzzle: InfoPuzzle, prefs?: UserPreferences): {
+    required_rights: string[];
+    negotiable_rights: string[];
+    red_lines: string[];
+};
+export { CUSTOMER_INTELLIGENCE_VERSION };