@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/knowledge/contact-risk.js

@@ -1,200 +1 @@
-import { MAX_IM_COUNT } from "@wowok/wowok";
-const R_C_01 = {
-    rule: {
-        id: "R-CONTACT-01",
-        level: "MEDIUM",
-        category: "permission",
-        title: "change_status has no permission check — IM list pollution risk",
-        description: "change_status lets any IM member self-update their status string without Permission " +
-            "verification (contact.move:32-43). If an attacker's address is added to the ims list " +
-            "(via im_add, which requires permission index 453), the attacker can freely pollute " +
-            "their status field (e.g. set status to 'fraud'). The risk is bounded by the im_add " +
-            "permission gate, but a misconfigured Permission could expose the IM list.",
-        affected_stakeholders: ["creator", "im_member"],
-        scenario: "Contact's IM list is misconfigured to allow public adds; attacker pollutes status",
-        mitigation: "Restrict permission index 453 (CONTACT_IM) to trusted guardians. Audit the IM list " +
-            "periodically. Business layer may validate status strings against an allowlist.",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (!ctx.change_status_no_permission)
-            return null;
-        return { ...R_C_01.rule, evidence: "change_status_no_permission=true" };
-    },
-};
-const R_C_02 = {
-    rule: {
-        id: "R-CONTACT-02",
-        level: "LOW",
-        category: "structural",
-        title: `MAX_IM_COUNT=${MAX_IM_COUNT} is permissive — on-chain storage cost`,
-        description: `A single Contact may hold up to MAX_IM_COUNT=${MAX_IM_COUNT} IM entries (contact.move:14). ` +
-            `Aborting with E_IM_COUNT_EXCEEDED (1) only triggers at the boundary. 200 entries is ` +
-            `relatively permissive for a social scenario; loading the full list on every read ` +
-            `increases gas and storage cost.`,
-        affected_stakeholders: ["creator"],
-        scenario: "Caller adds 200 IM entries to a single Contact",
-        mitigation: "Business layer should self-limit IM count well below 200. For high-volume contact " +
-            "lists, shard across multiple Contact objects and aggregate off-chain.",
-        related_move_error: "E_IM_COUNT_EXCEEDED (1)",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (ctx.im_count === undefined)
-            return null;
-        if (ctx.im_count < MAX_IM_COUNT)
-            return null;
-        return { ...R_C_02.rule, evidence: `im_count=${ctx.im_count}, limit=${MAX_IM_COUNT}` };
-    },
-};
-const R_C_03 = {
-    rule: {
-        id: "R-CONTACT-03",
-        level: "MEDIUM",
-        category: "semantic",
-        title: "IM list mutations emit no events — external indexers must poll",
-        description: "im_add / im_remove / im_clear do not emit events (contact.move:70-100). External " +
-            "indexers and notification systems cannot rely on event streams to track IM list " +
-            "changes; they must poll the ims field directly, increasing latency and RPC cost.",
-        affected_stakeholders: ["creator", "consumer"],
-        scenario: "Indexer expects an event on im_add but none is emitted; UI fails to refresh",
-        mitigation: "External indexers should poll the Contact.ims field on a cadence. A future version " +
-            "may add IMEvent; until then, do not build critical UX on IM event streams.",
-        auto_fixable: false,
-    },
-    check: (ctx) => null,
-};
-const R_C_04 = {
-    rule: {
-        id: "R-CONTACT-04",
-        level: "LOW",
-        category: "semantic",
-        title: "location defaults to empty string — may be misread as 'unset'",
-        description: "A freshly created Contact has location=\"\" (empty String). The Move type does not " +
-            "distinguish 'unset' from 'empty', so consumers may misinterpret an empty location " +
-            "as 'globally applicable' or as 'missing data'.",
-        affected_stakeholders: ["creator", "consumer"],
-        scenario: "Consumer reads location=\"\" and treats the Contact as global when it was never set",
-        mitigation: "Document that empty location means 'not specified'. If a default region is required, " +
-            "set location explicitly at creation time.",
-        auto_fixable: true,
-    },
-    check: (ctx) => {
-        if (!ctx.location_empty)
-            return null;
-        return { ...R_C_04.rule, evidence: "location=\"\" (empty, default)" };
-    },
-};
-const R_C_05 = {
-    rule: {
-        id: "R-CONTACT-05",
-        level: "MEDIUM",
-        category: "lifecycle",
-        title: "my_status silently fails for non-IM-members",
-        description: "my_status only updates the caller's status entry if the caller is in the ims list " +
-            "(contact.move:35-42). For a non-IM-member, the call silently succeeds without any " +
-            "state change — there is no abort and no event. Users get no feedback, making it " +
-            "impossible to distinguish 'status updated' from 'operation ignored'.",
-        affected_stakeholders: ["im_member"],
-        scenario: "Non-IM-member calls my_status expecting an error; operation is silently ignored",
-        mitigation: "SDK layer should pre-validate IM membership before submitting my_status and return a " +
-            "clear error. UI should show 'not an IM member' instead of 'success'.",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (!ctx.my_status_from_non_member)
-            return null;
-        return { ...R_C_05.rule, evidence: "my_status_from_non_member=true (will be silently ignored)" };
-    },
-};
-const R_C_06 = {
-    rule: {
-        id: "R-CONTACT-06",
-        level: "LOW",
-        category: "semantic",
-        title: "im_add description uses LONG_NAME (not DESCRIPTION) — different length cap",
-        description: "im_add's description parameter is validated with common::LONG_NAME rather than " +
-            "common::DESCRIPTION (contact.move:70-86). The two validators have different length " +
-            "limits; callers expecting DESCRIPTION semantics may submit overly long strings and " +
-            "hit an unexpected abort.",
-        affected_stakeholders: ["creator"],
-        scenario: "Caller submits an im_add description sized for DESCRIPTION but hits LONG_NAME limit",
-        mitigation: "Document that im_add description uses LONG_NAME validation. SDK should expose the " +
-            "exact limit so callers size their strings correctly.",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (!ctx.im_add_description_uses_long_name)
-            return null;
-        return { ...R_C_06.rule, evidence: "im_add description validated with LONG_NAME" };
-    },
-};
-const R_C_07 = {
-    rule: {
-        id: "R-CONTACT-07",
-        level: "MEDIUM",
-        category: "cross_object",
-        title: "permission_um_set creates Contact ↔ Permission bidirectional dependency",
-        description: "When Contact is set as a Permission's um via permission_um_set (contact.move:207-209), " +
-            "a bidirectional dependency forms: Permission.um → Contact, and Contact.permission → " +
-            "Permission. Deleting the Contact without first clearing the um reference leaves a " +
-            "dangling pointer in Permission.um.",
-        affected_stakeholders: ["creator", "consumer"],
-        scenario: "Contact is deleted while still bound as Permission.um; Permission.um becomes dangling",
-        mitigation: "Document the deletion order: (1) clear Permission.um via permission_um_set(null) " +
-            "first, (2) then delete the Contact. SDK should refuse to delete a Contact that is " +
-            "still bound as a um.",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (!ctx.bound_to_permission_um)
-            return null;
-        return { ...R_C_07.rule, evidence: "bound_to_permission_um=true (deletion requires unbinding)" };
-    },
-};
-const R_C_08 = {
-    rule: {
-        id: "R-CONTACT-08",
-        level: "LOW",
-        category: "knowledge",
-        title: "Knowledge layer & constant sync — RESOLVED",
-        description: `MAX_IM_COUNT is now synced to onchain-constants.ts (${MAX_IM_COUNT}). The MCP ` +
-            `Knowledge layer now includes contact-risk.ts. This risk rule is retained for ` +
-            `historical audit and to detect future regressions.`,
-        affected_stakeholders: ["system"],
-        scenario: "Future regression: someone removes MAX_IM_COUNT from onchain-constants.ts",
-        mitigation: "Run the onchain-constants sync test to detect drift.",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (ctx.constants_synced)
-            return null;
-        return { ...R_C_08.rule, evidence: "constants_synced=false" };
-    },
-};
-export const CONTACT_RISK_RULES = [
-    R_C_01,
-    R_C_02,
-    R_C_03,
-    R_C_04,
-    R_C_05,
-    R_C_06,
-    R_C_07,
-    R_C_08,
-];
-export const CONTACT_RISK_VERSION = "1.0.0";
-export function checkContactRisks(ctx) {
-    const risks = [];
-    for (const rule of CONTACT_RISK_RULES) {
-        const r = rule.check(ctx);
-        if (r)
-            risks.push(r);
-    }
-    if (!risks.find(r => r.id === "R-CONTACT-03")) {
-        risks.push(R_C_03.rule);
-    }
-    return risks;
-}
-export function getContactRiskById(id) {
-    return CONTACT_RISK_RULES.find(r => r.rule.id === id)?.rule;
-}
+import{MAX_IM_COUNT}from'@wowok/wowok';const R_C_01={'rule':{'id':'R-CONTACT-01','level':'MEDIUM','category':'permission','title':'change_status\x20has\x20no\x20permission\x20check\x20—\x20IM\x20list\x20pollution\x20risk','description':'change_status\x20lets\x20any\x20IM\x20member\x20self-update\x20their\x20status\x20string\x20without\x20Permission\x20'+'verification\x20(contact.move:32-43).\x20If\x20an\x20attacker\x27s\x20address\x20is\x20added\x20to\x20the\x20ims\x20list\x20'+'(via\x20im_add,\x20which\x20requires\x20permission\x20index\x20453),\x20the\x20attacker\x20can\x20freely\x20pollute\x20'+'their\x20status\x20field\x20(e.g.\x20set\x20status\x20to\x20\x27fraud\x27).\x20The\x20risk\x20is\x20bounded\x20by\x20the\x20im_add\x20'+'permission\x20gate,\x20but\x20a\x20misconfigured\x20Permission\x20could\x20expose\x20the\x20IM\x20list.','affected_stakeholders':['creator','im_member'],'scenario':'Contact\x27s\x20IM\x20list\x20is\x20misconfigured\x20to\x20allow\x20public\x20adds;\x20attacker\x20pollutes\x20status','mitigation':'Restrict\x20permission\x20index\x20453\x20(CONTACT_IM)\x20to\x20trusted\x20guardians.\x20Audit\x20the\x20IM\x20list\x20'+'periodically.\x20Business\x20layer\x20may\x20validate\x20status\x20strings\x20against\x20an\x20allowlist.','auto_fixable':![]},'check':a=>{if(!a['change_status_no_permission'])return null;return{...R_C_01['rule'],'evidence':'change_status_no_permission=true'};}},R_C_02={'rule':{'id':'R-CONTACT-02','level':'LOW','category':'structural','title':'MAX_IM_COUNT='+MAX_IM_COUNT+'\x20is\x20permissive\x20—\x20on-chain\x20storage\x20cost','description':'A\x20single\x20Contact\x20may\x20hold\x20up\x20to\x20MAX_IM_COUNT='+MAX_IM_COUNT+'\x20IM\x20entries\x20(contact.move:14).\x20'+'Aborting\x20with\x20E_IM_COUNT_EXCEEDED\x20(1)\x20only\x20triggers\x20at\x20the\x20boundary.\x20200\x20entries\x20is\x20'+'relatively\x20permissive\x20for\x20a\x20social\x20scenario;\x20loading\x20the\x20full\x20list\x20on\x20every\x20read\x20'+'increases\x20gas\x20and\x20storage\x20cost.','affected_stakeholders':['creator'],'scenario':'Caller\x20adds\x20200\x20IM\x20entries\x20to\x20a\x20single\x20Contact','mitigation':'Business\x20layer\x20should\x20self-limit\x20IM\x20count\x20well\x20below\x20200.\x20For\x20high-volume\x20contact\x20'+'lists,\x20shard\x20across\x20multiple\x20Contact\x20objects\x20and\x20aggregate\x20off-chain.','related_move_error':'E_IM_COUNT_EXCEEDED\x20(1)','auto_fixable':![]},'check':a=>{if(a['im_count']===undefined)return null;if(a['im_count']<MAX_IM_COUNT)return null;return{...R_C_02['rule'],'evidence':'im_count='+a['im_count']+',\x20limit='+MAX_IM_COUNT};}},R_C_03={'rule':{'id':'R-CONTACT-03','level':'MEDIUM','category':'semantic','title':'IM\x20list\x20mutations\x20emit\x20no\x20events\x20—\x20external\x20indexers\x20must\x20poll','description':'im_add\x20/\x20im_remove\x20/\x20im_clear\x20do\x20not\x20emit\x20events\x20(contact.move:70-100).\x20External\x20'+'indexers\x20and\x20notification\x20systems\x20cannot\x20rely\x20on\x20event\x20streams\x20to\x20track\x20IM\x20list\x20'+'changes;\x20they\x20must\x20poll\x20the\x20ims\x20field\x20directly,\x20increasing\x20latency\x20and\x20RPC\x20cost.','affected_stakeholders':['creator','consumer'],'scenario':'Indexer\x20expects\x20an\x20event\x20on\x20im_add\x20but\x20none\x20is\x20emitted;\x20UI\x20fails\x20to\x20refresh','mitigation':'External\x20indexers\x20should\x20poll\x20the\x20Contact.ims\x20field\x20on\x20a\x20cadence.\x20A\x20future\x20version\x20'+'may\x20add\x20IMEvent;\x20until\x20then,\x20do\x20not\x20build\x20critical\x20UX\x20on\x20IM\x20event\x20streams.','auto_fixable':![]},'check':a=>null},R_C_04={'rule':{'id':'R-CONTACT-04','level':'LOW','category':'semantic','title':'location\x20defaults\x20to\x20empty\x20string\x20—\x20may\x20be\x20misread\x20as\x20\x27unset\x27','description':'A\x20freshly\x20created\x20Contact\x20has\x20location=\x22\x22\x20(empty\x20String).\x20The\x20Move\x20type\x20does\x20not\x20'+'distinguish\x20\x27unset\x27\x20from\x20\x27empty\x27,\x20so\x20consumers\x20may\x20misinterpret\x20an\x20empty\x20location\x20'+'as\x20\x27globally\x20applicable\x27\x20or\x20as\x20\x27missing\x20data\x27.','affected_stakeholders':['creator','consumer'],'scenario':'Consumer\x20reads\x20location=\x22\x22\x20and\x20treats\x20the\x20Contact\x20as\x20global\x20when\x20it\x20was\x20never\x20set','mitigation':'Document\x20that\x20empty\x20location\x20means\x20\x27not\x20specified\x27.\x20If\x20a\x20default\x20region\x20is\x20required,\x20'+'set\x20location\x20explicitly\x20at\x20creation\x20time.','auto_fixable':!![]},'check':a=>{if(!a['location_empty'])return null;return{...R_C_04['rule'],'evidence':'location=\x22\x22\x20(empty,\x20default)'};}},R_C_05={'rule':{'id':'R-CONTACT-05','level':'MEDIUM','category':'lifecycle','title':'my_status\x20silently\x20fails\x20for\x20non-IM-members','description':'my_status\x20only\x20updates\x20the\x20caller\x27s\x20status\x20entry\x20if\x20the\x20caller\x20is\x20in\x20the\x20ims\x20list\x20'+'(contact.move:35-42).\x20For\x20a\x20non-IM-member,\x20the\x20call\x20silently\x20succeeds\x20without\x20any\x20'+'state\x20change\x20—\x20there\x20is\x20no\x20abort\x20and\x20no\x20event.\x20Users\x20get\x20no\x20feedback,\x20making\x20it\x20'+'impossible\x20to\x20distinguish\x20\x27status\x20updated\x27\x20from\x20\x27operation\x20ignored\x27.','affected_stakeholders':['im_member'],'scenario':'Non-IM-member\x20calls\x20my_status\x20expecting\x20an\x20error;\x20operation\x20is\x20silently\x20ignored','mitigation':'SDK\x20layer\x20should\x20pre-validate\x20IM\x20membership\x20before\x20submitting\x20my_status\x20and\x20return\x20a\x20'+'clear\x20error.\x20UI\x20should\x20show\x20\x27not\x20an\x20IM\x20member\x27\x20instead\x20of\x20\x27success\x27.','auto_fixable':![]},'check':a=>{if(!a['my_status_from_non_member'])return null;return{...R_C_05['rule'],'evidence':'my_status_from_non_member=true\x20(will\x20be\x20silently\x20ignored)'};}},R_C_06={'rule':{'id':'R-CONTACT-06','level':'LOW','category':'semantic','title':'im_add\x20description\x20uses\x20LONG_NAME\x20(not\x20DESCRIPTION)\x20—\x20different\x20length\x20cap','description':'im_add\x27s\x20description\x20parameter\x20is\x20validated\x20with\x20common::LONG_NAME\x20rather\x20than\x20'+'common::DESCRIPTION\x20(contact.move:70-86).\x20The\x20two\x20validators\x20have\x20different\x20length\x20'+'limits;\x20callers\x20expecting\x20DESCRIPTION\x20semantics\x20may\x20submit\x20overly\x20long\x20strings\x20and\x20'+'hit\x20an\x20unexpected\x20abort.','affected_stakeholders':['creator'],'scenario':'Caller\x20submits\x20an\x20im_add\x20description\x20sized\x20for\x20DESCRIPTION\x20but\x20hits\x20LONG_NAME\x20limit','mitigation':'Document\x20that\x20im_add\x20description\x20uses\x20LONG_NAME\x20validation.\x20SDK\x20should\x20expose\x20the\x20'+'exact\x20limit\x20so\x20callers\x20size\x20their\x20strings\x20correctly.','auto_fixable':![]},'check':a=>{if(!a['im_add_description_uses_long_name'])return null;return{...R_C_06['rule'],'evidence':'im_add\x20description\x20validated\x20with\x20LONG_NAME'};}},R_C_07={'rule':{'id':'R-CONTACT-07','level':'MEDIUM','category':'cross_object','title':'permission_um_set\x20creates\x20Contact\x20↔\x20Permission\x20bidirectional\x20dependency','description':'When\x20Contact\x20is\x20set\x20as\x20a\x20Permission\x27s\x20um\x20via\x20permission_um_set\x20(contact.move:207-209),\x20'+'a\x20bidirectional\x20dependency\x20forms:\x20Permission.um\x20→\x20Contact,\x20and\x20Contact.permission\x20→\x20'+'Permission.\x20Deleting\x20the\x20Contact\x20without\x20first\x20clearing\x20the\x20um\x20reference\x20leaves\x20a\x20'+'dangling\x20pointer\x20in\x20Permission.um.','affected_stakeholders':['creator','consumer'],'scenario':'Contact\x20is\x20deleted\x20while\x20still\x20bound\x20as\x20Permission.um;\x20Permission.um\x20becomes\x20dangling','mitigation':'Document\x20the\x20deletion\x20order:\x20(1)\x20clear\x20Permission.um\x20via\x20permission_um_set(null)\x20'+'first,\x20(2)\x20then\x20delete\x20the\x20Contact.\x20SDK\x20should\x20refuse\x20to\x20delete\x20a\x20Contact\x20that\x20is\x20'+'still\x20bound\x20as\x20a\x20um.','auto_fixable':![]},'check':a=>{if(!a['bound_to_permission_um'])return null;return{...R_C_07['rule'],'evidence':'bound_to_permission_um=true\x20(deletion\x20requires\x20unbinding)'};}},R_C_08={'rule':{'id':'R-CONTACT-08','level':'LOW','category':'knowledge','title':'Knowledge\x20layer\x20&\x20constant\x20sync\x20—\x20RESOLVED','description':'MAX_IM_COUNT\x20is\x20now\x20synced\x20to\x20onchain-constants.ts\x20('+MAX_IM_COUNT+').\x20The\x20MCP\x20'+'Knowledge\x20layer\x20now\x20includes\x20contact-risk.ts.\x20This\x20risk\x20rule\x20is\x20retained\x20for\x20'+'historical\x20audit\x20and\x20to\x20detect\x20future\x20regressions.','affected_stakeholders':['system'],'scenario':'Future\x20regression:\x20someone\x20removes\x20MAX_IM_COUNT\x20from\x20onchain-constants.ts','mitigation':'Run\x20the\x20onchain-constants\x20sync\x20test\x20to\x20detect\x20drift.','auto_fixable':![]},'check':a=>{if(a['constants_synced'])return null;return{...R_C_08['rule'],'evidence':'constants_synced=false'};}};export const CONTACT_RISK_RULES=[R_C_01,R_C_02,R_C_03,R_C_04,R_C_05,R_C_06,R_C_07,R_C_08];export const CONTACT_RISK_VERSION='1.0.0';export function checkContactRisks(a){const b=[];for(const c of CONTACT_RISK_RULES){const d=c['check'](a);if(d)b['push'](d);}return!b['find'](e=>e['id']==='R-CONTACT-03')&&b['push'](R_C_03['rule']),b;}export function getContactRiskById(a){return CONTACT_RISK_RULES['find'](b=>b['rule']['id']===a)?.['rule'];}

