@wowok/agent-mcp 2.3.13 → 2.3.16

package/dist/customer/order-strategy.js

@@ -0,0 +1,373 @@
+import { CUSTOMER_INTELLIGENCE_VERSION } from "./types.js";
+const SCENARIO_SPECS = {
+    info_asymmetry: {
+        scenario: "info_asymmetry",
+        merchant_tactic: "隐藏关键流程信息，Machine 不公开",
+        user_strategy: "要求查看 machineNode2file 导出 + Guard 配置；通过 Messenger 询问关键节点",
+        nash_equilibrium: "商家透明化（提供完整 Machine 文档）↔ 用户购买",
+        fallback: "放弃购买",
+        confidence: (puzzle) => {
+            if (puzzle.workflow_analysis === undefined)
+                return 0.9;
+            if (puzzle.completeness < 0.5)
+                return 0.9;
+            return 0.5;
+        },
+        rationale: (puzzle) => {
+            if (puzzle.workflow_analysis === undefined) {
+                return "流程结构分析缺失，信息严重不对称";
+            }
+            if (puzzle.completeness < 0.5) {
+                return `信息完整度仅 ${Math.round(puzzle.completeness * 100)}%，关键碎片缺失`;
+            }
+            return "信息完整度尚可，但仍建议索取 Machine 文档";
+        },
+    },
+    fund_safety: {
+        scenario: "fund_safety",
+        merchant_tactic: "无赔偿金或赔偿金不足",
+        user_strategy: "要求商家补充 compensation_fund 到订单金额 100%；写入 WTS 协议",
+        nash_equilibrium: "商家补足赔偿金 ↔ 用户购买",
+        fallback: "选择其他商家或要求仲裁前置",
+        confidence: (puzzle) => {
+            const fund = puzzle.fund_safety;
+            if (!fund)
+                return 0.6;
+            if (fund.compensation_covers_order === false)
+                return 0.95;
+            return 0.4;
+        },
+        rationale: (puzzle) => {
+            const fund = puzzle.fund_safety;
+            if (!fund)
+                return "资金安全分析缺失";
+            if (fund.compensation_covers_order === false) {
+                return `赔偿金仅覆盖 ${Math.round(fund.compensation_ratio * 100)}% 订单金额`;
+            }
+            return "赔偿金已覆盖订单金额";
+        },
+    },
+    refund_dispute: {
+        scenario: "refund_dispute",
+        merchant_tactic: "无退款路径或退款 Allocator 配置不公平",
+        user_strategy: "通过 Messenger 协商退款条款 + 要求 100%→Order Allocator",
+        nash_equilibrium: "商家配置退款 Allocator ↔ 用户购买",
+        fallback: "仲裁",
+        confidence: (puzzle) => {
+            const wf = puzzle.workflow_analysis;
+            if (!wf)
+                return 0.5;
+            if (wf.has_refund_path === false)
+                return 0.85;
+            return 0.4;
+        },
+        rationale: (puzzle) => {
+            const wf = puzzle.workflow_analysis;
+            if (!wf)
+                return "流程结构缺失，无法确认退款路径";
+            if (wf.has_refund_path === false)
+                return "流程中未检测到退款路径";
+            return "退款路径已存在";
+        },
+    },
+    arbitration_fairness: {
+        scenario: "arbitration_fairness",
+        merchant_tactic: "自建仲裁（owner=service owner）",
+        user_strategy: "要求第三方仲裁；通过 query_toolkit 验证 arb owner",
+        nash_equilibrium: "第三方仲裁 ↔ 用户购买",
+        fallback: "不购买",
+        confidence: (puzzle) => {
+            const trust = puzzle.trust_signals;
+            if (!trust)
+                return 0.6;
+            if (trust.arbitration_independent === false)
+                return 0.9;
+            return 0.3;
+        },
+        rationale: (puzzle) => {
+            const trust = puzzle.trust_signals;
+            if (!trust)
+                return "信任信号缺失，无法判断仲裁独立性";
+            if (trust.arbitration_independent === false) {
+                return "仲裁方与商家为同一地址，公正性存疑";
+            }
+            return "仲裁独立，公正性有保障";
+        },
+    },
+    pricing: {
+        scenario: "pricing",
+        merchant_tactic: "价格高于市场均价 20%+",
+        user_strategy: "引用 puzzle.market_context.avg_price 谈判；要求折扣或 Reward",
+        nash_equilibrium: "商家降价或提供 Reward ↔ 用户购买",
+        fallback: "接受当前价格但要求额外权益",
+        confidence: (puzzle) => {
+            const market = puzzle.market_context;
+            if (!market)
+                return 0.4;
+            if (market.price_percentile > 0.8)
+                return 0.7;
+            return 0.3;
+        },
+        rationale: (puzzle) => {
+            const market = puzzle.market_context;
+            if (!market)
+                return "市场环境数据缺失";
+            return `价格处于市场分位 ${Math.round(market.price_percentile * 100)}%`;
+        },
+    },
+    delivery_sla: {
+        scenario: "delivery_sla",
+        merchant_tactic: "无里程碑节点 / 无交付时间承诺",
+        user_strategy: "要求配置 milestone 节点 + 时间承诺写入 WTS",
+        nash_equilibrium: "商家配置 SLA ↔ 用户购买",
+        fallback: "接受但通过 Messenger 书面约定时间",
+        confidence: (puzzle) => {
+            const wf = puzzle.workflow_analysis;
+            if (!wf)
+                return 0.5;
+            if (wf.has_milestone_nodes === false)
+                return 0.8;
+            return 0.3;
+        },
+        rationale: (puzzle) => {
+            const wf = puzzle.workflow_analysis;
+            if (!wf)
+                return "流程结构缺失，无法判断里程碑";
+            if (wf.has_milestone_nodes === false)
+                return "未检测到里程碑节点";
+            return "已配置里程碑节点";
+        },
+    },
+    quality_verification: {
+        scenario: "quality_verification",
+        merchant_tactic: "WIP hash 未验证",
+        user_strategy: "要求 WIP hash 验证；要求样品或阶段性交付证据",
+        nash_equilibrium: "商家提供 WIP 验证 ↔ 用户购买",
+        fallback: "通过 Messenger 索取样品",
+        confidence: (puzzle) => {
+            const basics = puzzle.service_basics;
+            if (basics.wip_verified === false)
+                return 0.85;
+            return 0.3;
+        },
+        rationale: (puzzle) => {
+            const basics = puzzle.service_basics;
+            if (basics.wip_verified === false)
+                return "WIP hash 未经验证，交付物可能被篡改";
+            return "WIP hash 已验证";
+        },
+    },
+    after_sales: {
+        scenario: "after_sales",
+        merchant_tactic: "无 Messenger 或售后支持",
+        user_strategy: "要求配置 Messenger；要求写入售后条款",
+        nash_equilibrium: "商家提供售后通道 ↔ 用户购买",
+        fallback: "通过 Contact 通道替代",
+        confidence: (puzzle) => {
+            const trust = puzzle.trust_signals;
+            if (!trust)
+                return 0.5;
+            if (trust.has_messenger === false)
+                return 0.75;
+            return 0.3;
+        },
+        rationale: (puzzle) => {
+            const trust = puzzle.trust_signals;
+            if (!trust)
+                return "信任信号缺失，无法确认 Messenger";
+            if (trust.has_messenger === false)
+                return "未配置 Messenger，售后无通道";
+            return "已配置 Messenger";
+        },
+    },
+};
+export function recommendStrategy(scenario, ctx) {
+    const spec = SCENARIO_SPECS[scenario];
+    const { puzzle, prefs } = ctx;
+    const strategy = {
+        scenario: spec.scenario,
+        merchant_tactic: spec.merchant_tactic,
+        user_strategy: spec.user_strategy,
+        nash_equilibrium: spec.nash_equilibrium,
+    };
+    const confidence = clampConfidence(spec.confidence(puzzle));
+    const fallback = applyPrefsToFallback(scenario, spec.fallback, prefs);
+    const rationale = spec.rationale(puzzle);
+    return {
+        scenario: spec.scenario,
+        strategy,
+        confidence,
+        fallback,
+        rationale,
+    };
+}
+export function detectScenarios(puzzle) {
+    const scenarios = [];
+    if (puzzle.workflow_analysis === undefined || puzzle.completeness < 0.5) {
+        scenarios.push("info_asymmetry");
+    }
+    if (puzzle.fund_safety?.compensation_covers_order === false) {
+        scenarios.push("fund_safety");
+    }
+    if (puzzle.workflow_analysis?.has_refund_path === false) {
+        scenarios.push("refund_dispute");
+    }
+    if (puzzle.trust_signals?.arbitration_independent === false) {
+        scenarios.push("arbitration_fairness");
+    }
+    if (puzzle.market_context && puzzle.market_context.price_percentile > 0.8) {
+        scenarios.push("pricing");
+    }
+    if (puzzle.workflow_analysis?.has_milestone_nodes === false) {
+        scenarios.push("delivery_sla");
+    }
+    if (puzzle.service_basics.wip_verified === false) {
+        scenarios.push("quality_verification");
+    }
+    if (puzzle.trust_signals?.has_messenger === false) {
+        scenarios.push("after_sales");
+    }
+    return scenarios.slice(0, 3);
+}
+export function flowMigrationStrategy(puzzle) {
+    const wf = puzzle.workflow_analysis;
+    if (!wf || wf.machine_published === false) {
+        return {
+            strategy: "Machine 未发布，强烈建议要求商家发布后再下单",
+            risk: "high",
+            advice: "Machine 未发布意味着流程尚未生效，下单后订单可能无法按预期路径推进。建议通过 Messenger 要求商家先发布 Machine 再下单。",
+        };
+    }
+    if (wf.machine_paused === true) {
+        return {
+            strategy: "Machine 已暂停，确认原因后再下单",
+            risk: "medium",
+            advice: "Machine 已被商家暂停，可能是临时维护或主动停售。建议通过 Messenger 询问暂停原因并确认恢复时间后再下单。",
+        };
+    }
+    return {
+        strategy: "可放心下单，流程稳定",
+        risk: "low",
+        advice: "Machine 已发布且未暂停，流程处于活跃状态，可放心下单。仍建议下单后通过 Progress 节点监控推进。",
+    };
+}
+export function repeatGameStrategy(puzzle, history) {
+    const isLongTerm = history.completed >= 5 &&
+        (history.completed === 0 || history.disputes / history.completed < 0.2);
+    if (isLongTerm) {
+        const disputeRate = history.completed > 0
+            ? Math.round((history.disputes / history.completed) * 100)
+            : 0;
+        return {
+            strategy: "已建立长期信任，可考虑批量下单/优惠谈判",
+            is_long_term_partner: true,
+            advice: `历史已完成 ${history.completed} 单，争议率 ${disputeRate}%，信任度较高。` +
+                "可考虑批量下单以争取折扣，或协商长期合作协议。仍建议保留 WTS 凭证以备后续维权。",
+        };
+    }
+    if (history.completed < 5) {
+        return {
+            strategy: "首次合作，建议先小单测试，建立信任后再扩大",
+            is_long_term_partner: false,
+            advice: `历史合作仅 ${history.completed} 单，样本不足以判断长期信任。` +
+                "建议先用小额订单测试商家履约能力与沟通效率，" +
+                "积累信任后再扩大订单规模。重点关注退款路径与仲裁配置。",
+        };
+    }
+    const disputeRate = Math.round((history.disputes / history.completed) * 100);
+    return {
+        strategy: "历史争议率较高，建议谨慎下单并加强风险保障",
+        is_long_term_partner: false,
+        advice: `历史 ${history.completed} 单中争议率 ${disputeRate}% 偏高，建议本次下单要求商家补足赔偿金、写入 WTS 协议，并强化仲裁前置条款。`,
+    };
+}
+export function rightsProtectionStrategy(puzzle, prefs) {
+    const required = [];
+    const negotiable = [];
+    const red_lines = [];
+    const hasRefundPath = puzzle.workflow_analysis?.has_refund_path ?? false;
+    const hasArbPath = puzzle.workflow_analysis?.has_arbitration_path ?? false;
+    const arbIndependent = puzzle.trust_signals?.arbitration_independent ?? true;
+    const compensationRatio = puzzle.fund_safety?.compensation_ratio ?? 0;
+    if (!hasRefundPath) {
+        required.push("要求商家配置退款 Allocator（100%→Order）");
+    }
+    else {
+        required.push("确认退款路径可用");
+    }
+    if (!hasArbPath) {
+        required.push("要求商家绑定第三方仲裁服务");
+    }
+    else if (!arbIndependent) {
+        required.push("要求商家更换为第三方仲裁（当前为自建仲裁）");
+    }
+    else {
+        required.push("确认仲裁路径可用");
+    }
+    if (compensationRatio < 1) {
+        required.push(`要求商家补充赔偿金至订单金额 100%（当前覆盖 ${Math.round(compensationRatio * 100)}%）`);
+    }
+    else {
+        required.push("确认赔偿金充足");
+    }
+    if (prefs?.require_arbitration && !hasArbPath) {
+        required.push("用户偏好要求必备仲裁");
+    }
+    if (prefs?.require_compensation_fund && compensationRatio < 1) {
+        required.push("用户偏好要求必备赔偿金");
+    }
+    negotiable.push("价格（基于市场均价谈判）");
+    negotiable.push("交付时间（通过 Messenger 书面约定）");
+    negotiable.push("Reward 或折扣（基于 puzzle.market_context）");
+    if (prefs) {
+        if (prefs.bargain_hunting > 0.5) {
+            negotiable.push("额外折扣（用户占便宜心态强烈）");
+        }
+        if (prefs.reward_seeking) {
+            negotiable.push("Reward 激励条款");
+        }
+        if (prefs.delivery_speed_priority === "urgent") {
+            negotiable.push("加急交付承诺");
+        }
+    }
+    if (!hasArbPath && !hasRefundPath) {
+        red_lines.push("无仲裁且无退款路径：商家可任意违约，资金无保障，建议不购买");
+    }
+    if (compensationRatio < 0.5) {
+        red_lines.push(`赔偿金覆盖率仅 ${Math.round(compensationRatio * 100)}%（<50%）：订单失败时赔付严重不足，建议不购买`);
+    }
+    if (prefs) {
+        const trustScore = puzzle.trust_signals?.trust_score ?? 100;
+        if (trustScore < prefs.min_trust_score) {
+            red_lines.push(`综合信任分 ${trustScore} 低于用户最低要求 ${prefs.min_trust_score}`);
+        }
+    }
+    return {
+        required_rights: required,
+        negotiable_rights: negotiable,
+        red_lines: red_lines,
+    };
+}
+function clampConfidence(value) {
+    if (value < 0)
+        return 0;
+    if (value > 1)
+        return 1;
+    return value;
+}
+function applyPrefsToFallback(scenario, defaultFallback, prefs) {
+    if (!prefs)
+        return defaultFallback;
+    if (prefs.risk_appetite === "conservative") {
+        if (scenario === "arbitration_fairness" || scenario === "fund_safety") {
+            return "放弃购买（保守型用户）";
+        }
+    }
+    if (prefs.risk_appetite === "aggressive") {
+        if (scenario === "pricing") {
+            return "接受当前价格但要求额外 Reward 或折扣";
+        }
+    }
+    return defaultFallback;
+}
+export { CUSTOMER_INTELLIGENCE_VERSION };

