@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/knowledge/treasury-ledger.js

@@ -1,300 +1 @@
-export const TREASURY_PERMISSIONS = [
-    { index: 250, name: "TREASURY_NEW", description: "Create new Treasury", governed_operation: "treasury::new", active: true },
-    { index: 251, name: "TREASURY_DESCRIPTION", description: "Modify Treasury description", governed_operation: "treasury::description_set", active: true },
-    { index: 252, name: "TREASURY_DEPOSIT", description: "Internal deposit (Permission path)", governed_operation: "treasury::deposit", active: true },
-    { index: 253, name: "TREASURY_RECEIVE", description: "Receive CoinWrapper into balance", governed_operation: "treasury::receive", active: true },
-    { index: 254, name: "TREASURY_WITHDRAW", description: "Internal withdraw (Permission path, fixed amount)", governed_operation: "treasury::withdraw", active: true },
-    { index: 255, name: "TREASURY_EXTERNAL_DEPOSIT_GUARD", description: "Manage external deposit Guard list (add/remove/clear)", governed_operation: "treasury::external_deposit_guard_add/remove/clear", active: true },
-    { index: 256, name: "TREASURY_EXTERNAL_WITHDRAW_GUARD", description: "Manage external withdraw Guard list (add/remove/clear)", governed_operation: "treasury::external_withdraw_guard_add/remove/clear", active: true },
-    { index: 257, name: "TREASURY_OWNER_RECEIVE", description: "Owner receive (unwrap received objects, send to Permission owner)", governed_operation: "treasury::owner_receive / owner_receive_object", active: true },
-    { index: 258, name: "TREASURY_UM", description: "Set UM (User Manager = Contact object)", governed_operation: "treasury::um_set / um_none", active: true },
-    { index: -1, name: "TREASURY_EXTERNAL_DEPOSIT_RESERVED", description: "RESERVED — external_deposit uses Guard + Passport, does NOT call permission::check", governed_operation: "treasury::external_deposit (Guard path)", active: false },
-    { index: -1, name: "TREASURY_EXTERNAL_WITHDRAW_RESERVED", description: "RESERVED — external_withdraw uses Guard + Passport, does NOT call permission::check", governed_operation: "treasury::external_withdraw (Guard path)", active: false },
-];
-export const TREASURY_SCENES = [
-    {
-        id: "treasury_fund_collection",
-        name: "Team fund collection (internal deposit + receive)",
-        coin_type_category: "generic",
-        permission_index_range: "250-254",
-        builtin_indexes: TREASURY_PERMISSIONS.filter(p => [250, 251, 252, 253, 254].includes(p.index)),
-        owner_operations: ["um_set (258)", "owner_receive (257)", "permission transfer"],
-        admin_operations: ["description_set (251)"],
-        permission_index_operations: [
-            "treasury::deposit (252)",
-            "treasury::receive (253)",
-        ],
-        external_operations: [],
-        guard_list_mutable_after_publish: true,
-        common_patterns: [
-            "Owner-only deposit: TREASURY_DEPOSIT (252) granted to team finance",
-            "Receive automation: TREASURY_RECEIVE (253) for CoinWrapper intake",
-            "No external Guard: all deposits via Permission path",
-            "inflow accumulates total team contributions",
-        ],
-        irreversibility: {
-            deposit: "reversible",
-            withdraw: "irreversible",
-            external_deposit: "reversible",
-            external_withdraw: "irreversible",
-            owner_receive: "irreversible",
-        },
-        cross_object_collaboration: [
-            "Allocator.sharing.who=Entity → Treasury address (fund inflow)",
-            "Treasury.receive (253) converts CoinWrapper to balance",
-        ],
-        recommended_templates: ["T-T-01", "T-T-06"],
-    },
-    {
-        id: "treasury_external_ops",
-        name: "External deposit / withdraw with Guard protection",
-        coin_type_category: "generic",
-        permission_index_range: "255-256",
-        builtin_indexes: TREASURY_PERMISSIONS.filter(p => [255, 256].includes(p.index)),
-        owner_operations: ["external_deposit_guard_add/remove/clear (255)", "external_withdraw_guard_add/remove/clear (256)"],
-        admin_operations: [],
-        permission_index_operations: [
-            "treasury::external_deposit_guard_* (255)",
-            "treasury::external_withdraw_guard_* (256)",
-        ],
-        external_operations: [
-            "treasury::external_deposit (Guard + Passport, no Permission)",
-            "treasury::external_withdraw (Guard + Passport, no Permission)",
-        ],
-        guard_list_mutable_after_publish: true,
-        common_patterns: [
-            "Whitelist external deposit: external_deposit_guard with identifier=None",
-            "Capped external withdraw: external_withdraw_guard with identifier=amount field",
-            "Pair external ops with Guard for zero-Permission external access",
-            "store_from_id tracks order/business ID for audit trail",
-        ],
-        irreversibility: {
-            deposit: "reversible",
-            withdraw: "irreversible",
-            external_deposit: "reversible",
-            external_withdraw: "irreversible",
-            owner_receive: "irreversible",
-        },
-        cross_object_collaboration: [
-            "Guard object referenced by external_deposit_guard / external_withdraw_guard",
-            "Passport object required for every external_deposit / external_withdraw call",
-        ],
-        recommended_templates: ["T-T-03", "T-T-04"],
-    },
-    {
-        id: "treasury_guard_protection",
-        name: "Guard-protected Treasury (asymmetric identifier design)",
-        coin_type_category: "generic",
-        permission_index_range: "255-256",
-        builtin_indexes: TREASURY_PERMISSIONS.filter(p => [255, 256].includes(p.index)),
-        owner_operations: ["external_deposit_guard management (255)", "external_withdraw_guard management (256)"],
-        admin_operations: [],
-        permission_index_operations: [
-            "treasury::external_deposit_guard_add (255)",
-            "treasury::external_withdraw_guard_add (256)",
-        ],
-        external_operations: [
-            "external_deposit via Guard (identifier: Option<u8> — None means no amount limit)",
-            "external_withdraw via Guard (identifier: u8 — REQUIRED, no None option)",
-        ],
-        guard_list_mutable_after_publish: true,
-        common_patterns: [
-            "Asymmetric identifier: deposit optional, withdraw required",
-            "Deposit amount from Coin itself; withdraw amount from Guard submission",
-            "upsert semantics: add updates existing guard, else appends",
-            "external_deposit splits coin if value > guard-specified amount",
-        ],
-        irreversibility: {
-            deposit: "reversible",
-            withdraw: "irreversible",
-            external_deposit: "reversible",
-            external_withdraw: "irreversible",
-            owner_receive: "irreversible",
-        },
-        cross_object_collaboration: [
-            "Guard table item value type must be number (is_number_type) for identifier",
-            "Guard table item value type must be address-compatible for store_from_id",
-        ],
-        recommended_templates: ["T-T-03"],
-    },
-    {
-        id: "treasury_permission_sharing",
-        name: "Treasury shared with Service via common Permission",
-        coin_type_category: "generic",
-        permission_index_range: "250-258",
-        builtin_indexes: TREASURY_PERMISSIONS.filter(p => p.active),
-        owner_operations: ["um_set (258)", "owner_receive (257)"],
-        admin_operations: ["description_set (251)"],
-        permission_index_operations: [
-            "treasury::deposit (252) + service::publish (311) on same Permission",
-            "treasury::withdraw (254) + service::compensation_fund_withdraw (315)",
-        ],
-        external_operations: [],
-        guard_list_mutable_after_publish: true,
-        common_patterns: [
-            "Shared Permission: Treasury + Service reference same Permission object",
-            "Unified admin list: single admin team manages both Service and Treasury",
-            "Simplifies key management: one Permission object per business unit",
-        ],
-        irreversibility: {
-            deposit: "reversible",
-            withdraw: "irreversible",
-            external_deposit: "reversible",
-            external_withdraw: "irreversible",
-            owner_receive: "irreversible",
-        },
-        cross_object_collaboration: [
-            "Service.compensation_fund (parallel design, NOT a Treasury)",
-            "Service.order_allocator → Treasury as Entity target",
-        ],
-        recommended_templates: ["T-T-04", "T-T-05"],
-    },
-    {
-        id: "treasury_um_delegation",
-        name: "UM delegation (User Manager = Contact object)",
-        coin_type_category: "generic",
-        permission_index_range: "258",
-        builtin_indexes: TREASURY_PERMISSIONS.filter(p => p.index === 258),
-        owner_operations: ["um_set (258)", "um_none (258)"],
-        admin_operations: [],
-        permission_index_operations: [
-            "treasury::um_set (258)",
-            "treasury::um_none (258)",
-        ],
-        external_operations: [],
-        guard_list_mutable_after_publish: true,
-        common_patterns: [
-            "Owner-only UM: TREASURY_UM (258) restricted to owner (assert_owner)",
-            "UM is a Contact object address, not a regular user address",
-            "UM ≠ admin: UM is for contact management, not permission management",
-            "um_none revokes UM and disaffiliates from Registrar",
-        ],
-        irreversibility: {
-            deposit: "reversible",
-            withdraw: "irreversible",
-            external_deposit: "reversible",
-            external_withdraw: "irreversible",
-            owner_receive: "irreversible",
-        },
-        cross_object_collaboration: [
-            "Contact object referenced by Treasury.um",
-            "Registrar.affiliation / disaffiliation tracks UM-Treasury binding",
-        ],
-        recommended_templates: ["T-T-01"],
-    },
-    {
-        id: "treasury_owner_receive",
-        name: "Owner receive (unwrap & forward to Permission owner)",
-        coin_type_category: "generic",
-        permission_index_range: "257",
-        builtin_indexes: TREASURY_PERMISSIONS.filter(p => p.index === 257),
-        owner_operations: ["owner_receive (257)", "owner_receive_object (257)"],
-        admin_operations: [],
-        permission_index_operations: [
-            "treasury::owner_receive (257)",
-            "treasury::owner_receive_object (257)",
-        ],
-        external_operations: [],
-        guard_list_mutable_after_publish: true,
-        common_patterns: [
-            "Forward received assets: CoinWrapper unwrapped, sent to Permission.owner",
-            "Does NOT write to history (direct forward, no Record entry)",
-            "Used when Treasury should not retain received assets",
-            "owner_receive_object handles non-coin objects too",
-        ],
-        irreversibility: {
-            deposit: "reversible",
-            withdraw: "irreversible",
-            external_deposit: "reversible",
-            external_withdraw: "irreversible",
-            owner_receive: "irreversible",
-        },
-        cross_object_collaboration: [
-            "Permission.owner is the recipient (resolved at tx time)",
-            "Received objects come from Allocator / Arbitration.fees_transfer / external deposits",
-        ],
-        recommended_templates: ["T-T-06"],
-    },
-];
-export const TREASURY_LEDGER_VERSION = "1.0.0";
-export function getScenesByHostObject(_host) {
-    return TREASURY_SCENES;
-}
-export function findSceneById(id) {
-    return TREASURY_SCENES.find(s => s.id === id);
-}
-export function findSceneByPermissionIndex(index) {
-    for (const scene of TREASURY_SCENES) {
-        if (scene.builtin_indexes.some(p => p.index === index && p.active))
-            return scene;
-    }
-    return undefined;
-}
-export function getBuiltinPermissionByIndex(index) {
-    return TREASURY_PERMISSIONS.find(p => p.index === index && p.active);
-}
-export function isBuiltinTreasuryPermission(index) {
-    return getBuiltinPermissionByIndex(index) !== undefined;
-}
-export function getActiveBuiltinPermissions() {
-    return TREASURY_PERMISSIONS.filter(p => p.active);
-}
-export function getReservedBuiltinPermissions() {
-    return TREASURY_PERMISSIONS.filter(p => !p.active);
-}
-export function inferSceneFromIntent(intent) {
-    const lower = intent.toLowerCase();
-    if (lower.includes("um") || lower.includes("delegate") || lower.includes("user manager")) {
-        return findSceneById("treasury_um_delegation");
-    }
-    if (lower.includes("owner_receive") || lower.includes("owner receive") || lower.includes("forward")) {
-        return findSceneById("treasury_owner_receive");
-    }
-    if (lower.includes("external") || lower.includes("guard")) {
-        if (lower.includes("deposit")) {
-            return findSceneById("treasury_external_ops");
-        }
-        if (lower.includes("withdraw")) {
-            return findSceneById("treasury_external_ops");
-        }
-        return findSceneById("treasury_guard_protection");
-    }
-    if (lower.includes("service") || lower.includes("share")) {
-        return findSceneById("treasury_permission_sharing");
-    }
-    if (lower.includes("deposit") || lower.includes("receive") || lower.includes("fund") || lower.includes("collect")) {
-        return findSceneById("treasury_fund_collection");
-    }
-    return undefined;
-}
-export function getTreasuryScenesCount() {
-    return TREASURY_SCENES.length;
-}
-export function getMoveFunctionsForPermissionIndex(index) {
-    const map = {
-        250: ["treasury::new", "treasury::new_with_passport"],
-        251: ["treasury::description_set", "treasury::description_set_with_passport"],
-        252: ["treasury::deposit", "treasury::deposit_with_passport"],
-        253: ["treasury::receive", "treasury::receive_with_passport"],
-        254: ["treasury::withdraw", "treasury::withdraw_with_passport"],
-        255: [
-            "treasury::external_deposit_guard_add",
-            "treasury::external_deposit_guard_add_with_passport",
-            "treasury::external_deposit_guard_remove",
-            "treasury::external_deposit_guard_remove_with_passport",
-            "treasury::external_deposit_guard_clear",
-            "treasury::external_deposit_guard_clear_with_passport",
-        ],
-        256: [
-            "treasury::external_withdraw_guard_add",
-            "treasury::external_withdraw_guard_add_with_passport",
-            "treasury::external_withdraw_guard_remove",
-            "treasury::external_withdraw_guard_remove_with_passport",
-            "treasury::external_withdraw_guard_clear",
-            "treasury::external_withdraw_guard_clear_with_passport",
-        ],
-        257: ["treasury::owner_receive", "treasury::owner_receive_object"],
-        258: ["treasury::um_set", "treasury::um_set_with_passport", "treasury::um_none", "treasury::um_none_with_passport"],
-    };
-    return map[index] ?? [];
-}
+export const TREASURY_PERMISSIONS=[{'index':0xfa,'name':'TREASURY_NEW','description':'Create\x20new\x20Treasury','governed_operation':'treasury::new','active':!![]},{'index':0xfb,'name':'TREASURY_DESCRIPTION','description':'Modify\x20Treasury\x20description','governed_operation':'treasury::description_set','active':!![]},{'index':0xfc,'name':'TREASURY_DEPOSIT','description':'Internal\x20deposit\x20(Permission\x20path)','governed_operation':'treasury::deposit','active':!![]},{'index':0xfd,'name':'TREASURY_RECEIVE','description':'Receive\x20CoinWrapper\x20into\x20balance','governed_operation':'treasury::receive','active':!![]},{'index':0xfe,'name':'TREASURY_WITHDRAW','description':'Internal\x20withdraw\x20(Permission\x20path,\x20fixed\x20amount)','governed_operation':'treasury::withdraw','active':!![]},{'index':0xff,'name':'TREASURY_EXTERNAL_DEPOSIT_GUARD','description':'Manage\x20external\x20deposit\x20Guard\x20list\x20(add/remove/clear)','governed_operation':'treasury::external_deposit_guard_add/remove/clear','active':!![]},{'index':0x100,'name':'TREASURY_EXTERNAL_WITHDRAW_GUARD','description':'Manage\x20external\x20withdraw\x20Guard\x20list\x20(add/remove/clear)','governed_operation':'treasury::external_withdraw_guard_add/remove/clear','active':!![]},{'index':0x101,'name':'TREASURY_OWNER_RECEIVE','description':'Owner\x20receive\x20(unwrap\x20received\x20objects,\x20send\x20to\x20Permission\x20owner)','governed_operation':'treasury::owner_receive\x20/\x20owner_receive_object','active':!![]},{'index':0x102,'name':'TREASURY_UM','description':'Set\x20UM\x20(User\x20Manager\x20=\x20Contact\x20object)','governed_operation':'treasury::um_set\x20/\x20um_none','active':!![]},{'index':-0x1,'name':'TREASURY_EXTERNAL_DEPOSIT_RESERVED','description':'RESERVED\x20—\x20external_deposit\x20uses\x20Guard\x20+\x20Passport,\x20does\x20NOT\x20call\x20permission::check','governed_operation':'treasury::external_deposit\x20(Guard\x20path)','active':![]},{'index':-0x1,'name':'TREASURY_EXTERNAL_WITHDRAW_RESERVED','description':'RESERVED\x20—\x20external_withdraw\x20uses\x20Guard\x20+\x20Passport,\x20does\x20NOT\x20call\x20permission::check','governed_operation':'treasury::external_withdraw\x20(Guard\x20path)','active':![]}];export const TREASURY_SCENES=[{'id':'treasury_fund_collection','name':'Team\x20fund\x20collection\x20(internal\x20deposit\x20+\x20receive)','coin_type_category':'generic','permission_index_range':'250-254','builtin_indexes':TREASURY_PERMISSIONS['filter'](a=>[0xfa,0xfb,0xfc,0xfd,0xfe]['includes'](a['index'])),'owner_operations':['um_set\x20(258)','owner_receive\x20(257)','permission\x20transfer'],'admin_operations':['description_set\x20(251)'],'permission_index_operations':['treasury::deposit\x20(252)','treasury::receive\x20(253)'],'external_operations':[],'guard_list_mutable_after_publish':!![],'common_patterns':['Owner-only\x20deposit:\x20TREASURY_DEPOSIT\x20(252)\x20granted\x20to\x20team\x20finance','Receive\x20automation:\x20TREASURY_RECEIVE\x20(253)\x20for\x20CoinWrapper\x20intake','No\x20external\x20Guard:\x20all\x20deposits\x20via\x20Permission\x20path','inflow\x20accumulates\x20total\x20team\x20contributions'],'irreversibility':{'deposit':'reversible','withdraw':'irreversible','external_deposit':'reversible','external_withdraw':'irreversible','owner_receive':'irreversible'},'cross_object_collaboration':['Allocator.sharing.who=Entity\x20→\x20Treasury\x20address\x20(fund\x20inflow)','Treasury.receive\x20(253)\x20converts\x20CoinWrapper\x20to\x20balance'],'recommended_templates':['T-T-01','T-T-06']},{'id':'treasury_external_ops','name':'External\x20deposit\x20/\x20withdraw\x20with\x20Guard\x20protection','coin_type_category':'generic','permission_index_range':'255-256','builtin_indexes':TREASURY_PERMISSIONS['filter'](a=>[0xff,0x100]['includes'](a['index'])),'owner_operations':['external_deposit_guard_add/remove/clear\x20(255)','external_withdraw_guard_add/remove/clear\x20(256)'],'admin_operations':[],'permission_index_operations':['treasury::external_deposit_guard_*\x20(255)','treasury::external_withdraw_guard_*\x20(256)'],'external_operations':['treasury::external_deposit\x20(Guard\x20+\x20Passport,\x20no\x20Permission)','treasury::external_withdraw\x20(Guard\x20+\x20Passport,\x20no\x20Permission)'],'guard_list_mutable_after_publish':!![],'common_patterns':['Whitelist\x20external\x20deposit:\x20external_deposit_guard\x20with\x20identifier=None','Capped\x20external\x20withdraw:\x20external_withdraw_guard\x20with\x20identifier=amount\x20field','Pair\x20external\x20ops\x20with\x20Guard\x20for\x20zero-Permission\x20external\x20access','store_from_id\x20tracks\x20order/business\x20ID\x20for\x20audit\x20trail'],'irreversibility':{'deposit':'reversible','withdraw':'irreversible','external_deposit':'reversible','external_withdraw':'irreversible','owner_receive':'irreversible'},'cross_object_collaboration':['Guard\x20object\x20referenced\x20by\x20external_deposit_guard\x20/\x20external_withdraw_guard','Passport\x20object\x20required\x20for\x20every\x20external_deposit\x20/\x20external_withdraw\x20call'],'recommended_templates':['T-T-03','T-T-04']},{'id':'treasury_guard_protection','name':'Guard-protected\x20Treasury\x20(asymmetric\x20identifier\x20design)','coin_type_category':'generic','permission_index_range':'255-256','builtin_indexes':TREASURY_PERMISSIONS['filter'](a=>[0xff,0x100]['includes'](a['index'])),'owner_operations':['external_deposit_guard\x20management\x20(255)','external_withdraw_guard\x20management\x20(256)'],'admin_operations':[],'permission_index_operations':['treasury::external_deposit_guard_add\x20(255)','treasury::external_withdraw_guard_add\x20(256)'],'external_operations':['external_deposit\x20via\x20Guard\x20(identifier:\x20Option<u8>\x20—\x20None\x20means\x20no\x20amount\x20limit)','external_withdraw\x20via\x20Guard\x20(identifier:\x20u8\x20—\x20REQUIRED,\x20no\x20None\x20option)'],'guard_list_mutable_after_publish':!![],'common_patterns':['Asymmetric\x20identifier:\x20deposit\x20optional,\x20withdraw\x20required','Deposit\x20amount\x20from\x20Coin\x20itself;\x20withdraw\x20amount\x20from\x20Guard\x20submission','upsert\x20semantics:\x20add\x20updates\x20existing\x20guard,\x20else\x20appends','external_deposit\x20splits\x20coin\x20if\x20value\x20>\x20guard-specified\x20amount'],'irreversibility':{'deposit':'reversible','withdraw':'irreversible','external_deposit':'reversible','external_withdraw':'irreversible','owner_receive':'irreversible'},'cross_object_collaboration':['Guard\x20table\x20item\x20value\x20type\x20must\x20be\x20number\x20(is_number_type)\x20for\x20identifier','Guard\x20table\x20item\x20value\x20type\x20must\x20be\x20address-compatible\x20for\x20store_from_id'],'recommended_templates':['T-T-03']},{'id':'treasury_permission_sharing','name':'Treasury\x20shared\x20with\x20Service\x20via\x20common\x20Permission','coin_type_category':'generic','permission_index_range':'250-258','builtin_indexes':TREASURY_PERMISSIONS['filter'](a=>a['active']),'owner_operations':['um_set\x20(258)','owner_receive\x20(257)'],'admin_operations':['description_set\x20(251)'],'permission_index_operations':['treasury::deposit\x20(252)\x20+\x20service::publish\x20(311)\x20on\x20same\x20Permission','treasury::withdraw\x20(254)\x20+\x20service::compensation_fund_withdraw\x20(315)'],'external_operations':[],'guard_list_mutable_after_publish':!![],'common_patterns':['Shared\x20Permission:\x20Treasury\x20+\x20Service\x20reference\x20same\x20Permission\x20object','Unified\x20admin\x20list:\x20single\x20admin\x20team\x20manages\x20both\x20Service\x20and\x20Treasury','Simplifies\x20key\x20management:\x20one\x20Permission\x20object\x20per\x20business\x20unit'],'irreversibility':{'deposit':'reversible','withdraw':'irreversible','external_deposit':'reversible','external_withdraw':'irreversible','owner_receive':'irreversible'},'cross_object_collaboration':['Service.compensation_fund\x20(parallel\x20design,\x20NOT\x20a\x20Treasury)','Service.order_allocator\x20→\x20Treasury\x20as\x20Entity\x20target'],'recommended_templates':['T-T-04','T-T-05']},{'id':'treasury_um_delegation','name':'UM\x20delegation\x20(User\x20Manager\x20=\x20Contact\x20object)','coin_type_category':'generic','permission_index_range':'258','builtin_indexes':TREASURY_PERMISSIONS['filter'](a=>a['index']===0x102),'owner_operations':['um_set\x20(258)','um_none\x20(258)'],'admin_operations':[],'permission_index_operations':['treasury::um_set\x20(258)','treasury::um_none\x20(258)'],'external_operations':[],'guard_list_mutable_after_publish':!![],'common_patterns':['Owner-only\x20UM:\x20TREASURY_UM\x20(258)\x20restricted\x20to\x20owner\x20(assert_owner)','UM\x20is\x20a\x20Contact\x20object\x20address,\x20not\x20a\x20regular\x20user\x20address','UM\x20≠\x20admin:\x20UM\x20is\x20for\x20contact\x20management,\x20not\x20permission\x20management','um_none\x20revokes\x20UM\x20and\x20disaffiliates\x20from\x20Registrar'],'irreversibility':{'deposit':'reversible','withdraw':'irreversible','external_deposit':'reversible','external_withdraw':'irreversible','owner_receive':'irreversible'},'cross_object_collaboration':['Contact\x20object\x20referenced\x20by\x20Treasury.um','Registrar.affiliation\x20/\x20disaffiliation\x20tracks\x20UM-Treasury\x20binding'],'recommended_templates':['T-T-01']},{'id':'treasury_owner_receive','name':'Owner\x20receive\x20(unwrap\x20&\x20forward\x20to\x20Permission\x20owner)','coin_type_category':'generic','permission_index_range':'257','builtin_indexes':TREASURY_PERMISSIONS['filter'](a=>a['index']===0x101),'owner_operations':['owner_receive\x20(257)','owner_receive_object\x20(257)'],'admin_operations':[],'permission_index_operations':['treasury::owner_receive\x20(257)','treasury::owner_receive_object\x20(257)'],'external_operations':[],'guard_list_mutable_after_publish':!![],'common_patterns':['Forward\x20received\x20assets:\x20CoinWrapper\x20unwrapped,\x20sent\x20to\x20Permission.owner','Does\x20NOT\x20write\x20to\x20history\x20(direct\x20forward,\x20no\x20Record\x20entry)','Used\x20when\x20Treasury\x20should\x20not\x20retain\x20received\x20assets','owner_receive_object\x20handles\x20non-coin\x20objects\x20too'],'irreversibility':{'deposit':'reversible','withdraw':'irreversible','external_deposit':'reversible','external_withdraw':'irreversible','owner_receive':'irreversible'},'cross_object_collaboration':['Permission.owner\x20is\x20the\x20recipient\x20(resolved\x20at\x20tx\x20time)','Received\x20objects\x20come\x20from\x20Allocator\x20/\x20Arbitration.fees_transfer\x20/\x20external\x20deposits'],'recommended_templates':['T-T-06']}];export const TREASURY_LEDGER_VERSION='1.0.0';export function getScenesByHostObject(a){return TREASURY_SCENES;}export function findSceneById(a){return TREASURY_SCENES['find'](b=>b['id']===a);}export function findSceneByPermissionIndex(a){for(const b of TREASURY_SCENES){if(b['builtin_indexes']['some'](c=>c['index']===a&&c['active']))return b;}return undefined;}export function getBuiltinPermissionByIndex(a){return TREASURY_PERMISSIONS['find'](b=>b['index']===a&&b['active']);}export function isBuiltinTreasuryPermission(a){return getBuiltinPermissionByIndex(a)!==undefined;}export function getActiveBuiltinPermissions(){return TREASURY_PERMISSIONS['filter'](a=>a['active']);}export function getReservedBuiltinPermissions(){return TREASURY_PERMISSIONS['filter'](a=>!a['active']);}export function inferSceneFromIntent(a){const b=a['toLowerCase']();if(b['includes']('um')||b['includes']('delegate')||b['includes']('user\x20manager'))return findSceneById('treasury_um_delegation');if(b['includes']('owner_receive')||b['includes']('owner\x20receive')||b['includes']('forward'))return findSceneById('treasury_owner_receive');if(b['includes']('external')||b['includes']('guard')){if(b['includes']('deposit'))return findSceneById('treasury_external_ops');if(b['includes']('withdraw'))return findSceneById('treasury_external_ops');return findSceneById('treasury_guard_protection');}if(b['includes']('service')||b['includes']('share'))return findSceneById('treasury_permission_sharing');if(b['includes']('deposit')||b['includes']('receive')||b['includes']('fund')||b['includes']('collect'))return findSceneById('treasury_fund_collection');return undefined;}export function getTreasuryScenesCount(){return TREASURY_SCENES['length'];}export function getMoveFunctionsForPermissionIndex(a){const b={0xfa:['treasury::new','treasury::new_with_passport'],0xfb:['treasury::description_set','treasury::description_set_with_passport'],0xfc:['treasury::deposit','treasury::deposit_with_passport'],0xfd:['treasury::receive','treasury::receive_with_passport'],0xfe:['treasury::withdraw','treasury::withdraw_with_passport'],0xff:['treasury::external_deposit_guard_add','treasury::external_deposit_guard_add_with_passport','treasury::external_deposit_guard_remove','treasury::external_deposit_guard_remove_with_passport','treasury::external_deposit_guard_clear','treasury::external_deposit_guard_clear_with_passport'],0x100:['treasury::external_withdraw_guard_add','treasury::external_withdraw_guard_add_with_passport','treasury::external_withdraw_guard_remove','treasury::external_withdraw_guard_remove_with_passport','treasury::external_withdraw_guard_clear','treasury::external_withdraw_guard_clear_with_passport'],0x101:['treasury::owner_receive','treasury::owner_receive_object'],0x102:['treasury::um_set','treasury::um_set_with_passport','treasury::um_none','treasury::um_none_with_passport']};return b[a]??[];}