package/dist/knowledge/contact-templates.js

@@ -1,60 +1 @@
-export const CONTACT_TEMPLATES = [
-    {
-        id: "T-C-01",
-        name: "Basic contact",
-        description: "Named contact with a permission reference and description. Bind to a Service via `um`.",
-        applicable_scenes: ["contact_basic"],
-        industry_tags: ["universal"],
-        params: [
-            { name: "name", type: "string", description: "Contact object name", required: true },
-            { name: "permission", type: "string", description: "Permission object name/address", required: true },
-            { name: "description", type: "string", description: "Contact description shown to customers", required: true },
-        ],
-        body: (p) => ({
-            object: { name: p.name, permission: p.permission, replaceExistName: true },
-            description: p.description,
-        }),
-        notes: ["Bind this contact to a Service via the service call's 'um' field"],
-    },
-    {
-        id: "T-C-02",
-        name: "Support contact with IM",
-        description: "Contact with an initial IM entry pointing at a support account (after-sales / pre-order).",
-        applicable_scenes: ["contact_support"],
-        industry_tags: ["retail", "rental", "education", "travel", "freelance", "subscription"],
-        params: [
-            { name: "name", type: "string", description: "Contact object name", required: true },
-            { name: "permission", type: "string", description: "Permission object name/address", required: true },
-            { name: "description", type: "string", description: "Contact description shown to customers", required: true },
-            { name: "support_account", type: "string", description: "Support account name or 0x address for IM", required: true },
-            { name: "im_description", type: "string", description: "IM entry description (e.g. 'Primary support representative')", required: true },
-        ],
-        body: (p) => ({
-            object: { name: p.name, permission: p.permission, replaceExistName: true },
-            description: p.description,
-            ims: {
-                op: "add",
-                im: [{ at: p.support_account, description: p.im_description }],
-            },
-        }),
-        notes: [
-            "ims.im[].at accepts an account name or a full 0x address",
-            "ims is an op discriminated union — {op:'add'|'set'|'remove'|'clear'}",
-        ],
-    },
-];
-export const CONTACT_TEMPLATES_VERSION = "1.0.0";
-export function getContactTemplateById(id) {
-    return CONTACT_TEMPLATES.find((t) => t.id === id);
-}
-export function fillTemplate(templateId, params) {
-    const tpl = getContactTemplateById(templateId);
-    if (!tpl)
-        return { ok: false, error: `Template ${templateId} not found` };
-    for (const p of tpl.params) {
-        if (p.required && !(p.name in params)) {
-            return { ok: false, error: `Missing required param: ${p.name}` };
-        }
-    }
-    return { ok: true, body: tpl.body(params) };
-}
+export const CONTACT_TEMPLATES=[{'id':'T-C-01','name':'Basic\x20contact','description':'Named\x20contact\x20with\x20a\x20permission\x20reference\x20and\x20description.\x20Bind\x20to\x20a\x20Service\x20via\x20`um`.','applicable_scenes':['contact_basic'],'industry_tags':['universal'],'params':[{'name':'name','type':'string','description':'Contact\x20object\x20name','required':!![]},{'name':'permission','type':'string','description':'Permission\x20object\x20name/address','required':!![]},{'name':'description','type':'string','description':'Contact\x20description\x20shown\x20to\x20customers','required':!![]}],'body':a=>({'object':{'name':a['name'],'permission':a['permission'],'replaceExistName':!![]},'description':a['description']}),'notes':['Bind\x20this\x20contact\x20to\x20a\x20Service\x20via\x20the\x20service\x20call\x27s\x20\x27um\x27\x20field']},{'id':'T-C-02','name':'Support\x20contact\x20with\x20IM','description':'Contact\x20with\x20an\x20initial\x20IM\x20entry\x20pointing\x20at\x20a\x20support\x20account\x20(after-sales\x20/\x20pre-order).','applicable_scenes':['contact_support'],'industry_tags':['retail','rental','education','travel','freelance','subscription'],'params':[{'name':'name','type':'string','description':'Contact\x20object\x20name','required':!![]},{'name':'permission','type':'string','description':'Permission\x20object\x20name/address','required':!![]},{'name':'description','type':'string','description':'Contact\x20description\x20shown\x20to\x20customers','required':!![]},{'name':'support_account','type':'string','description':'Support\x20account\x20name\x20or\x200x\x20address\x20for\x20IM','required':!![]},{'name':'im_description','type':'string','description':'IM\x20entry\x20description\x20(e.g.\x20\x27Primary\x20support\x20representative\x27)','required':!![]}],'body':a=>({'object':{'name':a['name'],'permission':a['permission'],'replaceExistName':!![]},'description':a['description'],'ims':{'op':'add','im':[{'at':a['support_account'],'description':a['im_description']}]}}),'notes':['ims.im[].at\x20accepts\x20an\x20account\x20name\x20or\x20a\x20full\x200x\x20address','ims\x20is\x20an\x20op\x20discriminated\x20union\x20—\x20{op:\x27add\x27|\x27set\x27|\x27remove\x27|\x27clear\x27}']}];export const CONTACT_TEMPLATES_VERSION='1.0.0';export function getContactTemplateById(a){return CONTACT_TEMPLATES['find'](b=>b['id']===a);}export function fillTemplate(a,b){const c=getContactTemplateById(a);if(!c)return{'ok':![],'error':'Template\x20'+a+'\x20not\x20found'};for(const d of c['params']){if(d['required']&&!(d['name']in b))return{'ok':![],'error':'Missing\x20required\x20param:\x20'+d['name']};}return{'ok':!![],'body':c['body'](b)};}

