@wowok/agent-mcp 2.5.5 → 2.6.1

package/dist/extensions/modes.d.ts

@@ -0,0 +1,2 @@
+import type { IndustryMode } from "./types.js";
+export declare const BUILTIN_MODES: IndustryMode[];

package/dist/extensions/modes.js

@@ -0,0 +1,407 @@
+import { getScenarioMode } from "../knowledge/scenario-modes.js";
+import { getIndustryTraits } from "../knowledge/industry-registry.js";
+import { getIndustryRiskChecks, getIndustryNeeds } from "../customer/index.js";
+import { getFlywheelForIndustry } from "../knowledge/acquisition-flywheel.js";
+const GENERAL_TRAITS = {
+    has_logistics: false,
+    communication_heavy: false,
+    pure_digital: false,
+    long_cycle: false,
+    deposit_required: false,
+    multi_tier_allocation: false,
+    regulatory_intensity: "low",
+    trust_sensitivity: "medium",
+    consumption_frequency: "occasional",
+    avg_ticket_size: "medium",
+};
+const GENERAL_FLYWHEEL = {
+    industry: "general",
+    trustSellingPoints: [],
+    keyActions: [],
+    rewardStrategy: "User-defined",
+    discountStrategy: "User-defined",
+    trustDescription: "User-defined trust mechanism",
+};
+const GENERAL_MACHINE_SHAPE = [
+    { name: "paid", role: "Entry: order created and paid" },
+    { name: "delivering", role: "Service delivery in progress" },
+    { name: "completed", role: "Service completed, funds released" },
+    { name: "refunded", role: "Customer refund path" },
+    { name: "cancelled", role: "Pre-delivery cancellation" },
+];
+const GENERAL_ALLOCATOR = {
+    recipient: "signer",
+    count: 1,
+    mode: "surplus",
+    description: "Default: surplus to service owner (general fallback)",
+};
+const RETAIL_MACHINE_SHAPE = [
+    { name: "paid", role: "Entry: order paid via Service.buy(); Machine starts here" },
+    { name: "shipped", role: "Merchant ships goods, records shipping WIP (tracking number)" },
+    { name: "delivered", role: "Goods delivered to buyer" },
+    { name: "confirmed", role: "Buyer confirms receipt" },
+    { name: "completed", role: "Funds released to merchant" },
+    { name: "refunded", role: "Return & refund path" },
+    { name: "cancelled", role: "Pre-ship cancellation" },
+];
+const RETAIL_GUARDS = [
+    { template_id: "buy_guard_inventory", host: "service", purpose: "Verify inventory and buyer address on purchase" },
+    { template_id: "ship_guard_wip", host: "machine", purpose: "Shipping evidence WIP (logistics tracking number)" },
+    { template_id: "confirm_guard_signer", host: "machine", purpose: "Only buyer can confirm receipt" },
+    { template_id: "refund_guard_permission", host: "machine", purpose: "Return & refund requires merchant permission OR arbiter" },
+    { template_id: "tpl_payment_exception_compensation", host: "machine", purpose: "Logistics delay exception compensation (§2.13)" },
+];
+const RETAIL_ALLOCATOR = {
+    recipient: "entity",
+    count: 2,
+    mode: "rate",
+    description: "Platform 10% + Merchant 90% (rate-based split)",
+};
+const RETAIL_KEY_RISK = "Products don't match description — no refund path for returns";
+const RETAIL_BUILD_NOTES = [
+    "Logistics WIP (tracking number) is essential — shipping evidence protects both parties in return disputes",
+    "confirm_gate prevents merchant from self-confirming receipt",
+    "Refund path must support return-and-exchange flow",
+    "Compensation fund covers return/exchange disputes",
+];
+const SUPPORTED_INDUSTRY_SET = new Set([
+    "freelance", "rental", "education", "travel", "subscription", "retail",
+]);
+function fetchTemplate(name) {
+    const traits = getIndustryTraits(name) ?? GENERAL_TRAITS;
+    const isSupported = SUPPORTED_INDUSTRY_SET.has(name);
+    const risk_checks = isSupported
+        ? getIndustryRiskChecks(name)
+        : [];
+    const needs = isSupported
+        ? getIndustryNeeds(name)
+        : [];
+    const flywheel = getFlywheelForIndustry(name) ?? GENERAL_FLYWHEEL;
+    let machine_shape;
+    let guards;
+    let allocator;
+    let key_risk;
+    let build_notes;
+    if (name === "retail") {
+        machine_shape = RETAIL_MACHINE_SHAPE;
+        guards = RETAIL_GUARDS;
+        allocator = RETAIL_ALLOCATOR;
+        key_risk = RETAIL_KEY_RISK;
+        build_notes = RETAIL_BUILD_NOTES;
+    }
+    else if (name === "general") {
+        const sm = getScenarioMode("general");
+        machine_shape = GENERAL_MACHINE_SHAPE;
+        guards = [];
+        allocator = GENERAL_ALLOCATOR;
+        key_risk = sm?.key_risk ?? "No safety net — user must design all trust mechanisms manually";
+        build_notes = sm?.build_notes;
+    }
+    else {
+        const sm = getScenarioMode(name);
+        if (!sm) {
+            throw new Error(`[modes.ts] No scenario mode found for industry: ${name}`);
+        }
+        machine_shape = sm.machine_shape;
+        guards = sm.guards;
+        allocator = sm.allocator;
+        key_risk = sm.key_risk;
+        build_notes = sm.build_notes;
+    }
+    return { traits, risk_checks, needs, flywheel, machine_shape, guards, allocator, key_risk, build_notes };
+}
+export const BUILTIN_MODES = [
+    {
+        name: "freelance",
+        display_name: "Freelance 自由职业",
+        version: "v1",
+        source: "builtin",
+        ...fetchTemplate("freelance"),
+        capabilities_used: [
+            "permission.index_create", "permission.role_assign",
+            "guard.validate_buy", "guard.validate_wip_hash",
+            "machine.node_topology",
+            "treasury.owner_receive",
+            "allocation.distribute", "allocation.distribute_milestone",
+            "service.publish", "progress.advance",
+            "arb.vote_weighted", "contact.im_create",
+        ],
+        config_overrides: {
+            service: { setting_locked_time: "30d", engagement_type: "milestone" },
+            machine: { wip_required: true, wip_hash_algorithm: "sha256", acceptance_gate: true },
+        },
+        expected_benefits: [
+            { metric: "纠纷率降低", expected_value: "40%", evidence: "WIP 哈希 + 里程碑分账强制交付证据" },
+            { metric: "交付确认效率", expected_value: "提升 50%", evidence: "acceptance gate 自动化验收" },
+            { metric: "提供方回款保障", expected_value: "100%", evidence: "accepted 节点后资金自动释放给提供方" },
+        ],
+        risk_appetite: "balanced",
+        risk_constraints: {
+            require_arbitration: true,
+            require_compensation_fund: false,
+            require_wip_evidence: true,
+            other_constraints: ["setting_locked_time ≥ 7d 以锁定合作期规则"],
+        },
+        applicable_conditions: {
+            business_scale: "small",
+            min_daily_orders: 1,
+            other_conditions: ["适合中长期项目交付", "需里程碑分阶段验收"],
+        },
+        similar_industries: ["rental", "education"],
+        novel_capabilities: ["allocation.distribute_milestone"],
+    },
+    {
+        name: "rental",
+        display_name: "Rental 租赁",
+        version: "v1",
+        source: "builtin",
+        ...fetchTemplate("rental"),
+        capabilities_used: [
+            "permission.index_create", "permission.role_assign",
+            "guard.validate_buy", "guard.validate_wip_hash",
+            "machine.node_topology",
+            "treasury.owner_receive",
+            "allocation.distribute",
+            "service.publish", "progress.advance",
+            "arb.vote_weighted", "contact.im_create",
+        ],
+        config_overrides: {
+            treasury: { deposit_escrow: true, deposit_deductible: true },
+            machine: { wip_required: true, wip_stages: ["handover_out", "returned"], inspection_gate: true },
+        },
+        expected_benefits: [
+            { metric: "押金纠纷率", expected_value: "降低 60%", evidence: "pre-rental WIP 强制记录物品原始状态" },
+            { metric: "损坏定责准确率", expected_value: "提升 70%", evidence: "前后 WIP 哈希对比，杜绝无据扣款" },
+            { metric: "信任评分", expected_value: "提升 25%", evidence: "compensation_fund 覆盖损坏风险" },
+        ],
+        risk_appetite: "conservative",
+        risk_constraints: {
+            require_arbitration: true,
+            require_compensation_fund: true,
+            require_wip_evidence: true,
+            max_single_transaction: 10000,
+            other_constraints: ["押金必须 escrow 托管（不可直转）", "lock_duration ≥ 7d 防止商家随意提取"],
+        },
+        applicable_conditions: {
+            business_scale: "small",
+            min_daily_orders: 1,
+            other_conditions: ["需物理物品交接", "有物流或线下交付环节"],
+        },
+        similar_industries: ["retail", "travel"],
+        novel_capabilities: [],
+    },
+    {
+        name: "education",
+        display_name: "Education 教育",
+        version: "v1",
+        source: "builtin",
+        ...fetchTemplate("education"),
+        capabilities_used: [
+            "permission.index_create", "permission.role_assign",
+            "guard.validate_buy", "guard.validate_wip_hash",
+            "machine.node_topology",
+            "treasury.owner_receive",
+            "allocation.distribute", "allocation.distribute_milestone",
+            "service.publish", "progress.advance",
+            "arb.vote_weighted", "contact.im_create",
+        ],
+        config_overrides: {
+            allocation: {
+                strategy: {
+                    recipient: "entity",
+                    count: 1,
+                    mode: "amount",
+                    description: "1/N of tuition released per session attendance",
+                },
+                session_threshold: true,
+            },
+            service: { setting_locked_time: "120d", anti_runaway: true },
+        },
+        expected_benefits: [
+            { metric: "退费纠纷率", expected_value: "降低 50%", evidence: "per-session release 按课时释放学费" },
+            { metric: "机构跑路风险", expected_value: "消除", evidence: "资金按课时释放，未交付部分可退" },
+            { metric: "出勤可追溯", expected_value: "100%", evidence: "attendance_guard 每课时签名" },
+        ],
+        risk_appetite: "conservative",
+        risk_constraints: {
+            require_arbitration: true,
+            require_compensation_fund: true,
+            require_wip_evidence: false,
+            other_constraints: ["setting_locked_time 覆盖整个学期（≥90d）", "长周期需关注 >90d 进度"],
+        },
+        applicable_conditions: {
+            business_scale: "medium",
+            min_daily_orders: 1,
+            other_conditions: ["长周期交付", "需分课时验收", "监管强度 medium"],
+        },
+        similar_industries: ["freelance", "subscription"],
+        novel_capabilities: ["allocation.distribute_milestone"],
+    },
+    {
+        name: "travel",
+        display_name: "Travel 旅游",
+        version: "v1",
+        source: "builtin",
+        ...fetchTemplate("travel"),
+        capabilities_used: [
+            "permission.index_create", "permission.role_assign",
+            "guard.validate_buy", "guard.validate_wip_hash",
+            "machine.node_topology",
+            "treasury.owner_receive",
+            "allocation.distribute",
+            "service.publish", "progress.advance",
+            "arb.vote_weighted", "contact.im_create",
+        ],
+        config_overrides: {
+            allocation: {
+                strategy: {
+                    recipient: "entity",
+                    count: 3,
+                    mode: "amount",
+                    description: "Deposit 20% to agency, final 80% to agency, then agency-side Allocation splits to hotel/guide/driver per segment",
+                },
+                multi_tier_waterfall: true,
+                guard_chaining: true,
+            },
+            service: { supply_chain_suborders: true, segment_guard_required: true },
+        },
+        expected_benefits: [
+            { metric: "资金透明度", expected_value: "100%", evidence: "multi-tier allocation 按段分账至酒店/导游/司机" },
+            { metric: "行程变更纠纷", expected_value: "降低 45%", evidence: "segment WIP 每段验收" },
+            { metric: "违约赔付保障", expected_value: "提升 60%", evidence: "compensation_fund 覆盖行程违约" },
+        ],
+        risk_appetite: "balanced",
+        risk_constraints: {
+            require_arbitration: true,
+            require_compensation_fund: true,
+            require_wip_evidence: true,
+            other_constraints: ["多级分账需 guard chaining 校验", "deposit 20% + final 80% 两段付款"],
+        },
+        applicable_conditions: {
+            business_scale: "medium",
+            min_daily_orders: 1,
+            other_conditions: ["多段行程组合", "需酒店/导游/司机多方分账"],
+        },
+        similar_industries: ["rental", "education"],
+        novel_capabilities: [],
+    },
+    {
+        name: "subscription",
+        display_name: "Subscription 订阅",
+        version: "v1",
+        source: "builtin",
+        ...fetchTemplate("subscription"),
+        capabilities_used: [
+            "permission.index_create", "permission.role_assign",
+            "guard.validate_buy",
+            "machine.node_topology",
+            "treasury.owner_receive",
+            "allocation.distribute",
+            "service.publish", "progress.advance",
+            "arb.vote_weighted", "reward.claim_guard", "contact.im_create",
+        ],
+        config_overrides: {
+            machine: {
+                no_auto_renew_trap: true,
+                user_confirmed_charge: true,
+                cancel_anytime: true,
+                next_period_effective: true,
+            },
+            service: { creator_data_subscription: true, periodic_billing: true },
+        },
+        expected_benefits: [
+            { metric: "续费率", expected_value: "提升 25%", evidence: "loyalty reward + 透明订阅机制" },
+            { metric: "退订纠纷", expected_value: "消除", evidence: "cancel anytime + no auto-renew trap" },
+            { metric: "创作者留存", expected_value: "提升 30%", evidence: "deliver_guard_wip 防止内容断更" },
+        ],
+        risk_appetite: "aggressive",
+        risk_constraints: {
+            require_arbitration: false,
+            require_compensation_fund: false,
+            require_wip_evidence: false,
+            other_constraints: ["禁止 dead-end 节点（防止锁定）", "charge_guard 每期需用户确认"],
+        },
+        applicable_conditions: {
+            business_scale: "small",
+            min_daily_orders: 5,
+            other_conditions: ["纯数字交付", "周期性内容或 SaaS 服务"],
+        },
+        similar_industries: ["freelance", "education"],
+        novel_capabilities: [],
+    },
+    {
+        name: "retail",
+        display_name: "Retail 零售",
+        version: "v1",
+        source: "builtin",
+        ...fetchTemplate("retail"),
+        capabilities_used: [
+            "permission.index_create", "permission.role_assign",
+            "guard.validate_buy", "guard.validate_wip_hash",
+            "machine.node_topology",
+            "treasury.owner_receive",
+            "allocation.distribute",
+            "service.publish", "progress.advance",
+            "arb.vote_weighted", "reward.claim_guard", "contact.im_create",
+        ],
+        config_overrides: {
+            machine: {
+                wip_required: true,
+                wip_field: "tracking_number",
+                confirm_gate: true,
+                refund_requires_approval: true,
+            },
+            service: { logistics_mode: "standard", first_order_discount: true },
+        },
+        expected_benefits: [
+            { metric: "退货纠纷率", expected_value: "降低 35%", evidence: "logistics WIP + refund path 保障" },
+            { metric: "复购率", expected_value: "提升 20%", evidence: "spend cashback reward" },
+            { metric: "商品真实性可追溯", expected_value: "100%", evidence: "WIP 验证商品/物流信息" },
+        ],
+        risk_appetite: "conservative",
+        risk_constraints: {
+            require_arbitration: true,
+            require_compensation_fund: true,
+            require_wip_evidence: false,
+            other_constraints: ["refund_window ≥ 7d", "confirm_gate 仅买家可确认收货"],
+        },
+        applicable_conditions: {
+            business_scale: "medium",
+            min_daily_orders: 10,
+            other_conditions: ["有物流发货环节", "高频小额交易"],
+        },
+        similar_industries: ["rental", "subscription"],
+        novel_capabilities: [],
+    },
+    {
+        name: "general",
+        display_name: "General 通用",
+        version: "v1",
+        source: "builtin",
+        ...fetchTemplate("general"),
+        capabilities_used: [
+            "permission.index_create",
+            "machine.node_topology",
+            "treasury.owner_receive",
+            "allocation.distribute",
+            "service.publish",
+            "progress.advance",
+        ],
+        expected_benefits: [
+            { metric: "灵活性", expected_value: "100%", evidence: "用户自定义所有信任机制参数" },
+            { metric: "降级安全", expected_value: "可用", evidence: "任意时刻可切换至 general 兜底" },
+        ],
+        risk_appetite: "balanced",
+        risk_constraints: {
+            require_arbitration: false,
+            require_compensation_fund: false,
+            require_wip_evidence: false,
+        },
+        applicable_conditions: {
+            business_scale: "small",
+            other_conditions: ["降级兜底模式", "未被其他行业覆盖的混合场景"],
+        },
+        similar_industries: [],
+        novel_capabilities: [],
+    },
+];

