@wowok/agent-mcp 2.3.14 → 2.3.16

package/dist/customer/industry-risks.js

@@ -0,0 +1,424 @@
+import { CUSTOMER_INTELLIGENCE_VERSION } from "./types.js";
+const hasRefundPath = (p) => p.workflow_analysis?.has_refund_path ?? false;
+const hasArbitrationPath = (p) => p.workflow_analysis?.has_arbitration_path ?? false;
+const hasMilestoneNodes = (p) => p.workflow_analysis?.has_milestone_nodes ?? false;
+const hasMessenger = (p) => p.trust_signals?.has_messenger ?? false;
+const compensationCoversOrder = (p) => p.fund_safety?.compensation_covers_order ?? false;
+const lockDurationSafe = (p) => p.fund_safety?.lock_duration_safe ?? false;
+const userOperableForwards = (p) => p.workflow_analysis?.user_operable_forwards ?? 0;
+const wipVerified = (p) => p.service_basics.wip_verified === true;
+const hasCompensationFund = (p) => p.service_basics.compensation_fund_balance > 0n;
+const deadEndCount = (p) => p.workflow_analysis?.dead_end_nodes?.length ?? 0;
+const totalNodes = (p) => p.workflow_analysis?.total_nodes ?? 0;
+const trustScore = (p) => p.trust_signals?.trust_score ?? 0;
+const reviewTotal = (p) => p.trust_signals?.review_total ?? 0;
+const merchantTotalOrders = (p) => p.merchant_behavior?.total_orders ?? 0;
+const repeatBuyerRate = (p) => p.merchant_behavior?.repeat_buyer_rate ?? 0;
+const disputeRate = (p) => p.merchant_behavior?.dispute_rate ?? 1;
+const INDUSTRY_RISK_CHECKS = {
+    freelance: [
+        {
+            id: "fr_wip_verified", industry: "freelance", dimension: "trust",
+            description: "WIP hash verified (work traceable)",
+            weight: 30,
+            passed: wipVerified,
+            advice: "⚠️ WIP 未验证：自由职业交付物无法溯源，建议要求商家提供 WIP hash 并写入 WTS。",
+        },
+        {
+            id: "fr_milestone_nodes", industry: "freelance", dimension: "workflow",
+            description: "存在里程碑节点（分阶段验收）",
+            weight: 25,
+            passed: hasMilestoneNodes,
+            advice: "⚠️ 无里程碑节点：交付一次性完成无中间验收，建议要求商家增加分阶段交付节点。",
+        },
+        {
+            id: "fr_refund_path", industry: "freelance", dimension: "workflow",
+            description: "Has refund path",
+            weight: 25,
+            passed: hasRefundPath,
+            advice: "⚠️ No refund path: if freelance order delivery is not satisfactory, funds are hard to recover.",
+        },
+        {
+            id: "fr_response_time", industry: "freelance", dimension: "trust",
+            description: "Messenger configured (communication response guarantee)",
+            weight: 20,
+            passed: hasMessenger,
+            advice: "⚠️ Messenger not configured: cannot conduct requirement confirmation and revision communication.",
+        },
+    ],
+    rental: [
+        {
+            id: "rt_compensation_full", industry: "rental", dimension: "fund",
+            description: "赔偿金完全覆盖订单金额",
+            weight: 30,
+            passed: compensationCoversOrder,
+            advice: "🔴 赔偿金未完全覆盖：租赁物损坏时赔付不足，建议选择赔偿金充足的商家。",
+        },
+        {
+            id: "rt_lock_duration", industry: "rental", dimension: "fund",
+            description: "锁定期安全（赔偿金不可被商家随时撤回）",
+            weight: 25,
+            passed: lockDurationSafe,
+            advice: "⚠️ 锁定期不安全：商家可能随时撤回赔偿金，押金安全无保障。",
+        },
+        {
+            id: "rt_arbitration", industry: "rental", dimension: "workflow",
+            description: "Arbitration configured (damage dispute resolution)",
+            weight: 25,
+            passed: hasArbitrationPath,
+            advice: "⚠️ Arbitration not configured: no third-party ruling channel for rental damage disputes.",
+        },
+        {
+            id: "rt_user_operable", industry: "rental", dimension: "workflow",
+            description: "存在用户可操作路径（归还/确认）",
+            weight: 20,
+            passed: (p) => userOperableForwards(p) > 0,
+            advice: "🔴 无用户可操作路径：归还流程完全依赖商家，可能被恶意拖延。",
+        },
+    ],
+    education: [
+        {
+            id: "ed_refund_path", industry: "education", dimension: "workflow",
+            description: "Has refund path (refund guarantee)",
+            weight: 30,
+            passed: hasRefundPath,
+            advice: "🔴 No refund path: course refund not guaranteed, recommend asking the merchant to configure a refund Allocator.",
+        },
+        {
+            id: "ed_compensation", industry: "education", dimension: "fund",
+            description: "Has compensation fund",
+            weight: 25,
+            passed: hasCompensationFund,
+            advice: "⚠️ No compensation fund: no automatic compensation source when course service quality is not up to standard.",
+        },
+        {
+            id: "ed_arbitration", industry: "education", dimension: "workflow",
+            description: "Arbitration configured",
+            weight: 25,
+            passed: hasArbitrationPath,
+            advice: "⚠️ Arbitration not configured: no resolution channel for course quality disputes.",
+        },
+        {
+            id: "ed_long_cycle_ok", industry: "education", dimension: "workflow",
+            description: "Long cycle acceptable (education industry allows long cycles, over 90 days needs attention)",
+            weight: 20,
+            passed: () => true,
+            advice: "ℹ️ Long delivery cycles are normal in education, but if the actual cycle exceeds 90 days, recommend periodically checking learning progress and lesson consumption.",
+        },
+    ],
+    travel: [
+        {
+            id: "tr_urgent_delivery", industry: "travel", dimension: "workflow",
+            description: "Urgent delivery configuration (needs milestone nodes for phased acceptance)",
+            weight: 30,
+            passed: hasMilestoneNodes,
+            advice: "⚠️ No milestone nodes: travel itinerary has no phased acceptance, recommend setting nodes by itinerary stage.",
+        },
+        {
+            id: "tr_compensation_full", industry: "travel", dimension: "fund",
+            description: "Compensation fully covers (breach compensation)",
+            weight: 25,
+            passed: compensationCoversOrder,
+            advice: "🔴 Compensation not fully covered: insufficient payout when itinerary breaches.",
+        },
+        {
+            id: "tr_refund_path", industry: "travel", dimension: "workflow",
+            description: "Has refund path (itinerary change/cancellation)",
+            weight: 25,
+            passed: hasRefundPath,
+            advice: "⚠️ No refund path: funds hard to recover when itinerary changes or cancels due to force majeure.",
+        },
+        {
+            id: "tr_messenger", industry: "travel", dimension: "trust",
+            description: "Messenger configured (emergency communication)",
+            weight: 20,
+            passed: hasMessenger,
+            advice: "⚠️ Messenger not configured: cannot immediately contact merchant during travel emergencies.",
+        },
+    ],
+    subscription: [
+        {
+            id: "sub_no_lockin", industry: "subscription", dimension: "workflow",
+            description: "No long-term lock-in (no dead-end nodes, can exit)",
+            weight: 30,
+            passed: (p) => deadEndCount(p) === 0,
+            advice: "🔴 Dead-end nodes exist: subscription may be locked and unable to exit, auto-renewal trap exists.",
+        },
+        {
+            id: "sub_refund_path", industry: "subscription", dimension: "workflow",
+            description: "Has refund path (exit mechanism)",
+            weight: 25,
+            passed: hasRefundPath,
+            advice: "⚠️ No refund path: remaining cycle fees hard to recover after subscription exit.",
+        },
+        {
+            id: "sub_user_operable", industry: "subscription", dimension: "workflow",
+            description: "Has user-operable path (pause/downgrade/cancel)",
+            weight: 25,
+            passed: (p) => userOperableForwards(p) > 0,
+            advice: "🔴 No user-operable path: subscription status entirely controlled by merchant, cannot pause or cancel independently.",
+        },
+        {
+            id: "sub_compensation_optional", industry: "subscription", dimension: "fund",
+            description: "Compensation optional (not mandatory for subscription industry)",
+            weight: 20,
+            passed: () => true,
+            advice: "ℹ️ Compensation is not mandatory for subscription industry; having it is better.",
+        },
+    ],
+    retail: [
+        {
+            id: "ret_wip_verified", industry: "retail", dimension: "trust",
+            description: "WIP verified (authenticity/logistics traceable)",
+            weight: 25,
+            passed: wipVerified,
+            advice: "⚠️ WIP not verified: product traceability info missing, recommend confirming authenticity guarantee.",
+        },
+        {
+            id: "ret_compensation_full", industry: "retail", dimension: "fund",
+            description: "赔偿金完全覆盖",
+            weight: 25,
+            passed: compensationCoversOrder,
+            advice: "⚠️ 赔偿金未完全覆盖：退换货纠纷时赔付不足。",
+        },
+        {
+            id: "ret_refund_path", industry: "retail", dimension: "workflow",
+            description: "存在退款路径（退换货）",
+            weight: 25,
+            passed: hasRefundPath,
+            advice: "🔴 无退款路径：退换货无保障。",
+        },
+        {
+            id: "ret_arbitration", industry: "retail", dimension: "workflow",
+            description: "Arbitration configured",
+            weight: 25,
+            passed: hasArbitrationPath,
+            advice: "⚠️ Arbitration not configured: no third-party ruling for return/exchange disputes.",
+        },
+    ],
+};
+function commonNeeds() {
+    return [
+        {
+            id: "need_arbitration", tier: "common",
+            description: "配置仲裁（纠纷解决通道）",
+            satisfied: hasArbitrationPath,
+            advice: "未配置仲裁：纠纷无第三方解决通道。",
+        },
+        {
+            id: "need_refund_path", tier: "common",
+            description: "Has refund path",
+            satisfied: hasRefundPath,
+            advice: "无退款路径：交付失败时资金难以回收。",
+        },
+        {
+            id: "need_user_operable", tier: "common",
+            description: "Has user-operable Forward",
+            satisfied: (p) => userOperableForwards(p) > 0,
+            advice: "No user-operable steps in workflow, order progress depends entirely on merchant.",
+        },
+        {
+            id: "need_messenger", tier: "common",
+            description: "Messenger configured",
+            satisfied: hasMessenger,
+            advice: "商家无 Messenger 通道，无法协商或售后沟通。",
+        },
+    ];
+}
+const INDUSTRY_NEEDS = {
+    freelance: [
+        ...commonNeeds(),
+        {
+            id: "need_wip_verified", tier: "personalized",
+            description: "WIP 验证（作品知识产权可溯源）",
+            satisfied: wipVerified,
+            advice: "WIP 未验证：作品知识产权归属与原创性无法溯源。",
+        },
+        {
+            id: "need_milestone_nodes", tier: "personalized",
+            description: "Milestone nodes (phased feedback)",
+            satisfied: hasMilestoneNodes,
+            advice: "No milestone nodes: lack of phased feedback and revision round control.",
+        },
+        {
+            id: "need_merchant_history", tier: "advanced",
+            description: "商家历史 ≥3 单（履约经验）",
+            satisfied: (p) => merchantTotalOrders(p) >= 3,
+            advice: "商家历史订单不足 3 单：履约经验有限。",
+        },
+    ],
+    rental: [
+        ...commonNeeds(),
+        {
+            id: "need_lock_duration_safe", tier: "personalized",
+            description: "Lock duration safe (deposit cannot be withdrawn)",
+            satisfied: lockDurationSafe,
+            advice: "Lock duration not safe: deposit may be withdrawn by merchant at any time.",
+        },
+        {
+            id: "need_compensation_full", tier: "personalized",
+            description: "Compensation fully covers",
+            satisfied: compensationCoversOrder,
+            advice: "Compensation not fully covered: insufficient payout for rental item damage.",
+        },
+        {
+            id: "need_merchant_history", tier: "advanced",
+            description: "Merchant history ≥5 orders (rental experience)",
+            satisfied: (p) => merchantTotalOrders(p) >= 5,
+            advice: "Merchant history orders less than 5: rental service experience limited.",
+        },
+    ],
+    education: [
+        ...commonNeeds(),
+        {
+            id: "need_has_compensation", tier: "personalized",
+            description: "Has compensation fund (course quality guarantee)",
+            satisfied: hasCompensationFund,
+            advice: "No compensation fund: no compensation source when course quality is not up to standard.",
+        },
+        {
+            id: "need_long_cycle_ok", tier: "personalized",
+            description: "长周期可接受",
+            satisfied: () => true,
+            advice: "教育行业长周期属正常；建议跟踪课时消耗与出勤。",
+        },
+        {
+            id: "need_high_reputation", tier: "advanced",
+            description: "声誉评分高（trust_score ≥70）",
+            satisfied: (p) => trustScore(p) >= 70,
+            advice: "商家声誉评分低于 70：课程口碑可能不佳。",
+        },
+    ],
+    travel: [
+        ...commonNeeds(),
+        {
+            id: "need_urgent_delivery", tier: "personalized",
+            description: "Urgent delivery configuration (milestone phasing)",
+            satisfied: hasMilestoneNodes,
+            advice: "No milestone nodes: itinerary has no phased acceptance, urgent delivery guarantee insufficient.",
+        },
+        {
+            id: "need_compensation_full", tier: "personalized",
+            description: "赔偿金完全覆盖（违约赔偿）",
+            satisfied: compensationCoversOrder,
+            advice: "赔偿金未完全覆盖：行程违约赔付不足。",
+        },
+        {
+            id: "need_high_reputation", tier: "advanced",
+            description: "High reputation score (trust_score ≥70)",
+            satisfied: (p) => trustScore(p) >= 70,
+            advice: "Merchant reputation score below 70: travel service reputation may be poor.",
+        },
+    ],
+    subscription: [
+        ...commonNeeds(),
+        {
+            id: "need_no_lockin", tier: "personalized",
+            description: "无长期锁定（无死端节点）",
+            satisfied: (p) => deadEndCount(p) === 0,
+            advice: "存在死端节点：订阅可能被锁定，存在续费陷阱。",
+        },
+        {
+            id: "need_low_dispute", tier: "personalized",
+            description: "Low dispute rate (≤15%, stable content quality)",
+            satisfied: (p) => disputeRate(p) <= 0.15,
+            advice: "Dispute rate is high: subscription content quality may be unstable.",
+        },
+        {
+            id: "need_repeat_rate", tier: "advanced",
+            description: "Repeat buyer rate ≥20% (strong subscription renewal willingness)",
+            satisfied: (p) => repeatBuyerRate(p) >= 0.2,
+            advice: "Repeat buyer rate below 20%: subscription renewal willingness is weak, service may not be worth long-term subscription.",
+        },
+    ],
+    retail: [
+        ...commonNeeds(),
+        {
+            id: "need_wip_verified", tier: "personalized",
+            description: "WIP verified (authenticity/logistics traceability)",
+            satisfied: wipVerified,
+            advice: "WIP not verified: product authenticity and logistics traceability info missing.",
+        },
+        {
+            id: "need_compensation_full", tier: "personalized",
+            description: "赔偿金完全覆盖",
+            satisfied: compensationCoversOrder,
+            advice: "赔偿金未完全覆盖：退换货纠纷赔付不足。",
+        },
+        {
+            id: "need_high_reputation", tier: "advanced",
+            description: "High reputation score (trust_score ≥70)",
+            satisfied: (p) => trustScore(p) >= 70,
+            advice: "Merchant reputation score below 70: product or service reputation may be poor.",
+        },
+    ],
+};
+export function getIndustryRiskChecks(industry) {
+    return INDUSTRY_RISK_CHECKS[industry];
+}
+export function getIndustryNeeds(industry) {
+    return INDUSTRY_NEEDS[industry];
+}
+export function checkIndustryNeeds(puzzle, industry) {
+    const needs = getIndustryNeeds(industry);
+    const met = [];
+    const unmet = [];
+    for (const n of needs) {
+        if (n.satisfied(puzzle))
+            met.push(n);
+        else
+            unmet.push(n);
+    }
+    return { met, unmet };
+}
+export function assessIndustryRisks(puzzle, industry) {
+    const internalChecks = INDUSTRY_RISK_CHECKS[industry];
+    const totalWeight = internalChecks.reduce((s, c) => s + c.weight, 0);
+    const checks = internalChecks.map((c) => {
+        const passed = c.passed(puzzle);
+        return {
+            id: c.id,
+            dimension: c.dimension,
+            description: c.description,
+            weight: c.weight,
+            passed,
+            advice: passed ? undefined : c.advice,
+        };
+    });
+    const passedWeight = checks.reduce((s, c) => s + (c.passed ? c.weight : 0), 0);
+    const passRatio = totalWeight > 0 ? passedWeight / totalWeight : 0;
+    const rawAdj = Math.round((passRatio - 0.5) * 20);
+    const score_adjustment = Math.max(-10, Math.min(10, rawAdj));
+    const needs = getIndustryNeeds(industry);
+    const { met, unmet } = checkIndustryNeeds(puzzle, industry);
+    const passedCount = checks.filter((c) => c.passed).length;
+    const sign = score_adjustment >= 0 ? "+" : "";
+    const summary = `${industry} industry risk check: ${passedCount} checks passed out of ${checks.length}` +
+        ` (pass rate ${Math.round(passRatio * 100)}%); ${met.length} needs satisfied out of ${needs.length};` +
+        ` Score adjustment ${sign}${score_adjustment}.`;
+    return {
+        industry,
+        checks,
+        needs,
+        unmet_needs: unmet,
+        score_adjustment,
+        summary,
+    };
+}
+export function inferIndustry(puzzle) {
+    const basics = puzzle.service_basics;
+    if (basics.price_raw < 1000000000n && basics.has_wip) {
+        return "retail";
+    }
+    if (basics.compensation_lock_duration > 7) {
+        return "rental";
+    }
+    if (reviewTotal(puzzle) > 50) {
+        return "retail";
+    }
+    if (totalNodes(puzzle) > 10) {
+        return "education";
+    }
+    return "freelance";
+}
+export { CUSTOMER_INTELLIGENCE_VERSION };