package/dist/knowledge/contact-translation.d.ts

@@ -0,0 +1,39 @@
+export declare const CONTACT_TRANSLATION_VERSION = "1.0.0";
+export interface SemanticToContactSchemaRule {
+    id: string;
+    pattern_name: string;
+    semantic_intent: string;
+    match_keywords: string[];
+    required_fields: string[];
+    optional_fields: string[];
+    example: Record<string, unknown>;
+}
+export declare const SEMANTIC_TO_CONTACT_SCHEMA_RULES: SemanticToContactSchemaRule[];
+export interface ContactFieldTranslation {
+    field_name: string;
+    value_type: string;
+    semantic: string;
+    format_example: string;
+    validation_rules: string[];
+}
+export declare const CONTACT_FIELD_TRANSLATIONS: ContactFieldTranslation[];
+export interface ContactConstraintRule {
+    id: string;
+    name: string;
+    description: string;
+    related_field: string;
+}
+export declare const CONTACT_CONSTRAINT_RULES: ContactConstraintRule[];
+export interface ContactExplainInput {
+    description?: string;
+    location?: string;
+    im_count?: number;
+    bound_to_permission_um?: boolean;
+}
+export interface ContactExplanation {
+    summary: string;
+    location_status: string;
+    im_status: string;
+    warnings: string[];
+}
+export declare function explainContact(input: ContactExplainInput): ContactExplanation;