package/dist/customer/post-purchase.d.ts

@@ -0,0 +1,42 @@
+import type { InfoPuzzle } from "./types.js";
+import { CUSTOMER_INTELLIGENCE_VERSION } from "./types.js";
+export type PostPurchasePhase = "refund_tracking" | "quality_issue" | "merchant_unreachable" | "arbitration_support";
+export interface PostPurchaseContext {
+    phase: PostPurchasePhase;
+    order_id: string;
+    service_id: string;
+    puzzle?: InfoPuzzle;
+    order_amount?: bigint;
+    refunded_amount?: bigint;
+    wip_hash?: string;
+    original_wip_hash?: string;
+    last_merchant_reply_at?: number;
+    now: number;
+    arbitration_initiated?: boolean;
+    arb_window_days?: number;
+    evidence?: string[];
+    has_arbitration?: boolean;
+    refund_requested?: boolean;
+}
+export interface PostPurchaseAction {
+    id: string;
+    phase: PostPurchasePhase;
+    priority: "required" | "recommended" | "info";
+    title: string;
+    message: string;
+    next_step?: string;
+    tool?: string;
+    deadline?: number;
+}
+export declare function generatePostPurchaseAdvice(ctx: PostPurchaseContext): PostPurchaseAction[];
+export declare function trackRefund(ctx: PostPurchaseContext): PostPurchaseAction[];
+export declare function handleQualityIssue(ctx: PostPurchaseContext): PostPurchaseAction[];
+export declare function handleMerchantUnreachable(ctx: PostPurchaseContext): PostPurchaseAction[];
+export declare function arbitrationSupport(ctx: PostPurchaseContext): PostPurchaseAction[];
+export declare function generateArbitrationTemplate(ctx: PostPurchaseContext): {
+    title: string;
+    description: string;
+    evidence_required: string[];
+    claim: string;
+};
+export { CUSTOMER_INTELLIGENCE_VERSION };