@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/extensions/modes.js

@@ -1,499 +1 @@
-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: "delivered", role: "Deliverable available for review" },
-    { name: "completed", role: "Service completed, funds released" },
-    { name: "cancelled", role: "Pre-delivery cancellation — triggers refund Allocator" },
-];
-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: "returned", role: "Buyer ships goods back — triggers refund Allocator (R-M1-11 compliant)" },
-    { name: "cancelled", role: "Pre-ship cancellation — triggers refund Allocator" },
-];
-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 RETAIL_D2C_MACHINE_SHAPE = [
-    { name: "ordered", role: "Entry: order created (funds escrowed in Allocation)" },
-    { name: "shipped", role: "Merchant ships goods" },
-    { name: "delivered", role: "Goods delivered to buyer" },
-    { name: "completed", role: "Buyer confirms receipt — withdraw_guard releases funds" },
-    { name: "cancelled", role: "Pre-ship cancellation — refund_guard refunds buyer" },
-];
-const RETAIL_D2C_GUARDS = [
-    { template_id: "withdraw_guard_delivery", host: "service", purpose: "Release funds to merchant + processor on order completion (delivery confirmation)" },
-    { template_id: "refund_guard_cancellation", host: "service", purpose: "Refund 100% to buyer on order cancellation" },
-];
-const RETAIL_D2C_ALLOCATOR = {
-    recipient: "entity",
-    count: 2,
-    mode: "rate",
-    description: "Merchant 97% + Processor 3% (rate-based split, no platform commission)",
-};
-const RETAIL_D2C_KEY_RISK = "No platform arbitration — disputes rely on optional Arbitration or off-chain chargeback";
-const RETAIL_D2C_BUILD_NOTES = [
-    "Allocation escrow replaces platform custody — funds locked in contract until Guard releases",
-    "withdraw_guard enforces delivery gate — merchant must reach 'completed' state to receive payment",
-    "refund_guard ensures 100% refund on cancellation — no merchant approval needed",
-    "No buy_guard needed — D2C doesn't gate purchases (open storefront)",
-    "Arbitration is optional — add when dispute volume justifies the cost",
-    "Service ↔ Guard circular dependency: create Service (unpublished) → create Guards → update Service (publish)",
-];
-const SUPPORTED_INDUSTRY_SET = new Set([
-    "freelance", "rental", "education", "travel", "subscription", "retail", "retail_d2c",
-]);
-function fetchTemplate(name) {
-    const traitsLookupName = name === "retail_d2c" ? "retail" : name;
-    const traits = getIndustryTraits(traitsLookupName) ?? GENERAL_TRAITS;
-    const isSupported = SUPPORTED_INDUSTRY_SET.has(name);
-    const industryLookupName = name === "retail_d2c" ? "retail" : name;
-    const risk_checks = isSupported
-        ? getIndustryRiskChecks(industryLookupName)
-        : [];
-    const needs = isSupported
-        ? getIndustryNeeds(industryLookupName)
-        : [];
-    const flywheel = getFlywheelForIndustry(traitsLookupName) ?? 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 === "retail_d2c") {
-        machine_shape = RETAIL_D2C_MACHINE_SHAPE;
-        guards = RETAIL_D2C_GUARDS;
-        allocator = RETAIL_D2C_ALLOCATOR;
-        key_risk = RETAIL_D2C_KEY_RISK;
-        build_notes = RETAIL_D2C_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: "Dispute rate reduction", expected_value: "40%", evidence: "WIP hash + milestone allocation enforces delivery evidence" },
-            { metric: "Delivery confirmation efficiency", expected_value: "+50%", evidence: "acceptance gate automates acceptance workflow" },
-            { metric: "Provider payment assurance", expected_value: "100%", evidence: "Funds auto-release to provider after accepted node" },
-        ],
-        risk_appetite: "balanced",
-        risk_constraints: {
-            require_arbitration: true,
-            require_compensation_fund: false,
-            require_wip_evidence: true,
-            other_constraints: [
-                "setting_locked_time >= 7d to lock engagement-period rules",
-                "ISSUE-P1-4: 48h auto-accept requires off-chain keeper (WoWok Guard does not support time-based triggers). Deploy a keeper service that polls Progress objects in 'delivered' state and calls adminUnhold (permission 224) after 48h timeout. See keeper template in docs.",
-            ],
-        },
-        applicable_conditions: {
-            business_scale: "small",
-            min_daily_orders: 1,
-            other_conditions: ["Suitable for mid-to-long-term project delivery", "Requires milestone-based phased acceptance"],
-        },
-        similar_industries: ["rental", "education"],
-        novel_capabilities: ["allocation.distribute_milestone"],
-        disabled_builtin_constraints: ["require_compensation_fund"],
-    },
-    {
-        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: "Deposit dispute rate", expected_value: "-60%", evidence: "pre-rental WIP mandatorily records item's original state" },
-            { metric: "Damage liability accuracy", expected_value: "+70%", evidence: "pre/post WIP hash comparison eliminates unfounded deductions" },
-            { metric: "Trust score", expected_value: "+25%", evidence: "compensation_fund covers damage risk" },
-        ],
-        risk_appetite: "conservative",
-        risk_constraints: {
-            require_arbitration: true,
-            require_compensation_fund: true,
-            require_wip_evidence: true,
-            max_single_transaction: 10000,
-            compensation_fund_coverage_ratio: 10,
-            other_constraints: ["Deposit must be escrowed (no direct transfer)", "lock_duration >= 7d to prevent arbitrary merchant withdrawal"],
-        },
-        applicable_conditions: {
-            business_scale: "small",
-            min_daily_orders: 1,
-            other_conditions: ["Requires physical item handover", "Has logistics or offline delivery leg"],
-        },
-        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: "Refund dispute rate", expected_value: "-50%", evidence: "per-session release distributes tuition by class" },
-            { metric: "Institution runaway risk", expected_value: "eliminated", evidence: "Funds release per session; undelivered portion is refundable" },
-            { metric: "Attendance traceability", expected_value: "100%", evidence: "attendance_guard signs each session" },
-        ],
-        risk_appetite: "conservative",
-        risk_constraints: {
-            require_arbitration: true,
-            require_compensation_fund: true,
-            require_wip_evidence: false,
-            other_constraints: ["setting_locked_time covers the entire term (>=90d)", "Long-cycle projects must monitor >90d progress"],
-        },
-        applicable_conditions: {
-            business_scale: "medium",
-            min_daily_orders: 1,
-            other_conditions: ["Long-cycle delivery", "Requires per-session acceptance", "Regulatory intensity: medium"],
-        },
-        similar_industries: ["freelance", "subscription"],
-        novel_capabilities: ["allocation.distribute_milestone"],
-        disabled_builtin_constraints: ["require_wip_evidence"],
-    },
-    {
-        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: "Fund transparency", expected_value: "100%", evidence: "multi-tier allocation splits per segment to hotel/guide/driver" },
-            { metric: "Itinerary change disputes", expected_value: "-45%", evidence: "segment WIP accepts each leg" },
-            { metric: "Breach compensation assurance", expected_value: "+60%", evidence: "compensation_fund covers itinerary breach" },
-        ],
-        risk_appetite: "balanced",
-        risk_constraints: {
-            require_arbitration: true,
-            require_compensation_fund: true,
-            require_wip_evidence: true,
-            other_constraints: ["Multi-tier allocation requires guard chaining validation", "deposit 20% + final 80% two-stage payment"],
-        },
-        applicable_conditions: {
-            business_scale: "medium",
-            min_daily_orders: 1,
-            other_conditions: ["Multi-segment itinerary combination", "Requires hotel/guide/driver multi-party allocation"],
-        },
-        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: "Renewal rate", expected_value: "+25%", evidence: "loyalty reward + transparent subscription mechanism" },
-            { metric: "Cancellation disputes", expected_value: "eliminated", evidence: "cancel anytime + no auto-renew trap" },
-            { metric: "Creator retention", expected_value: "+30%", evidence: "deliver_guard_wip prevents content dropout" },
-        ],
-        risk_appetite: "aggressive",
-        risk_constraints: {
-            require_arbitration: false,
-            require_compensation_fund: false,
-            require_wip_evidence: false,
-            compensation_fund_coverage_ratio: 3,
-            other_constraints: ["Forbid dead-end nodes (prevent lock-in)", "charge_guard requires user confirmation each period"],
-        },
-        applicable_conditions: {
-            business_scale: "small",
-            min_daily_orders: 5,
-            other_conditions: ["Pure-digital delivery", "Periodic content or SaaS service"],
-        },
-        similar_industries: ["freelance", "education"],
-        novel_capabilities: [],
-        disabled_builtin_constraints: ["require_arbitration", "require_compensation_fund", "require_wip_evidence"],
-    },
-    {
-        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: "Return dispute rate", expected_value: "-35%", evidence: "logistics WIP + refund path assurance" },
-            { metric: "Repurchase rate", expected_value: "+20%", evidence: "spend cashback reward" },
-            { metric: "Product authenticity traceability", expected_value: "100%", evidence: "WIP verifies product/logistics info" },
-        ],
-        risk_appetite: "conservative",
-        risk_constraints: {
-            require_arbitration: true,
-            require_compensation_fund: true,
-            require_wip_evidence: false,
-            compensation_fund_coverage_ratio: 5,
-            other_constraints: ["refund_window >= 7d", "confirm_gate: only buyer can confirm receipt"],
-        },
-        applicable_conditions: {
-            business_scale: "medium",
-            min_daily_orders: 10,
-            other_conditions: ["Has logistics shipping leg", "High-frequency small-ticket transactions"],
-        },
-        similar_industries: ["rental", "subscription"],
-        novel_capabilities: [],
-        disabled_builtin_constraints: ["require_wip_evidence"],
-    },
-    {
-        name: "retail_d2c",
-        display_name: "Retail D2C (Direct-to-Consumer)",
-        version: "v1",
-        source: "builtin",
-        ...fetchTemplate("retail_d2c"),
-        capabilities_used: [
-            "permission.index_create", "permission.role_assign",
-            "guard.validate_withdraw", "guard.validate_refund",
-            "machine.node_topology",
-            "allocation.distribute",
-            "service.publish", "progress.advance",
-            "contact.im_create",
-        ],
-        config_overrides: {
-            machine: {
-                wip_required: false,
-                confirm_gate: true,
-                refund_requires_approval: false,
-            },
-            service: { logistics_mode: "merchant_managed", multi_recipient_allocation: true },
-        },
-        expected_benefits: [
-            { metric: "Merchant revenue share", expected_value: "97%", evidence: "No platform commission — only 3% processing fee" },
-            { metric: "Fund safety", expected_value: "contract-grade", evidence: "Allocation escrow + Guard verification replaces platform custody" },
-            { metric: "Delivery reliability", expected_value: "high", evidence: "withdraw_guard enforces delivery confirmation before payment" },
-        ],
-        risk_appetite: "balanced",
-        risk_constraints: {
-            require_arbitration: false,
-            require_compensation_fund: false,
-            require_wip_evidence: false,
-            other_constraints: [
-                "Allocation escrow required (withdraw_guard + refund_guard)",
-                "Service ↔ Guard circular dependency requires 3-step creation pattern",
-            ],
-        },
-        applicable_conditions: {
-            business_scale: "small",
-            min_daily_orders: 1,
-            other_conditions: ["Independent storefront (no marketplace)", "Merchant-managed logistics", "Allocation escrow model"],
-        },
-        similar_industries: ["retail", "subscription"],
-        novel_capabilities: ["Allocation escrow as platform-custody alternative", "Multi-recipient allocation (merchant + processor)"],
-        disabled_builtin_constraints: ["require_arbitration", "require_compensation_fund", "require_wip_evidence"],
-    },
-    {
-        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: "Flexibility", expected_value: "100%", evidence: "User customizes all trust mechanism parameters" },
-            { metric: "Degraded safety", expected_value: "usable", evidence: "Can fall back to general at any time" },
-        ],
-        risk_appetite: "balanced",
-        risk_constraints: {
-            require_arbitration: false,
-            require_compensation_fund: false,
-            require_wip_evidence: false,
-        },
-        applicable_conditions: {
-            business_scale: "small",
-            other_conditions: ["Fallback degraded mode", "Hybrid scenarios not covered by other industries"],
-        },
-        similar_industries: [],
-        novel_capabilities: [],
-        disabled_builtin_constraints: ["require_arbitration", "require_compensation_fund", "require_wip_evidence"],
-    },
-];
+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':![],'communication_heavy':![],'pure_digital':![],'long_cycle':![],'deposit_required':![],'multi_tier_allocation':![],'regulatory_intensity':'low','trust_sensitivity':'medium','consumption_frequency':'occasional','avg_ticket_size':'medium'},GENERAL_FLYWHEEL={'industry':'general','trustSellingPoints':[],'keyActions':[],'rewardStrategy':'User-defined','discountStrategy':'User-defined','trustDescription':'User-defined\x20trust\x20mechanism'},GENERAL_MACHINE_SHAPE=[{'name':'paid','role':'Entry:\x20order\x20created\x20and\x20paid'},{'name':'delivering','role':'Service\x20delivery\x20in\x20progress'},{'name':'delivered','role':'Deliverable\x20available\x20for\x20review'},{'name':'completed','role':'Service\x20completed,\x20funds\x20released'},{'name':'cancelled','role':'Pre-delivery\x20cancellation\x20—\x20triggers\x20refund\x20Allocator'}],GENERAL_ALLOCATOR={'recipient':'signer','count':0x1,'mode':'surplus','description':'Default:\x20surplus\x20to\x20service\x20owner\x20(general\x20fallback)'},RETAIL_MACHINE_SHAPE=[{'name':'paid','role':'Entry:\x20order\x20paid\x20via\x20Service.buy();\x20Machine\x20starts\x20here'},{'name':'shipped','role':'Merchant\x20ships\x20goods,\x20records\x20shipping\x20WIP\x20(tracking\x20number)'},{'name':'delivered','role':'Goods\x20delivered\x20to\x20buyer'},{'name':'confirmed','role':'Buyer\x20confirms\x20receipt'},{'name':'completed','role':'Funds\x20released\x20to\x20merchant'},{'name':'returned','role':'Buyer\x20ships\x20goods\x20back\x20—\x20triggers\x20refund\x20Allocator\x20(R-M1-11\x20compliant)'},{'name':'cancelled','role':'Pre-ship\x20cancellation\x20—\x20triggers\x20refund\x20Allocator'}],RETAIL_GUARDS=[{'template_id':'buy_guard_inventory','host':'service','purpose':'Verify\x20inventory\x20and\x20buyer\x20address\x20on\x20purchase'},{'template_id':'ship_guard_wip','host':'machine','purpose':'Shipping\x20evidence\x20WIP\x20(logistics\x20tracking\x20number)'},{'template_id':'confirm_guard_signer','host':'machine','purpose':'Only\x20buyer\x20can\x20confirm\x20receipt'},{'template_id':'refund_guard_permission','host':'machine','purpose':'Return\x20&\x20refund\x20requires\x20merchant\x20permission\x20OR\x20arbiter'},{'template_id':'tpl_payment_exception_compensation','host':'machine','purpose':'Logistics\x20delay\x20exception\x20compensation\x20(§2.13)'}],RETAIL_ALLOCATOR={'recipient':'entity','count':0x2,'mode':'rate','description':'Platform\x2010%\x20+\x20Merchant\x2090%\x20(rate-based\x20split)'},RETAIL_KEY_RISK='Products\x20don\x27t\x20match\x20description\x20—\x20no\x20refund\x20path\x20for\x20returns',RETAIL_BUILD_NOTES=['Logistics\x20WIP\x20(tracking\x20number)\x20is\x20essential\x20—\x20shipping\x20evidence\x20protects\x20both\x20parties\x20in\x20return\x20disputes','confirm_gate\x20prevents\x20merchant\x20from\x20self-confirming\x20receipt','Refund\x20path\x20must\x20support\x20return-and-exchange\x20flow','Compensation\x20fund\x20covers\x20return/exchange\x20disputes'],RETAIL_D2C_MACHINE_SHAPE=[{'name':'ordered','role':'Entry:\x20order\x20created\x20(funds\x20escrowed\x20in\x20Allocation)'},{'name':'shipped','role':'Merchant\x20ships\x20goods'},{'name':'delivered','role':'Goods\x20delivered\x20to\x20buyer'},{'name':'completed','role':'Buyer\x20confirms\x20receipt\x20—\x20withdraw_guard\x20releases\x20funds'},{'name':'cancelled','role':'Pre-ship\x20cancellation\x20—\x20refund_guard\x20refunds\x20buyer'}],RETAIL_D2C_GUARDS=[{'template_id':'withdraw_guard_delivery','host':'service','purpose':'Release\x20funds\x20to\x20merchant\x20+\x20processor\x20on\x20order\x20completion\x20(delivery\x20confirmation)'},{'template_id':'refund_guard_cancellation','host':'service','purpose':'Refund\x20100%\x20to\x20buyer\x20on\x20order\x20cancellation'}],RETAIL_D2C_ALLOCATOR={'recipient':'entity','count':0x2,'mode':'rate','description':'Merchant\x2097%\x20+\x20Processor\x203%\x20(rate-based\x20split,\x20no\x20platform\x20commission)'},RETAIL_D2C_KEY_RISK='No\x20platform\x20arbitration\x20—\x20disputes\x20rely\x20on\x20optional\x20Arbitration\x20or\x20off-chain\x20chargeback',RETAIL_D2C_BUILD_NOTES=['Allocation\x20escrow\x20replaces\x20platform\x20custody\x20—\x20funds\x20locked\x20in\x20contract\x20until\x20Guard\x20releases','withdraw_guard\x20enforces\x20delivery\x20gate\x20—\x20merchant\x20must\x20reach\x20\x27completed\x27\x20state\x20to\x20receive\x20payment','refund_guard\x20ensures\x20100%\x20refund\x20on\x20cancellation\x20—\x20no\x20merchant\x20approval\x20needed','No\x20buy_guard\x20needed\x20—\x20D2C\x20doesn\x27t\x20gate\x20purchases\x20(open\x20storefront)','Arbitration\x20is\x20optional\x20—\x20add\x20when\x20dispute\x20volume\x20justifies\x20the\x20cost','Service\x20↔\x20Guard\x20circular\x20dependency:\x20create\x20Service\x20(unpublished)\x20→\x20create\x20Guards\x20→\x20update\x20Service\x20(publish)'],SUPPORTED_INDUSTRY_SET=new Set(['freelance','rental','education','travel','subscription','retail','retail_d2c']);function fetchTemplate(a){const b=a==='retail_d2c'?'retail':a,c=getIndustryTraits(b)??GENERAL_TRAITS,d=SUPPORTED_INDUSTRY_SET['has'](a),e=a==='retail_d2c'?'retail':a,f=d?getIndustryRiskChecks(e):[],g=d?getIndustryNeeds(e):[],h=getFlywheelForIndustry(b)??GENERAL_FLYWHEEL;let i,j,k,l,m;if(a==='retail')i=RETAIL_MACHINE_SHAPE,j=RETAIL_GUARDS,k=RETAIL_ALLOCATOR,l=RETAIL_KEY_RISK,m=RETAIL_BUILD_NOTES;else{if(a==='retail_d2c')i=RETAIL_D2C_MACHINE_SHAPE,j=RETAIL_D2C_GUARDS,k=RETAIL_D2C_ALLOCATOR,l=RETAIL_D2C_KEY_RISK,m=RETAIL_D2C_BUILD_NOTES;else{if(a==='general'){const n=getScenarioMode('general');i=GENERAL_MACHINE_SHAPE,j=[],k=GENERAL_ALLOCATOR,l=n?.['key_risk']??'No\x20safety\x20net\x20—\x20user\x20must\x20design\x20all\x20trust\x20mechanisms\x20manually',m=n?.['build_notes'];}else{const o=getScenarioMode(a);if(!o)throw new Error('[modes.ts]\x20No\x20scenario\x20mode\x20found\x20for\x20industry:\x20'+a);i=o['machine_shape'],j=o['guards'],k=o['allocator'],l=o['key_risk'],m=o['build_notes'];}}}return{'traits':c,'risk_checks':f,'needs':g,'flywheel':h,'machine_shape':i,'guards':j,'allocator':k,'key_risk':l,'build_notes':m};}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':!![],'wip_hash_algorithm':'sha256','acceptance_gate':!![]}},'expected_benefits':[{'metric':'Dispute\x20rate\x20reduction','expected_value':'40%','evidence':'WIP\x20hash\x20+\x20milestone\x20allocation\x20enforces\x20delivery\x20evidence'},{'metric':'Delivery\x20confirmation\x20efficiency','expected_value':'+50%','evidence':'acceptance\x20gate\x20automates\x20acceptance\x20workflow'},{'metric':'Provider\x20payment\x20assurance','expected_value':'100%','evidence':'Funds\x20auto-release\x20to\x20provider\x20after\x20accepted\x20node'}],'risk_appetite':'balanced','risk_constraints':{'require_arbitration':!![],'require_compensation_fund':![],'require_wip_evidence':!![],'other_constraints':['setting_locked_time\x20>=\x207d\x20to\x20lock\x20engagement-period\x20rules','ISSUE-P1-4:\x2048h\x20auto-accept\x20requires\x20off-chain\x20keeper\x20(WoWok\x20Guard\x20does\x20not\x20support\x20time-based\x20triggers).\x20Deploy\x20a\x20keeper\x20service\x20that\x20polls\x20Progress\x20objects\x20in\x20\x27delivered\x27\x20state\x20and\x20calls\x20adminUnhold\x20(permission\x20224)\x20after\x2048h\x20timeout.\x20See\x20keeper\x20template\x20in\x20docs.']},'applicable_conditions':{'business_scale':'small','min_daily_orders':0x1,'other_conditions':['Suitable\x20for\x20mid-to-long-term\x20project\x20delivery','Requires\x20milestone-based\x20phased\x20acceptance']},'similar_industries':['rental','education'],'novel_capabilities':['allocation.distribute_milestone'],'disabled_builtin_constraints':['require_compensation_fund']},{'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':!![],'deposit_deductible':!![]},'machine':{'wip_required':!![],'wip_stages':['handover_out','returned'],'inspection_gate':!![]}},'expected_benefits':[{'metric':'Deposit\x20dispute\x20rate','expected_value':'-60%','evidence':'pre-rental\x20WIP\x20mandatorily\x20records\x20item\x27s\x20original\x20state'},{'metric':'Damage\x20liability\x20accuracy','expected_value':'+70%','evidence':'pre/post\x20WIP\x20hash\x20comparison\x20eliminates\x20unfounded\x20deductions'},{'metric':'Trust\x20score','expected_value':'+25%','evidence':'compensation_fund\x20covers\x20damage\x20risk'}],'risk_appetite':'conservative','risk_constraints':{'require_arbitration':!![],'require_compensation_fund':!![],'require_wip_evidence':!![],'max_single_transaction':0x2710,'compensation_fund_coverage_ratio':0xa,'other_constraints':['Deposit\x20must\x20be\x20escrowed\x20(no\x20direct\x20transfer)','lock_duration\x20>=\x207d\x20to\x20prevent\x20arbitrary\x20merchant\x20withdrawal']},'applicable_conditions':{'business_scale':'small','min_daily_orders':0x1,'other_conditions':['Requires\x20physical\x20item\x20handover','Has\x20logistics\x20or\x20offline\x20delivery\x20leg']},'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':0x1,'mode':'amount','description':'1/N\x20of\x20tuition\x20released\x20per\x20session\x20attendance'},'session_threshold':!![]},'service':{'setting_locked_time':'120d','anti_runaway':!![]}},'expected_benefits':[{'metric':'Refund\x20dispute\x20rate','expected_value':'-50%','evidence':'per-session\x20release\x20distributes\x20tuition\x20by\x20class'},{'metric':'Institution\x20runaway\x20risk','expected_value':'eliminated','evidence':'Funds\x20release\x20per\x20session;\x20undelivered\x20portion\x20is\x20refundable'},{'metric':'Attendance\x20traceability','expected_value':'100%','evidence':'attendance_guard\x20signs\x20each\x20session'}],'risk_appetite':'conservative','risk_constraints':{'require_arbitration':!![],'require_compensation_fund':!![],'require_wip_evidence':![],'other_constraints':['setting_locked_time\x20covers\x20the\x20entire\x20term\x20(>=90d)','Long-cycle\x20projects\x20must\x20monitor\x20>90d\x20progress']},'applicable_conditions':{'business_scale':'medium','min_daily_orders':0x1,'other_conditions':['Long-cycle\x20delivery','Requires\x20per-session\x20acceptance','Regulatory\x20intensity:\x20medium']},'similar_industries':['freelance','subscription'],'novel_capabilities':['allocation.distribute_milestone'],'disabled_builtin_constraints':['require_wip_evidence']},{'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':0x3,'mode':'amount','description':'Deposit\x2020%\x20to\x20agency,\x20final\x2080%\x20to\x20agency,\x20then\x20agency-side\x20Allocation\x20splits\x20to\x20hotel/guide/driver\x20per\x20segment'},'multi_tier_waterfall':!![],'guard_chaining':!![]},'service':{'supply_chain_suborders':!![],'segment_guard_required':!![]}},'expected_benefits':[{'metric':'Fund\x20transparency','expected_value':'100%','evidence':'multi-tier\x20allocation\x20splits\x20per\x20segment\x20to\x20hotel/guide/driver'},{'metric':'Itinerary\x20change\x20disputes','expected_value':'-45%','evidence':'segment\x20WIP\x20accepts\x20each\x20leg'},{'metric':'Breach\x20compensation\x20assurance','expected_value':'+60%','evidence':'compensation_fund\x20covers\x20itinerary\x20breach'}],'risk_appetite':'balanced','risk_constraints':{'require_arbitration':!![],'require_compensation_fund':!![],'require_wip_evidence':!![],'other_constraints':['Multi-tier\x20allocation\x20requires\x20guard\x20chaining\x20validation','deposit\x2020%\x20+\x20final\x2080%\x20two-stage\x20payment']},'applicable_conditions':{'business_scale':'medium','min_daily_orders':0x1,'other_conditions':['Multi-segment\x20itinerary\x20combination','Requires\x20hotel/guide/driver\x20multi-party\x20allocation']},'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':!![],'user_confirmed_charge':!![],'cancel_anytime':!![],'next_period_effective':!![]},'service':{'creator_data_subscription':!![],'periodic_billing':!![]}},'expected_benefits':[{'metric':'Renewal\x20rate','expected_value':'+25%','evidence':'loyalty\x20reward\x20+\x20transparent\x20subscription\x20mechanism'},{'metric':'Cancellation\x20disputes','expected_value':'eliminated','evidence':'cancel\x20anytime\x20+\x20no\x20auto-renew\x20trap'},{'metric':'Creator\x20retention','expected_value':'+30%','evidence':'deliver_guard_wip\x20prevents\x20content\x20dropout'}],'risk_appetite':'aggressive','risk_constraints':{'require_arbitration':![],'require_compensation_fund':![],'require_wip_evidence':![],'compensation_fund_coverage_ratio':0x3,'other_constraints':['Forbid\x20dead-end\x20nodes\x20(prevent\x20lock-in)','charge_guard\x20requires\x20user\x20confirmation\x20each\x20period']},'applicable_conditions':{'business_scale':'small','min_daily_orders':0x5,'other_conditions':['Pure-digital\x20delivery','Periodic\x20content\x20or\x20SaaS\x20service']},'similar_industries':['freelance','education'],'novel_capabilities':[],'disabled_builtin_constraints':['require_arbitration','require_compensation_fund','require_wip_evidence']},{'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':!![],'wip_field':'tracking_number','confirm_gate':!![],'refund_requires_approval':!![]},'service':{'logistics_mode':'standard','first_order_discount':!![]}},'expected_benefits':[{'metric':'Return\x20dispute\x20rate','expected_value':'-35%','evidence':'logistics\x20WIP\x20+\x20refund\x20path\x20assurance'},{'metric':'Repurchase\x20rate','expected_value':'+20%','evidence':'spend\x20cashback\x20reward'},{'metric':'Product\x20authenticity\x20traceability','expected_value':'100%','evidence':'WIP\x20verifies\x20product/logistics\x20info'}],'risk_appetite':'conservative','risk_constraints':{'require_arbitration':!![],'require_compensation_fund':!![],'require_wip_evidence':![],'compensation_fund_coverage_ratio':0x5,'other_constraints':['refund_window\x20>=\x207d','confirm_gate:\x20only\x20buyer\x20can\x20confirm\x20receipt']},'applicable_conditions':{'business_scale':'medium','min_daily_orders':0xa,'other_conditions':['Has\x20logistics\x20shipping\x20leg','High-frequency\x20small-ticket\x20transactions']},'similar_industries':['rental','subscription'],'novel_capabilities':[],'disabled_builtin_constraints':['require_wip_evidence']},{'name':'retail_d2c','display_name':'Retail\x20D2C\x20(Direct-to-Consumer)','version':'v1','source':'builtin',...fetchTemplate('retail_d2c'),'capabilities_used':['permission.index_create','permission.role_assign','guard.validate_withdraw','guard.validate_refund','machine.node_topology','allocation.distribute','service.publish','progress.advance','contact.im_create'],'config_overrides':{'machine':{'wip_required':![],'confirm_gate':!![],'refund_requires_approval':![]},'service':{'logistics_mode':'merchant_managed','multi_recipient_allocation':!![]}},'expected_benefits':[{'metric':'Merchant\x20revenue\x20share','expected_value':'97%','evidence':'No\x20platform\x20commission\x20—\x20only\x203%\x20processing\x20fee'},{'metric':'Fund\x20safety','expected_value':'contract-grade','evidence':'Allocation\x20escrow\x20+\x20Guard\x20verification\x20replaces\x20platform\x20custody'},{'metric':'Delivery\x20reliability','expected_value':'high','evidence':'withdraw_guard\x20enforces\x20delivery\x20confirmation\x20before\x20payment'}],'risk_appetite':'balanced','risk_constraints':{'require_arbitration':![],'require_compensation_fund':![],'require_wip_evidence':![],'other_constraints':['Allocation\x20escrow\x20required\x20(withdraw_guard\x20+\x20refund_guard)','Service\x20↔\x20Guard\x20circular\x20dependency\x20requires\x203-step\x20creation\x20pattern']},'applicable_conditions':{'business_scale':'small','min_daily_orders':0x1,'other_conditions':['Independent\x20storefront\x20(no\x20marketplace)','Merchant-managed\x20logistics','Allocation\x20escrow\x20model']},'similar_industries':['retail','subscription'],'novel_capabilities':['Allocation\x20escrow\x20as\x20platform-custody\x20alternative','Multi-recipient\x20allocation\x20(merchant\x20+\x20processor)'],'disabled_builtin_constraints':['require_arbitration','require_compensation_fund','require_wip_evidence']},{'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':'Flexibility','expected_value':'100%','evidence':'User\x20customizes\x20all\x20trust\x20mechanism\x20parameters'},{'metric':'Degraded\x20safety','expected_value':'usable','evidence':'Can\x20fall\x20back\x20to\x20general\x20at\x20any\x20time'}],'risk_appetite':'balanced','risk_constraints':{'require_arbitration':![],'require_compensation_fund':![],'require_wip_evidence':![]},'applicable_conditions':{'business_scale':'small','other_conditions':['Fallback\x20degraded\x20mode','Hybrid\x20scenarios\x20not\x20covered\x20by\x20other\x20industries']},'similar_industries':[],'novel_capabilities':[],'disabled_builtin_constraints':['require_arbitration','require_compensation_fund','require_wip_evidence']}];

package/dist/extensions/registry.d.ts

@@ -15,6 +15,7 @@ export declare class IndustryModeRegistry {
     listModes(): IndustryMode[];
     resolveAlias(name: string): string;
     hasMode(name: string): boolean;
+    unregisterMode(name: string): boolean;
     evaluateMode(name: string, intent: string, context: ProjectContext): ModeEvaluation;
     evaluateMigration(sourceName: string, targetName: string): ModeMigrationEvaluation;
     registerUserMode(mode: UserDefinedMode, userId: string): Promise<boolean>;