@wowok/agent-mcp 2.7.0 → 2.7.2

package/dist/knowledge/demand-translation.js

@@ -1,354 +1 @@
-import { MAX_REWARD_COUNT, MAX_GUARD_COUNT_DEMAND, MAX_DESCRIPTION_LENGTH, MAX_LONG_NAME_LENGTH, } from "@wowok/wowok";
-const MAX_FEEDBACK_COUNT = 20;
-export const SEMANTIC_TO_DEMAND_SCHEMA_RULES = [
-    {
-        id: "P-DEM-01",
-        pattern_name: "Open Demand (no guards) — free presentation",
-        configuration_classification: "open",
-        semantic_intent: "An open Demand accepts presentations from any sender via the plain `present` function (demand.move:100). " +
-            "No Passport is required. Use this for broad-cast demands where the creator wants to collect as many " +
-            "presentations as possible (e.g. open calls for service providers, public RFPs). The guards vector is empty.",
-        match_keywords: ["open", "no guard", "free presentation", "public", "rfp", "open call"],
-        schema_elements: {
-            required_fields: ["description", "permission"],
-            optional_fields: ["location", "rewards", "um", "namedNew"],
-            presentation_path: "plain_present",
-            um_recommendation: "Optional. Set um to a Contact object if the Demand should be managed by an intermediary. " +
-                "Leave as Option::none for direct creator management.",
-        },
-        constraints: [
-            "guards vector must be empty (initial state — do not call guard_add)",
-            "Callers MUST use plain `present` or `present_service` — present_with_passport will abort with E_GUARD_NOT_FOUND (4)",
-            "description non-empty and within MAX_DESCRIPTION_LENGTH (4000 chars)",
-            "If location is set, within MAX_LONG_NAME_LENGTH (256 chars)",
-        ],
-        example: {
-            description: "Open call for freelance designers — submit portfolio link as recommend",
-            location: "Shanghai",
-            rewards: ["0xabc...reward_addr_1"],
-            permission: "0xperm...permission_addr",
-            um: null,
-            namedNew: { name: "open_design_call_2026" },
-        },
-    },
-    {
-        id: "P-DEM-02",
-        pattern_name: "Guarded Demand (with guards) — passport required for present",
-        configuration_classification: "guarded",
-        semantic_intent: "A guarded Demand requires every presenter to supply a Passport that passes one of the affiliated Guards. " +
-            "Use this when the creator wants to filter presentations by Guard-defined criteria (KYC, membership, " +
-            "stake, etc.). The guards vector is non-empty. Each guard carries an optional service_identifier that, " +
-            "when set, routes present_with_passport to extract the submission address from the Passport (overriding " +
-            "the supplied service parameter).",
-        match_keywords: ["guarded", "passport", "kyc", "membership", "filtered", "gated", "service_identifier"],
-        schema_elements: {
-            required_fields: ["description", "permission", "guards"],
-            optional_fields: ["location", "rewards", "um", "namedNew"],
-            presentation_path: "present_with_passport",
-            um_recommendation: "Optional. Same as P-DEM-01. If the Demand is mediated by an intermediary Contact, set um to that " +
-                "Contact address and the intermediary can manage the Demand via the Contact's permission.",
-        },
-        constraints: [
-            "guards vector non-empty (call guard_add at least once)",
-            "Each guard address must be unique (duplicate guard_add updates service_identifier instead of pushing)",
-            "guard_count ≤ MAX_GUARD_COUNT_DEMAND (20) — E_MAX_GUARD_COUNT_EXCEEDED (2) on overflow",
-            "When service_identifier is provided, it MUST be a valid u8 indexing a Service-typed submission in the Guard",
-            "Presenters MUST use present_with_passport / present_service_with_passport — plain present aborts with E_NEED_PASSPORT (3)",
-            "by_guard (Guard address) passed to present_with_passport MUST already be in the guards vector — E_GUARD_NOT_FOUND (4) otherwise",
-        ],
-        example: {
-            description: "KYC-gated call for certified auditors only",
-            location: "Remote",
-            rewards: ["0xabc...reward_addr_1", "0xdef...reward_addr_2"],
-            guards: [
-                { guard: "0xguard1...", service_identifier: 0 },
-                { guard: "0xguard2...", service_identifier: null },
-            ],
-            permission: "0xperm...permission_addr",
-            um: null,
-            namedNew: { name: "kyc_auditor_call_2026" },
-        },
-    },
-    {
-        id: "P-DEM-03",
-        pattern_name: "Demand with UM (um_set) — Contact object manages demand",
-        configuration_classification: "um_managed",
-        semantic_intent: "A Demand with um set has an affiliated Contact object that manages the Demand on behalf of the creator. " +
-            "The Contact's address is stored in Demand.um (Option<address>). The Contact can perform operations " +
-            "through its own permission scope. Use this when a Demand is operated by an intermediary (agent, " +
-            "marketplace, escrow service) rather than the original creator. um_set_imp (demand.move:139-147) " +
-            "disaffiliates the old um before affiliating the new one (P-DEM-P1-1 fix).",
-        match_keywords: ["um", "contact", "managed", "intermediary", "agent", "marketplace", "escrow"],
-        schema_elements: {
-            required_fields: ["description", "permission", "um"],
-            optional_fields: ["location", "rewards", "guards", "namedNew"],
-            presentation_path: "either",
-            um_recommendation: "Required for this pattern. Set um to a Contact object address via um_set. The Contact's " +
-                "permission scope applies to subsequent operations. To remove the Contact, call um_none — " +
-                "um_none_imp disaffiliates the Contact before clearing self.um.",
-        },
-        constraints: [
-            "um must be a valid Contact object address (set via um_set, permission index 408)",
-            "um_set_imp disaffiliates old um before affiliating new (P-DEM-P1-1 fix — prevents Registrar dependency leak)",
-            "um_none_imp disaffiliates um before clearing (symmetric with um_set_imp)",
-            "If guards is also non-empty, the present_with_passport path applies (P-DEM-02 constraints also hold)",
-            "permission_set (DE-D-2=A) can migrate the Demand to a new Permission — affiliation_change is called on the Registrar",
-        ],
-        example: {
-            description: "Marketplace-managed Demand for freelance design services",
-            location: "Shanghai",
-            rewards: ["0xabc...reward_addr_1"],
-            guards: [{ guard: "0xguard1...", service_identifier: null }],
-            permission: "0xperm...permission_addr",
-            um: "0xcontact...marketplace_contact_addr",
-            namedNew: { name: "marketplace_managed_design_2026" },
-        },
-    },
-];
-export const DEMAND_FIELD_TRANSLATIONS = [
-    {
-        field_name: "description",
-        value_type: "string",
-        semantic: "Human-readable description of this Demand. Required field. The Move contract validates via " +
-            "common::DESCRIPTION (demand.move:157,177), which enforces the 4000-char limit. Should be a one-line " +
-            "summary of what the Demand is asking for (e.g. \"freelance designer for brand identity work\").",
-        format_example: "Freelance designer for brand identity work (logo + style guide)",
-        validation_rules: [
-            "Required field",
-            `Length ≤ MAX_DESCRIPTION_LENGTH (${MAX_DESCRIPTION_LENGTH} chars)`,
-            "Move validates via common::DESCRIPTION — E_DESCRIPTION_LENGTH_EXCEEDED (4) on overflow",
-        ],
-    },
-    {
-        field_name: "location",
-        value_type: "string",
-        semantic: "Geographic location associated with the Demand. Validated via common::LONG_NAME (demand.move:180). " +
-            "Empty string (\"\") is valid — new_imp initializes location to empty. Use location_set to update after " +
-            "creation. This is the ONLY Move Demand struct field that the matching engine reads directly (other " +
-            "matching fields like tags, maxPrice, scenario are caller-enriched — see P-DEM-P1-3 / R-DEM-07).",
-        format_example: "Shanghai or Remote",
-        validation_rules: [
-            "Optional (empty string \"\" is the default initial value)",
-            `Length ≤ MAX_LONG_NAME_LENGTH (${MAX_LONG_NAME_LENGTH} chars)`,
-            "Move validates via common::LONG_NAME — E_LONG_NAME_LENGTH_EXCEEDED (11) on overflow",
-        ],
-    },
-    {
-        field_name: "rewards",
-        value_type: "vector<address> (string[] in SDK)",
-        semantic: "Reward object addresses affiliated with this Demand. Each reward is added via reward_add, which " +
-            "triggers registrar::affiliation. The matching engine reads maxPrice from the Reward objects " +
-            "(caller-enriched — the Demand struct only stores addresses, not Reward metadata).",
-        format_example: "[\"0xabc...reward_addr_1\", \"0xdef...reward_addr_2\"]",
-        validation_rules: [
-            `Count ≤ MAX_REWARD_COUNT (${MAX_REWARD_COUNT}) — E_MAX_REWARD_COUNT_EXCEEDED (1) on overflow`,
-            "Each address must be a valid Reward object address",
-            "Duplicate addresses are silently ignored (reward_add_imp checks contains before push)",
-            "reward_remove / reward_clear disaffiliate via the Registrar before removing",
-        ],
-    },
-    {
-        field_name: "guards",
-        value_type: "vector<ServiceGuard> ({ guard: address, service_identifier: Option<u8> }[] in SDK)",
-        semantic: "Guard addresses with optional service_identifier. When non-empty, presenters MUST use " +
-            "present_with_passport (or present_service_with_passport). The service_identifier, when set, routes " +
-            "present_with_passport to extract the submission address from the Passport (overriding the supplied " +
-            "service parameter). guard_add validates the service_identifier type BEFORE any mutation (P-DEM-P1-2 fix).",
-        format_example: "[{ guard: \"0xguard1...\", service_identifier: 0 }, { guard: \"0xguard2...\", service_identifier: null }]",
-        validation_rules: [
-            `Count ≤ MAX_GUARD_COUNT_DEMAND (${MAX_GUARD_COUNT_DEMAND}) — E_MAX_GUARD_COUNT_EXCEEDED (2) on overflow`,
-            "Each guard address must be a valid Guard object address",
-            "Duplicate addresses update service_identifier in place (no new push)",
-            "When service_identifier is provided, it MUST index a Service-typed submission in the Guard",
-            "guard_remove / guard_clear disaffiliate via the Registrar before removing",
-        ],
-    },
-    {
-        field_name: "um",
-        value_type: "Option<address> (string | null in SDK)",
-        semantic: "Optional Contact object address that manages this Demand. When set, the Contact can perform " +
-            "operations through its own permission scope. um_set_imp (demand.move:139-147) disaffiliates the old " +
-            "um before affiliating the new one (P-DEM-P1-1 fix — prevents Registrar dependency leak). To clear, " +
-            "call um_none — um_none_imp disaffiliates before clearing self.um.",
-        format_example: "0xcontact...marketplace_contact_addr or null",
-        validation_rules: [
-            "Optional (null/undefined → Option::none) — initial state",
-            "When set, must be a valid Contact object address",
-            "um_set_imp disaffiliates old um before setting new (P-DEM-P1-1 fix)",
-            "um_none_imp disaffiliates um before clearing (symmetric)",
-            "Permission index 408 required for um_set / um_none",
-        ],
-    },
-    {
-        field_name: "presenters",
-        value_type: "ParentTable<address, ServiceInfo> (not directly settable — populated by present)",
-        semantic: "Service presentation records, keyed by presenter address. Each entry contains: recommend (String), " +
-            "service (Option<address>), update_time (u64), acceptance_score (Option<u8>), feedback (String), " +
-            "feedback_time (u64). Populated by present_imp — presenters call present / present_with_passport to " +
-            "add or update their entry. feedback_imp updates an existing entry's feedback fields.",
-        format_example: "(not directly settable — populated by present operations)",
-        validation_rules: [
-            "Not directly settable by the creator — populated by presenter operations",
-            "Each presenter address maps to at most one ServiceInfo entry",
-            "present updates update_time and overwrites recommend/service on each call",
-            "feedback updates acceptance_score, feedback, feedback_time (only if presenter exists)",
-        ],
-    },
-    {
-        field_name: "permission",
-        value_type: "address",
-        semantic: "Permission object address bound to this Demand. All mutations require permission::assert_permission_with_sender " +
-            "with the appropriate index (400-408). permission_set (demand.move:286) is exposed via CallPermission.apply " +
-            "(DE-D-2=A) and migrates the affiliation via registrar::affiliation_change.",
-        format_example: "0xperm...permission_addr",
-        validation_rules: [
-            "Required field (set at creation via new_imp)",
-            "permission::assert_with_sender(permission, 400, ctx) required for new (DEMAND_NEW)",
-            "permission::assert_permission_with_sender(permission, <index>, &self.permission, ctx) required for all mutations",
-            "Permission indices: 400=NEW, 401=DESCRIPTION, 402=LOCATION, 404=GUARD, 405=REWARD, 406=FEEDBACK, 407=OWNER_RECEIVE, 408=UM",
-            "permission_set migrates affiliation via registrar::affiliation_change (DE-D-2=A)",
-        ],
-    },
-];
-export const DEMAND_CONSTRAINT_RULES = [
-    {
-        id: "DEMAND_C_01",
-        name: "description non-empty and within size limit",
-        description: `The 'description' field must be non-empty and ≤ MAX_DESCRIPTION_LENGTH (${MAX_DESCRIPTION_LENGTH} chars).`,
-        validation_logic: "description.length > 0 && description.length <= MAX_DESCRIPTION_LENGTH",
-        failure_message: `description must be 1..${MAX_DESCRIPTION_LENGTH} chars — E_DESCRIPTION_LENGTH_EXCEEDED (4) on overflow`,
-        related_field: "description",
-    },
-    {
-        id: "DEMAND_C_02",
-        name: "location within size limit",
-        description: `The 'location' field must be ≤ MAX_LONG_NAME_LENGTH (${MAX_LONG_NAME_LENGTH} chars). Empty string is valid.`,
-        validation_logic: "location.length <= MAX_LONG_NAME_LENGTH",
-        failure_message: `location exceeds MAX_LONG_NAME_LENGTH (${MAX_LONG_NAME_LENGTH} chars) — E_LONG_NAME_LENGTH_EXCEEDED (11)`,
-        related_field: "location",
-    },
-    {
-        id: "DEMAND_C_03",
-        name: "rewards count within limit",
-        description: `The 'rewards' vector count must be ≤ MAX_REWARD_COUNT (${MAX_REWARD_COUNT}).`,
-        validation_logic: `rewards.length <= MAX_REWARD_COUNT`,
-        failure_message: `rewards count exceeds MAX_REWARD_COUNT (${MAX_REWARD_COUNT}) — E_MAX_REWARD_COUNT_EXCEEDED (1)`,
-        related_field: "rewards",
-    },
-    {
-        id: "DEMAND_C_04",
-        name: "guards count within limit",
-        description: `The 'guards' vector count must be ≤ MAX_GUARD_COUNT_DEMAND (${MAX_GUARD_COUNT_DEMAND}).`,
-        validation_logic: `guards.length <= MAX_GUARD_COUNT_DEMAND`,
-        failure_message: `guards count exceeds MAX_GUARD_COUNT_DEMAND (${MAX_GUARD_COUNT_DEMAND}) — E_MAX_GUARD_COUNT_EXCEEDED (2)`,
-        related_field: "guards",
-    },
-    {
-        id: "DEMAND_C_05",
-        name: "service_identifier valid u8 when provided",
-        description: "When service_identifier is provided to guard_add, it must be a valid u8 (0-255) indexing a " +
-            "Service-typed submission in the Guard. guard_add_imp validates via guard::get_submission_object_type " +
-            "and common::assert_service_object_type BEFORE any mutation (P-DEM-P1-2 fix).",
-        validation_logic: "service_identifier == null || (Number.isInteger(service_identifier) && 0 <= service_identifier && service_identifier <= 255)",
-        failure_message: "service_identifier must be a u8 (0-255) indexing a Service-typed submission — E_INVALID_SERVICE_OBJECT_TYPE (13)",
-        related_field: "guards.service_identifier",
-    },
-    {
-        id: "DEMAND_C_06",
-        name: "present requires passport when guards non-empty",
-        description: "When the guards vector is non-empty, callers MUST use present_with_passport / present_service_with_passport. " +
-            "The plain present function asserts `vector::is_empty(&self.guards)` and aborts with E_NEED_PASSPORT (3). " +
-            "The by_guard parameter to present_with_passport MUST already be in the guards vector " +
-            "(otherwise E_GUARD_NOT_FOUND (4)).",
-        validation_logic: "!guards_non_empty || using_present_with_passport; by_guard in guards",
-        failure_message: "present without passport when guards non-empty — E_NEED_PASSPORT (3); by_guard not in guards — E_GUARD_NOT_FOUND (4)",
-        related_field: "guards + presentation_path",
-    },
-];
-export function explainDemand(input) {
-    const warnings = [];
-    const recommendations = [];
-    const hasGuards = !!input.guards && input.guards.length > 0;
-    const hasUm = !!input.um;
-    let classification = "open";
-    let presentationPath = "plain_present";
-    if (hasGuards && hasUm) {
-        classification = "guarded + um_managed (P-DEM-02 + P-DEM-03 combined)";
-        presentationPath = "present_with_passport (um does not change presentation path)";
-    }
-    else if (hasGuards) {
-        classification = "guarded (P-DEM-02) — passport required for present";
-        presentationPath = "present_with_passport / present_service_with_passport";
-    }
-    else if (hasUm) {
-        classification = "um_managed (P-DEM-03) — Contact manages the Demand";
-        presentationPath = "plain present (no guards) OR present_with_passport (if guards added later)";
-    }
-    else {
-        classification = "open (P-DEM-01) — free presentation, no passport required";
-        presentationPath = "present / present_service (plain path)";
-    }
-    const bindingParts = [];
-    if (input.permission) {
-        bindingParts.push(`permission=${input.permission.substring(0, 10)}... (bound at creation)`);
-    }
-    if (hasUm) {
-        bindingParts.push(`um=${input.um.substring(0, 10)}... (Contact manages Demand)`);
-    }
-    if (input.rewards && input.rewards.length > 0) {
-        bindingParts.push(`rewards=${input.rewards.length} affiliated via Registrar`);
-    }
-    if (hasGuards) {
-        bindingParts.push(`guards=${input.guards.length} affiliated via Registrar`);
-    }
-    const bindingStatus = bindingParts.length > 0
-        ? `Bindings: ${bindingParts.join("; ")}`
-        : "No Registrar affiliations (bare Demand)";
-    const sizeStatus = [];
-    if (input.description !== undefined) {
-        sizeStatus.push(`description=${input.description.length} chars (limit ${MAX_DESCRIPTION_LENGTH})`);
-    }
-    if (input.location !== undefined) {
-        sizeStatus.push(`location=${input.location.length} chars (limit ${MAX_LONG_NAME_LENGTH})`);
-    }
-    if (input.rewards) {
-        sizeStatus.push(`rewards=${input.rewards.length}/${MAX_REWARD_COUNT}`);
-    }
-    if (input.guards) {
-        sizeStatus.push(`guards=${input.guards.length}/${MAX_GUARD_COUNT_DEMAND}`);
-    }
-    if (hasGuards) {
-        const invalidSids = input.guards.filter(g => g.service_identifier !== null && g.service_identifier !== undefined
-            && !(typeof g.service_identifier === "number" && Number.isInteger(g.service_identifier)
-                && g.service_identifier >= 0 && g.service_identifier <= 255));
-        if (invalidSids.length > 0) {
-            warnings.push(`${invalidSids.length} guard(s) have invalid service_identifier (must be u8 0-255)`);
-        }
-    }
-    if (!input.description || input.description.length === 0) {
-        warnings.push("description is empty — Demand will be hard to identify in queries");
-    }
-    if (!input.description || input.description.length === 0) {
-        recommendations.push("Provide a non-empty description for discoverability");
-    }
-    if (input.location === undefined || input.location === "") {
-        recommendations.push("Consider setting location if the Demand is geographic (only on-chain field used by matching)");
-    }
-    if (!hasGuards) {
-        recommendations.push("Consider adding guards if presentations should be filtered (KYC, membership, etc.)");
-    }
-    if (!hasUm && classification === "open") {
-        recommendations.push("Consider setting um to a Contact if the Demand should be managed by an intermediary");
-    }
-    const summary = `Demand is ${classification}. ${presentationPath}. ${bindingStatus}. ` +
-        (sizeStatus.length > 0 ? `Sizes: ${sizeStatus.join(", ")}.` : "");
-    return {
-        summary,
-        configuration_classification: classification,
-        presentation_path: presentationPath,
-        binding_status: bindingStatus,
-        size_status: sizeStatus.join(", "),
-        warnings,
-        recommendations,
-    };
-}
+import{MAX_REWARD_COUNT,MAX_GUARD_COUNT_DEMAND,MAX_DESCRIPTION_LENGTH,MAX_LONG_NAME_LENGTH}from'@wowok/wowok';const MAX_FEEDBACK_COUNT=0x14;export const SEMANTIC_TO_DEMAND_SCHEMA_RULES=[{'id':'P-DEM-01','pattern_name':'Open\x20Demand\x20(no\x20guards)\x20—\x20free\x20presentation','configuration_classification':'open','semantic_intent':'An\x20open\x20Demand\x20accepts\x20presentations\x20from\x20any\x20sender\x20via\x20the\x20plain\x20`present`\x20function\x20(demand.move:100).\x20'+'No\x20Passport\x20is\x20required.\x20Use\x20this\x20for\x20broad-cast\x20demands\x20where\x20the\x20creator\x20wants\x20to\x20collect\x20as\x20many\x20'+'presentations\x20as\x20possible\x20(e.g.\x20open\x20calls\x20for\x20service\x20providers,\x20public\x20RFPs).\x20The\x20guards\x20vector\x20is\x20empty.','match_keywords':['open','no\x20guard','free\x20presentation','public','rfp','open\x20call'],'schema_elements':{'required_fields':['description','permission'],'optional_fields':['location','rewards','um','namedNew'],'presentation_path':'plain_present','um_recommendation':'Optional.\x20Set\x20um\x20to\x20a\x20Contact\x20object\x20if\x20the\x20Demand\x20should\x20be\x20managed\x20by\x20an\x20intermediary.\x20'+'Leave\x20as\x20Option::none\x20for\x20direct\x20creator\x20management.'},'constraints':['guards\x20vector\x20must\x20be\x20empty\x20(initial\x20state\x20—\x20do\x20not\x20call\x20guard_add)','Callers\x20MUST\x20use\x20plain\x20`present`\x20or\x20`present_service`\x20—\x20present_with_passport\x20will\x20abort\x20with\x20E_GUARD_NOT_FOUND\x20(4)','description\x20non-empty\x20and\x20within\x20MAX_DESCRIPTION_LENGTH\x20(4000\x20chars)','If\x20location\x20is\x20set,\x20within\x20MAX_LONG_NAME_LENGTH\x20(256\x20chars)'],'example':{'description':'Open\x20call\x20for\x20freelance\x20designers\x20—\x20submit\x20portfolio\x20link\x20as\x20recommend','location':'Shanghai','rewards':['0xabc...reward_addr_1'],'permission':'0xperm...permission_addr','um':null,'namedNew':{'name':'open_design_call_2026'}}},{'id':'P-DEM-02','pattern_name':'Guarded\x20Demand\x20(with\x20guards)\x20—\x20passport\x20required\x20for\x20present','configuration_classification':'guarded','semantic_intent':'A\x20guarded\x20Demand\x20requires\x20every\x20presenter\x20to\x20supply\x20a\x20Passport\x20that\x20passes\x20one\x20of\x20the\x20affiliated\x20Guards.\x20'+'Use\x20this\x20when\x20the\x20creator\x20wants\x20to\x20filter\x20presentations\x20by\x20Guard-defined\x20criteria\x20(KYC,\x20membership,\x20'+'stake,\x20etc.).\x20The\x20guards\x20vector\x20is\x20non-empty.\x20Each\x20guard\x20carries\x20an\x20optional\x20service_identifier\x20that,\x20'+'when\x20set,\x20routes\x20present_with_passport\x20to\x20extract\x20the\x20submission\x20address\x20from\x20the\x20Passport\x20(overriding\x20'+'the\x20supplied\x20service\x20parameter).','match_keywords':['guarded','passport','kyc','membership','filtered','gated','service_identifier'],'schema_elements':{'required_fields':['description','permission','guards'],'optional_fields':['location','rewards','um','namedNew'],'presentation_path':'present_with_passport','um_recommendation':'Optional.\x20Same\x20as\x20P-DEM-01.\x20If\x20the\x20Demand\x20is\x20mediated\x20by\x20an\x20intermediary\x20Contact,\x20set\x20um\x20to\x20that\x20'+'Contact\x20address\x20and\x20the\x20intermediary\x20can\x20manage\x20the\x20Demand\x20via\x20the\x20Contact\x27s\x20permission.'},'constraints':['guards\x20vector\x20non-empty\x20(call\x20guard_add\x20at\x20least\x20once)','Each\x20guard\x20address\x20must\x20be\x20unique\x20(duplicate\x20guard_add\x20updates\x20service_identifier\x20instead\x20of\x20pushing)','guard_count\x20≤\x20MAX_GUARD_COUNT_DEMAND\x20(20)\x20—\x20E_MAX_GUARD_COUNT_EXCEEDED\x20(2)\x20on\x20overflow','When\x20service_identifier\x20is\x20provided,\x20it\x20MUST\x20be\x20a\x20valid\x20u8\x20indexing\x20a\x20Service-typed\x20submission\x20in\x20the\x20Guard','Presenters\x20MUST\x20use\x20present_with_passport\x20/\x20present_service_with_passport\x20—\x20plain\x20present\x20aborts\x20with\x20E_NEED_PASSPORT\x20(3)','by_guard\x20(Guard\x20address)\x20passed\x20to\x20present_with_passport\x20MUST\x20already\x20be\x20in\x20the\x20guards\x20vector\x20—\x20E_GUARD_NOT_FOUND\x20(4)\x20otherwise'],'example':{'description':'KYC-gated\x20call\x20for\x20certified\x20auditors\x20only','location':'Remote','rewards':['0xabc...reward_addr_1','0xdef...reward_addr_2'],'guards':[{'guard':'0xguard1...','service_identifier':0x0},{'guard':'0xguard2...','service_identifier':null}],'permission':'0xperm...permission_addr','um':null,'namedNew':{'name':'kyc_auditor_call_2026'}}},{'id':'P-DEM-03','pattern_name':'Demand\x20with\x20UM\x20(um_set)\x20—\x20Contact\x20object\x20manages\x20demand','configuration_classification':'um_managed','semantic_intent':'A\x20Demand\x20with\x20um\x20set\x20has\x20an\x20affiliated\x20Contact\x20object\x20that\x20manages\x20the\x20Demand\x20on\x20behalf\x20of\x20the\x20creator.\x20'+'The\x20Contact\x27s\x20address\x20is\x20stored\x20in\x20Demand.um\x20(Option<address>).\x20The\x20Contact\x20can\x20perform\x20operations\x20'+'through\x20its\x20own\x20permission\x20scope.\x20Use\x20this\x20when\x20a\x20Demand\x20is\x20operated\x20by\x20an\x20intermediary\x20(agent,\x20'+'marketplace,\x20escrow\x20service)\x20rather\x20than\x20the\x20original\x20creator.\x20um_set_imp\x20(demand.move:139-147)\x20'+'disaffiliates\x20the\x20old\x20um\x20before\x20affiliating\x20the\x20new\x20one\x20(P-DEM-P1-1\x20fix).','match_keywords':['um','contact','managed','intermediary','agent','marketplace','escrow'],'schema_elements':{'required_fields':['description','permission','um'],'optional_fields':['location','rewards','guards','namedNew'],'presentation_path':'either','um_recommendation':'Required\x20for\x20this\x20pattern.\x20Set\x20um\x20to\x20a\x20Contact\x20object\x20address\x20via\x20um_set.\x20The\x20Contact\x27s\x20'+'permission\x20scope\x20applies\x20to\x20subsequent\x20operations.\x20To\x20remove\x20the\x20Contact,\x20call\x20um_none\x20—\x20'+'um_none_imp\x20disaffiliates\x20the\x20Contact\x20before\x20clearing\x20self.um.'},'constraints':['um\x20must\x20be\x20a\x20valid\x20Contact\x20object\x20address\x20(set\x20via\x20um_set,\x20permission\x20index\x20408)','um_set_imp\x20disaffiliates\x20old\x20um\x20before\x20affiliating\x20new\x20(P-DEM-P1-1\x20fix\x20—\x20prevents\x20Registrar\x20dependency\x20leak)','um_none_imp\x20disaffiliates\x20um\x20before\x20clearing\x20(symmetric\x20with\x20um_set_imp)','If\x20guards\x20is\x20also\x20non-empty,\x20the\x20present_with_passport\x20path\x20applies\x20(P-DEM-02\x20constraints\x20also\x20hold)','permission_set\x20(DE-D-2=A)\x20can\x20migrate\x20the\x20Demand\x20to\x20a\x20new\x20Permission\x20—\x20affiliation_change\x20is\x20called\x20on\x20the\x20Registrar'],'example':{'description':'Marketplace-managed\x20Demand\x20for\x20freelance\x20design\x20services','location':'Shanghai','rewards':['0xabc...reward_addr_1'],'guards':[{'guard':'0xguard1...','service_identifier':null}],'permission':'0xperm...permission_addr','um':'0xcontact...marketplace_contact_addr','namedNew':{'name':'marketplace_managed_design_2026'}}}];export const DEMAND_FIELD_TRANSLATIONS=[{'field_name':'description','value_type':'string','semantic':'Human-readable\x20description\x20of\x20this\x20Demand.\x20Required\x20field.\x20The\x20Move\x20contract\x20validates\x20via\x20'+'common::DESCRIPTION\x20(demand.move:157,177),\x20which\x20enforces\x20the\x204000-char\x20limit.\x20Should\x20be\x20a\x20one-line\x20'+'summary\x20of\x20what\x20the\x20Demand\x20is\x20asking\x20for\x20(e.g.\x20\x22freelance\x20designer\x20for\x20brand\x20identity\x20work\x22).','format_example':'Freelance\x20designer\x20for\x20brand\x20identity\x20work\x20(logo\x20+\x20style\x20guide)','validation_rules':['Required\x20field','Length\x20≤\x20MAX_DESCRIPTION_LENGTH\x20('+MAX_DESCRIPTION_LENGTH+'\x20chars)','Move\x20validates\x20via\x20common::DESCRIPTION\x20—\x20E_DESCRIPTION_LENGTH_EXCEEDED\x20(4)\x20on\x20overflow']},{'field_name':'location','value_type':'string','semantic':'Geographic\x20location\x20associated\x20with\x20the\x20Demand.\x20Validated\x20via\x20common::LONG_NAME\x20(demand.move:180).\x20'+'Empty\x20string\x20(\x22\x22)\x20is\x20valid\x20—\x20new_imp\x20initializes\x20location\x20to\x20empty.\x20Use\x20location_set\x20to\x20update\x20after\x20'+'creation.\x20This\x20is\x20the\x20ONLY\x20Move\x20Demand\x20struct\x20field\x20that\x20the\x20matching\x20engine\x20reads\x20directly\x20(other\x20'+'matching\x20fields\x20like\x20tags,\x20maxPrice,\x20scenario\x20are\x20caller-enriched\x20—\x20see\x20P-DEM-P1-3\x20/\x20R-DEM-07).','format_example':'Shanghai\x20or\x20Remote','validation_rules':['Optional\x20(empty\x20string\x20\x22\x22\x20is\x20the\x20default\x20initial\x20value)','Length\x20≤\x20MAX_LONG_NAME_LENGTH\x20('+MAX_LONG_NAME_LENGTH+'\x20chars)','Move\x20validates\x20via\x20common::LONG_NAME\x20—\x20E_LONG_NAME_LENGTH_EXCEEDED\x20(11)\x20on\x20overflow']},{'field_name':'rewards','value_type':'vector<address>\x20(string[]\x20in\x20SDK)','semantic':'Reward\x20object\x20addresses\x20affiliated\x20with\x20this\x20Demand.\x20Each\x20reward\x20is\x20added\x20via\x20reward_add,\x20which\x20'+'triggers\x20registrar::affiliation.\x20The\x20matching\x20engine\x20reads\x20maxPrice\x20from\x20the\x20Reward\x20objects\x20'+'(caller-enriched\x20—\x20the\x20Demand\x20struct\x20only\x20stores\x20addresses,\x20not\x20Reward\x20metadata).','format_example':'[\x220xabc...reward_addr_1\x22,\x20\x220xdef...reward_addr_2\x22]','validation_rules':['Count\x20≤\x20MAX_REWARD_COUNT\x20('+MAX_REWARD_COUNT+')\x20—\x20E_MAX_REWARD_COUNT_EXCEEDED\x20(1)\x20on\x20overflow','Each\x20address\x20must\x20be\x20a\x20valid\x20Reward\x20object\x20address','Duplicate\x20addresses\x20are\x20silently\x20ignored\x20(reward_add_imp\x20checks\x20contains\x20before\x20push)','reward_remove\x20/\x20reward_clear\x20disaffiliate\x20via\x20the\x20Registrar\x20before\x20removing']},{'field_name':'guards','value_type':'vector<ServiceGuard>\x20({\x20guard:\x20address,\x20service_identifier:\x20Option<u8>\x20}[]\x20in\x20SDK)','semantic':'Guard\x20addresses\x20with\x20optional\x20service_identifier.\x20When\x20non-empty,\x20presenters\x20MUST\x20use\x20'+'present_with_passport\x20(or\x20present_service_with_passport).\x20The\x20service_identifier,\x20when\x20set,\x20routes\x20'+'present_with_passport\x20to\x20extract\x20the\x20submission\x20address\x20from\x20the\x20Passport\x20(overriding\x20the\x20supplied\x20'+'service\x20parameter).\x20guard_add\x20validates\x20the\x20service_identifier\x20type\x20BEFORE\x20any\x20mutation\x20(P-DEM-P1-2\x20fix).','format_example':'[{\x20guard:\x20\x220xguard1...\x22,\x20service_identifier:\x200\x20},\x20{\x20guard:\x20\x220xguard2...\x22,\x20service_identifier:\x20null\x20}]','validation_rules':['Count\x20≤\x20MAX_GUARD_COUNT_DEMAND\x20('+MAX_GUARD_COUNT_DEMAND+')\x20—\x20E_MAX_GUARD_COUNT_EXCEEDED\x20(2)\x20on\x20overflow','Each\x20guard\x20address\x20must\x20be\x20a\x20valid\x20Guard\x20object\x20address','Duplicate\x20addresses\x20update\x20service_identifier\x20in\x20place\x20(no\x20new\x20push)','When\x20service_identifier\x20is\x20provided,\x20it\x20MUST\x20index\x20a\x20Service-typed\x20submission\x20in\x20the\x20Guard','guard_remove\x20/\x20guard_clear\x20disaffiliate\x20via\x20the\x20Registrar\x20before\x20removing']},{'field_name':'um','value_type':'Option<address>\x20(string\x20|\x20null\x20in\x20SDK)','semantic':'Optional\x20Contact\x20object\x20address\x20that\x20manages\x20this\x20Demand.\x20When\x20set,\x20the\x20Contact\x20can\x20perform\x20'+'operations\x20through\x20its\x20own\x20permission\x20scope.\x20um_set_imp\x20(demand.move:139-147)\x20disaffiliates\x20the\x20old\x20'+'um\x20before\x20affiliating\x20the\x20new\x20one\x20(P-DEM-P1-1\x20fix\x20—\x20prevents\x20Registrar\x20dependency\x20leak).\x20To\x20clear,\x20'+'call\x20um_none\x20—\x20um_none_imp\x20disaffiliates\x20before\x20clearing\x20self.um.','format_example':'0xcontact...marketplace_contact_addr\x20or\x20null','validation_rules':['Optional\x20(null/undefined\x20→\x20Option::none)\x20—\x20initial\x20state','When\x20set,\x20must\x20be\x20a\x20valid\x20Contact\x20object\x20address','um_set_imp\x20disaffiliates\x20old\x20um\x20before\x20setting\x20new\x20(P-DEM-P1-1\x20fix)','um_none_imp\x20disaffiliates\x20um\x20before\x20clearing\x20(symmetric)','Permission\x20index\x20408\x20required\x20for\x20um_set\x20/\x20um_none']},{'field_name':'presenters','value_type':'ParentTable<address,\x20ServiceInfo>\x20(not\x20directly\x20settable\x20—\x20populated\x20by\x20present)','semantic':'Service\x20presentation\x20records,\x20keyed\x20by\x20presenter\x20address.\x20Each\x20entry\x20contains:\x20recommend\x20(String),\x20'+'service\x20(Option<address>),\x20update_time\x20(u64),\x20acceptance_score\x20(Option<u8>),\x20feedback\x20(String),\x20'+'feedback_time\x20(u64).\x20Populated\x20by\x20present_imp\x20—\x20presenters\x20call\x20present\x20/\x20present_with_passport\x20to\x20'+'add\x20or\x20update\x20their\x20entry.\x20feedback_imp\x20updates\x20an\x20existing\x20entry\x27s\x20feedback\x20fields.','format_example':'(not\x20directly\x20settable\x20—\x20populated\x20by\x20present\x20operations)','validation_rules':['Not\x20directly\x20settable\x20by\x20the\x20creator\x20—\x20populated\x20by\x20presenter\x20operations','Each\x20presenter\x20address\x20maps\x20to\x20at\x20most\x20one\x20ServiceInfo\x20entry','present\x20updates\x20update_time\x20and\x20overwrites\x20recommend/service\x20on\x20each\x20call','feedback\x20updates\x20acceptance_score,\x20feedback,\x20feedback_time\x20(only\x20if\x20presenter\x20exists)']},{'field_name':'permission','value_type':'address','semantic':'Permission\x20object\x20address\x20bound\x20to\x20this\x20Demand.\x20All\x20mutations\x20require\x20permission::assert_permission_with_sender\x20'+'with\x20the\x20appropriate\x20index\x20(400-408).\x20permission_set\x20(demand.move:286)\x20is\x20exposed\x20via\x20CallPermission.apply\x20'+'(DE-D-2=A)\x20and\x20migrates\x20the\x20affiliation\x20via\x20registrar::affiliation_change.','format_example':'0xperm...permission_addr','validation_rules':['Required\x20field\x20(set\x20at\x20creation\x20via\x20new_imp)','permission::assert_with_sender(permission,\x20400,\x20ctx)\x20required\x20for\x20new\x20(DEMAND_NEW)','permission::assert_permission_with_sender(permission,\x20<index>,\x20&self.permission,\x20ctx)\x20required\x20for\x20all\x20mutations','Permission\x20indices:\x20400=NEW,\x20401=DESCRIPTION,\x20402=LOCATION,\x20404=GUARD,\x20405=REWARD,\x20406=FEEDBACK,\x20407=OWNER_RECEIVE,\x20408=UM','permission_set\x20migrates\x20affiliation\x20via\x20registrar::affiliation_change\x20(DE-D-2=A)']}];export const DEMAND_CONSTRAINT_RULES=[{'id':'DEMAND_C_01','name':'description\x20non-empty\x20and\x20within\x20size\x20limit','description':'The\x20\x27description\x27\x20field\x20must\x20be\x20non-empty\x20and\x20≤\x20MAX_DESCRIPTION_LENGTH\x20('+MAX_DESCRIPTION_LENGTH+'\x20chars).','validation_logic':'description.length\x20>\x200\x20&&\x20description.length\x20<=\x20MAX_DESCRIPTION_LENGTH','failure_message':'description\x20must\x20be\x201..'+MAX_DESCRIPTION_LENGTH+'\x20chars\x20—\x20E_DESCRIPTION_LENGTH_EXCEEDED\x20(4)\x20on\x20overflow','related_field':'description'},{'id':'DEMAND_C_02','name':'location\x20within\x20size\x20limit','description':'The\x20\x27location\x27\x20field\x20must\x20be\x20≤\x20MAX_LONG_NAME_LENGTH\x20('+MAX_LONG_NAME_LENGTH+'\x20chars).\x20Empty\x20string\x20is\x20valid.','validation_logic':'location.length\x20<=\x20MAX_LONG_NAME_LENGTH','failure_message':'location\x20exceeds\x20MAX_LONG_NAME_LENGTH\x20('+MAX_LONG_NAME_LENGTH+'\x20chars)\x20—\x20E_LONG_NAME_LENGTH_EXCEEDED\x20(11)','related_field':'location'},{'id':'DEMAND_C_03','name':'rewards\x20count\x20within\x20limit','description':'The\x20\x27rewards\x27\x20vector\x20count\x20must\x20be\x20≤\x20MAX_REWARD_COUNT\x20('+MAX_REWARD_COUNT+').','validation_logic':'rewards.length\x20<=\x20MAX_REWARD_COUNT','failure_message':'rewards\x20count\x20exceeds\x20MAX_REWARD_COUNT\x20('+MAX_REWARD_COUNT+')\x20—\x20E_MAX_REWARD_COUNT_EXCEEDED\x20(1)','related_field':'rewards'},{'id':'DEMAND_C_04','name':'guards\x20count\x20within\x20limit','description':'The\x20\x27guards\x27\x20vector\x20count\x20must\x20be\x20≤\x20MAX_GUARD_COUNT_DEMAND\x20('+MAX_GUARD_COUNT_DEMAND+').','validation_logic':'guards.length\x20<=\x20MAX_GUARD_COUNT_DEMAND','failure_message':'guards\x20count\x20exceeds\x20MAX_GUARD_COUNT_DEMAND\x20('+MAX_GUARD_COUNT_DEMAND+')\x20—\x20E_MAX_GUARD_COUNT_EXCEEDED\x20(2)','related_field':'guards'},{'id':'DEMAND_C_05','name':'service_identifier\x20valid\x20u8\x20when\x20provided','description':'When\x20service_identifier\x20is\x20provided\x20to\x20guard_add,\x20it\x20must\x20be\x20a\x20valid\x20u8\x20(0-255)\x20indexing\x20a\x20'+'Service-typed\x20submission\x20in\x20the\x20Guard.\x20guard_add_imp\x20validates\x20via\x20guard::get_submission_object_type\x20'+'and\x20common::assert_service_object_type\x20BEFORE\x20any\x20mutation\x20(P-DEM-P1-2\x20fix).','validation_logic':'service_identifier\x20==\x20null\x20||\x20(Number.isInteger(service_identifier)\x20&&\x200\x20<=\x20service_identifier\x20&&\x20service_identifier\x20<=\x20255)','failure_message':'service_identifier\x20must\x20be\x20a\x20u8\x20(0-255)\x20indexing\x20a\x20Service-typed\x20submission\x20—\x20E_INVALID_SERVICE_OBJECT_TYPE\x20(13)','related_field':'guards.service_identifier'},{'id':'DEMAND_C_06','name':'present\x20requires\x20passport\x20when\x20guards\x20non-empty','description':'When\x20the\x20guards\x20vector\x20is\x20non-empty,\x20callers\x20MUST\x20use\x20present_with_passport\x20/\x20present_service_with_passport.\x20'+'The\x20plain\x20present\x20function\x20asserts\x20`vector::is_empty(&self.guards)`\x20and\x20aborts\x20with\x20E_NEED_PASSPORT\x20(3).\x20'+'The\x20by_guard\x20parameter\x20to\x20present_with_passport\x20MUST\x20already\x20be\x20in\x20the\x20guards\x20vector\x20'+'(otherwise\x20E_GUARD_NOT_FOUND\x20(4)).','validation_logic':'!guards_non_empty\x20||\x20using_present_with_passport;\x20by_guard\x20in\x20guards','failure_message':'present\x20without\x20passport\x20when\x20guards\x20non-empty\x20—\x20E_NEED_PASSPORT\x20(3);\x20by_guard\x20not\x20in\x20guards\x20—\x20E_GUARD_NOT_FOUND\x20(4)','related_field':'guards\x20+\x20presentation_path'}];export function explainDemand(a){const b=[],c=[],d=!!a['guards']&&a['guards']['length']>0x0,e=!!a['um'];let f='open',g='plain_present';if(d&&e)f='guarded\x20+\x20um_managed\x20(P-DEM-02\x20+\x20P-DEM-03\x20combined)',g='present_with_passport\x20(um\x20does\x20not\x20change\x20presentation\x20path)';else{if(d)f='guarded\x20(P-DEM-02)\x20—\x20passport\x20required\x20for\x20present',g='present_with_passport\x20/\x20present_service_with_passport';else e?(f='um_managed\x20(P-DEM-03)\x20—\x20Contact\x20manages\x20the\x20Demand',g='plain\x20present\x20(no\x20guards)\x20OR\x20present_with_passport\x20(if\x20guards\x20added\x20later)'):(f='open\x20(P-DEM-01)\x20—\x20free\x20presentation,\x20no\x20passport\x20required',g='present\x20/\x20present_service\x20(plain\x20path)');}const h=[];a['permission']&&h['push']('permission='+a['permission']['substring'](0x0,0xa)+'...\x20(bound\x20at\x20creation)');e&&h['push']('um='+a['um']['substring'](0x0,0xa)+'...\x20(Contact\x20manages\x20Demand)');a['rewards']&&a['rewards']['length']>0x0&&h['push']('rewards='+a['rewards']['length']+'\x20affiliated\x20via\x20Registrar');d&&h['push']('guards='+a['guards']['length']+'\x20affiliated\x20via\x20Registrar');const i=h['length']>0x0?'Bindings:\x20'+h['join'](';\x20'):'No\x20Registrar\x20affiliations\x20(bare\x20Demand)',j=[];a['description']!==undefined&&j['push']('description='+a['description']['length']+'\x20chars\x20(limit\x20'+MAX_DESCRIPTION_LENGTH+')');a['location']!==undefined&&j['push']('location='+a['location']['length']+'\x20chars\x20(limit\x20'+MAX_LONG_NAME_LENGTH+')');a['rewards']&&j['push']('rewards='+a['rewards']['length']+'/'+MAX_REWARD_COUNT);a['guards']&&j['push']('guards='+a['guards']['length']+'/'+MAX_GUARD_COUNT_DEMAND);if(d){const l=a['guards']['filter'](m=>m['service_identifier']!==null&&m['service_identifier']!==undefined&&!(typeof m['service_identifier']==='number'&&Number['isInteger'](m['service_identifier'])&&m['service_identifier']>=0x0&&m['service_identifier']<=0xff));l['length']>0x0&&b['push'](l['length']+'\x20guard(s)\x20have\x20invalid\x20service_identifier\x20(must\x20be\x20u8\x200-255)');}(!a['description']||a['description']['length']===0x0)&&b['push']('description\x20is\x20empty\x20—\x20Demand\x20will\x20be\x20hard\x20to\x20identify\x20in\x20queries');(!a['description']||a['description']['length']===0x0)&&c['push']('Provide\x20a\x20non-empty\x20description\x20for\x20discoverability');(a['location']===undefined||a['location']==='')&&c['push']('Consider\x20setting\x20location\x20if\x20the\x20Demand\x20is\x20geographic\x20(only\x20on-chain\x20field\x20used\x20by\x20matching)');!d&&c['push']('Consider\x20adding\x20guards\x20if\x20presentations\x20should\x20be\x20filtered\x20(KYC,\x20membership,\x20etc.)');!e&&f==='open'&&c['push']('Consider\x20setting\x20um\x20to\x20a\x20Contact\x20if\x20the\x20Demand\x20should\x20be\x20managed\x20by\x20an\x20intermediary');const k='Demand\x20is\x20'+f+'.\x20'+g+'.\x20'+i+'.\x20'+(j['length']>0x0?'Sizes:\x20'+j['join'](',\x20')+'.':'');return{'summary':k,'configuration_classification':f,'presentation_path':g,'binding_status':i,'size_status':j['join'](',\x20'),'warnings':b,'recommendations':c};}