@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/knowledge/permission-templates.js

@@ -1,234 +1 @@
-export const PERMISSION_TEMPLATES = [
-    {
-        id: "T-P-01",
-        name: "Basic permission",
-        description: "Single-admin permission (owner=admin). Suitable for solo operators",
-        applicable_scenes: ["repository_permission", "reward_permission", "progress_permission", "demand_permission", "contact_permission"],
-        industry_tags: ["universal"],
-        params: [
-            { name: "owner_address", type: "address", description: "Owner address (also becomes admin)", required: true },
-            { name: "description", type: "string", description: "Permission description", required: true },
-        ],
-        body: (p) => ({
-            object: null,
-            description: p.description,
-            admin: { op: "set", addresses: [p.owner_address] },
-        }),
-        notes: ["Use this as a starting point; add admins or entities as needed"],
-    },
-    {
-        id: "T-P-02",
-        name: "Multi-admin permission",
-        description: "Multiple admins for collaborative management. Suitable for teams",
-        applicable_scenes: ["service_permission", "machine_permission", "treasury_permission", "arbitration_permission"],
-        industry_tags: ["universal"],
-        params: [
-            { name: "owner_address", type: "address", description: "Owner address", required: true },
-            { name: "admin_addresses", type: "string[]", description: "Additional admin addresses", required: true },
-            { name: "description", type: "string", description: "Permission description", required: true },
-        ],
-        body: (p) => ({
-            object: null,
-            description: p.description,
-            admin: {
-                op: "set",
-                addresses: [p.owner_address, ...p.admin_addresses],
-            },
-        }),
-        notes: ["All admins have equal power; use multi-sig if available"],
-    },
-    {
-        id: "T-P-03",
-        name: "Service permission",
-        description: "Template for Service object with publish/pause/allocator permissions",
-        applicable_scenes: ["service_permission"],
-        industry_tags: ["retail", "service"],
-        params: [
-            { name: "owner_address", type: "address", description: "Service owner", required: true },
-            { name: "publisher_address", type: "address", description: "Address allowed to publish (can be same as owner)", required: true },
-            { name: "allocator_address", type: "address", description: "Address allowed to set order allocator", required: true },
-            { name: "pauser_address", type: "address", description: "Address allowed to pause/resume", required: true },
-            { name: "service_address", type: "address", description: "Target Service object address (for apply)", required: false },
-        ],
-        body: (p) => {
-            const result = {
-                object: null,
-                description: "Service permission",
-                admin: { op: "set", addresses: [p.owner_address] },
-                table: [
-                    { op: "add perm by index", index: 311, entity: [p.publisher_address] },
-                    { op: "add perm by index", index: 313, entity: [p.allocator_address] },
-                    { op: "add perm by index", index: 310, entity: [p.pauser_address] },
-                ],
-                remark: [
-                    { op: "set", index: 311, remark: "service.publish" },
-                    { op: "set", index: 313, remark: "service.order_allocator" },
-                    { op: "set", index: 310, remark: "service.pause" },
-                ],
-            };
-            if (p.service_address)
-                result.apply = [p.service_address];
-            return result;
-        },
-        notes: ["Assign different addresses to different roles for least-privilege"],
-    },
-    {
-        id: "T-P-04",
-        name: "Machine permission",
-        description: "Template for Machine object with publish/node/pause permissions",
-        applicable_scenes: ["machine_permission"],
-        industry_tags: ["workflow", "automation"],
-        params: [
-            { name: "owner_address", type: "address", description: "Machine owner", required: true },
-            { name: "node_editor_address", type: "address", description: "Address allowed to edit nodes (pre-publish only)", required: true },
-            { name: "pauser_address", type: "address", description: "Address allowed to pause/resume", required: true },
-            { name: "machine_address", type: "address", description: "Target Machine object address (for apply)", required: false },
-        ],
-        body: (p) => {
-            const result = {
-                object: null,
-                description: "Machine permission",
-                admin: { op: "set", addresses: [p.owner_address] },
-                table: [
-                    { op: "add perm by index", index: 205, entity: [p.owner_address] },
-                    { op: "add perm by index", index: 206, entity: [p.node_editor_address] },
-                    { op: "add perm by index", index: 204, entity: [p.pauser_address] },
-                ],
-                remark: [
-                    { op: "set", index: 205, remark: "machine.publish" },
-                    { op: "set", index: 206, remark: "machine.node" },
-                    { op: "set", index: 204, remark: "machine.pause" },
-                ],
-            };
-            if (p.machine_address)
-                result.apply = [p.machine_address];
-            return result;
-        },
-        notes: ["MACHINE_PUBLISH (205) should be owner-only", "Node editing only effective before publish"],
-    },
-    {
-        id: "T-P-05",
-        name: "Treasury permission",
-        description: "Template for Treasury with deposit/withdraw/external ops + guard",
-        applicable_scenes: ["treasury_permission"],
-        industry_tags: ["finance", "treasury"],
-        params: [
-            { name: "owner_address", type: "address", description: "Treasury owner", required: true },
-            { name: "depositor_address", type: "address", description: "Address allowed to deposit", required: true },
-            { name: "withdrawer_address", type: "address", description: "Address allowed to withdraw", required: true },
-            { name: "external_operator_address", type: "address", description: "Address for external deposit/withdraw", required: false },
-            { name: "treasury_address", type: "address", description: "Target Treasury object address (for apply)", required: false },
-        ],
-        body: (p) => {
-            const table = [
-                { op: "add perm by index", index: 252, entity: [p.depositor_address] },
-                { op: "add perm by index", index: 254, entity: [p.withdrawer_address] },
-            ];
-            const remark = [
-                { op: "set", index: 252, remark: "treasury.deposit" },
-                { op: "set", index: 254, remark: "treasury.withdraw" },
-            ];
-            if (p.external_operator_address) {
-                table.push({ op: "add perm by index", index: 255, entity: [p.owner_address] }, { op: "add perm by index", index: 256, entity: [p.owner_address] });
-                remark.push({ op: "set", index: 255, remark: "treasury.external_deposit_guard" }, { op: "set", index: 256, remark: "treasury.external_withdraw_guard" });
-            }
-            const result = {
-                object: null,
-                description: "Treasury permission",
-                admin: { op: "set", addresses: [p.owner_address] },
-                table,
-                remark,
-            };
-            if (p.treasury_address)
-                result.apply = [p.treasury_address];
-            return result;
-        },
-        notes: ["Grant TREASURY_EXTERNAL_*_GUARD (255/256) to owner for guard-list management; authorize external operators via external_*_guard_add (Guard + Passport, no Permission index)"],
-    },
-    {
-        id: "T-P-06",
-        name: "Arbitration permission",
-        description: "Template for Arbitration with vote/feedback/confirm permissions",
-        applicable_scenes: ["arbitration_permission"],
-        industry_tags: ["arbitration", "dispute"],
-        params: [
-            { name: "owner_address", type: "address", description: "Arbitration owner", required: true },
-            { name: "voter_addresses", type: "string[]", description: "Arbiter addresses allowed to vote", required: true },
-            { name: "feedback_address", type: "address", description: "Address allowed to provide feedback", required: false },
-            { name: "arbitration_address", type: "address", description: "Target Arbitration object address (for apply)", required: false },
-        ],
-        body: (p) => {
-            const result = {
-                object: null,
-                description: "Arbitration permission",
-                admin: { op: "set", addresses: [p.owner_address] },
-                table: [
-                    { op: "add perm by index", index: 357, entity: p.voter_addresses },
-                ],
-                remark: [
-                    { op: "set", index: 357, remark: "arbitration.vote" },
-                ],
-            };
-            if (p.feedback_address) {
-                result.table.push({ op: "add perm by index", index: 359, entity: [p.feedback_address] });
-                result.remark.push({ op: "set", index: 359, remark: "arbitration.feedback" });
-            }
-            if (p.arbitration_address)
-                result.apply = [p.arbitration_address];
-            return result;
-        },
-        notes: ["Voting weight is determined by voting_guard, not by permission index", "Multiple arbiters can share ARBITRATION_VOTE"],
-    },
-    {
-        id: "T-P-08",
-        name: "Ownership transfer",
-        description: "Template for transferring Permission ownership",
-        applicable_scenes: ["ownership_transfer"],
-        industry_tags: ["universal"],
-        params: [
-            { name: "permission_address", type: "address", description: "Permission object address", required: true },
-            { name: "new_owner_address", type: "address", description: "New owner address", required: true },
-        ],
-        body: (p) => ({
-            object: p.permission_address,
-            builder: p.new_owner_address,
-        }),
-        notes: ["⚠️ IRREVERSIBLE operation", "Export Permission JSON before transfer", "Verify new owner address twice"],
-    },
-];
-export const PERMISSION_TEMPLATES_VERSION = "1.0.0";
-export function getAllTemplates() {
-    return [...PERMISSION_TEMPLATES];
-}
-export function getTemplateById(id) {
-    return PERMISSION_TEMPLATES.find(t => t.id === id);
-}
-export function getTemplatesByScene(sceneId) {
-    return PERMISSION_TEMPLATES.filter(t => t.applicable_scenes.includes(sceneId));
-}
-export function getTemplatesByIndustry(industry) {
-    return PERMISSION_TEMPLATES.filter(t => t.industry_tags.includes(industry) || t.industry_tags.includes("universal"));
-}
-export function suggestTemplateForScene(sceneId) {
-    const matches = getTemplatesByScene(sceneId);
-    return matches.length > 0 ? matches[0] : undefined;
-}
-export function listTemplates() {
-    return PERMISSION_TEMPLATES.map(t => ({
-        id: t.id,
-        name: t.name,
-        description: t.description,
-        scenes: t.applicable_scenes,
-    }));
-}
-export function fillTemplate(templateId, params) {
-    const tpl = getTemplateById(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 PERMISSION_TEMPLATES=[{'id':'T-P-01','name':'Basic\x20permission','description':'Single-admin\x20permission\x20(owner=admin).\x20Suitable\x20for\x20solo\x20operators','applicable_scenes':['repository_permission','reward_permission','progress_permission','demand_permission','contact_permission'],'industry_tags':['universal'],'params':[{'name':'owner_address','type':'address','description':'Owner\x20address\x20(also\x20becomes\x20admin)','required':!![]},{'name':'description','type':'string','description':'Permission\x20description','required':!![]}],'body':a=>({'object':null,'description':a['description'],'admin':{'op':'set','addresses':[a['owner_address']]}}),'notes':['Use\x20this\x20as\x20a\x20starting\x20point;\x20add\x20admins\x20or\x20entities\x20as\x20needed']},{'id':'T-P-02','name':'Multi-admin\x20permission','description':'Multiple\x20admins\x20for\x20collaborative\x20management.\x20Suitable\x20for\x20teams','applicable_scenes':['service_permission','machine_permission','treasury_permission','arbitration_permission'],'industry_tags':['universal'],'params':[{'name':'owner_address','type':'address','description':'Owner\x20address','required':!![]},{'name':'admin_addresses','type':'string[]','description':'Additional\x20admin\x20addresses','required':!![]},{'name':'description','type':'string','description':'Permission\x20description','required':!![]}],'body':a=>({'object':null,'description':a['description'],'admin':{'op':'set','addresses':[a['owner_address'],...a['admin_addresses']]}}),'notes':['All\x20admins\x20have\x20equal\x20power;\x20use\x20multi-sig\x20if\x20available']},{'id':'T-P-03','name':'Service\x20permission','description':'Template\x20for\x20Service\x20object\x20with\x20publish/pause/allocator\x20permissions','applicable_scenes':['service_permission'],'industry_tags':['retail','service'],'params':[{'name':'owner_address','type':'address','description':'Service\x20owner','required':!![]},{'name':'publisher_address','type':'address','description':'Address\x20allowed\x20to\x20publish\x20(can\x20be\x20same\x20as\x20owner)','required':!![]},{'name':'allocator_address','type':'address','description':'Address\x20allowed\x20to\x20set\x20order\x20allocator','required':!![]},{'name':'pauser_address','type':'address','description':'Address\x20allowed\x20to\x20pause/resume','required':!![]},{'name':'service_address','type':'address','description':'Target\x20Service\x20object\x20address\x20(for\x20apply)','required':![]}],'body':a=>{const b={'object':null,'description':'Service\x20permission','admin':{'op':'set','addresses':[a['owner_address']]},'table':[{'op':'add\x20perm\x20by\x20index','index':0x137,'entity':[a['publisher_address']]},{'op':'add\x20perm\x20by\x20index','index':0x139,'entity':[a['allocator_address']]},{'op':'add\x20perm\x20by\x20index','index':0x136,'entity':[a['pauser_address']]}],'remark':[{'op':'set','index':0x137,'remark':'service.publish'},{'op':'set','index':0x139,'remark':'service.order_allocator'},{'op':'set','index':0x136,'remark':'service.pause'}]};if(a['service_address'])b['apply']=[a['service_address']];return b;},'notes':['Assign\x20different\x20addresses\x20to\x20different\x20roles\x20for\x20least-privilege']},{'id':'T-P-04','name':'Machine\x20permission','description':'Template\x20for\x20Machine\x20object\x20with\x20publish/node/pause\x20permissions','applicable_scenes':['machine_permission'],'industry_tags':['workflow','automation'],'params':[{'name':'owner_address','type':'address','description':'Machine\x20owner','required':!![]},{'name':'node_editor_address','type':'address','description':'Address\x20allowed\x20to\x20edit\x20nodes\x20(pre-publish\x20only)','required':!![]},{'name':'pauser_address','type':'address','description':'Address\x20allowed\x20to\x20pause/resume','required':!![]},{'name':'machine_address','type':'address','description':'Target\x20Machine\x20object\x20address\x20(for\x20apply)','required':![]}],'body':a=>{const b={'object':null,'description':'Machine\x20permission','admin':{'op':'set','addresses':[a['owner_address']]},'table':[{'op':'add\x20perm\x20by\x20index','index':0xcd,'entity':[a['owner_address']]},{'op':'add\x20perm\x20by\x20index','index':0xce,'entity':[a['node_editor_address']]},{'op':'add\x20perm\x20by\x20index','index':0xcc,'entity':[a['pauser_address']]}],'remark':[{'op':'set','index':0xcd,'remark':'machine.publish'},{'op':'set','index':0xce,'remark':'machine.node'},{'op':'set','index':0xcc,'remark':'machine.pause'}]};if(a['machine_address'])b['apply']=[a['machine_address']];return b;},'notes':['MACHINE_PUBLISH\x20(205)\x20should\x20be\x20owner-only','Node\x20editing\x20only\x20effective\x20before\x20publish']},{'id':'T-P-05','name':'Treasury\x20permission','description':'Template\x20for\x20Treasury\x20with\x20deposit/withdraw/external\x20ops\x20+\x20guard','applicable_scenes':['treasury_permission'],'industry_tags':['finance','treasury'],'params':[{'name':'owner_address','type':'address','description':'Treasury\x20owner','required':!![]},{'name':'depositor_address','type':'address','description':'Address\x20allowed\x20to\x20deposit','required':!![]},{'name':'withdrawer_address','type':'address','description':'Address\x20allowed\x20to\x20withdraw','required':!![]},{'name':'external_operator_address','type':'address','description':'Address\x20for\x20external\x20deposit/withdraw','required':![]},{'name':'treasury_address','type':'address','description':'Target\x20Treasury\x20object\x20address\x20(for\x20apply)','required':![]}],'body':a=>{const b=[{'op':'add\x20perm\x20by\x20index','index':0xfc,'entity':[a['depositor_address']]},{'op':'add\x20perm\x20by\x20index','index':0xfe,'entity':[a['withdrawer_address']]}],c=[{'op':'set','index':0xfc,'remark':'treasury.deposit'},{'op':'set','index':0xfe,'remark':'treasury.withdraw'}];a['external_operator_address']&&(b['push']({'op':'add\x20perm\x20by\x20index','index':0xff,'entity':[a['owner_address']]},{'op':'add\x20perm\x20by\x20index','index':0x100,'entity':[a['owner_address']]}),c['push']({'op':'set','index':0xff,'remark':'treasury.external_deposit_guard'},{'op':'set','index':0x100,'remark':'treasury.external_withdraw_guard'}));const d={'object':null,'description':'Treasury\x20permission','admin':{'op':'set','addresses':[a['owner_address']]},'table':b,'remark':c};if(a['treasury_address'])d['apply']=[a['treasury_address']];return d;},'notes':['Grant\x20TREASURY_EXTERNAL_*_GUARD\x20(255/256)\x20to\x20owner\x20for\x20guard-list\x20management;\x20authorize\x20external\x20operators\x20via\x20external_*_guard_add\x20(Guard\x20+\x20Passport,\x20no\x20Permission\x20index)']},{'id':'T-P-06','name':'Arbitration\x20permission','description':'Template\x20for\x20Arbitration\x20with\x20vote/feedback/confirm\x20permissions','applicable_scenes':['arbitration_permission'],'industry_tags':['arbitration','dispute'],'params':[{'name':'owner_address','type':'address','description':'Arbitration\x20owner','required':!![]},{'name':'voter_addresses','type':'string[]','description':'Arbiter\x20addresses\x20allowed\x20to\x20vote','required':!![]},{'name':'feedback_address','type':'address','description':'Address\x20allowed\x20to\x20provide\x20feedback','required':![]},{'name':'arbitration_address','type':'address','description':'Target\x20Arbitration\x20object\x20address\x20(for\x20apply)','required':![]}],'body':a=>{const b={'object':null,'description':'Arbitration\x20permission','admin':{'op':'set','addresses':[a['owner_address']]},'table':[{'op':'add\x20perm\x20by\x20index','index':0x165,'entity':a['voter_addresses']}],'remark':[{'op':'set','index':0x165,'remark':'arbitration.vote'}]};a['feedback_address']&&(b['table']['push']({'op':'add\x20perm\x20by\x20index','index':0x167,'entity':[a['feedback_address']]}),b['remark']['push']({'op':'set','index':0x167,'remark':'arbitration.feedback'}));if(a['arbitration_address'])b['apply']=[a['arbitration_address']];return b;},'notes':['Voting\x20weight\x20is\x20determined\x20by\x20voting_guard,\x20not\x20by\x20permission\x20index','Multiple\x20arbiters\x20can\x20share\x20ARBITRATION_VOTE']},{'id':'T-P-08','name':'Ownership\x20transfer','description':'Template\x20for\x20transferring\x20Permission\x20ownership','applicable_scenes':['ownership_transfer'],'industry_tags':['universal'],'params':[{'name':'permission_address','type':'address','description':'Permission\x20object\x20address','required':!![]},{'name':'new_owner_address','type':'address','description':'New\x20owner\x20address','required':!![]}],'body':a=>({'object':a['permission_address'],'builder':a['new_owner_address']}),'notes':['⚠️\x20IRREVERSIBLE\x20operation','Export\x20Permission\x20JSON\x20before\x20transfer','Verify\x20new\x20owner\x20address\x20twice']}];export const PERMISSION_TEMPLATES_VERSION='1.0.0';export function getAllTemplates(){return[...PERMISSION_TEMPLATES];}export function getTemplateById(a){return PERMISSION_TEMPLATES['find'](b=>b['id']===a);}export function getTemplatesByScene(a){return PERMISSION_TEMPLATES['filter'](b=>b['applicable_scenes']['includes'](a));}export function getTemplatesByIndustry(a){return PERMISSION_TEMPLATES['filter'](b=>b['industry_tags']['includes'](a)||b['industry_tags']['includes']('universal'));}export function suggestTemplateForScene(a){const b=getTemplatesByScene(a);return b['length']>0x0?b[0x0]:undefined;}export function listTemplates(){return PERMISSION_TEMPLATES['map'](a=>({'id':a['id'],'name':a['name'],'description':a['description'],'scenes':a['applicable_scenes']}));}export function fillTemplate(a,b){const c=getTemplateById(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/permission-translation.js

@@ -1,350 +1 @@
-import { isBuiltinPermission, getBuiltinPermissionByIndex, findSceneByPermissionIndex, } from "./permission-ledger.js";
-export const SEMANTIC_TO_SCHEMA_RULES = [
-    {
-        id: "P-P-01",
-        pattern_name: "Create new Permission",
-        semantic_intent: "Create a new Permission for a Service/Machine/Treasury/etc.",
-        match_keywords: ["create", "new"],
-        schema_fields: ["object(null)", "description", "admin", "table", "remark"],
-        example_json: {
-            object: null,
-            description: "Permission for myshop service",
-            admin: { op: "set", addresses: ["0xOWNER", "0xADMIN1"] },
-            table: { op: "set perm by index", index: 311, entity: ["0xUSER1", "0xUSER2"] },
-            remark: { op: "set", index: 311, remark: "service.publish" },
-        },
-        reverse_explanation: "object=null indicates creation; admin/table/remark initialize the permission",
-    },
-    {
-        id: "P-P-02",
-        pattern_name: "Grant permission to entities",
-        semantic_intent: "Grant a specific permission index to multiple entities",
-        match_keywords: ["grant", "authorize"],
-        schema_fields: ["object", "table(op=add perm by index)"],
-        example_json: {
-            object: "0xPERMISSION_ADDRESS",
-            table: { op: "add perm by index", index: 313, entity: ["0xNEW_USER"] },
-        },
-        reverse_explanation: "table.op='add perm by index' adds entities to an existing permission index",
-    },
-    {
-        id: "P-P-03",
-        pattern_name: "Set admin list",
-        semantic_intent: "Replace the admin list",
-        match_keywords: ["admin", "set admin"],
-        schema_fields: ["object", "admin(op=set)"],
-        example_json: {
-            object: "0xPERMISSION_ADDRESS",
-            admin: { op: "set", addresses: ["0xADMIN1", "0xADMIN2", "0xADMIN3"] },
-        },
-        reverse_explanation: "admin.op='set' overwrites the entire admin list",
-    },
-    {
-        id: "P-P-04",
-        pattern_name: "Transfer ownership",
-        semantic_intent: "Transfer Permission ownership to a new address",
-        match_keywords: ["transfer", "handover"],
-        schema_fields: ["object", "builder"],
-        example_json: {
-            object: "0xPERMISSION_ADDRESS",
-            builder: "0xNEW_OWNER",
-        },
-        reverse_explanation: "builder field triggers ownership transfer; irreversible",
-    },
-    {
-        id: "P-P-05",
-        pattern_name: "Set/clear UM (User Manager)",
-        semantic_intent: "Delegate UM management or revoke UM",
-        match_keywords: ["um", "user manager", "delegate", "contact"],
-        schema_fields: ["object", "um"],
-        example_json: {
-            object: "0xPERMISSION_ADDRESS",
-            um: "0xUM_ADDRESS",
-        },
-        reverse_explanation: "um=null revokes; um=<address> delegates to Contact object",
-    },
-    {
-        id: "P-P-06",
-        pattern_name: "Apply Permission to other objects",
-        semantic_intent: "Apply Permission to Service/Machine/Treasury/Arbitration/Repository/Reward/Demand",
-        match_keywords: ["apply", "bind"],
-        schema_fields: ["object", "apply"],
-        example_json: {
-            object: "0xPERMISSION_ADDRESS",
-            apply: ["0xSERVICE_ADDRESS", "0xMACHINE_ADDRESS"],
-        },
-        reverse_explanation: "apply field binds Permission to target objects; signer must be owner of those objects",
-    },
-    {
-        id: "P-P-07",
-        pattern_name: "Manage remarks",
-        semantic_intent: "Add/remove/clear remarks for permission indexes",
-        match_keywords: ["remark", "note"],
-        schema_fields: ["object", "remark"],
-        example_json: {
-            object: "0xPERMISSION_ADDRESS",
-            remark: { op: "set", index: 1000, remark: "custom.refund_approval" },
-        },
-        reverse_explanation: "remark.op='set|remove|clear' manages documentation for permission indexes",
-    },
-    {
-        id: "P-P-08",
-        pattern_name: "Entity batch operations",
-        semantic_intent: "Swap/replace/copy/del entities",
-        match_keywords: ["swap", "replace", "copy", "del"],
-        schema_fields: ["object", "entity"],
-        example_json: {
-            object: "0xPERMISSION_ADDRESS",
-            entity: { op: "swap", entity1: "0xUSER1", entity2: "0xUSER2" },
-        },
-        reverse_explanation: "entity.op manages bulk entity-permission reassignments",
-    },
-];
-export const SCHEMA_TO_SEMANTIC_RULES = [
-    {
-        element_type: "field",
-        type_name: "object",
-        semantic_explanation: "Permission object address. STRING=operate existing; null/omitted=create new",
-    },
-    {
-        element_type: "field",
-        type_name: "description",
-        semantic_explanation: "Human-readable description of this Permission's purpose",
-    },
-    {
-        element_type: "field",
-        type_name: "admin",
-        semantic_explanation: "Admin list management. Admin can modify table/remark/entity/description but cannot transfer ownership",
-    },
-    {
-        element_type: "field",
-        type_name: "table",
-        semantic_explanation: "Permission table operations. 'by index' = permission-centric (one perm, many entities); 'by entity' = entity-centric (one entity, many perms)",
-    },
-    {
-        element_type: "field",
-        type_name: "entity",
-        semantic_explanation: "Bulk entity operations (swap/replace/copy/del). Affects all permission indexes of affected entities",
-    },
-    {
-        element_type: "field",
-        type_name: "remark",
-        semantic_explanation: "Documentation for permission indexes. Highly recommended for custom indexes >= 1000",
-    },
-    {
-        element_type: "field",
-        type_name: "apply",
-        semantic_explanation: "Bind Permission to target objects. Signer must be owner of those target objects",
-    },
-    {
-        element_type: "field",
-        type_name: "builder",
-        semantic_explanation: "Transfer ownership. IRREVERSIBLE. Original owner loses ALL control",
-    },
-    {
-        element_type: "field",
-        type_name: "um",
-        semantic_explanation: "User Manager (Contact object address). UM ≠ admin; UM is for contact management",
-    },
-    {
-        element_type: "field",
-        type_name: "owner_receive",
-        semantic_explanation: "Unwrap received objects and send to owner",
-    },
-    {
-        element_type: "op",
-        type_name: "add perm by index",
-        semantic_explanation: "Grant a permission index to multiple entities (additive)",
-    },
-    {
-        element_type: "op",
-        type_name: "set perm by index",
-        semantic_explanation: "REPLACE the entity list for a permission index (destructive)",
-    },
-    {
-        element_type: "op",
-        type_name: "remove perm by index",
-        semantic_explanation: "Revoke a permission index from multiple entities",
-    },
-    {
-        element_type: "op",
-        type_name: "add perm by entity",
-        semantic_explanation: "Grant multiple permission indexes to one entity (additive)",
-    },
-    {
-        element_type: "op",
-        type_name: "set perm by entity",
-        semantic_explanation: "REPLACE all permission indexes for an entity (destructive)",
-    },
-    {
-        element_type: "op",
-        type_name: "remove perm by entity",
-        semantic_explanation: "Revoke multiple permission indexes from one entity",
-    },
-    {
-        element_type: "op",
-        type_name: "swap",
-        semantic_explanation: "Exchange ALL permission indexes between two entities",
-    },
-    {
-        element_type: "op",
-        type_name: "replace",
-        semantic_explanation: "Move all permission indexes from entity1 to entity2; entity1 loses all permissions",
-    },
-    {
-        element_type: "op",
-        type_name: "copy",
-        semantic_explanation: "Copy all permission indexes from entity1 to entity2 (additive); entity1 retains permissions",
-    },
-    {
-        element_type: "op",
-        type_name: "del",
-        semantic_explanation: "Delete an entity and all its permission indexes",
-    },
-];
-export const PERMISSION_CONSTRAINT_RULES = [
-    {
-        id: "MC-P-01",
-        category: "structural",
-        rule: "Custom permission index must be >= 1000 (USER_DEFINED_PERM_INDEX_START)",
-        applies_to: ["table.index", "remark.index"],
-    },
-    {
-        id: "MC-P-02",
-        category: "structural",
-        rule: "Builtin permission indexes (0-999) must match their host object type",
-        applies_to: ["table.index", "apply"],
-    },
-    {
-        id: "MC-P-03",
-        category: "structural",
-        rule: "Entity count <= MAX_ENTITY_COUNT (1000)",
-        applies_to: ["table.entity", "entity.entity1", "entity.entity2"],
-    },
-    {
-        id: "MC-P-04",
-        category: "structural",
-        rule: "Per-entity permission count <= MAX_PERM_FOR_ENTITY (1000)",
-        applies_to: ["table.index (when array)"],
-    },
-    {
-        id: "MC-P-05",
-        category: "structural",
-        rule: "Admin count <= MAX_ADMIN_COUNT (500)",
-        applies_to: ["admin.addresses"],
-    },
-    {
-        id: "MC-P-06",
-        category: "authority",
-        rule: "Only owner can call builder (transfer) and um_set (assert_owner)",
-        applies_to: ["builder", "um"],
-    },
-    {
-        id: "MC-P-07",
-        category: "authority",
-        rule: "Only admin can modify description/remark/table/entity/admin (assert_admin)",
-        applies_to: ["description", "remark", "table", "entity", "admin"],
-    },
-    {
-        id: "MC-P-08",
-        category: "lifecycle",
-        rule: "Ownership transfer is irreversible; new owner auto-becomes admin",
-        applies_to: ["builder"],
-    },
-    {
-        id: "MC-P-09",
-        category: "semantic",
-        rule: "UM is for contact management only; UM ≠ admin (cannot modify permissions)",
-        applies_to: ["um"],
-    },
-    {
-        id: "MC-P-10",
-        category: "cross_object",
-        rule: "apply target object type must match the permission indexes used",
-        applies_to: ["apply", "table.index"],
-    },
-    {
-        id: "MC-P-11",
-        category: "cross_object",
-        rule: "Once Permission is bound to Progress (which binds Machine), post-publish permission table changes have limited effect",
-        applies_to: ["apply (Progress)"],
-    },
-    {
-        id: "MC-P-12",
-        category: "semantic",
-        rule: "Custom permission indexes (>= 1000) should have remark for maintainability",
-        applies_to: ["remark", "table.index"],
-    },
-];
-export const PERMISSION_TRANSLATION_VERSION = "1.0.0";
-export function matchSemanticPattern(userIntent) {
-    const lower = userIntent.toLowerCase();
-    return SEMANTIC_TO_SCHEMA_RULES.filter(rule => rule.match_keywords.some(kw => lower.includes(kw.toLowerCase())));
-}
-export function explainPermissionCallData(data) {
-    const lines = [];
-    if (data.object === null || data.object === undefined) {
-        lines.push("Operation: CREATE new Permission");
-    }
-    else {
-        lines.push(`Operation: MODIFY existing Permission at ${data.object}`);
-    }
-    if (data.description)
-        lines.push(`- Set description: "${data.description}"`);
-    if (data.admin) {
-        lines.push(`- Admin ${data.admin.op}: [${data.admin.addresses.join(", ")}]`);
-    }
-    if (data.table) {
-        const t = data.table;
-        if (typeof t.index === "number") {
-            const builtin = getBuiltinPermissionByIndex(t.index);
-            const indexDesc = builtin ? `${builtin.name} (${builtin.description})` : `custom index ${t.index}`;
-            lines.push(`- Table ${t.op}: ${indexDesc}`);
-        }
-    }
-    if (data.entity) {
-        const e = data.entity;
-        if (e.op === "del") {
-            lines.push(`- Entity del: remove ${e.entity} and all its permissions`);
-        }
-        else if (e.entity1 && e.entity2) {
-            lines.push(`- Entity ${e.op}: ${e.entity1} → ${e.entity2}`);
-        }
-    }
-    if (data.remark) {
-        const r = data.remark;
-        if (r.op === "set")
-            lines.push(`- Remark set: index ${r.index} = "${r.remark}"`);
-        else if (r.op === "remove")
-            lines.push(`- Remark remove: index ${r.index}`);
-        else if (r.op === "clear")
-            lines.push(`- Remark clear: all indexes`);
-    }
-    if (data.apply && data.apply.length > 0) {
-        lines.push(`- Apply to: ${data.apply.join(", ")}`);
-    }
-    if (data.builder) {
-        lines.push(`- ⚠️ TRANSFER ownership to ${data.builder} (IRREVERSIBLE)`);
-    }
-    if (data.um !== undefined) {
-        lines.push(data.um === null ? `- UM: revoke` : `- UM: set to ${data.um}`);
-    }
-    return lines.join("\n");
-}
-export function explainField(fieldName) {
-    return SCHEMA_TO_SEMANTIC_RULES.find(r => r.element_type === "field" && r.type_name === fieldName);
-}
-export function explainOp(opName) {
-    return SCHEMA_TO_SEMANTIC_RULES.find(r => r.element_type === "op" && r.type_name === opName);
-}
-export function getConstraintsByCategory(category) {
-    return PERMISSION_CONSTRAINT_RULES.filter(r => r.category === category);
-}
-export function explainPermissionIndex(index) {
-    if (isBuiltinPermission(index)) {
-        const entry = getBuiltinPermissionByIndex(index);
-        const scene = findSceneByPermissionIndex(index);
-        return `${entry?.name ?? "Unknown"} (${index}) — ${entry?.description ?? ""} [host: ${scene?.host_object ?? "unknown"}]`;
-    }
-    return `Custom permission (${index}) — must be documented via remark`;
-}
+import{isBuiltinPermission,getBuiltinPermissionByIndex,findSceneByPermissionIndex}from'./permission-ledger.js';export const SEMANTIC_TO_SCHEMA_RULES=[{'id':'P-P-01','pattern_name':'Create\x20new\x20Permission','semantic_intent':'Create\x20a\x20new\x20Permission\x20for\x20a\x20Service/Machine/Treasury/etc.','match_keywords':['create','new'],'schema_fields':['object(null)','description','admin','table','remark'],'example_json':{'object':null,'description':'Permission\x20for\x20myshop\x20service','admin':{'op':'set','addresses':['0xOWNER','0xADMIN1']},'table':{'op':'set\x20perm\x20by\x20index','index':0x137,'entity':['0xUSER1','0xUSER2']},'remark':{'op':'set','index':0x137,'remark':'service.publish'}},'reverse_explanation':'object=null\x20indicates\x20creation;\x20admin/table/remark\x20initialize\x20the\x20permission'},{'id':'P-P-02','pattern_name':'Grant\x20permission\x20to\x20entities','semantic_intent':'Grant\x20a\x20specific\x20permission\x20index\x20to\x20multiple\x20entities','match_keywords':['grant','authorize'],'schema_fields':['object','table(op=add\x20perm\x20by\x20index)'],'example_json':{'object':'0xPERMISSION_ADDRESS','table':{'op':'add\x20perm\x20by\x20index','index':0x139,'entity':['0xNEW_USER']}},'reverse_explanation':'table.op=\x27add\x20perm\x20by\x20index\x27\x20adds\x20entities\x20to\x20an\x20existing\x20permission\x20index'},{'id':'P-P-03','pattern_name':'Set\x20admin\x20list','semantic_intent':'Replace\x20the\x20admin\x20list','match_keywords':['admin','set\x20admin'],'schema_fields':['object','admin(op=set)'],'example_json':{'object':'0xPERMISSION_ADDRESS','admin':{'op':'set','addresses':['0xADMIN1','0xADMIN2','0xADMIN3']}},'reverse_explanation':'admin.op=\x27set\x27\x20overwrites\x20the\x20entire\x20admin\x20list'},{'id':'P-P-04','pattern_name':'Transfer\x20ownership','semantic_intent':'Transfer\x20Permission\x20ownership\x20to\x20a\x20new\x20address','match_keywords':['transfer','handover'],'schema_fields':['object','builder'],'example_json':{'object':'0xPERMISSION_ADDRESS','builder':'0xNEW_OWNER'},'reverse_explanation':'builder\x20field\x20triggers\x20ownership\x20transfer;\x20irreversible'},{'id':'P-P-05','pattern_name':'Set/clear\x20UM\x20(User\x20Manager)','semantic_intent':'Delegate\x20UM\x20management\x20or\x20revoke\x20UM','match_keywords':['um','user\x20manager','delegate','contact'],'schema_fields':['object','um'],'example_json':{'object':'0xPERMISSION_ADDRESS','um':'0xUM_ADDRESS'},'reverse_explanation':'um=null\x20revokes;\x20um=<address>\x20delegates\x20to\x20Contact\x20object'},{'id':'P-P-06','pattern_name':'Apply\x20Permission\x20to\x20other\x20objects','semantic_intent':'Apply\x20Permission\x20to\x20Service/Machine/Treasury/Arbitration/Repository/Reward/Demand','match_keywords':['apply','bind'],'schema_fields':['object','apply'],'example_json':{'object':'0xPERMISSION_ADDRESS','apply':['0xSERVICE_ADDRESS','0xMACHINE_ADDRESS']},'reverse_explanation':'apply\x20field\x20binds\x20Permission\x20to\x20target\x20objects;\x20signer\x20must\x20be\x20owner\x20of\x20those\x20objects'},{'id':'P-P-07','pattern_name':'Manage\x20remarks','semantic_intent':'Add/remove/clear\x20remarks\x20for\x20permission\x20indexes','match_keywords':['remark','note'],'schema_fields':['object','remark'],'example_json':{'object':'0xPERMISSION_ADDRESS','remark':{'op':'set','index':0x3e8,'remark':'custom.refund_approval'}},'reverse_explanation':'remark.op=\x27set|remove|clear\x27\x20manages\x20documentation\x20for\x20permission\x20indexes'},{'id':'P-P-08','pattern_name':'Entity\x20batch\x20operations','semantic_intent':'Swap/replace/copy/del\x20entities','match_keywords':['swap','replace','copy','del'],'schema_fields':['object','entity'],'example_json':{'object':'0xPERMISSION_ADDRESS','entity':{'op':'swap','entity1':'0xUSER1','entity2':'0xUSER2'}},'reverse_explanation':'entity.op\x20manages\x20bulk\x20entity-permission\x20reassignments'}];export const SCHEMA_TO_SEMANTIC_RULES=[{'element_type':'field','type_name':'object','semantic_explanation':'Permission\x20object\x20address.\x20STRING=operate\x20existing;\x20null/omitted=create\x20new'},{'element_type':'field','type_name':'description','semantic_explanation':'Human-readable\x20description\x20of\x20this\x20Permission\x27s\x20purpose'},{'element_type':'field','type_name':'admin','semantic_explanation':'Admin\x20list\x20management.\x20Admin\x20can\x20modify\x20table/remark/entity/description\x20but\x20cannot\x20transfer\x20ownership'},{'element_type':'field','type_name':'table','semantic_explanation':'Permission\x20table\x20operations.\x20\x27by\x20index\x27\x20=\x20permission-centric\x20(one\x20perm,\x20many\x20entities);\x20\x27by\x20entity\x27\x20=\x20entity-centric\x20(one\x20entity,\x20many\x20perms)'},{'element_type':'field','type_name':'entity','semantic_explanation':'Bulk\x20entity\x20operations\x20(swap/replace/copy/del).\x20Affects\x20all\x20permission\x20indexes\x20of\x20affected\x20entities'},{'element_type':'field','type_name':'remark','semantic_explanation':'Documentation\x20for\x20permission\x20indexes.\x20Highly\x20recommended\x20for\x20custom\x20indexes\x20>=\x201000'},{'element_type':'field','type_name':'apply','semantic_explanation':'Bind\x20Permission\x20to\x20target\x20objects.\x20Signer\x20must\x20be\x20owner\x20of\x20those\x20target\x20objects'},{'element_type':'field','type_name':'builder','semantic_explanation':'Transfer\x20ownership.\x20IRREVERSIBLE.\x20Original\x20owner\x20loses\x20ALL\x20control'},{'element_type':'field','type_name':'um','semantic_explanation':'User\x20Manager\x20(Contact\x20object\x20address).\x20UM\x20≠\x20admin;\x20UM\x20is\x20for\x20contact\x20management'},{'element_type':'field','type_name':'owner_receive','semantic_explanation':'Unwrap\x20received\x20objects\x20and\x20send\x20to\x20owner'},{'element_type':'op','type_name':'add\x20perm\x20by\x20index','semantic_explanation':'Grant\x20a\x20permission\x20index\x20to\x20multiple\x20entities\x20(additive)'},{'element_type':'op','type_name':'set\x20perm\x20by\x20index','semantic_explanation':'REPLACE\x20the\x20entity\x20list\x20for\x20a\x20permission\x20index\x20(destructive)'},{'element_type':'op','type_name':'remove\x20perm\x20by\x20index','semantic_explanation':'Revoke\x20a\x20permission\x20index\x20from\x20multiple\x20entities'},{'element_type':'op','type_name':'add\x20perm\x20by\x20entity','semantic_explanation':'Grant\x20multiple\x20permission\x20indexes\x20to\x20one\x20entity\x20(additive)'},{'element_type':'op','type_name':'set\x20perm\x20by\x20entity','semantic_explanation':'REPLACE\x20all\x20permission\x20indexes\x20for\x20an\x20entity\x20(destructive)'},{'element_type':'op','type_name':'remove\x20perm\x20by\x20entity','semantic_explanation':'Revoke\x20multiple\x20permission\x20indexes\x20from\x20one\x20entity'},{'element_type':'op','type_name':'swap','semantic_explanation':'Exchange\x20ALL\x20permission\x20indexes\x20between\x20two\x20entities'},{'element_type':'op','type_name':'replace','semantic_explanation':'Move\x20all\x20permission\x20indexes\x20from\x20entity1\x20to\x20entity2;\x20entity1\x20loses\x20all\x20permissions'},{'element_type':'op','type_name':'copy','semantic_explanation':'Copy\x20all\x20permission\x20indexes\x20from\x20entity1\x20to\x20entity2\x20(additive);\x20entity1\x20retains\x20permissions'},{'element_type':'op','type_name':'del','semantic_explanation':'Delete\x20an\x20entity\x20and\x20all\x20its\x20permission\x20indexes'}];export const PERMISSION_CONSTRAINT_RULES=[{'id':'MC-P-01','category':'structural','rule':'Custom\x20permission\x20index\x20must\x20be\x20>=\x201000\x20(USER_DEFINED_PERM_INDEX_START)','applies_to':['table.index','remark.index']},{'id':'MC-P-02','category':'structural','rule':'Builtin\x20permission\x20indexes\x20(0-999)\x20must\x20match\x20their\x20host\x20object\x20type','applies_to':['table.index','apply']},{'id':'MC-P-03','category':'structural','rule':'Entity\x20count\x20<=\x20MAX_ENTITY_COUNT\x20(1000)','applies_to':['table.entity','entity.entity1','entity.entity2']},{'id':'MC-P-04','category':'structural','rule':'Per-entity\x20permission\x20count\x20<=\x20MAX_PERM_FOR_ENTITY\x20(1000)','applies_to':['table.index\x20(when\x20array)']},{'id':'MC-P-05','category':'structural','rule':'Admin\x20count\x20<=\x20MAX_ADMIN_COUNT\x20(500)','applies_to':['admin.addresses']},{'id':'MC-P-06','category':'authority','rule':'Only\x20owner\x20can\x20call\x20builder\x20(transfer)\x20and\x20um_set\x20(assert_owner)','applies_to':['builder','um']},{'id':'MC-P-07','category':'authority','rule':'Only\x20admin\x20can\x20modify\x20description/remark/table/entity/admin\x20(assert_admin)','applies_to':['description','remark','table','entity','admin']},{'id':'MC-P-08','category':'lifecycle','rule':'Ownership\x20transfer\x20is\x20irreversible;\x20new\x20owner\x20auto-becomes\x20admin','applies_to':['builder']},{'id':'MC-P-09','category':'semantic','rule':'UM\x20is\x20for\x20contact\x20management\x20only;\x20UM\x20≠\x20admin\x20(cannot\x20modify\x20permissions)','applies_to':['um']},{'id':'MC-P-10','category':'cross_object','rule':'apply\x20target\x20object\x20type\x20must\x20match\x20the\x20permission\x20indexes\x20used','applies_to':['apply','table.index']},{'id':'MC-P-11','category':'cross_object','rule':'Once\x20Permission\x20is\x20bound\x20to\x20Progress\x20(which\x20binds\x20Machine),\x20post-publish\x20permission\x20table\x20changes\x20have\x20limited\x20effect','applies_to':['apply\x20(Progress)']},{'id':'MC-P-12','category':'semantic','rule':'Custom\x20permission\x20indexes\x20(>=\x201000)\x20should\x20have\x20remark\x20for\x20maintainability','applies_to':['remark','table.index']}];export const PERMISSION_TRANSLATION_VERSION='1.0.0';export function matchSemanticPattern(a){const b=a['toLowerCase']();return SEMANTIC_TO_SCHEMA_RULES['filter'](c=>c['match_keywords']['some'](d=>b['includes'](d['toLowerCase']())));}export function explainPermissionCallData(a){const b=[];a['object']===null||a['object']===undefined?b['push']('Operation:\x20CREATE\x20new\x20Permission'):b['push']('Operation:\x20MODIFY\x20existing\x20Permission\x20at\x20'+a['object']);if(a['description'])b['push']('-\x20Set\x20description:\x20\x22'+a['description']+'\x22');a['admin']&&b['push']('-\x20Admin\x20'+a['admin']['op']+':\x20['+a['admin']['addresses']['join'](',\x20')+']');if(a['table']){const c=a['table'];if(typeof c['index']==='number'){const d=getBuiltinPermissionByIndex(c['index']),f=d?d['name']+'\x20('+d['description']+')':'custom\x20index\x20'+c['index'];b['push']('-\x20Table\x20'+c['op']+':\x20'+f);}}if(a['entity']){const g=a['entity'];if(g['op']==='del')b['push']('-\x20Entity\x20del:\x20remove\x20'+g['entity']+'\x20and\x20all\x20its\x20permissions');else g['entity1']&&g['entity2']&&b['push']('-\x20Entity\x20'+g['op']+':\x20'+g['entity1']+'\x20→\x20'+g['entity2']);}if(a['remark']){const h=a['remark'];if(h['op']==='set')b['push']('-\x20Remark\x20set:\x20index\x20'+h['index']+'\x20=\x20\x22'+h['remark']+'\x22');else{if(h['op']==='remove')b['push']('-\x20Remark\x20remove:\x20index\x20'+h['index']);else{if(h['op']==='clear')b['push']('-\x20Remark\x20clear:\x20all\x20indexes');}}}return a['apply']&&a['apply']['length']>0x0&&b['push']('-\x20Apply\x20to:\x20'+a['apply']['join'](',\x20')),a['builder']&&b['push']('-\x20⚠️\x20TRANSFER\x20ownership\x20to\x20'+a['builder']+'\x20(IRREVERSIBLE)'),a['um']!==undefined&&b['push'](a['um']===null?'-\x20UM:\x20revoke':'-\x20UM:\x20set\x20to\x20'+a['um']),b['join']('\x0a');}export function explainField(a){return SCHEMA_TO_SEMANTIC_RULES['find'](b=>b['element_type']==='field'&&b['type_name']===a);}export function explainOp(a){return SCHEMA_TO_SEMANTIC_RULES['find'](b=>b['element_type']==='op'&&b['type_name']===a);}export function getConstraintsByCategory(a){return PERMISSION_CONSTRAINT_RULES['filter'](b=>b['category']===a);}export function explainPermissionIndex(a){if(isBuiltinPermission(a)){const b=getBuiltinPermissionByIndex(a),c=findSceneByPermissionIndex(a);return(b?.['name']??'Unknown')+'\x20('+a+')\x20—\x20'+(b?.['description']??'')+'\x20[host:\x20'+(c?.['host_object']??'unknown')+']';}return'Custom\x20permission\x20('+a+')\x20—\x20must\x20be\x20documented\x20via\x20remark';}