package/dist/customer/info-puzzle.d.ts

@@ -0,0 +1,102 @@
+import type { InfoPuzzle, ServiceBasics, WorkflowAnalysis, FundSafety, TrustSignals, MerchantBehavior, MarketContext, PuzzleDepth } from "./types.js";
+import { CUSTOMER_INTELLIGENCE_VERSION } from "./types.js";
+export interface ServiceRawData {
+    name?: string;
+    bPublished?: boolean;
+    bPaused?: boolean;
+    price?: string;
+    priceRaw?: bigint;
+    token_type?: string;
+    sales?: Array<{
+        suspension?: boolean;
+        wip_url?: string;
+        wip_hash?: string;
+    }>;
+    machine?: string;
+    buy_guard?: string;
+    customer_required?: unknown[];
+    arbitrations?: string[];
+    compensation_fund?: {
+        balance?: bigint;
+    };
+    compensation_lock_duration?: number;
+    um?: string;
+    order_allocators?: Array<{
+        allocators?: Array<{
+            amount?: {
+                type?: string;
+                value?: bigint;
+            };
+            surplus_to?: string;
+            guard?: string;
+            marker?: {
+                node?: string;
+            };
+        }>;
+    }>;
+}
+export interface MachineNodeRaw {
+    name: string;
+    forwards?: Array<{
+        name?: string;
+        weight?: number;
+        namedOperator?: string | null;
+        guard?: string | null;
+        to?: string;
+    }>;
+    is_pair_done?: boolean;
+}
+export interface ReviewRaw {
+    rating?: "like" | "dislike" | string;
+    reviewer?: string;
+    verified?: boolean;
+    has_evidence?: boolean;
+    timestamp?: number;
+}
+export interface EventRaw {
+    type: string;
+    timestamp?: number;
+    address?: string;
+    data?: Record<string, unknown>;
+}
+export declare function assembleServiceBasics(serviceId: string, raw: ServiceRawData, wipVerified?: boolean): ServiceBasics;
+export declare function assembleWorkflowAnalysis(nodes: MachineNodeRaw[], isPublished: boolean, isPaused: boolean): WorkflowAnalysis;
+export declare function assembleFundSafety(raw: ServiceRawData, orderAmount: bigint): FundSafety;
+export declare function assembleTrustSignals(service: ServiceRawData, reviews: ReviewRaw[], trustScore: {
+    score: number;
+    level: string;
+}, arbitrationOwner?: string, serviceOwner?: string): TrustSignals;
+export declare function assembleMerchantBehavior(events: EventRaw[], orderHistory?: Array<{
+    status: string;
+    has_dispute: boolean;
+    is_repeat: boolean;
+}>): MerchantBehavior;
+export declare function assembleMarketContext(similarServices: Array<{
+    price: bigint;
+}>, currentPrice: bigint): MarketContext;
+export interface PuzzleRawData {
+    service: ServiceRawData;
+    machine_nodes?: MachineNodeRaw[];
+    machine_published?: boolean;
+    machine_paused?: boolean;
+    reviews?: ReviewRaw[];
+    events?: EventRaw[];
+    similar_services?: Array<{
+        price: bigint;
+    }>;
+    order_amount?: bigint;
+    trust_score?: {
+        score: number;
+        level: string;
+    };
+    arbitration_owner?: string;
+    service_owner?: string;
+    wip_verified?: boolean;
+    order_history?: Array<{
+        status: string;
+        has_dispute: boolean;
+        is_repeat: boolean;
+    }>;
+}
+export declare function assembleInfoPuzzle(serviceId: string, raw: PuzzleRawData, depth?: PuzzleDepth): InfoPuzzle;
+export { CUSTOMER_INTELLIGENCE_VERSION };