@wowok/agent-mcp 2.7.0 → 2.7.2

package/dist/knowledge/service-templates.js

@@ -1,456 +1 @@
-export const SERVICE_TEMPLATES = [
-    {
-        id: "T-S-01",
-        name: "Retail e-commerce Service",
-        description: "Standard retail shop with multiple SKUs, WIP-verified products, owner-only allocation",
-        applicable_scenes: ["service_retail", "service_buy_guard"],
-        industry_tags: ["retail", "ecommerce", "digital_goods"],
-        params: [
-            { name: "owner_address", type: "address", description: "Service owner address (receives payments)", required: true },
-            { name: "permission_address", type: "address", description: "Permission object address (must be owned by owner)", required: true },
-            { name: "description", type: "string", description: "Shop description", required: true },
-            { name: "location", type: "string", description: "Shop URL (HTTPS or IPFS)", required: false, default: "" },
-            { name: "sales_items", type: "object", description: "Array of {name, price, stock, wip, wip_hash}", required: true },
-            { name: "buy_guard_address", type: "address", description: "Buyer eligibility Guard (null for public sale)", required: false, default: "" },
-        ],
-        body: (p) => {
-            const result = {
-                object: null,
-                description: p.description,
-                permission: p.permission_address,
-                location: p.location || undefined,
-                sales: { op: "add", sales: p.sales_items },
-                order_allocators: [
-                    {
-                        threshold: "0",
-                        sharing: [{ who: { Object: p.owner_address }, weight: 100 }],
-                    },
-                ],
-            };
-            if (p.buy_guard_address)
-                result.buy_guard = p.buy_guard_address;
-            return result;
-        },
-        notes: [
-            "WIP hash is MANDATORY for tamper protection — never leave empty if wip URL is set",
-            "Use buy_guard for pre-sale whitelist phase, then clear for public sale",
-            "Single-recipient allocation (owner 100%) — use T-S-08 for multi-party split",
-        ],
-        post_publish_considerations: [
-            "machine/arbitrations/order_allocators become immutable — verify before publish",
-            "Sales can still be added/removed/updated post-publish",
-            "buy_guard can be changed post-publish (unusual exception)",
-        ],
-    },
-    {
-        id: "T-S-02",
-        name: "Rental Service (deposit + use + return)",
-        description: "Equipment/asset rental with deposit guarantee, Machine workflow, and arbitration",
-        applicable_scenes: ["service_rental"],
-        industry_tags: ["rental", "equipment", "real_estate"],
-        params: [
-            { name: "owner_address", type: "address", description: "Service owner (rental company)", required: true },
-            { name: "permission_address", type: "address", description: "Permission object address", required: true },
-            { name: "description", type: "string", description: "Rental service description", required: true },
-            { name: "machine_address", type: "address", description: "Published Machine with Reserve→Pay→Pickup→Return→Refund nodes", required: true },
-            { name: "arbitration_address", type: "address", description: "Arbitration for deposit disputes", required: true },
-            { name: "rental_items", type: "object", description: "Array of {name, price, stock=1, wip, wip_hash}", required: true },
-            { name: "compensation_fund_balance", type: "string", description: "Initial deposit to compensation_fund (in base units)", required: false, default: "0" },
-        ],
-        body: (p) => ({
-            object: null,
-            description: p.description,
-            permission: p.permission_address,
-            machine: p.machine_address,
-            arbitrations: { op: "add", objects: [p.arbitration_address] },
-            sales: { op: "add", sales: p.rental_items },
-            order_allocators: [
-                {
-                    threshold: "0",
-                    sharing: [{ who: { Object: p.owner_address }, weight: 100 }],
-                },
-            ],
-            compensation_fund_add: p.compensation_fund_balance && p.compensation_fund_balance !== "0"
-                ? { balance: p.compensation_fund_balance }
-                : undefined,
-        }),
-        notes: [
-            "stock=1 per rental item (unique items) — once rented, stock becomes 0",
-            "Machine must define deposit/return/refund nodes for proper rental flow",
-            "compensation_fund holds deposit guarantees — separate from rental fee",
-            "Arbitration required if compensation_fund > 0 (F-S-19)",
-        ],
-        post_publish_considerations: [
-            "Machine binding is permanent — verify workflow before publish",
-            "Arbitration binding is permanent — choose reputable arbiters",
-            "Sales can be updated (add new rental items, remove deprecated ones)",
-        ],
-    },
-    {
-        id: "T-S-03",
-        name: "Subscription Service (tiered plans)",
-        description: "Recurring-access service with tiered plans (Free/Pro/Enterprise), discount coupons, loyalty rewards",
-        applicable_scenes: ["service_subscription"],
-        industry_tags: ["subscription", "saas", "membership"],
-        params: [
-            { name: "owner_address", type: "address", description: "Service owner", required: true },
-            { name: "permission_address", type: "address", description: "Permission object address", required: true },
-            { name: "description", type: "string", description: "Subscription service description", required: true },
-            { name: "tier_plans", type: "object", description: "Array of {name, price, stock=999999, wip, wip_hash} for each tier", required: true },
-            { name: "trial_discount_count", type: "number", description: "Number of trial discount coupons to issue", required: false, default: 0 },
-            { name: "reward_address", type: "address", description: "Loyalty Reward object address (optional)", required: false, default: "" },
-        ],
-        body: (p) => {
-            const result = {
-                object: null,
-                description: p.description,
-                permission: p.permission_address,
-                sales: { op: "add", sales: p.tier_plans },
-                order_allocators: [
-                    {
-                        threshold: "0",
-                        sharing: [{ who: { Object: p.owner_address }, weight: 100 }],
-                    },
-                ],
-            };
-            if (p.reward_address) {
-                result.rewards = { op: "add", objects: [p.reward_address] };
-            }
-            return result;
-        },
-        notes: [
-            "Subscription renewals are handled by repeat orders (no native recurring billing)",
-            "Use large stock values (e.g. 999999) since subscriptions are not inventory-limited",
-            "Trial discounts: issue via service::discount (312) post-publish",
-            "Loyalty rewards: bind via service::reward_add (318) — locked by setting_lock_duration",
-        ],
-        post_publish_considerations: [
-            "Tier prices can be updated via sales_set (existing subscribers unaffected)",
-            "Discount coupons can be issued/destroyed post-publish",
-            "Rewards can be added but removal locked by duration",
-        ],
-    },
-    {
-        id: "T-S-04",
-        name: "Workflow-bound Service (machine-driven delivery)",
-        description: "Service with multi-step delivery workflow (e.g. freelance, custom manufacturing, course)",
-        applicable_scenes: ["service_workflow", "service_rental"],
-        industry_tags: ["workflow", "freelance", "manufacturing", "education"],
-        params: [
-            { name: "owner_address", type: "address", description: "Service owner (provider)", required: true },
-            { name: "permission_address", type: "address", description: "Permission object address", required: true },
-            { name: "description", type: "string", description: "Service description", required: true },
-            { name: "machine_address", type: "address", description: "Published Machine with Pay→Confirm→Deliver→Sign-off nodes", required: true },
-            { name: "service_items", type: "object", description: "Array of {name, price, stock, wip, wip_hash}", required: true },
-            { name: "customer_required", type: "string[]", description: "Required info fields (e.g. ['name','project_brief'])", required: false, default: [] },
-        ],
-        body: (p) => ({
-            object: null,
-            description: p.description,
-            permission: p.permission_address,
-            machine: p.machine_address,
-            sales: { op: "add", sales: p.service_items },
-            customer_required: p.customer_required,
-            order_allocators: [
-                {
-                    threshold: "0",
-                    sharing: [{ who: { Object: p.owner_address }, weight: 100 }],
-                },
-            ],
-        }),
-        notes: [
-            "Machine MUST be published before binding (machine::publish)",
-            "Each order creates a Progress object tracking the workflow",
-            "Named operators can be assigned per Forward in the Machine",
-            "Service.bPaused does NOT affect already-created Progress (existing orders continue)",
-        ],
-        post_publish_considerations: [
-            "Machine binding is PERMANENT — cannot upgrade workflow post-publish",
-            "To change workflow: clone Service with new Machine, migrate customers via discounts",
-            "customer_required fields can be updated post-publish",
-        ],
-    },
-    {
-        id: "T-S-05",
-        name: "Arbitration-bound Service (dispute-ready)",
-        description: "Service with multiple Arbitration objects for different dispute scopes + compensation_fund",
-        applicable_scenes: ["service_arbitration", "service_arbitration_binding"],
-        industry_tags: ["arbitration", "dispute_resolution", "high_value"],
-        params: [
-            { name: "owner_address", type: "address", description: "Service owner", required: true },
-            { name: "permission_address", type: "address", description: "Permission object address", required: true },
-            { name: "description", type: "string", description: "Service description", required: true },
-            { name: "arbitration_addresses", type: "string[]", description: "1-3 Arbitration object addresses (different scopes)", required: true },
-            { name: "compensation_fund_balance", type: "string", description: "Initial compensation_fund deposit (base units)", required: true },
-            { name: "setting_lock_duration_ms", type: "number", description: "Initial setting_lock_duration in ms (default 30 days)", required: false, default: 2592000000 },
-            { name: "service_items", type: "object", description: "Array of {name, price, stock, wip, wip_hash}", required: true },
-        ],
-        body: (p) => ({
-            object: null,
-            description: p.description,
-            permission: p.permission_address,
-            arbitrations: { op: "add", objects: p.arbitration_addresses },
-            compensation_fund_add: { balance: p.compensation_fund_balance },
-            setting_lock_duration_add: p.setting_lock_duration_ms,
-            sales: { op: "add", sales: p.service_items },
-            order_allocators: [
-                {
-                    threshold: "0",
-                    sharing: [{ who: { Object: p.owner_address }, weight: 100 }],
-                },
-            ],
-        }),
-        notes: [
-            "Use 2-3 Arbitration objects: e.g. one for quality disputes, one for delivery disputes",
-            "compensation_fund > 0 REQUIRES arbitrations non-empty (F-S-19, E_ARBITRATION_NOT_SET_WITH_COMPENSATION_FUND)",
-            "compensation_fund coin type MUST match Service<T> type parameter",
-            "setting_lock_duration protects customers — only-increase mechanism",
-        ],
-        post_publish_considerations: [
-            "Arbitration bindings are PERMANENT — verify arb reputation before publish",
-            "compensation_fund_add (deposit) is always mutable post-publish",
-            "compensation_fund_withdraw requires bPaused=true + lock_duration expired",
-            "Cannot add new Arbitration post-publish — only pre-publish",
-        ],
-    },
-    {
-        id: "T-S-06",
-        name: "Compensation fund Service (embedded Balance<T>)",
-        description: "Service focused on compensation_fund management — emphasizes distinction from Treasury",
-        applicable_scenes: ["service_compensation_fund", "service_arbitration"],
-        industry_tags: ["finance", "escrow", "guarantee"],
-        params: [
-            { name: "owner_address", type: "address", description: "Service owner", required: true },
-            { name: "permission_address", type: "address", description: "Permission object address", required: true },
-            { name: "description", type: "string", description: "Service description", required: true },
-            { name: "arbitration_addresses", type: "string[]", description: "Arbitration objects (required when fund > 0)", required: true },
-            { name: "initial_deposit", type: "string", description: "Initial compensation_fund deposit (base units)", required: true },
-            { name: "lock_duration_ms", type: "number", description: "setting_lock_duration (ms)", required: false, default: 2592000000 },
-            { name: "service_items", type: "object", description: "Sales items", required: true },
-        ],
-        body: (p) => ({
-            object: null,
-            description: p.description,
-            permission: p.permission_address,
-            arbitrations: { op: "add", objects: p.arbitration_addresses },
-            compensation_fund_add: { balance: p.initial_deposit },
-            setting_lock_duration_add: p.lock_duration_ms,
-            sales: { op: "add", sales: p.service_items },
-            order_allocators: [
-                {
-                    threshold: "0",
-                    sharing: [{ who: { Object: p.owner_address }, weight: 100 }],
-                },
-            ],
-        }),
-        notes: [
-            "⚠️ compensation_fund is INTERNAL Balance<T> — distinct from Treasury (external)",
-            "Treasury is referenced via order_allocators.sharing.who=Entity (Treasury address)",
-            "compensation_fund is consumed by arbitration::compensation_claim (driven by arb result)",
-            "Owner can only withdraw via compensation_fund_withdraw (requires paused + lock expired)",
-        ],
-        post_publish_considerations: [
-            "Deposits (compensation_fund_add) always allowed",
-            "Withdrawals (compensation_fund_withdraw) require bPaused=true + lock_duration expired",
-            "Receive (compensation_fund_receive) locked by duration",
-            "setting_lock_duration only-increase — plan withdrawal timeline carefully",
-        ],
-    },
-    {
-        id: "T-S-07",
-        name: "Dynamic pricing Service (discount-driven)",
-        description: "Service with promotional discount coupons — supports rates (basis points, per 10000) and minus (direct deduction) types",
-        applicable_scenes: ["service_dynamic_pricing"],
-        industry_tags: ["retail", "marketing", "promotion"],
-        params: [
-            { name: "owner_address", type: "address", description: "Service owner", required: true },
-            { name: "permission_address", type: "address", description: "Permission object address", required: true },
-            { name: "description", type: "string", description: "Service description", required: true },
-            { name: "service_items", type: "object", description: "Array of {name, price, stock, wip, wip_hash}", required: true },
-            { name: "discount_specs", type: "object", description: "Array of {name, type, data, count, expire_at} for initial discounts", required: false, default: [] },
-        ],
-        body: (p) => ({
-            object: null,
-            description: p.description,
-            permission: p.permission_address,
-            sales: { op: "add", sales: p.service_items },
-            order_allocators: [
-                {
-                    threshold: "0",
-                    sharing: [{ who: { Object: p.owner_address }, weight: 100 }],
-                },
-            ],
-        }),
-        notes: [
-            "Discounts are issued POST-PUBLISH via service::discount (312) — not in create body",
-            "discount_type=0 rates (basis points, e.g. 1000=10%); 1=minus (direct deduction, base units)",
-            "MAX_DISCOUNT_COUNT_ONCE = 1000 per issue call",
-            "MAX_DISCOUNT_RECEIVER_ONCE = 1000 receivers per call",
-            "MAX_DISCOUNT_TOTAL_COUNT = 20000 total coupons per Service",
-            "discount_destroy is holder-only (no SERVICE_DISCOUNT permission needed)",
-        ],
-        post_publish_considerations: [
-            "Discount coupons can be issued/destroyed freely",
-            "Sales prices can be updated via sales_set (existing orders unaffected)",
-            "Track discount usage to avoid stockout of promotional items",
-        ],
-    },
-    {
-        id: "T-S-08",
-        name: "Multi-allocator Service (tiered fund distribution)",
-        description: "Service with multiple allocator tiers — first-match-wins distribution based on order value",
-        applicable_scenes: ["service_multi_allocator", "service_order_allocator", "service_reward"],
-        industry_tags: ["marketplace", "platform", "logistics"],
-        params: [
-            { name: "owner_address", type: "address", description: "Service owner (merchant)", required: true },
-            { name: "permission_address", type: "address", description: "Permission object address", required: true },
-            { name: "description", type: "string", description: "Service description", required: true },
-            { name: "platform_address", type: "address", description: "Platform fee recipient", required: true },
-            { name: "logistics_address", type: "address", description: "Logistics fee recipient (optional)", required: false, default: "" },
-            { name: "service_items", type: "object", description: "Array of {name, price, stock, wip, wip_hash}", required: true },
-            { name: "tier1_threshold", type: "string", description: "Small order threshold (base units, e.g. '0')", required: false, default: "0" },
-            { name: "tier2_threshold", type: "string", description: "Medium order threshold (base units)", required: false, default: "10000000000" },
-            { name: "tier3_threshold", type: "string", description: "Large order threshold (base units)", required: false, default: "100000000000" },
-        ],
-        body: (p) => {
-            const allocators = [
-                {
-                    threshold: p.tier1_threshold,
-                    sharing: [
-                        { who: { Object: p.owner_address }, weight: 90 },
-                        { who: { Object: p.platform_address }, weight: 10 },
-                    ],
-                },
-                {
-                    threshold: p.tier2_threshold,
-                    sharing: p.logistics_address
-                        ? [
-                            { who: { Object: p.owner_address }, weight: 80 },
-                            { who: { Object: p.platform_address }, weight: 10 },
-                            { who: { Object: p.logistics_address }, weight: 10 },
-                        ]
-                        : [
-                            { who: { Object: p.owner_address }, weight: 85 },
-                            { who: { Object: p.platform_address }, weight: 15 },
-                        ],
-                },
-                {
-                    threshold: p.tier3_threshold,
-                    sharing: p.logistics_address
-                        ? [
-                            { who: { Object: p.owner_address }, weight: 70 },
-                            { who: { Object: p.platform_address }, weight: 10 },
-                            { who: { Object: p.logistics_address }, weight: 20 },
-                        ]
-                        : [
-                            { who: { Object: p.owner_address }, weight: 80 },
-                            { who: { Object: p.platform_address }, weight: 20 },
-                        ],
-                },
-            ];
-            return {
-                object: null,
-                description: p.description,
-                permission: p.permission_address,
-                sales: { op: "add", sales: p.service_items },
-                order_allocators: allocators,
-            };
-        },
-        notes: [
-            "First-match-wins: first allocator whose threshold <= order value handles distribution",
-            "Each tier can have its own Guard for execution authorization (optional)",
-            "Thresholds must be ascending (tier1 < tier2 < tier3)",
-            "MAX_SHARING_COUNT = 100 per allocator (sum of sharing entries)",
-            "Treasury addresses can be referenced via sharing.who=Entity (Treasury object)",
-        ],
-        post_publish_considerations: [
-            "⚠️ order_allocators is IMMUTABLE post-publish (F-S-22) — verify tiers before publish",
-            "To change fee split: clone Service with new allocators (cannot migrate existing Orders)",
-            "Sales can still be updated post-publish (only allocator is locked)",
-        ],
-    },
-    {
-        id: "T-S-09",
-        name: "Supply Chain Sub-order Service (milestone unlock via buy_guard)",
-        description: "Sub-service whose buy_guard verifies the user purchased the main service order. Each milestone = one sub-order. Enables supply chain composition: main service → multiple sub-services with conditional access.",
-        applicable_scenes: ["service_buy_guard"],
-        industry_tags: ["travel", "rental", "education", "freelance", "ecommerce", "supply_chain"],
-        params: [
-            { name: "owner_address", type: "address", description: "Sub-service owner address", required: true },
-            { name: "permission_address", type: "address", description: "Permission object address", required: true },
-            { name: "description", type: "string", description: "Sub-service description (e.g., 'Hotel booking for tour package X')", required: true },
-            { name: "main_service_address", type: "address", description: "Main Service object address (the parent service)", required: true },
-            { name: "buy_guard_address", type: "address", description: "Guard address verifying main order ownership (order.owner==Signer AND order.service==main_service)", required: true },
-            { name: "price", type: "number", description: "Sub-service price", required: true },
-            { name: "machine_address", type: "address", description: "Machine object for sub-order workflow", required: true },
-        ],
-        body: (p) => ({
-            object: null,
-            description: p.description,
-            service_type: "supply_chain_sub",
-            buy_guard: p.buy_guard_address,
-            price: p.price,
-            machine: p.machine_address,
-            permission: p.permission_address,
-        }),
-        notes: [
-            "VERIFIED: service.move#L173 (buy_guard: Option<address>), L263-268 (buy_with_passport evaluates buy_guard)",
-            "VERIFIER-EVIDENCE DESIGN: user submits main Order as evidence (b_submission=true), buy_guard verifies order.owner==Signer AND order.service==main_service_address",
-            "No parent_order field needed — relationship verified via buy_guard querying submitted Order fields",
-            "Each milestone = one sub-order with its own Service + buy_guard + Machine",
-            "Main flow Machine can branch to different sub-services based on node progression",
-            "Use tpl_buy_guard_order_holder (guard-templates.ts) for the buy_guard design",
-        ],
-        post_publish_considerations: [
-            "buy_guard is mutable post-publish (can update the guard address)",
-            "If main service is unpublished, sub-service buy_guard will fail (order.service won't match)",
-            "Consider publishing main service before sub-services",
-        ],
-    },
-];
-export const SERVICE_TEMPLATES_VERSION = "1.0.0";
-export function getAllServiceTemplates() {
-    return [...SERVICE_TEMPLATES];
-}
-export function getServiceTemplateById(id) {
-    return SERVICE_TEMPLATES.find(t => t.id === id);
-}
-export function getServiceTemplatesByScene(sceneId) {
-    return SERVICE_TEMPLATES.filter(t => t.applicable_scenes.includes(sceneId));
-}
-export function getServiceTemplatesByIndustry(industry) {
-    return SERVICE_TEMPLATES.filter(t => t.industry_tags.includes(industry) || t.industry_tags.includes("universal"));
-}
-export function suggestServiceTemplateForScene(sceneId) {
-    const matches = getServiceTemplatesByScene(sceneId);
-    return matches.length > 0 ? matches[0] : undefined;
-}
-export function listServiceTemplates() {
-    return SERVICE_TEMPLATES.map(t => ({
-        id: t.id,
-        name: t.name,
-        description: t.description,
-        scenes: t.applicable_scenes,
-    }));
-}
-export function fillServiceTemplate(templateId, params) {
-    const tpl = getServiceTemplateById(templateId);
-    if (!tpl)
-        return { ok: false, error: `Template ${templateId} not found` };
-    const missing = [];
-    for (const p of tpl.params) {
-        if (p.required && !(p.name in params)) {
-            missing.push(p.name);
-        }
-    }
-    if (missing.length > 0) {
-        return { ok: false, error: `Missing required params: ${missing.join(", ")}`, missing_required: missing };
-    }
-    const filled = { ...params };
-    for (const p of tpl.params) {
-        if (!(p.name in filled) && p.default !== undefined) {
-            filled[p.name] = p.default;
-        }
-    }
-    return { ok: true, body: tpl.body(filled) };
-}
+export const SERVICE_TEMPLATES=[{'id':'T-S-01','name':'Retail\x20e-commerce\x20Service','description':'Standard\x20retail\x20shop\x20with\x20multiple\x20SKUs,\x20WIP-verified\x20products,\x20owner-only\x20allocation','applicable_scenes':['service_retail','service_buy_guard'],'industry_tags':['retail','ecommerce','digital_goods'],'params':[{'name':'owner_address','type':'address','description':'Service\x20owner\x20address\x20(receives\x20payments)','required':!![]},{'name':'permission_address','type':'address','description':'Permission\x20object\x20address\x20(must\x20be\x20owned\x20by\x20owner)','required':!![]},{'name':'description','type':'string','description':'Shop\x20description','required':!![]},{'name':'location','type':'string','description':'Service\x20geographic\x20location\x20(city/region)','required':![],'default':''},{'name':'sales_items','type':'object','description':'Array\x20of\x20{name,\x20price,\x20stock,\x20wip,\x20wip_hash}','required':!![]},{'name':'buy_guard_address','type':'address','description':'Buyer\x20eligibility\x20Guard\x20(null\x20for\x20public\x20sale)','required':![],'default':''}],'body':a=>{const b={'object':null,'description':a['description'],'permission':a['permission_address'],'location':a['location']||undefined,'sales':{'op':'add','sales':a['sales_items']},'order_allocators':[{'threshold':'0','sharing':[{'who':{'Object':a['owner_address']},'weight':0x64}]}]};if(a['buy_guard_address'])b['buy_guard']=a['buy_guard_address'];return b;},'notes':['WIP\x20hash\x20is\x20MANDATORY\x20for\x20tamper\x20protection\x20—\x20never\x20leave\x20empty\x20if\x20wip\x20URL\x20is\x20set','Use\x20buy_guard\x20for\x20pre-sale\x20whitelist\x20phase,\x20then\x20clear\x20for\x20public\x20sale','Single-recipient\x20allocation\x20(owner\x20100%)\x20—\x20use\x20T-S-08\x20for\x20multi-party\x20split'],'post_publish_considerations':['machine/arbitrations/order_allocators\x20become\x20immutable\x20—\x20verify\x20before\x20publish','Sales\x20can\x20still\x20be\x20added/removed/updated\x20post-publish','buy_guard\x20can\x20be\x20changed\x20post-publish\x20(unusual\x20exception)']},{'id':'T-S-02','name':'Rental\x20Service\x20(deposit\x20+\x20use\x20+\x20return)','description':'Equipment/asset\x20rental\x20with\x20deposit\x20guarantee,\x20Machine\x20workflow,\x20and\x20arbitration','applicable_scenes':['service_rental'],'industry_tags':['rental','equipment','real_estate'],'params':[{'name':'owner_address','type':'address','description':'Service\x20owner\x20(rental\x20company)','required':!![]},{'name':'permission_address','type':'address','description':'Permission\x20object\x20address','required':!![]},{'name':'description','type':'string','description':'Rental\x20service\x20description','required':!![]},{'name':'machine_address','type':'address','description':'Published\x20Machine\x20with\x20Reserve→Pay→Pickup→Return→Refund\x20nodes','required':!![]},{'name':'arbitration_address','type':'address','description':'Arbitration\x20for\x20deposit\x20disputes','required':!![]},{'name':'rental_items','type':'object','description':'Array\x20of\x20{name,\x20price,\x20stock=1,\x20wip,\x20wip_hash}','required':!![]},{'name':'compensation_fund_balance','type':'string','description':'Initial\x20deposit\x20to\x20compensation_fund\x20(in\x20base\x20units)','required':![],'default':'0'}],'body':a=>({'object':null,'description':a['description'],'permission':a['permission_address'],'machine':a['machine_address'],'arbitrations':{'op':'add','objects':[a['arbitration_address']]},'sales':{'op':'add','sales':a['rental_items']},'order_allocators':[{'threshold':'0','sharing':[{'who':{'Object':a['owner_address']},'weight':0x64}]}],'compensation_fund_add':a['compensation_fund_balance']&&a['compensation_fund_balance']!=='0'?{'balance':a['compensation_fund_balance']}:undefined}),'notes':['stock=1\x20per\x20rental\x20item\x20(unique\x20items)\x20—\x20once\x20rented,\x20stock\x20becomes\x200','Machine\x20must\x20define\x20deposit/return/refund\x20nodes\x20for\x20proper\x20rental\x20flow','compensation_fund\x20holds\x20deposit\x20guarantees\x20—\x20separate\x20from\x20rental\x20fee','Arbitration\x20required\x20if\x20compensation_fund\x20>\x200\x20(F-S-19)'],'post_publish_considerations':['Machine\x20binding\x20is\x20permanent\x20—\x20verify\x20workflow\x20before\x20publish','Arbitration\x20binding\x20is\x20permanent\x20—\x20choose\x20reputable\x20arbiters','Sales\x20can\x20be\x20updated\x20(add\x20new\x20rental\x20items,\x20remove\x20deprecated\x20ones)']},{'id':'T-S-03','name':'Subscription\x20Service\x20(tiered\x20plans)','description':'Recurring-access\x20service\x20with\x20tiered\x20plans\x20(Free/Pro/Enterprise),\x20discount\x20coupons,\x20loyalty\x20rewards','applicable_scenes':['service_subscription'],'industry_tags':['subscription','saas','membership'],'params':[{'name':'owner_address','type':'address','description':'Service\x20owner','required':!![]},{'name':'permission_address','type':'address','description':'Permission\x20object\x20address','required':!![]},{'name':'description','type':'string','description':'Subscription\x20service\x20description','required':!![]},{'name':'tier_plans','type':'object','description':'Array\x20of\x20{name,\x20price,\x20stock=999999,\x20wip,\x20wip_hash}\x20for\x20each\x20tier','required':!![]},{'name':'trial_discount_count','type':'number','description':'Number\x20of\x20trial\x20discount\x20coupons\x20to\x20issue','required':![],'default':0x0},{'name':'reward_address','type':'address','description':'Loyalty\x20Reward\x20object\x20address\x20(optional)','required':![],'default':''}],'body':a=>{const b={'object':null,'description':a['description'],'permission':a['permission_address'],'sales':{'op':'add','sales':a['tier_plans']},'order_allocators':[{'threshold':'0','sharing':[{'who':{'Object':a['owner_address']},'weight':0x64}]}]};return a['reward_address']&&(b['rewards']={'op':'add','objects':[a['reward_address']]}),b;},'notes':['Subscription\x20renewals\x20are\x20handled\x20by\x20repeat\x20orders\x20(no\x20native\x20recurring\x20billing)','Use\x20large\x20stock\x20values\x20(e.g.\x20999999)\x20since\x20subscriptions\x20are\x20not\x20inventory-limited','Trial\x20discounts:\x20issue\x20via\x20service::discount\x20(312)\x20post-publish','Loyalty\x20rewards:\x20bind\x20via\x20service::reward_add\x20(318)\x20—\x20locked\x20by\x20setting_lock_duration'],'post_publish_considerations':['Tier\x20prices\x20can\x20be\x20updated\x20via\x20sales_set\x20(existing\x20subscribers\x20unaffected)','Discount\x20coupons\x20can\x20be\x20issued/destroyed\x20post-publish','Rewards\x20can\x20be\x20added\x20but\x20removal\x20locked\x20by\x20duration']},{'id':'T-S-04','name':'Workflow-bound\x20Service\x20(machine-driven\x20delivery)','description':'Service\x20with\x20multi-step\x20delivery\x20workflow\x20(e.g.\x20freelance,\x20custom\x20manufacturing,\x20course)','applicable_scenes':['service_workflow','service_rental'],'industry_tags':['workflow','freelance','manufacturing','education'],'params':[{'name':'owner_address','type':'address','description':'Service\x20owner\x20(provider)','required':!![]},{'name':'permission_address','type':'address','description':'Permission\x20object\x20address','required':!![]},{'name':'description','type':'string','description':'Service\x20description','required':!![]},{'name':'machine_address','type':'address','description':'Published\x20Machine\x20with\x20Pay→Confirm→Deliver→Sign-off\x20nodes','required':!![]},{'name':'service_items','type':'object','description':'Array\x20of\x20{name,\x20price,\x20stock,\x20wip,\x20wip_hash}','required':!![]},{'name':'customer_required','type':'string[]','description':'Required\x20info\x20fields\x20(e.g.\x20[\x27name\x27,\x27project_brief\x27])','required':![],'default':[]}],'body':a=>({'object':null,'description':a['description'],'permission':a['permission_address'],'machine':a['machine_address'],'sales':{'op':'add','sales':a['service_items']},'customer_required':a['customer_required'],'order_allocators':[{'threshold':'0','sharing':[{'who':{'Object':a['owner_address']},'weight':0x64}]}]}),'notes':['Machine\x20MUST\x20be\x20published\x20before\x20binding\x20(machine::publish)','Each\x20order\x20creates\x20a\x20Progress\x20object\x20tracking\x20the\x20workflow','Named\x20operators\x20can\x20be\x20assigned\x20per\x20Forward\x20in\x20the\x20Machine','Service.bPaused\x20does\x20NOT\x20affect\x20already-created\x20Progress\x20(existing\x20orders\x20continue)'],'post_publish_considerations':['Machine\x20binding\x20is\x20PERMANENT\x20—\x20cannot\x20upgrade\x20workflow\x20post-publish','To\x20change\x20workflow:\x20clone\x20Service\x20with\x20new\x20Machine,\x20migrate\x20customers\x20via\x20discounts','customer_required\x20fields\x20can\x20be\x20updated\x20post-publish']},{'id':'T-S-05','name':'Arbitration-bound\x20Service\x20(dispute-ready)','description':'Service\x20with\x20multiple\x20Arbitration\x20objects\x20for\x20different\x20dispute\x20scopes\x20+\x20compensation_fund','applicable_scenes':['service_arbitration','service_arbitration_binding'],'industry_tags':['arbitration','dispute_resolution','high_value'],'params':[{'name':'owner_address','type':'address','description':'Service\x20owner','required':!![]},{'name':'permission_address','type':'address','description':'Permission\x20object\x20address','required':!![]},{'name':'description','type':'string','description':'Service\x20description','required':!![]},{'name':'arbitration_addresses','type':'string[]','description':'1-3\x20Arbitration\x20object\x20addresses\x20(different\x20scopes)','required':!![]},{'name':'compensation_fund_balance','type':'string','description':'Initial\x20compensation_fund\x20deposit\x20(base\x20units)','required':!![]},{'name':'setting_lock_duration_ms','type':'number','description':'Initial\x20setting_lock_duration\x20in\x20ms\x20(default\x2030\x20days)','required':![],'default':0x9a7ec800},{'name':'service_items','type':'object','description':'Array\x20of\x20{name,\x20price,\x20stock,\x20wip,\x20wip_hash}','required':!![]}],'body':a=>({'object':null,'description':a['description'],'permission':a['permission_address'],'arbitrations':{'op':'add','objects':a['arbitration_addresses']},'compensation_fund_add':{'balance':a['compensation_fund_balance']},'setting_lock_duration_add':a['setting_lock_duration_ms'],'sales':{'op':'add','sales':a['service_items']},'order_allocators':[{'threshold':'0','sharing':[{'who':{'Object':a['owner_address']},'weight':0x64}]}]}),'notes':['Use\x202-3\x20Arbitration\x20objects:\x20e.g.\x20one\x20for\x20quality\x20disputes,\x20one\x20for\x20delivery\x20disputes','compensation_fund\x20>\x200\x20REQUIRES\x20arbitrations\x20non-empty\x20(F-S-19,\x20E_ARBITRATION_NOT_SET_WITH_COMPENSATION_FUND)','compensation_fund\x20coin\x20type\x20MUST\x20match\x20Service<T>\x20type\x20parameter','setting_lock_duration\x20protects\x20customers\x20—\x20only-increase\x20mechanism'],'post_publish_considerations':['Arbitration\x20bindings\x20are\x20PERMANENT\x20—\x20verify\x20arb\x20reputation\x20before\x20publish','compensation_fund_add\x20(deposit)\x20is\x20always\x20mutable\x20post-publish','compensation_fund_withdraw\x20requires\x20bPaused=true\x20+\x20lock_duration\x20expired','Cannot\x20add\x20new\x20Arbitration\x20post-publish\x20—\x20only\x20pre-publish']},{'id':'T-S-06','name':'Compensation\x20fund\x20Service\x20(embedded\x20Balance<T>)','description':'Service\x20focused\x20on\x20compensation_fund\x20management\x20—\x20emphasizes\x20distinction\x20from\x20Treasury','applicable_scenes':['service_compensation_fund','service_arbitration'],'industry_tags':['finance','escrow','guarantee'],'params':[{'name':'owner_address','type':'address','description':'Service\x20owner','required':!![]},{'name':'permission_address','type':'address','description':'Permission\x20object\x20address','required':!![]},{'name':'description','type':'string','description':'Service\x20description','required':!![]},{'name':'arbitration_addresses','type':'string[]','description':'Arbitration\x20objects\x20(required\x20when\x20fund\x20>\x200)','required':!![]},{'name':'initial_deposit','type':'string','description':'Initial\x20compensation_fund\x20deposit\x20(base\x20units)','required':!![]},{'name':'lock_duration_ms','type':'number','description':'setting_lock_duration\x20(ms)','required':![],'default':0x9a7ec800},{'name':'service_items','type':'object','description':'Sales\x20items','required':!![]}],'body':a=>({'object':null,'description':a['description'],'permission':a['permission_address'],'arbitrations':{'op':'add','objects':a['arbitration_addresses']},'compensation_fund_add':{'balance':a['initial_deposit']},'setting_lock_duration_add':a['lock_duration_ms'],'sales':{'op':'add','sales':a['service_items']},'order_allocators':[{'threshold':'0','sharing':[{'who':{'Object':a['owner_address']},'weight':0x64}]}]}),'notes':['⚠️\x20compensation_fund\x20is\x20INTERNAL\x20Balance<T>\x20—\x20distinct\x20from\x20Treasury\x20(external)','Treasury\x20is\x20referenced\x20via\x20order_allocators.sharing.who=Entity\x20(Treasury\x20address)','compensation_fund\x20is\x20consumed\x20by\x20arbitration::compensation_claim\x20(driven\x20by\x20arb\x20result)','Owner\x20can\x20only\x20withdraw\x20via\x20compensation_fund_withdraw\x20(requires\x20paused\x20+\x20lock\x20expired)'],'post_publish_considerations':['Deposits\x20(compensation_fund_add)\x20always\x20allowed','Withdrawals\x20(compensation_fund_withdraw)\x20require\x20bPaused=true\x20+\x20lock_duration\x20expired','Receive\x20(compensation_fund_receive)\x20locked\x20by\x20duration','setting_lock_duration\x20only-increase\x20—\x20plan\x20withdrawal\x20timeline\x20carefully']},{'id':'T-S-07','name':'Dynamic\x20pricing\x20Service\x20(discount-driven)','description':'Service\x20with\x20promotional\x20discount\x20coupons\x20—\x20supports\x20rates\x20(basis\x20points,\x20per\x2010000)\x20and\x20minus\x20(direct\x20deduction)\x20types','applicable_scenes':['service_dynamic_pricing'],'industry_tags':['retail','marketing','promotion'],'params':[{'name':'owner_address','type':'address','description':'Service\x20owner','required':!![]},{'name':'permission_address','type':'address','description':'Permission\x20object\x20address','required':!![]},{'name':'description','type':'string','description':'Service\x20description','required':!![]},{'name':'service_items','type':'object','description':'Array\x20of\x20{name,\x20price,\x20stock,\x20wip,\x20wip_hash}','required':!![]},{'name':'discount_specs','type':'object','description':'Array\x20of\x20{name,\x20type,\x20data,\x20count,\x20expire_at}\x20for\x20initial\x20discounts','required':![],'default':[]}],'body':a=>({'object':null,'description':a['description'],'permission':a['permission_address'],'sales':{'op':'add','sales':a['service_items']},'order_allocators':[{'threshold':'0','sharing':[{'who':{'Object':a['owner_address']},'weight':0x64}]}]}),'notes':['Discounts\x20are\x20issued\x20POST-PUBLISH\x20via\x20service::discount\x20(312)\x20—\x20not\x20in\x20create\x20body','discount_type=0\x20rates\x20(basis\x20points,\x20e.g.\x201000=10%);\x201=minus\x20(direct\x20deduction,\x20base\x20units)','MAX_DISCOUNT_COUNT_ONCE\x20=\x201000\x20per\x20issue\x20call','MAX_DISCOUNT_RECEIVER_ONCE\x20=\x201000\x20receivers\x20per\x20call','MAX_DISCOUNT_TOTAL_COUNT\x20=\x2020000\x20total\x20coupons\x20per\x20Service','discount_destroy\x20is\x20holder-only\x20(no\x20SERVICE_DISCOUNT\x20permission\x20needed)'],'post_publish_considerations':['Discount\x20coupons\x20can\x20be\x20issued/destroyed\x20freely','Sales\x20prices\x20can\x20be\x20updated\x20via\x20sales_set\x20(existing\x20orders\x20unaffected)','Track\x20discount\x20usage\x20to\x20avoid\x20stockout\x20of\x20promotional\x20items']},{'id':'T-S-08','name':'Multi-allocator\x20Service\x20(tiered\x20fund\x20distribution)','description':'Service\x20with\x20multiple\x20allocator\x20tiers\x20—\x20first-match-wins\x20distribution\x20based\x20on\x20order\x20value','applicable_scenes':['service_multi_allocator','service_order_allocator','service_reward'],'industry_tags':['marketplace','platform','logistics'],'params':[{'name':'owner_address','type':'address','description':'Service\x20owner\x20(merchant)','required':!![]},{'name':'permission_address','type':'address','description':'Permission\x20object\x20address','required':!![]},{'name':'description','type':'string','description':'Service\x20description','required':!![]},{'name':'platform_address','type':'address','description':'Platform\x20fee\x20recipient','required':!![]},{'name':'logistics_address','type':'address','description':'Logistics\x20fee\x20recipient\x20(optional)','required':![],'default':''},{'name':'service_items','type':'object','description':'Array\x20of\x20{name,\x20price,\x20stock,\x20wip,\x20wip_hash}','required':!![]},{'name':'tier1_threshold','type':'string','description':'Small\x20order\x20threshold\x20(base\x20units,\x20e.g.\x20\x270\x27)','required':![],'default':'0'},{'name':'tier2_threshold','type':'string','description':'Medium\x20order\x20threshold\x20(base\x20units)','required':![],'default':'10000000000'},{'name':'tier3_threshold','type':'string','description':'Large\x20order\x20threshold\x20(base\x20units)','required':![],'default':'100000000000'}],'body':a=>{const b=[{'threshold':a['tier1_threshold'],'sharing':[{'who':{'Object':a['owner_address']},'weight':0x5a},{'who':{'Object':a['platform_address']},'weight':0xa}]},{'threshold':a['tier2_threshold'],'sharing':a['logistics_address']?[{'who':{'Object':a['owner_address']},'weight':0x50},{'who':{'Object':a['platform_address']},'weight':0xa},{'who':{'Object':a['logistics_address']},'weight':0xa}]:[{'who':{'Object':a['owner_address']},'weight':0x55},{'who':{'Object':a['platform_address']},'weight':0xf}]},{'threshold':a['tier3_threshold'],'sharing':a['logistics_address']?[{'who':{'Object':a['owner_address']},'weight':0x46},{'who':{'Object':a['platform_address']},'weight':0xa},{'who':{'Object':a['logistics_address']},'weight':0x14}]:[{'who':{'Object':a['owner_address']},'weight':0x50},{'who':{'Object':a['platform_address']},'weight':0x14}]}];return{'object':null,'description':a['description'],'permission':a['permission_address'],'sales':{'op':'add','sales':a['service_items']},'order_allocators':b};},'notes':['First-match-wins:\x20first\x20allocator\x20whose\x20threshold\x20<=\x20order\x20value\x20handles\x20distribution','Each\x20tier\x20can\x20have\x20its\x20own\x20Guard\x20for\x20execution\x20authorization\x20(optional)','Thresholds\x20must\x20be\x20ascending\x20(tier1\x20<\x20tier2\x20<\x20tier3)','MAX_SHARING_COUNT\x20=\x20100\x20per\x20allocator\x20(sum\x20of\x20sharing\x20entries)','Treasury\x20addresses\x20can\x20be\x20referenced\x20via\x20sharing.who=Entity\x20(Treasury\x20object)'],'post_publish_considerations':['⚠️\x20order_allocators\x20is\x20IMMUTABLE\x20post-publish\x20(F-S-22)\x20—\x20verify\x20tiers\x20before\x20publish','To\x20change\x20fee\x20split:\x20clone\x20Service\x20with\x20new\x20allocators\x20(cannot\x20migrate\x20existing\x20Orders)','Sales\x20can\x20still\x20be\x20updated\x20post-publish\x20(only\x20allocator\x20is\x20locked)']},{'id':'T-S-09','name':'Supply\x20Chain\x20Sub-order\x20Service\x20(milestone\x20unlock\x20via\x20buy_guard)','description':'Sub-service\x20whose\x20buy_guard\x20verifies\x20the\x20user\x20purchased\x20the\x20main\x20service\x20order.\x20Each\x20milestone\x20=\x20one\x20sub-order.\x20Enables\x20supply\x20chain\x20composition:\x20main\x20service\x20→\x20multiple\x20sub-services\x20with\x20conditional\x20access.','applicable_scenes':['service_buy_guard'],'industry_tags':['travel','rental','education','freelance','ecommerce','supply_chain'],'params':[{'name':'owner_address','type':'address','description':'Sub-service\x20owner\x20address','required':!![]},{'name':'permission_address','type':'address','description':'Permission\x20object\x20address','required':!![]},{'name':'description','type':'string','description':'Sub-service\x20description\x20(e.g.,\x20\x27Hotel\x20booking\x20for\x20tour\x20package\x20X\x27)','required':!![]},{'name':'main_service_address','type':'address','description':'Main\x20Service\x20object\x20address\x20(the\x20parent\x20service)','required':!![]},{'name':'buy_guard_address','type':'address','description':'Guard\x20address\x20verifying\x20main\x20order\x20ownership\x20(order.owner==Signer\x20AND\x20order.service==main_service)','required':!![]},{'name':'price','type':'number','description':'Sub-service\x20price','required':!![]},{'name':'machine_address','type':'address','description':'Machine\x20object\x20for\x20sub-order\x20workflow','required':!![]}],'body':a=>({'object':null,'description':a['description'],'service_type':'supply_chain_sub','buy_guard':a['buy_guard_address'],'price':a['price'],'machine':a['machine_address'],'permission':a['permission_address']}),'notes':['VERIFIED:\x20service.move#L173\x20(buy_guard:\x20Option<address>),\x20L263-268\x20(buy_with_passport\x20evaluates\x20buy_guard)','VERIFIER-EVIDENCE\x20DESIGN:\x20user\x20submits\x20main\x20Order\x20as\x20evidence\x20(b_submission=true),\x20buy_guard\x20verifies\x20order.owner==Signer\x20AND\x20order.service==main_service_address','No\x20parent_order\x20field\x20needed\x20—\x20relationship\x20verified\x20via\x20buy_guard\x20querying\x20submitted\x20Order\x20fields','Each\x20milestone\x20=\x20one\x20sub-order\x20with\x20its\x20own\x20Service\x20+\x20buy_guard\x20+\x20Machine','Main\x20flow\x20Machine\x20can\x20branch\x20to\x20different\x20sub-services\x20based\x20on\x20node\x20progression','Use\x20tpl_buy_guard_order_holder\x20(guard-templates.ts)\x20for\x20the\x20buy_guard\x20design'],'post_publish_considerations':['buy_guard\x20is\x20mutable\x20post-publish\x20(can\x20update\x20the\x20guard\x20address)','If\x20main\x20service\x20is\x20unpublished,\x20sub-service\x20buy_guard\x20will\x20fail\x20(order.service\x20won\x27t\x20match)','Consider\x20publishing\x20main\x20service\x20before\x20sub-services']}];export const SERVICE_TEMPLATES_VERSION='1.0.0';export function getAllServiceTemplates(){return[...SERVICE_TEMPLATES];}export function getServiceTemplateById(a){return SERVICE_TEMPLATES['find'](b=>b['id']===a);}export function getServiceTemplatesByScene(a){return SERVICE_TEMPLATES['filter'](b=>b['applicable_scenes']['includes'](a));}export function getServiceTemplatesByIndustry(a){return SERVICE_TEMPLATES['filter'](b=>b['industry_tags']['includes'](a)||b['industry_tags']['includes']('universal'));}export function suggestServiceTemplateForScene(a){const b=getServiceTemplatesByScene(a);return b['length']>0x0?b[0x0]:undefined;}export function listServiceTemplates(){return SERVICE_TEMPLATES['map'](a=>({'id':a['id'],'name':a['name'],'description':a['description'],'scenes':a['applicable_scenes']}));}export function fillServiceTemplate(a,b){const c=getServiceTemplateById(a);if(!c)return{'ok':![],'error':'Template\x20'+a+'\x20not\x20found'};const d=[];for(const f of c['params']){f['required']&&!(f['name']in b)&&d['push'](f['name']);}if(d['length']>0x0)return{'ok':![],'error':'Missing\x20required\x20params:\x20'+d['join'](',\x20'),'missing_required':d};const e={...b};for(const g of c['params']){!(g['name']in e)&&g['default']!==undefined&&(e[g['name']]=g['default']);}return{'ok':!![],'body':c['body'](e)};}