package/dist/extensions/registry.d.ts

@@ -0,0 +1,48 @@
+import type { IndustryMode, UserDefinedMode, Blueprint, BlueprintObject, BlueprintEdge, ProjectContext, ModeEvaluation, ModeMigrationEvaluation } from "./types.js";
+export declare class IndustryModeRegistry {
+    private static instance;
+    private registrations;
+    private userModes;
+    private aliases;
+    private evaluator;
+    private initialized;
+    static Instance(): IndustryModeRegistry;
+    private constructor();
+    registerMode(mode: IndustryMode, aliases?: string[]): boolean;
+    getMode(name: string): IndustryMode | undefined;
+    listModes(): IndustryMode[];
+    resolveAlias(name: string): string;
+    hasMode(name: string): boolean;
+    evaluateMode(name: string, intent: string, context: ProjectContext): ModeEvaluation;
+    evaluateMigration(sourceName: string, targetName: string): ModeMigrationEvaluation;
+    registerUserMode(mode: UserDefinedMode, userId: string): boolean;
+    deriveMode(sourceMode: string, modifications: Partial<UserDefinedMode>, userId: string, newName: string, newDisplayName?: string): UserDefinedMode | undefined;
+    evolveMode(modeName: string, updates: Partial<UserDefinedMode>, userId: string, changeDescription: string, bumpVersion?: boolean): UserDefinedMode | undefined;
+    listUserModes(userId: string): UserDefinedMode[];
+    getUserMode(modeName: string, userId: string): UserDefinedMode | undefined;
+    unregisterUserMode(modeName: string, userId: string): boolean;
+    private userModeKey;
+    private bumpPatchVersion;
+    applyTemplate(name: string, intent: string, context: ProjectContext): Blueprint;
+    applyUserMode(modeName: string, userId: string, intent: string, context: ProjectContext): Blueprint;
+    private doApplyTemplate;
+    validateBlueprint(objects: BlueprintObject[], edges: BlueprintEdge[], mode: IndustryMode): {
+        errors: string[];
+        warnings: string[];
+    };
+    private buildObjects;
+    private buildPermissionIndexes;
+    private applyConfigOverrides;
+    private applyConfigOverrideRules;
+    private evaluateCondition;
+    private setNestedField;
+    private buildEdges;
+    private makeEdge;
+    private buildSteps;
+    private defaultScenarios;
+    private recordCapabilitiesUsed;
+    private makeObject;
+    private registerBuiltinModes;
+}
+export declare function getIndustryModeRegistry(): IndustryModeRegistry;
+export declare const INDUSTRY_MODE_REGISTRY_VERSION = 2.1;