package/dist/knowledge/contact-translation.js

@@ -0,0 +1 @@
+import{MAX_IM_COUNT}from'@wowok/wowok';export const CONTACT_TRANSLATION_VERSION='1.0.0';export const SEMANTIC_TO_CONTACT_SCHEMA_RULES=[{'id':'P-CONTACT-01','pattern_name':'Create\x20contact','semantic_intent':'Create\x20a\x20shared\x20Contact\x20object\x20owned\x20by\x20a\x20Permission\x20(index\x20450).','match_keywords':['create\x20contact','new\x20contact','customer\x20service'],'required_fields':['permission','description'],'optional_fields':[],'example':{'description':'Customer\x20service\x20contact'}},{'id':'P-CONTACT-02','pattern_name':'Add\x20IM\x20member','semantic_intent':'Add\x20an\x20IM\x20entry\x20to\x20the\x20contact\x20list\x20(permission\x20index\x20453).','match_keywords':['add\x20im','add\x20member','add\x20contact\x20im'],'required_fields':['im'],'optional_fields':['description'],'example':{'im':'0x...','description':'support\x20desk'}},{'id':'P-CONTACT-03','pattern_name':'Set\x20location','semantic_intent':'Set\x20the\x20contact\x27s\x20geographic\x20region\x20(permission\x20index\x20452,\x20LONG_NAME).','match_keywords':['set\x20location','update\x20location'],'required_fields':['location'],'optional_fields':[],'example':{'location':'cn-guangdong-shenzhen'}}];export const CONTACT_FIELD_TRANSLATIONS=[{'field_name':'description','value_type':'string','semantic':'Human-readable\x20description\x20of\x20the\x20Contact\x20(common::DESCRIPTION\x20validation).','format_example':'Customer\x20service\x20contact','validation_rules':['common::DESCRIPTION\x20max\x20length']},{'field_name':'location','value_type':'string','semantic':'Geographic\x20region\x20string;\x20defaults\x20to\x20empty\x20(unset).','format_example':'cn-guangdong-shenzhen','validation_rules':['common::LONG_NAME\x20validation','empty\x20means\x20unset']},{'field_name':'ims','value_type':'vector<Im>','semantic':'IM\x20entry\x20list\x20(≤\x20MAX_IM_COUNT\x20'+MAX_IM_COUNT+').\x20Each\x20Im\x20has\x20at/status/join_time/description.','format_example':'[{at,\x20status,\x20join_time,\x20description}]','validation_rules':['im_add\x20aborts\x20E_IM_COUNT_EXCEEDED\x20(1)\x20at\x20cap']},{'field_name':'permission','value_type':'address','semantic':'Owning\x20Permission\x20address\x20(set\x20at\x20creation).','format_example':'0x...permission...','validation_rules':['set\x20via\x20new(permission,\x20…)\x20index\x20450']}];export const CONTACT_CONSTRAINT_RULES=[{'id':'CONTACT_C_01','name':'IM\x20count\x20cap','description':'ims\x20length\x20<\x20MAX_IM_COUNT\x20('+MAX_IM_COUNT+').','related_field':'ims'},{'id':'CONTACT_C_02','name':'description\x20validation','description':'description\x20uses\x20common::DESCRIPTION.','related_field':'description'},{'id':'CONTACT_C_03','name':'location\x20validation','description':'location\x20uses\x20common::LONG_NAME.','related_field':'location'},{'id':'CONTACT_C_04','name':'im\x20description\x20validation','description':'im_add\x20description\x20uses\x20common::LONG_NAME\x20(not\x20DESCRIPTION).','related_field':'ims'},{'id':'CONTACT_C_05','name':'permission\x20gating','description':'create=450,\x20description_set=451,\x20location_set=452,\x20im_add/remove/clear=453,\x20owner_receive=454.','related_field':'permission'}];export function explainContact(a){const b=[],c=a['location']?'location=\x22'+a['location']+'\x22':'location\x20unset\x20(empty\x20string)',d=a['im_count']!==undefined?a['im_count']+'/'+MAX_IM_COUNT+'\x20IM\x20entries':'IM\x20count\x20unknown';return a['im_count']!==undefined&&a['im_count']>=MAX_IM_COUNT&&b['push']('IM\x20list\x20at\x20cap\x20('+MAX_IM_COUNT+');\x20im_add\x20will\x20abort\x20E_IM_COUNT_EXCEEDED'),a['bound_to_permission_um']&&b['push']('Contact\x20is\x20bound\x20as\x20Permission.um;\x20unbind\x20before\x20deletion'),{'summary':'Contact\x20('+(a['description']??'no\x20description')+').\x20'+c+'.\x20'+d+'.','location_status':c,'im_status':d,'warnings':b};}

package/dist/knowledge/demand-confirm.js