package/dist/knowledge/treasury-puzzle.js

@@ -1,216 +1 @@
-export function initPuzzleFromIntent(intent) {
-    const puzzle = {};
-    if (intent.action || intent.rule_sentence) {
-        puzzle.intent = {
-            action: intent.action ?? "create",
-            coin_type: intent.coin_type,
-            purpose: intent.purpose ?? "custom",
-            rule_sentence: intent.rule_sentence ?? "",
-            failure_conditions: intent.failure_conditions ?? [],
-        };
-    }
-    puzzle.constraints = {
-        F_T_01_description_length_le_4000: true,
-        F_T_02_external_deposit_guard_count_le_100: true,
-        F_T_03_external_withdraw_guard_count_le_200: true,
-        F_T_04_external_withdraw_guard_identifier_required: true,
-        F_T_05_guard_identifier_is_number_type: true,
-        F_T_06_store_from_id_address_compatible: true,
-        F_T_07_external_deposit_amount_sufficient: true,
-        F_T_08_external_withdraw_amount_le_balance: true,
-        F_T_09_withdraw_fixed_amount_le_balance: true,
-        F_T_10_external_guard_in_list: true,
-        F_T_11_coin_type_matches_type_parameter: true,
-        F_T_12_um_is_contact_object: true,
-        F_T_13_permission_index_matches_move: true,
-    };
-    return puzzle;
-}
-export function checkPuzzleCompleteness(puzzle) {
-    const missing = [];
-    const missing_details = [];
-    if (!puzzle.intent) {
-        missing.push("A");
-        missing_details.push({ dimension: "A", reason: "Intent not specified (action + rule_sentence)" });
-    }
-    else if (!puzzle.intent.rule_sentence) {
-        missing.push("A");
-        missing_details.push({ dimension: "A", reason: "rule_sentence is empty" });
-    }
-    if (!puzzle.binding) {
-        missing.push("B");
-        missing_details.push({ dimension: "B", reason: "Binding not specified (type_parameter + permission)" });
-    }
-    else if (!puzzle.binding.type_parameter) {
-        missing.push("B");
-        missing_details.push({ dimension: "B", reason: "type_parameter (Coin type T) missing" });
-    }
-    else if (!puzzle.binding.associated_permission) {
-        missing.push("B");
-        missing_details.push({ dimension: "B", reason: "associated_permission missing" });
-    }
-    if (!puzzle.data_source && puzzle.intent?.action === "create") {
-        missing.push("C");
-        missing_details.push({ dimension: "C", reason: "Data source not specified (permission + coin_source + guards)" });
-    }
-    if (!puzzle.operations) {
-        missing.push("D");
-        missing_details.push({ dimension: "D", reason: "Operations not enumerated" });
-    }
-    if (!puzzle.logic) {
-        missing.push("E");
-        missing_details.push({ dimension: "E", reason: "Logic flow (access_control + fund_flow + history) not defined" });
-    }
-    if (!puzzle.constraints) {
-        missing.push("F");
-        missing_details.push({ dimension: "F", reason: "Constraints not checked" });
-    }
-    return {
-        dimensions: ["A", "B", "C", "D", "E", "F"],
-        missing,
-        missing_details,
-        complete: missing.length === 0,
-        next_step: missing.length === 0
-            ? "Puzzle complete — ready for confirmation text generation"
-            : `Next: complete dimension ${missing[0]} — ${missing_details[0].reason}`,
-    };
-}
-export const MAX_EXTERNAL_DEPOSIT_GUARD_COUNT = 100;
-export const MAX_EXTERNAL_WITHDRAW_GUARD_COUNT = 200;
-export const MAX_DESCRIPTION_LENGTH = 4000;
-export function validateConstraints(puzzle) {
-    const violations = [];
-    if (puzzle.operations?.operations) {
-        for (const op of puzzle.operations.operations) {
-            if (op.type === "description_set" && op.description.length > MAX_DESCRIPTION_LENGTH) {
-                violations.push({
-                    constraint_id: "F-T-01",
-                    severity: "HIGH",
-                    message: `Description length ${op.description.length} exceeds MAX_DESCRIPTION_LENGTH ${MAX_DESCRIPTION_LENGTH}`,
-                    current_value: op.description.length,
-                    limit: MAX_DESCRIPTION_LENGTH,
-                });
-            }
-        }
-    }
-    if (puzzle.data_source && puzzle.data_source.external_deposit_guards.length > MAX_EXTERNAL_DEPOSIT_GUARD_COUNT) {
-        violations.push({
-            constraint_id: "F-T-02",
-            severity: "HIGH",
-            message: `external_deposit_guard count ${puzzle.data_source.external_deposit_guards.length} exceeds ${MAX_EXTERNAL_DEPOSIT_GUARD_COUNT}`,
-            current_value: puzzle.data_source.external_deposit_guards.length,
-            limit: MAX_EXTERNAL_DEPOSIT_GUARD_COUNT,
-        });
-    }
-    if (puzzle.data_source && puzzle.data_source.external_withdraw_guards.length > MAX_EXTERNAL_WITHDRAW_GUARD_COUNT) {
-        violations.push({
-            constraint_id: "F-T-03",
-            severity: "HIGH",
-            message: `external_withdraw_guard count ${puzzle.data_source.external_withdraw_guards.length} exceeds ${MAX_EXTERNAL_WITHDRAW_GUARD_COUNT}`,
-            current_value: puzzle.data_source.external_withdraw_guards.length,
-            limit: MAX_EXTERNAL_WITHDRAW_GUARD_COUNT,
-        });
-    }
-    if (puzzle.data_source) {
-        for (const g of puzzle.data_source.external_withdraw_guards) {
-            if (g.identifier === undefined || g.identifier === null) {
-                violations.push({
-                    constraint_id: "F-T-04",
-                    severity: "HIGH",
-                    message: `external_withdraw_guard ${g.guard} missing required identifier (u8)`,
-                });
-            }
-        }
-    }
-    if (puzzle.logic?.access_control_flow) {
-        for (const flow of puzzle.logic.access_control_flow) {
-            if (flow.permission_index !== undefined) {
-                if (flow.permission_index > 258 && flow.permission_index < 1000) {
-                    violations.push({
-                        constraint_id: "F-T-13",
-                        severity: "CRITICAL",
-                        message: `Permission index ${flow.permission_index} is in the 259-999 range; active Treasury indexes are 250-258. Possible R-T-01 residual.`,
-                        current_value: flow.permission_index,
-                        limit: "250-258",
-                    });
-                }
-            }
-        }
-    }
-    return violations;
-}
-export function generateConfirmationText(puzzle) {
-    const lines = [];
-    lines.push("═══ Treasury Confirmation ═══");
-    lines.push("");
-    if (puzzle.intent) {
-        lines.push(`Action: ${puzzle.intent.action}`);
-        if (puzzle.intent.coin_type)
-            lines.push(`Coin type: ${puzzle.intent.coin_type}`);
-        lines.push(`Purpose: ${puzzle.intent.purpose}`);
-        lines.push(`Rule: ${puzzle.intent.rule_sentence}`);
-        if (puzzle.intent.failure_conditions.length > 0) {
-            lines.push("Failure conditions:");
-            for (const fc of puzzle.intent.failure_conditions)
-                lines.push(`  - ${fc}`);
-        }
-        lines.push("");
-    }
-    if (puzzle.binding) {
-        lines.push("─ Binding ──────────────");
-        lines.push(`Host object: ${puzzle.binding.host_object}`);
-        lines.push(`Type parameter (T): ${puzzle.binding.type_parameter}`);
-        lines.push(`Associated Permission: ${puzzle.binding.associated_permission}`);
-        if (puzzle.binding.associated_um !== undefined) {
-            lines.push(`UM: ${puzzle.binding.associated_um ?? "(none)"}`);
-        }
-        lines.push(`Sharing with Allocator: ${puzzle.binding.sharing_with_allocator}`);
-        lines.push(`Sharing with Arbitration: ${puzzle.binding.sharing_with_arbitration}`);
-        lines.push(`Sharing with Service: ${puzzle.binding.sharing_with_service}`);
-        lines.push("");
-    }
-    if (puzzle.data_source) {
-        lines.push("─ Data Source ──────────────");
-        lines.push(`Permission: ${puzzle.data_source.permission_object}`);
-        lines.push(`Coin source: ${JSON.stringify(puzzle.data_source.coin_source)}`);
-        if (puzzle.data_source.external_deposit_guards.length > 0) {
-            lines.push(`External deposit guards (${puzzle.data_source.external_deposit_guards.length}):`);
-            for (const g of puzzle.data_source.external_deposit_guards) {
-                lines.push(`  guard=${g.guard}, identifier=${g.identifier ?? "None"}, store_from_id=${g.store_from_id ?? "None"}`);
-            }
-        }
-        if (puzzle.data_source.external_withdraw_guards.length > 0) {
-            lines.push(`External withdraw guards (${puzzle.data_source.external_withdraw_guards.length}):`);
-            for (const g of puzzle.data_source.external_withdraw_guards) {
-                lines.push(`  guard=${g.guard}, identifier=${g.identifier} (required), store_from_id=${g.store_from_id ?? "None"}`);
-            }
-        }
-        lines.push("");
-    }
-    if (puzzle.operations && puzzle.operations.operations.length > 0) {
-        lines.push("─ Operations ──────────────");
-        for (const op of puzzle.operations.operations)
-            lines.push(`  - ${JSON.stringify(op)}`);
-        lines.push("");
-    }
-    if (puzzle.logic) {
-        lines.push("─ Logic ──────────────");
-        lines.push("Access control flow:");
-        for (const f of puzzle.logic.access_control_flow) {
-            lines.push(`  path=${f.path}, perm_idx=${f.permission_index ?? "N/A"}, guard=${f.guard_address ?? "N/A"}, passport=${f.passport_required}`);
-        }
-        lines.push("Fund flow:");
-        for (const f of puzzle.logic.fund_flow) {
-            lines.push(`  from=${f.from}, to=${f.to}, amount_source=${f.amount_source}`);
-        }
-        lines.push("");
-    }
-    const violations = validateConstraints(puzzle);
-    if (violations.length > 0) {
-        lines.push("─ Constraint Violations ──────────────");
-        for (const v of violations)
-            lines.push(`  [${v.severity}] ${v.constraint_id}: ${v.message}`);
-        lines.push("");
-    }
-    return lines.join("\n");
-}
+export function initPuzzleFromIntent(a){const b={};return(a['action']||a['rule_sentence'])&&(b['intent']={'action':a['action']??'create','coin_type':a['coin_type'],'purpose':a['purpose']??'custom','rule_sentence':a['rule_sentence']??'','failure_conditions':a['failure_conditions']??[]}),b['constraints']={'F_T_01_description_length_le_4000':!![],'F_T_02_external_deposit_guard_count_le_100':!![],'F_T_03_external_withdraw_guard_count_le_200':!![],'F_T_04_external_withdraw_guard_identifier_required':!![],'F_T_05_guard_identifier_is_number_type':!![],'F_T_06_store_from_id_address_compatible':!![],'F_T_07_external_deposit_amount_sufficient':!![],'F_T_08_external_withdraw_amount_le_balance':!![],'F_T_09_withdraw_fixed_amount_le_balance':!![],'F_T_10_external_guard_in_list':!![],'F_T_11_coin_type_matches_type_parameter':!![],'F_T_12_um_is_contact_object':!![],'F_T_13_permission_index_matches_move':!![]},b;}export function checkPuzzleCompleteness(a){const b=[],c=[];if(!a['intent'])b['push']('A'),c['push']({'dimension':'A','reason':'Intent\x20not\x20specified\x20(action\x20+\x20rule_sentence)'});else!a['intent']['rule_sentence']&&(b['push']('A'),c['push']({'dimension':'A','reason':'rule_sentence\x20is\x20empty'}));if(!a['binding'])b['push']('B'),c['push']({'dimension':'B','reason':'Binding\x20not\x20specified\x20(type_parameter\x20+\x20permission)'});else{if(!a['binding']['type_parameter'])b['push']('B'),c['push']({'dimension':'B','reason':'type_parameter\x20(Coin\x20type\x20T)\x20missing'});else!a['binding']['associated_permission']&&(b['push']('B'),c['push']({'dimension':'B','reason':'associated_permission\x20missing'}));}return!a['data_source']&&a['intent']?.['action']==='create'&&(b['push']('C'),c['push']({'dimension':'C','reason':'Data\x20source\x20not\x20specified\x20(permission\x20+\x20coin_source\x20+\x20guards)'})),!a['operations']&&(b['push']('D'),c['push']({'dimension':'D','reason':'Operations\x20not\x20enumerated'})),!a['logic']&&(b['push']('E'),c['push']({'dimension':'E','reason':'Logic\x20flow\x20(access_control\x20+\x20fund_flow\x20+\x20history)\x20not\x20defined'})),!a['constraints']&&(b['push']('F'),c['push']({'dimension':'F','reason':'Constraints\x20not\x20checked'})),{'dimensions':['A','B','C','D','E','F'],'missing':b,'missing_details':c,'complete':b['length']===0x0,'next_step':b['length']===0x0?'Puzzle\x20complete\x20—\x20ready\x20for\x20confirmation\x20text\x20generation':'Next:\x20complete\x20dimension\x20'+b[0x0]+'\x20—\x20'+c[0x0]['reason']};}export const MAX_EXTERNAL_DEPOSIT_GUARD_COUNT=0x64;export const MAX_EXTERNAL_WITHDRAW_GUARD_COUNT=0xc8;export const MAX_DESCRIPTION_LENGTH=0xfa0;export function validateConstraints(a){const b=[];if(a['operations']?.['operations'])for(const c of a['operations']['operations']){c['type']==='description_set'&&c['description']['length']>MAX_DESCRIPTION_LENGTH&&b['push']({'constraint_id':'F-T-01','severity':'HIGH','message':'Description\x20length\x20'+c['description']['length']+'\x20exceeds\x20MAX_DESCRIPTION_LENGTH\x20'+MAX_DESCRIPTION_LENGTH,'current_value':c['description']['length'],'limit':MAX_DESCRIPTION_LENGTH});}a['data_source']&&a['data_source']['external_deposit_guards']['length']>MAX_EXTERNAL_DEPOSIT_GUARD_COUNT&&b['push']({'constraint_id':'F-T-02','severity':'HIGH','message':'external_deposit_guard\x20count\x20'+a['data_source']['external_deposit_guards']['length']+'\x20exceeds\x20'+MAX_EXTERNAL_DEPOSIT_GUARD_COUNT,'current_value':a['data_source']['external_deposit_guards']['length'],'limit':MAX_EXTERNAL_DEPOSIT_GUARD_COUNT});a['data_source']&&a['data_source']['external_withdraw_guards']['length']>MAX_EXTERNAL_WITHDRAW_GUARD_COUNT&&b['push']({'constraint_id':'F-T-03','severity':'HIGH','message':'external_withdraw_guard\x20count\x20'+a['data_source']['external_withdraw_guards']['length']+'\x20exceeds\x20'+MAX_EXTERNAL_WITHDRAW_GUARD_COUNT,'current_value':a['data_source']['external_withdraw_guards']['length'],'limit':MAX_EXTERNAL_WITHDRAW_GUARD_COUNT});if(a['data_source'])for(const d of a['data_source']['external_withdraw_guards']){(d['identifier']===undefined||d['identifier']===null)&&b['push']({'constraint_id':'F-T-04','severity':'HIGH','message':'external_withdraw_guard\x20'+d['guard']+'\x20missing\x20required\x20identifier\x20(u8)'});}if(a['logic']?.['access_control_flow'])for(const e of a['logic']['access_control_flow']){e['permission_index']!==undefined&&(e['permission_index']>0x102&&e['permission_index']<0x3e8&&b['push']({'constraint_id':'F-T-13','severity':'CRITICAL','message':'Permission\x20index\x20'+e['permission_index']+'\x20is\x20in\x20the\x20259-999\x20range;\x20active\x20Treasury\x20indexes\x20are\x20250-258.\x20Possible\x20R-T-01\x20residual.','current_value':e['permission_index'],'limit':'250-258'}));}return b;}export function generateConfirmationText(a){const b=[];b['push']('═══\x20Treasury\x20Confirmation\x20═══'),b['push']('');if(a['intent']){b['push']('Action:\x20'+a['intent']['action']);if(a['intent']['coin_type'])b['push']('Coin\x20type:\x20'+a['intent']['coin_type']);b['push']('Purpose:\x20'+a['intent']['purpose']),b['push']('Rule:\x20'+a['intent']['rule_sentence']);if(a['intent']['failure_conditions']['length']>0x0){b['push']('Failure\x20conditions:');for(const d of a['intent']['failure_conditions'])b['push']('\x20\x20-\x20'+d);}b['push']('');}a['binding']&&(b['push']('─\x20Binding\x20──────────────'),b['push']('Host\x20object:\x20'+a['binding']['host_object']),b['push']('Type\x20parameter\x20(T):\x20'+a['binding']['type_parameter']),b['push']('Associated\x20Permission:\x20'+a['binding']['associated_permission']),a['binding']['associated_um']!==undefined&&b['push']('UM:\x20'+(a['binding']['associated_um']??'(none)')),b['push']('Sharing\x20with\x20Allocator:\x20'+a['binding']['sharing_with_allocator']),b['push']('Sharing\x20with\x20Arbitration:\x20'+a['binding']['sharing_with_arbitration']),b['push']('Sharing\x20with\x20Service:\x20'+a['binding']['sharing_with_service']),b['push'](''));if(a['data_source']){b['push']('─\x20Data\x20Source\x20──────────────'),b['push']('Permission:\x20'+a['data_source']['permission_object']),b['push']('Coin\x20source:\x20'+JSON['stringify'](a['data_source']['coin_source']));if(a['data_source']['external_deposit_guards']['length']>0x0){b['push']('External\x20deposit\x20guards\x20('+a['data_source']['external_deposit_guards']['length']+'):');for(const e of a['data_source']['external_deposit_guards']){b['push']('\x20\x20guard='+e['guard']+',\x20identifier='+(e['identifier']??'None')+',\x20store_from_id='+(e['store_from_id']??'None'));}}if(a['data_source']['external_withdraw_guards']['length']>0x0){b['push']('External\x20withdraw\x20guards\x20('+a['data_source']['external_withdraw_guards']['length']+'):');for(const h of a['data_source']['external_withdraw_guards']){b['push']('\x20\x20guard='+h['guard']+',\x20identifier='+h['identifier']+'\x20(required),\x20store_from_id='+(h['store_from_id']??'None'));}}b['push']('');}if(a['operations']&&a['operations']['operations']['length']>0x0){b['push']('─\x20Operations\x20──────────────');for(const i of a['operations']['operations'])b['push']('\x20\x20-\x20'+JSON['stringify'](i));b['push']('');}if(a['logic']){b['push']('─\x20Logic\x20──────────────'),b['push']('Access\x20control\x20flow:');for(const j of a['logic']['access_control_flow']){b['push']('\x20\x20path='+j['path']+',\x20perm_idx='+(j['permission_index']??'N/A')+',\x20guard='+(j['guard_address']??'N/A')+',\x20passport='+j['passport_required']);}b['push']('Fund\x20flow:');for(const k of a['logic']['fund_flow']){b['push']('\x20\x20from='+k['from']+',\x20to='+k['to']+',\x20amount_source='+k['amount_source']);}b['push']('');}const c=validateConstraints(a);if(c['length']>0x0){b['push']('─\x20Constraint\x20Violations\x20──────────────');for(const l of c)b['push']('\x20\x20['+l['severity']+']\x20'+l['constraint_id']+':\x20'+l['message']);b['push']('');}return b['join']('\x0a');}