@@ -1,206 +1 @@
-import { MAX_REWARD_COUNT, MAX_GUARD_COUNT_DEMAND, MAX_DESCRIPTION_LENGTH, MAX_LONG_NAME_LENGTH, } from "@wowok/wowok";
-const MAX_FEEDBACK_COUNT = 20;
-function checkDescription(input) {
-    const len = input.description?.length ?? 0;
-    const passed = len > 0 && len <= MAX_DESCRIPTION_LENGTH;
-    return {
-        id: "C-DEM-01",
-        severity: passed ? "info" : (len === 0 ? "warn" : "block"),
-        title: `description non-empty and within MAX_DESCRIPTION_LENGTH (${MAX_DESCRIPTION_LENGTH} chars)`,
-        description: "description is a REQUIRED field. Move contract validates via common::DESCRIPTION (demand.move:157,177). " +
-            "Empty string is technically rejected by common::DESCRIPTION only if NAME_ALLOW_EMPTY is not used; the new_imp " +
-            "path uses common::DESCRIPTION which allows empty but enforces the 4000-char limit. Non-empty descriptions are " +
-            "strongly recommended for Demand discoverability.",
-        passed,
-        evidence: input.description === undefined ? "undefined" : `length=${len}, limit=${MAX_DESCRIPTION_LENGTH}`,
-        fix_hint: passed ? undefined : `Provide a description of 1..${MAX_DESCRIPTION_LENGTH} characters.`,
-    };
-}
-function checkLocation(input) {
-    const len = input.location?.length ?? 0;
-    const passed = len <= MAX_LONG_NAME_LENGTH;
-    return {
-        id: "C-DEM-02",
-        severity: passed ? "info" : "block",
-        title: `location within MAX_LONG_NAME_LENGTH (${MAX_LONG_NAME_LENGTH} chars)`,
-        description: "location is set via location_set_imp (demand.move:179-182) which validates via common::LONG_NAME. " +
-            "Move aborts with E_LONG_NAME_LENGTH_EXCEEDED (11) on overflow. Empty location (\"\") is valid — new_imp " +
-            "initializes location to empty string. Use location_set to update after creation.",
-        passed,
-        evidence: input.location === undefined ? "undefined" : `length=${len}, limit=${MAX_LONG_NAME_LENGTH}`,
-        fix_hint: passed ? undefined : `Trim location to ≤ ${MAX_LONG_NAME_LENGTH} characters.`,
-    };
-}
-function checkRewards(input) {
-    const count = input.rewards?.length ?? 0;
-    const passed = count <= MAX_REWARD_COUNT;
-    return {
-        id: "C-DEM-03",
-        severity: passed ? "info" : "block",
-        title: `rewards count within MAX_REWARD_COUNT (${MAX_REWARD_COUNT})`,
-        description: "Each reward_add_imp (demand.move:184-191) checks `vector::length(&self.rewards) < MAX_REWARD_COUNT` " +
-            "before pushing (after de-duplication). Move aborts with E_MAX_REWARD_COUNT_EXCEEDED (1) on overflow. " +
-            "Rewards are affiliated via the Registrar — adding/removing triggers affiliation/disaffiliation.",
-        passed,
-        evidence: `count=${count}, limit=${MAX_REWARD_COUNT}`,
-        fix_hint: passed ? undefined : `Remove rewards before adding new ones. Limit=${MAX_REWARD_COUNT}.`,
-    };
-}
-function checkGuards(input) {
-    const count = input.guards?.length ?? 0;
-    const passed = count <= MAX_GUARD_COUNT_DEMAND;
-    return {
-        id: "C-DEM-04",
-        severity: passed ? "info" : "block",
-        title: `guards count within MAX_GUARD_COUNT_DEMAND (${MAX_GUARD_COUNT_DEMAND})`,
-        description: "Each guard_add_imp (demand.move:213-242) checks `vector::length(&self.guards) < MAX_GUARD_COUNT` " +
-            "before pushing (after duplicate check — duplicates update service_identifier in place). " +
-            "Move aborts with E_MAX_GUARD_COUNT_EXCEEDED (2) on overflow. Guards are affiliated via the Registrar.",
-        passed,
-        evidence: `count=${count}, limit=${MAX_GUARD_COUNT_DEMAND}`,
-        fix_hint: passed ? undefined : `Remove guards before adding new ones. Limit=${MAX_GUARD_COUNT_DEMAND}.`,
-    };
-}
-function checkFeedback(input) {
-    const count = input.feedback?.length ?? 0;
-    const passed = count <= MAX_FEEDBACK_COUNT;
-    return {
-        id: "C-DEM-05",
-        severity: passed ? "info" : "block",
-        title: `feedback batch count within MAX_FEEDBACK_COUNT (${MAX_FEEDBACK_COUNT})`,
-        description: "Move feedback (demand.move:352) updates ONE presenter per call — feedback_imp writes to a single " +
-            "ServiceInfo record. The SDK batches multiple feedback calls and caps the batch at MAX_FEEDBACK_COUNT=" +
-            `${MAX_FEEDBACK_COUNT} (SDK-only limit, NOT in onchain-constants.ts). Exceeding the SDK batch limit is ` +
-            "rejected before transaction building. Each feedback string is validated by common::DESCRIPTION (4000 chars).",
-        passed,
-        evidence: `count=${count}, limit=${MAX_FEEDBACK_COUNT}`,
-        fix_hint: passed ? undefined : `Split feedback into batches of ≤ ${MAX_FEEDBACK_COUNT} entries.`,
-    };
-}
-function checkServiceIdentifier(input) {
-    const sid = input.service_identifier;
-    if (sid === null || sid === undefined) {
-        return {
-            id: "C-DEM-06",
-            severity: "info",
-            title: "service_identifier is null/undefined → Option::none (use supplied service address)",
-            description: "When service_identifier is None, guard_add_imp stores Option::none in ServiceGuard. At present_with_passport " +
-                "time, present_with_passport_imp uses the service parameter (or Option::none for plain present_with_passport). " +
-                "Use None when the Demand does not need to route presentations through a specific Service submission.",
-            passed: true,
-            evidence: "null/undefined → Option::none",
-        };
-    }
-    const isU8 = typeof sid === "number" && Number.isInteger(sid) && sid >= 0 && sid <= 255;
-    return {
-        id: "C-DEM-06",
-        severity: isU8 ? "info" : "block",
-        title: "service_identifier is a valid u8 (0-255) when provided",
-        description: "When provided, service_identifier must be a u8 index into the Guard's submission registry. " +
-            "guard_add_imp (demand.move:218-222) calls guard::get_submission_object_type(guard, *i) and " +
-            "common::assert_service_object_type(t) — the submission at that index MUST exist and have type " +
-            "ObjectType::Service. At present_with_passport time, the submission address is extracted from the Passport " +
-            "via passport::submission_get(passport, &g, *service_identifier).",
-        passed: isU8,
-        evidence: `service_identifier=${sid}`,
-        fix_hint: isU8 ? undefined : "Provide an integer in [0, 255] that indexes a Service-typed submission in the Guard.",
-    };
-}
-function checkByGuard(input) {
-    const byGuard = input.by_guard;
-    if (byGuard === null || byGuard === undefined) {
-        return {
-            id: "C-DEM-07",
-            severity: "info",
-            title: "by_guard is null → use plain present (requires empty guards vector)",
-            description: "When by_guard is None, the caller uses plain present (demand.move:100) which asserts " +
-                "`vector::is_empty(&self.guards)` — aborts with E_NEED_PASSPORT (3) if guards exist. Use this path " +
-                "for open Demands (no guards).",
-            passed: true,
-            evidence: "null/undefined → plain present path",
-        };
-    }
-    if (input.guards === undefined) {
-        return {
-            id: "C-DEM-07",
-            severity: "info",
-            title: "by_guard provided (cannot verify membership — guards list not supplied)",
-            description: "present_with_passport_imp (demand.move:110-129) iterates the guards vector looking for a matching " +
-                "guard address. If not found, it aborts with E_GUARD_NOT_FOUND (4). The caller must ensure by_guard " +
-                "is in Demand.guards — this check could not verify because the guards list was not supplied.",
-            passed: true,
-            evidence: `by_guard=${byGuard.substring(0, 10)}... (guards list not supplied)`,
-            fix_hint: "Pass input.guards to enable membership verification.",
-        };
-    }
-    const isInGuards = input.guards.includes(byGuard);
-    return {
-        id: "C-DEM-07",
-        severity: isInGuards ? "info" : "block",
-        title: "by_guard exists in Demand.guards (when specified)",
-        description: "When by_guard is specified, present_with_passport_imp (demand.move:110-129) iterates the guards vector " +
-            "looking for a matching guard address. If not found, it aborts with E_GUARD_NOT_FOUND (4). The caller " +
-            "MUST ensure by_guard was previously added via guard_add.",
-        passed: isInGuards,
-        evidence: `by_guard=${byGuard.substring(0, 10)}..., in guards=${isInGuards}`,
-        fix_hint: isInGuards ? undefined : "Call guard_add(permission, guard, service_identifier) first.",
-    };
-}
-function checkPermissionSetAvailable(input) {
-    const available = input.permission_set_available !== false;
-    return {
-        id: "C-DEM-08",
-        severity: available ? "info" : "warn",
-        title: "permission_set available via CallPermission.apply (DE-D-2=A)",
-        description: "The Move permission_set function (demand.move:286) is exposed in the SDK via the CallPermission.apply " +
-            "mechanism (DE-D-2=A). It calls permission::assert_owner(old) and registrar::affiliation_change to migrate " +
-            "the affiliation. Permission indices for Demand (demand.move:20): 400=DEMAND_NEW, 401=DEMAND_DESCRIPTION, " +
-            "402=DEMAND_LOCATION, 404=DEMAND_GUARD, 405=DEMAND_REWARD, 406=DEMAND_FEEDBACK, 407=DEMAND_OWNER_RECEIVE, " +
-            "408=DEMAND_UM. This is an info check — it confirms the capability is available, not a creation prerequisite.",
-        passed: available,
-        evidence: available ? "exposed via CallPermission.apply" : "not available (regression)",
-        fix_hint: available ? undefined : "Restore the CallPermission.apply path for permission_set.",
-    };
-}
-export function preCheckDemandCreation(input) {
-    return [
-        checkDescription(input),
-        checkLocation(input),
-        checkRewards(input),
-        checkGuards(input),
-        checkFeedback(input),
-        checkServiceIdentifier(input),
-        checkByGuard(input),
-        checkPermissionSetAvailable(input),
-    ];
-}
-export function canCreateDemand(input) {
-    const items = preCheckDemandCreation(input);
-    return {
-        canCreate: items.every(i => i.severity !== "block" || i.passed),
-        blockers: items.filter(i => i.severity === "block" && !i.passed),
-        warnings: items.filter(i => i.severity === "warn" && !i.passed),
-        info: items.filter(i => i.severity === "info"),
-    };
-}
-export function formatDemandCreationSummary(input) {
-    const { canCreate, blockers, warnings, info } = canCreateDemand(input);
-    const lines = [];
-    lines.push(canCreate ? "✓ Demand pre-check PASSED" : "✗ Demand pre-check FAILED");
-    lines.push("");
-    if (blockers.length > 0) {
-        lines.push("BLOCKERS (must fix before operation):");
-        blockers.forEach(b => lines.push(`  [${b.id}] ${b.title} — ${b.evidence ?? ""}`));
-        lines.push("");
-    }
-    if (warnings.length > 0) {
-        lines.push("WARNINGS (review recommended):");
-        warnings.forEach(w => lines.push(`  [${w.id}] ${w.title} — ${w.evidence ?? ""}`));
-        lines.push("");
-    }
-    if (info.length > 0) {
-        lines.push("INFO:");
-        info.forEach(i => lines.push(`  [${i.id}] ${i.title}`));
-    }
-    return lines.join("\n");
-}
+import{MAX_REWARD_COUNT,MAX_GUARD_COUNT_DEMAND,MAX_DESCRIPTION_LENGTH,MAX_LONG_NAME_LENGTH}from'@wowok/wowok';const MAX_FEEDBACK_COUNT=0x14;function checkDescription(a){const b=a['description']?.['length']??0x0,c=b>0x0&&b<=MAX_DESCRIPTION_LENGTH;return{'id':'C-DEM-01','severity':c?'info':b===0x0?'warn':'block','title':'description\x20non-empty\x20and\x20within\x20MAX_DESCRIPTION_LENGTH\x20('+MAX_DESCRIPTION_LENGTH+'\x20chars)','description':'description\x20is\x20a\x20REQUIRED\x20field.\x20Move\x20contract\x20validates\x20via\x20common::DESCRIPTION\x20(demand.move:157,177).\x20'+'Empty\x20string\x20is\x20technically\x20rejected\x20by\x20common::DESCRIPTION\x20only\x20if\x20NAME_ALLOW_EMPTY\x20is\x20not\x20used;\x20the\x20new_imp\x20'+'path\x20uses\x20common::DESCRIPTION\x20which\x20allows\x20empty\x20but\x20enforces\x20the\x204000-char\x20limit.\x20Non-empty\x20descriptions\x20are\x20'+'strongly\x20recommended\x20for\x20Demand\x20discoverability.','passed':c,'evidence':a['description']===undefined?'undefined':'length='+b+',\x20limit='+MAX_DESCRIPTION_LENGTH,'fix_hint':c?undefined:'Provide\x20a\x20description\x20of\x201..'+MAX_DESCRIPTION_LENGTH+'\x20characters.'};}function checkLocation(a){const b=a['location']?.['length']??0x0,c=b<=MAX_LONG_NAME_LENGTH;return{'id':'C-DEM-02','severity':c?'info':'block','title':'location\x20within\x20MAX_LONG_NAME_LENGTH\x20('+MAX_LONG_NAME_LENGTH+'\x20chars)','description':'location\x20is\x20set\x20via\x20location_set_imp\x20(demand.move:179-182)\x20which\x20validates\x20via\x20common::LONG_NAME.\x20'+'Move\x20aborts\x20with\x20E_LONG_NAME_LENGTH_EXCEEDED\x20(11)\x20on\x20overflow.\x20Empty\x20location\x20(\x22\x22)\x20is\x20valid\x20—\x20new_imp\x20'+'initializes\x20location\x20to\x20empty\x20string.\x20Use\x20location_set\x20to\x20update\x20after\x20creation.','passed':c,'evidence':a['location']===undefined?'undefined':'length='+b+',\x20limit='+MAX_LONG_NAME_LENGTH,'fix_hint':c?undefined:'Trim\x20location\x20to\x20≤\x20'+MAX_LONG_NAME_LENGTH+'\x20characters.'};}function checkRewards(a){const b=a['rewards']?.['length']??0x0,c=b<=MAX_REWARD_COUNT;return{'id':'C-DEM-03','severity':c?'info':'block','title':'rewards\x20count\x20within\x20MAX_REWARD_COUNT\x20('+MAX_REWARD_COUNT+')','description':'Each\x20reward_add_imp\x20(demand.move:184-191)\x20checks\x20`vector::length(&self.rewards)\x20<\x20MAX_REWARD_COUNT`\x20'+'before\x20pushing\x20(after\x20de-duplication).\x20Move\x20aborts\x20with\x20E_MAX_REWARD_COUNT_EXCEEDED\x20(1)\x20on\x20overflow.\x20'+'Rewards\x20are\x20affiliated\x20via\x20the\x20Registrar\x20—\x20adding/removing\x20triggers\x20affiliation/disaffiliation.','passed':c,'evidence':'count='+b+',\x20limit='+MAX_REWARD_COUNT,'fix_hint':c?undefined:'Remove\x20rewards\x20before\x20adding\x20new\x20ones.\x20Limit='+MAX_REWARD_COUNT+'.'};}function checkGuards(a){const b=a['guards']?.['length']??0x0,c=b<=MAX_GUARD_COUNT_DEMAND;return{'id':'C-DEM-04','severity':c?'info':'block','title':'guards\x20count\x20within\x20MAX_GUARD_COUNT_DEMAND\x20('+MAX_GUARD_COUNT_DEMAND+')','description':'Each\x20guard_add_imp\x20(demand.move:213-242)\x20checks\x20`vector::length(&self.guards)\x20<\x20MAX_GUARD_COUNT`\x20'+'before\x20pushing\x20(after\x20duplicate\x20check\x20—\x20duplicates\x20update\x20service_identifier\x20in\x20place).\x20'+'Move\x20aborts\x20with\x20E_MAX_GUARD_COUNT_EXCEEDED\x20(2)\x20on\x20overflow.\x20Guards\x20are\x20affiliated\x20via\x20the\x20Registrar.','passed':c,'evidence':'count='+b+',\x20limit='+MAX_GUARD_COUNT_DEMAND,'fix_hint':c?undefined:'Remove\x20guards\x20before\x20adding\x20new\x20ones.\x20Limit='+MAX_GUARD_COUNT_DEMAND+'.'};}function checkFeedback(a){const b=a['feedback']?.['length']??0x0,c=b<=MAX_FEEDBACK_COUNT;return{'id':'C-DEM-05','severity':c?'info':'block','title':'feedback\x20batch\x20count\x20within\x20MAX_FEEDBACK_COUNT\x20('+MAX_FEEDBACK_COUNT+')','description':'Move\x20feedback\x20(demand.move:352)\x20updates\x20ONE\x20presenter\x20per\x20call\x20—\x20feedback_imp\x20writes\x20to\x20a\x20single\x20'+'ServiceInfo\x20record.\x20The\x20SDK\x20batches\x20multiple\x20feedback\x20calls\x20and\x20caps\x20the\x20batch\x20at\x20MAX_FEEDBACK_COUNT='+(MAX_FEEDBACK_COUNT+'\x20(SDK-only\x20limit,\x20NOT\x20in\x20onchain-constants.ts).\x20Exceeding\x20the\x20SDK\x20batch\x20limit\x20is\x20')+'rejected\x20before\x20transaction\x20building.\x20Each\x20feedback\x20string\x20is\x20validated\x20by\x20common::DESCRIPTION\x20(4000\x20chars).','passed':c,'evidence':'count='+b+',\x20limit='+MAX_FEEDBACK_COUNT,'fix_hint':c?undefined:'Split\x20feedback\x20into\x20batches\x20of\x20≤\x20'+MAX_FEEDBACK_COUNT+'\x20entries.'};}function checkServiceIdentifier(a){const b=a['service_identifier'];if(b===null||b===undefined)return{'id':'C-DEM-06','severity':'info','title':'service_identifier\x20is\x20null/undefined\x20→\x20Option::none\x20(use\x20supplied\x20service\x20address)','description':'When\x20service_identifier\x20is\x20None,\x20guard_add_imp\x20stores\x20Option::none\x20in\x20ServiceGuard.\x20At\x20present_with_passport\x20'+'time,\x20present_with_passport_imp\x20uses\x20the\x20service\x20parameter\x20(or\x20Option::none\x20for\x20plain\x20present_with_passport).\x20'+'Use\x20None\x20when\x20the\x20Demand\x20does\x20not\x20need\x20to\x20route\x20presentations\x20through\x20a\x20specific\x20Service\x20submission.','passed':!![],'evidence':'null/undefined\x20→\x20Option::none'};const c=typeof b==='number'&&Number['isInteger'](b)&&b>=0x0&&b<=0xff;return{'id':'C-DEM-06','severity':c?'info':'block','title':'service_identifier\x20is\x20a\x20valid\x20u8\x20(0-255)\x20when\x20provided','description':'When\x20provided,\x20service_identifier\x20must\x20be\x20a\x20u8\x20index\x20into\x20the\x20Guard\x27s\x20submission\x20registry.\x20'+'guard_add_imp\x20(demand.move:218-222)\x20calls\x20guard::get_submission_object_type(guard,\x20*i)\x20and\x20'+'common::assert_service_object_type(t)\x20—\x20the\x20submission\x20at\x20that\x20index\x20MUST\x20exist\x20and\x20have\x20type\x20'+'ObjectType::Service.\x20At\x20present_with_passport\x20time,\x20the\x20submission\x20address\x20is\x20extracted\x20from\x20the\x20Passport\x20'+'via\x20passport::submission_get(passport,\x20&g,\x20*service_identifier).','passed':c,'evidence':'service_identifier='+b,'fix_hint':c?undefined:'Provide\x20an\x20integer\x20in\x20[0,\x20255]\x20that\x20indexes\x20a\x20Service-typed\x20submission\x20in\x20the\x20Guard.'};}function checkByGuard(a){const b=a['by_guard'];if(b===null||b===undefined)return{'id':'C-DEM-07','severity':'info','title':'by_guard\x20is\x20null\x20→\x20use\x20plain\x20present\x20(requires\x20empty\x20guards\x20vector)','description':'When\x20by_guard\x20is\x20None,\x20the\x20caller\x20uses\x20plain\x20present\x20(demand.move:100)\x20which\x20asserts\x20'+'`vector::is_empty(&self.guards)`\x20—\x20aborts\x20with\x20E_NEED_PASSPORT\x20(3)\x20if\x20guards\x20exist.\x20Use\x20this\x20path\x20'+'for\x20open\x20Demands\x20(no\x20guards).','passed':!![],'evidence':'null/undefined\x20→\x20plain\x20present\x20path'};if(a['guards']===undefined)return{'id':'C-DEM-07','severity':'info','title':'by_guard\x20provided\x20(cannot\x20verify\x20membership\x20—\x20guards\x20list\x20not\x20supplied)','description':'present_with_passport_imp\x20(demand.move:110-129)\x20iterates\x20the\x20guards\x20vector\x20looking\x20for\x20a\x20matching\x20'+'guard\x20address.\x20If\x20not\x20found,\x20it\x20aborts\x20with\x20E_GUARD_NOT_FOUND\x20(4).\x20The\x20caller\x20must\x20ensure\x20by_guard\x20'+'is\x20in\x20Demand.guards\x20—\x20this\x20check\x20could\x20not\x20verify\x20because\x20the\x20guards\x20list\x20was\x20not\x20supplied.','passed':!![],'evidence':'by_guard='+b['substring'](0x0,0xa)+'...\x20(guards\x20list\x20not\x20supplied)','fix_hint':'Pass\x20input.guards\x20to\x20enable\x20membership\x20verification.'};const c=a['guards']['includes'](b);return{'id':'C-DEM-07','severity':c?'info':'block','title':'by_guard\x20exists\x20in\x20Demand.guards\x20(when\x20specified)','description':'When\x20by_guard\x20is\x20specified,\x20present_with_passport_imp\x20(demand.move:110-129)\x20iterates\x20the\x20guards\x20vector\x20'+'looking\x20for\x20a\x20matching\x20guard\x20address.\x20If\x20not\x20found,\x20it\x20aborts\x20with\x20E_GUARD_NOT_FOUND\x20(4).\x20The\x20caller\x20'+'MUST\x20ensure\x20by_guard\x20was\x20previously\x20added\x20via\x20guard_add.','passed':c,'evidence':'by_guard='+b['substring'](0x0,0xa)+'...,\x20in\x20guards='+c,'fix_hint':c?undefined:'Call\x20guard_add(permission,\x20guard,\x20service_identifier)\x20first.'};}function checkPermissionSetAvailable(a){const b=a['permission_set_available']!==![];return{'id':'C-DEM-08','severity':b?'info':'warn','title':'permission_set\x20available\x20via\x20CallPermission.apply\x20(DE-D-2=A)','description':'The\x20Move\x20permission_set\x20function\x20(demand.move:286)\x20is\x20exposed\x20in\x20the\x20SDK\x20via\x20the\x20CallPermission.apply\x20'+'mechanism\x20(DE-D-2=A).\x20It\x20calls\x20permission::assert_owner(old)\x20and\x20registrar::affiliation_change\x20to\x20migrate\x20'+'the\x20affiliation.\x20Permission\x20indices\x20for\x20Demand\x20(demand.move:20):\x20400=DEMAND_NEW,\x20401=DEMAND_DESCRIPTION,\x20'+'402=DEMAND_LOCATION,\x20404=DEMAND_GUARD,\x20405=DEMAND_REWARD,\x20406=DEMAND_FEEDBACK,\x20407=DEMAND_OWNER_RECEIVE,\x20'+'408=DEMAND_UM.\x20This\x20is\x20an\x20info\x20check\x20—\x20it\x20confirms\x20the\x20capability\x20is\x20available,\x20not\x20a\x20creation\x20prerequisite.','passed':b,'evidence':b?'exposed\x20via\x20CallPermission.apply':'not\x20available\x20(regression)','fix_hint':b?undefined:'Restore\x20the\x20CallPermission.apply\x20path\x20for\x20permission_set.'};}export function preCheckDemandCreation(a){return[checkDescription(a),checkLocation(a),checkRewards(a),checkGuards(a),checkFeedback(a),checkServiceIdentifier(a),checkByGuard(a),checkPermissionSetAvailable(a)];}export function canCreateDemand(a){const b=preCheckDemandCreation(a);return{'canCreate':b['every'](c=>c['severity']!=='block'||c['passed']),'blockers':b['filter'](c=>c['severity']==='block'&&!c['passed']),'warnings':b['filter'](c=>c['severity']==='warn'&&!c['passed']),'info':b['filter'](c=>c['severity']==='info')};}export function formatDemandCreationSummary(a){const {canCreate:b,blockers:c,warnings:d,info:e}=canCreateDemand(a),f=[];return f['push'](b?'✓\x20Demand\x20pre-check\x20PASSED':'✗\x20Demand\x20pre-check\x20FAILED'),f['push'](''),c['length']>0x0&&(f['push']('BLOCKERS\x20(must\x20fix\x20before\x20operation):'),c['forEach'](g=>f['push']('\x20\x20['+g['id']+']\x20'+g['title']+'\x20—\x20'+(g['evidence']??''))),f['push']('')),d['length']>0x0&&(f['push']('WARNINGS\x20(review\x20recommended):'),d['forEach'](g=>f['push']('\x20\x20['+g['id']+']\x20'+g['title']+'\x20—\x20'+(g['evidence']??''))),f['push']('')),e['length']>0x0&&(f['push']('INFO:'),e['forEach'](g=>f['push']('\x20\x20['+g['id']+']\x20'+g['title']))),f['join']('\x0a');}

package/dist/knowledge/demand-context.d.ts

@@ -0,0 +1,17 @@
+import { type DemandScene } from "./demand-ledger.js";
+export declare const DEMAND_CONTEXT_VERSION = "1.0.0";
+export interface DemandContextBundle {
+    scene?: DemandScene;
+    rewarded: boolean;
+    guarded: boolean;
+    summary: string;
+}
+export interface BuildDemandContextInput {
+    description?: string;
+    reward_count?: number;
+    guard_count?: number;
+}
+export declare function buildDemandContext(input: BuildDemandContextInput): DemandContextBundle;
+export declare function getDemandContextSummary(ctx: DemandContextBundle): string;
+export declare function isRewardedDemand(ctx: DemandContextBundle): boolean;
+export declare function getDemandSceneByIdSafe(id: string): DemandScene | undefined;

package/dist/knowledge/demand-context.js

@@ -0,0 +1 @@
+import{getDemandSceneById}from'./demand-ledger.js';export const DEMAND_CONTEXT_VERSION='1.0.0';export function buildDemandContext(a){const b=(a['reward_count']??0x0)>0x0,c=(a['guard_count']??0x0)>0x0,d=[];return a['description']&&d['push']('demand\x20\x22'+a['description']+'\x22'),d['push'](b?'rewarded':'not\x20rewarded'),d['push'](c?'guarded\x20present':'open\x20present'),{'scene':undefined,'rewarded':b,'guarded':c,'summary':d['join']('\x20·\x20')};}export function getDemandContextSummary(a){return a['summary'];}export function isRewardedDemand(a){return a['rewarded'];}export function getDemandSceneByIdSafe(a){return getDemandSceneById(a);}

package/dist/knowledge/demand-ledger.d.ts

@@ -0,0 +1,26 @@
+export declare const DEMAND_LEDGER_VERSION = "1.0.0";
+export type DemandSceneClassification = "publish" | "present" | "feedback";
+export interface DemandScene {
+    id: string;
+    classification: DemandSceneClassification;
+    semantic: string;
+}
+export declare const DEMAND_SCENES: DemandScene[];
+export interface DemandFieldEntry {
+    field: string;
+    value_type: string;
+    semantic: string;
+    required: boolean;
+}
+export declare const DEMAND_FIELDS: DemandFieldEntry[];
+export interface DemandErrorEntry {
+    code: string;
+    value: number;
+    description: string;
+}
+export declare const DEMAND_ERROR_CODES: DemandErrorEntry[];
+export declare function getDemandField(field: string): DemandFieldEntry | undefined;
+export declare function getDemandErrorByCode(code: string): DemandErrorEntry | undefined;
+export declare function getDemandErrorByValue(value: number): DemandErrorEntry | undefined;
+export declare function getDemandSceneById(id: string): DemandScene | undefined;
+export declare function inferDemandSceneFromIntent(intent: string): DemandScene | undefined;

package/dist/knowledge/demand-ledger.js

@@ -0,0 +1 @@
+export const DEMAND_LEDGER_VERSION='1.0.0';export const DEMAND_SCENES=[{'id':'demand_publish','classification':'publish','semantic':'Create\x20+\x20share\x20the\x20Demand\x20(description\x20+\x20location\x20+\x20rewards\x20+\x20guards).'},{'id':'demand_present','classification':'present','semantic':'A\x20presenter\x20(service/merchant)\x20submits\x20a\x20recommendation\x20to\x20the\x20Demand.'},{'id':'demand_feedback','classification':'feedback','semantic':'Demand\x20owner\x20rates\x20a\x20presenter\x27s\x20submission\x20(acceptance_score\x20+\x20feedback).'}];export const DEMAND_FIELDS=[{'field':'description','value_type':'string','semantic':'Demand\x20description\x20(common::DESCRIPTION\x20validation).','required':!![]},{'field':'location','value_type':'string','semantic':'Geographic\x20region\x20string\x20(structured\x20via\x20region.ts).','required':!![]},{'field':'rewards','value_type':'vector<address>','semantic':'Reward\x20objects\x20offered\x20(≤\x20MAX_REWARD_COUNT\x2020).','required':![]},{'field':'guards','value_type':'vector<ServiceGuard>','semantic':'Guards\x20a\x20presenter\x20must\x20pass\x20to\x20present\x20(≤\x20MAX_GUARD_COUNT\x2020).','required':![]},{'field':'presenters','value_type':'ParentTable<address,\x20ServiceInfo>','semantic':'Presenter\x20submissions\x20(who\x20→\x20recommend/service/acceptance).','required':![]},{'field':'um','value_type':'Option<address>','semantic':'User\x20manager\x20(optional).','required':![]},{'field':'permission','value_type':'address','semantic':'Owning\x20Permission\x20organization.','required':!![]}];export const DEMAND_ERROR_CODES=[{'code':'E_MAX_REWARD_COUNT_EXCEEDED','value':0x1,'description':'rewards\x20>\x20MAX_REWARD_COUNT\x20(20).'},{'code':'E_MAX_GUARD_COUNT_EXCEEDED','value':0x2,'description':'guards\x20>\x20MAX_GUARD_COUNT\x20(20).'},{'code':'E_NEED_PASSPORT','value':0x3,'description':'present\x20requires\x20empty\x20guards\x20(no\x20guard\x20→\x20no\x20passport).'},{'code':'E_GUARD_NOT_FOUND','value':0x4,'description':'Referenced\x20guard\x20not\x20found.'}];export function getDemandField(a){return DEMAND_FIELDS['find'](b=>b['field']===a);}export function getDemandErrorByCode(a){return DEMAND_ERROR_CODES['find'](b=>b['code']===a);}export function getDemandErrorByValue(a){return DEMAND_ERROR_CODES['find'](b=>b['value']===a);}export function getDemandSceneById(a){return DEMAND_SCENES['find'](b=>b['id']===a);}export function inferDemandSceneFromIntent(a){const b=a['toLowerCase']();if(/(publish|post|announce|create|发需求|发布)/['test'](b))return DEMAND_SCENES['find'](c=>c['classification']==='publish');if(/(present|apply|submit|bid|报价|应征)/['test'](b))return DEMAND_SCENES['find'](c=>c['classification']==='present');if(/(feedback|accept|score|rate|评价|采纳)/['test'](b))return DEMAND_SCENES['find'](c=>c['classification']==='feedback');return undefined;}