@wowok/agent-mcp 3.0.2 → 3.0.3

package/dist/knowledge/treasury-confirm.d.ts

@@ -1,133 +0,0 @@
-import { type TreasuryRiskAssessment } from "./treasury-risk.js";
-export type TreasuryConfirmGateStatus = "approved" | "blocked_checklist" | "blocked_risk" | "blocked_user" | "blocked_environment";
-export interface TreasuryConfirmGateResult {
-    status: TreasuryConfirmGateStatus;
-    checklist_result: TreasuryChecklistResult;
-    risk_result?: TreasuryRiskAssessment;
-    user_confirmation?: TreasuryUserConfirmation;
-    environment_result?: TreasuryEnvironmentResult;
-    confirmation_text?: string;
-    block_reason?: string;
-    decision_record: TreasuryDecisionRecord;
-}
-export interface TreasuryChecklistResult {
-    all_passed: boolean;
-    items: TreasuryChecklistItem[];
-}
-export interface TreasuryChecklistItem {
-    id: string;
-    description: string;
-    passed: boolean;
-    message: string;
-}
-export interface TreasuryUserConfirmation {
-    questions_asked: TreasuryConfirmationQuestion[];
-    responses: TreasuryConfirmationResponse[];
-    all_confirmed: boolean;
-}
-export interface TreasuryConfirmationQuestion {
-    id: string;
-    question: string;
-    requires_explicit_yes: boolean;
-    related_risk_ids?: string[];
-}
-export interface TreasuryConfirmationResponse {
-    question_id: string;
-    response: "yes" | "no" | "skip";
-}
-export interface TreasuryEnvironmentResult {
-    passed: boolean;
-    checks: {
-        name: string;
-        passed: boolean;
-        message: string;
-    }[];
-}
-export interface TreasuryDecisionRecord {
-    timestamp: string;
-    gate_version: string;
-    final_status: TreasuryConfirmGateStatus;
-    layers_passed: string[];
-    layers_failed: string[];
-}
-export interface TreasuryJsonForConfirm {
-    object?: string | object | null;
-    description?: string;
-    deposit?: {
-        coin?: {
-            balance?: string;
-            coin_object?: string;
-        };
-        by_external_deposit_guard?: string;
-        payment_info?: {
-            remark?: string;
-            index: number;
-        };
-    };
-    withdraw?: {
-        amount?: {
-            fixed?: string;
-            by_external_withdraw_guard?: string;
-        };
-        recipient?: string;
-        payment_info?: {
-            remark?: string;
-            index: number;
-        };
-    };
-    external_deposit_guard?: {
-        op: "add" | "set";
-        guards: {
-            guard: string;
-            identifier?: number | null;
-            store_from_id?: number | null;
-        }[];
-    } | {
-        op: "remove";
-        guards: string[];
-    } | {
-        op: "clear";
-    };
-    external_withdraw_guard?: {
-        op: "add" | "set";
-        guards: {
-            guard: string;
-            identifier?: number | null;
-            store_from_id?: number | null;
-        }[];
-    } | {
-        op: "remove";
-        guards: string[];
-    } | {
-        op: "clear";
-    };
-    receive?: string[] | "recently";
-    owner_receive?: string[] | "recently";
-    um?: string | null;
-}
-export interface TreasuryConfirmGateInput {
-    treasury_json: TreasuryJsonForConfirm;
-    intent?: string;
-    type_parameter?: string;
-    permission_address?: string;
-    current_balance?: string;
-    current_external_deposit_guard_count?: number;
-    current_external_withdraw_guard_count?: number;
-    shared_with_service?: boolean;
-    shared_with_allocator?: boolean;
-    shared_with_arbitration?: boolean;
-    current_permission_indexes_granted?: number[];
-    skip_user_confirmation?: boolean;
-    skip_environment_check?: boolean;
-}
-export declare const TREASURY_PUBLISH_CHECKLIST: TreasuryChecklistItem[];
-export declare const TREASURY_CONFIRMATION_QUESTIONS: TreasuryConfirmationQuestion[];
-export declare const TREASURY_CONFIRM_VERSION = "1.0.0";
-export declare function runTreasuryConfirmGate(input: TreasuryConfirmGateInput): TreasuryConfirmGateResult;
-export interface ProgressiveTreasuryCheckResult {
-    stage: "checklist" | "risk" | "confirmation" | "environment" | "complete";
-    status: "pass" | "fail" | "pending";
-    message: string;
-    next_action?: string;
-}
-export declare function progressiveTreasuryCheck(input: TreasuryConfirmGateInput): ProgressiveTreasuryCheckResult;

package/dist/knowledge/treasury-confirm.js

@@ -1 +0,0 @@
-import{assessTreasuryRisks}from'./treasury-risk.js';import{MAX_EXTERNAL_DEPOSIT_GUARD_COUNT,MAX_EXTERNAL_WITHDRAW_GUARD_COUNT,MAX_DESCRIPTION_LENGTH}from'./treasury-puzzle.js';export const TREASURY_PUBLISH_CHECKLIST=[{'id':'C-T-01','description':'type_parameter\x20(Coin\x20type\x20T)\x20specified\x20and\x20valid','passed':![],'message':''},{'id':'C-T-02','description':'Permission\x20object\x20configured\x20(new\x20or\x20existing)','passed':![],'message':''},{'id':'C-T-03','description':'description\x20length\x20<=\x20MAX_DESCRIPTION_LENGTH\x20(4000)','passed':![],'message':''},{'id':'C-T-04','description':'external_withdraw_guard.identifier\x20provided\x20(u8,\x20required)','passed':![],'message':''},{'id':'C-T-05','description':'external_deposit_guard\x20count\x20<=\x20MAX_EXTERNAL_DEPOSIT_GUARD_COUNT\x20(100)','passed':![],'message':''},{'id':'C-T-06','description':'external_withdraw_guard\x20count\x20<=\x20MAX_EXTERNAL_WITHDRAW_GUARD_COUNT\x20(200)','passed':![],'message':''},{'id':'C-T-07','description':'withdraw\x20recipient\x20address\x20valid','passed':![],'message':''},{'id':'C-T-08','description':'UM\x20address\x20is\x20valid\x20Contact\x20object\x20reference\x20(or\x20null\x20for\x20revoke)','passed':![],'message':''},{'id':'C-T-09','description':'withdraw\x20(fixed)\x20/\x20external_withdraw\x20double-confirmed\x20by\x20user','passed':![],'message':''},{'id':'C-T-10','description':'Permission\x20indexes\x20align\x20with\x20Move\x20on-chain\x20(no\x20stale\x20259/260)','passed':![],'message':''}];function runStaticChecklist(a){const b=TREASURY_PUBLISH_CHECKLIST['map'](p=>({...p})),c=a['treasury_json'],d=b['find'](p=>p['id']==='C-T-01');if(typeof c['object']==='object'&&c['object']!==null){const p=c['object'],q=!!p['type_parameter']&&p['type_parameter']['length']>0x0;d['passed']=q,d['message']=q?'':'type_parameter\x20missing\x20in\x20object\x20(required\x20for\x20creation)';}else{if(a['type_parameter'])d['passed']=!![];else typeof c['object']==='string'?d['passed']=!![]:(d['passed']=![],d['message']='Cannot\x20determine\x20type_parameter');}const e=b['find'](r=>r['id']==='C-T-02');if(typeof c['object']==='object'&&c['object']!==null){const r=c['object'],s=!!r['permission'];e['passed']=s,e['message']=s?'':'permission\x20missing\x20in\x20object\x20(required\x20for\x20creation)';}else a['permission_address']?e['passed']=!![]:e['passed']=!![];const f=b['find'](t=>t['id']==='C-T-03');if(c['description']!==undefined){const t=c['description']['length']<=MAX_DESCRIPTION_LENGTH;f['passed']=t,f['message']=t?'':'Description\x20length\x20'+c['description']['length']+'\x20>\x20'+MAX_DESCRIPTION_LENGTH;}else f['passed']=!![];const g=b['find'](u=>u['id']==='C-T-04');if(c['external_withdraw_guard']&&(c['external_withdraw_guard']['op']==='add'||c['external_withdraw_guard']['op']==='set')){const u=c['external_withdraw_guard']['guards']['filter'](w=>w['identifier']===undefined||w['identifier']===null),v=u['length']===0x0;g['passed']=v,g['message']=v?'':u['length']+'\x20withdraw\x20guard(s)\x20missing\x20identifier\x20(u8\x20required)';}else g['passed']=!![];const h=b['find'](w=>w['id']==='C-T-05');if(c['external_deposit_guard']&&(c['external_deposit_guard']['op']==='add'||c['external_deposit_guard']['op']==='set')){const w=a['current_external_deposit_guard_count']??0x0,x=c['external_deposit_guard']['guards']['length'],y=(c['external_deposit_guard']['op']==='set'?x:w+x)<=MAX_EXTERNAL_DEPOSIT_GUARD_COUNT;h['passed']=y,h['message']=y?'':'deposit_guard\x20count\x20'+(c['external_deposit_guard']['op']==='set'?x:w+x)+'\x20>\x20'+MAX_EXTERNAL_DEPOSIT_GUARD_COUNT;}else h['passed']=!![];const i=b['find'](z=>z['id']==='C-T-06');if(c['external_withdraw_guard']&&(c['external_withdraw_guard']['op']==='add'||c['external_withdraw_guard']['op']==='set')){const z=a['current_external_withdraw_guard_count']??0x0,A=c['external_withdraw_guard']['guards']['length'],B=(c['external_withdraw_guard']['op']==='set'?A:z+A)<=MAX_EXTERNAL_WITHDRAW_GUARD_COUNT;i['passed']=B,i['message']=B?'':'withdraw_guard\x20count\x20'+(c['external_withdraw_guard']['op']==='set'?A:z+A)+'\x20>\x20'+MAX_EXTERNAL_WITHDRAW_GUARD_COUNT;}else i['passed']=!![];const j=b['find'](C=>C['id']==='C-T-07');if(c['withdraw']?.['recipient']){const C=c['withdraw']['recipient']['startsWith']('0x')&&c['withdraw']['recipient']['length']>=0x28;j['passed']=C,j['message']=C?'':'Recipient\x20'+c['withdraw']['recipient']+'\x20invalid';}else c['withdraw']?(j['passed']=![],j['message']='withdraw\x20specified\x20without\x20recipient'):j['passed']=!![];const k=b['find'](D=>D['id']==='C-T-08');if(c['um']!==undefined){const D=c['um']===null||typeof c['um']==='string'&&c['um']['startsWith']('0x')&&c['um']['length']>=0x28;k['passed']=D,k['message']=D?'':'UM\x20'+c['um']+'\x20invalid\x20(must\x20be\x20Contact\x20object\x20address\x20or\x20null)';}else k['passed']=!![];const l=b['find'](E=>E['id']==='C-T-09');c['withdraw']?(l['passed']=![],l['message']='Pending\x20user\x20confirmation\x20in\x20Layer\x203\x20(QT3/QT4)'):l['passed']=!![];const m=b['find'](E=>E['id']==='C-T-10'),n=(a['current_permission_indexes_granted']??[])['filter'](E=>E===0x103||E===0x104),o=n['length']===0x0;return m['passed']=o,m['message']=o?'':'Stale\x20indexes\x20259/260\x20detected:\x20'+n['join'](',')+'\x20(R-T-01\x20regression)',{'all_passed':b['filter'](E=>E['id']!=='C-T-09')['every'](E=>E['passed']),'items':b};}function adaptRiskAssessment(a){const b={'object':typeof a['treasury_json']['object']==='string'?a['treasury_json']['object']:null,'description':a['treasury_json']['description'],'deposit':a['treasury_json']['deposit']?{'coin_balance':a['treasury_json']['deposit']['coin']?.['balance'],'coin_object':a['treasury_json']['deposit']['coin']?.['coin_object'],'by_external_deposit_guard':a['treasury_json']['deposit']['by_external_deposit_guard']}:undefined,'withdraw':a['treasury_json']['withdraw']?{'amount_fixed':a['treasury_json']['withdraw']['amount']?.['fixed'],'amount_by_external_withdraw_guard':a['treasury_json']['withdraw']['amount']?.['by_external_withdraw_guard'],'recipient':a['treasury_json']['withdraw']['recipient']}:undefined,'external_deposit_guard':a['treasury_json']['external_deposit_guard'],'external_withdraw_guard':a['treasury_json']['external_withdraw_guard'],'owner_receive':a['treasury_json']['owner_receive'],'um':a['treasury_json']['um'],'permission_address':a['permission_address'],'type_parameter':a['type_parameter'],'current_balance':a['current_balance'],'current_external_deposit_guard_count':a['current_external_deposit_guard_count'],'current_external_withdraw_guard_count':a['current_external_withdraw_guard_count'],'shared_with_service':a['shared_with_service'],'shared_with_allocator':a['shared_with_allocator'],'shared_with_arbitration':a['shared_with_arbitration'],'current_permission_indexes_granted':a['current_permission_indexes_granted']};return assessTreasuryRisks(b);}export const TREASURY_CONFIRMATION_QUESTIONS=[{'id':'QT1','question':'Is\x20the\x20Coin\x20type\x20T\x20(type_parameter)\x20correct\x20and\x20matching\x20all\x20expected\x20deposit/withdraw\x20operations?','requires_explicit_yes':!![]},{'id':'QT2','question':'Is\x20the\x20associated\x20Permission\x20object\x20correctly\x20configured\x20with\x20intended\x20admin/entity/index\x20assignments?','requires_explicit_yes':!![]},{'id':'QT3','question':'⚠️\x20If\x20withdrawing\x20(fixed\x20amount):\x20do\x20you\x20confirm\x20the\x20recipient\x20address\x20and\x20amount\x20are\x20correct?\x20This\x20operation\x20is\x20IRREVERSIBLE.','requires_explicit_yes':!![],'related_risk_ids':['R-T-4-01']},{'id':'QT4','question':'⚠️\x20If\x20external_withdraw\x20via\x20Guard:\x20do\x20you\x20confirm\x20the\x20Guard\x20rules\x20match\x20business\x20intent\x20and\x20the\x20identifier\x20points\x20to\x20the\x20correct\x20amount\x20field?\x20IRREVERSIBLE.','requires_explicit_yes':!![],'related_risk_ids':['R-T-4-02']},{'id':'QT5','question':'If\x20configuring\x20external_deposit/withdraw_guard:\x20are\x20the\x20Guard\x20table\x20fields\x20correctly\x20typed\x20(number\x20for\x20identifier,\x20address-compatible\x20for\x20store_from_id)?','requires_explicit_yes':!![],'related_risk_ids':['R-T-1-04']},{'id':'QT6','question':'If\x20sharing\x20Permission\x20with\x20a\x20Service\x20or\x20referenced\x20by\x20Allocator/Arbitration:\x20have\x20you\x20verified\x20the\x20cross-object\x20consistency\x20(R-T-5-01\x20/\x20R-T-5-02)?','requires_explicit_yes':![]}];function processUserConfirmation(a,b){const c=[...TREASURY_CONFIRMATION_QUESTIONS];if(!a['treasury_json']['withdraw']?.['amount']?.['fixed']){const d=c['findIndex'](e=>e['id']==='QT3');if(d>=0x0)c['splice'](d,0x1);}if(!a['treasury_json']['withdraw']?.['amount']?.['by_external_withdraw_guard']){const e=c['findIndex'](f=>f['id']==='QT4');if(e>=0x0)c['splice'](e,0x1);}if(!a['treasury_json']['external_deposit_guard']&&!a['treasury_json']['external_withdraw_guard']){const f=c['findIndex'](g=>g['id']==='QT5');if(f>=0x0)c['splice'](f,0x1);}if(!a['shared_with_service']&&!a['shared_with_allocator']&&!a['shared_with_arbitration']){const g=c['findIndex'](h=>h['id']==='QT6');if(g>=0x0)c['splice'](g,0x1);}if(a['skip_user_confirmation'])return{'questions_asked':c,'responses':c['map'](h=>({'question_id':h['id'],'response':'yes'})),'all_confirmed':!![]};return{'questions_asked':c,'responses':[],'all_confirmed':![]};}function verifyEnvironment(a){const b=[];typeof a['treasury_json']['object']==='string'&&b['push']({'name':'treasury_object_exists','passed':!![],'message':'Treasury\x20object\x20'+a['treasury_json']['object']+'\x20assumed\x20to\x20exist'});(a['permission_address']||typeof a['treasury_json']['object']==='object')&&b['push']({'name':'permission_object_exists','passed':!![],'message':'Permission\x20object\x20exists\x20and\x20is\x20bound\x20to\x20Treasury'});const c=[];a['treasury_json']['deposit']&&!a['treasury_json']['deposit']['by_external_deposit_guard']&&c['push'](0xfc);if(a['treasury_json']['withdraw']?.['amount']?.['fixed'])c['push'](0xfe);if(a['treasury_json']['external_deposit_guard'])c['push'](0xff);if(a['treasury_json']['external_withdraw_guard'])c['push'](0x100);if(a['treasury_json']['owner_receive'])c['push'](0x101);if(a['treasury_json']['um']!==undefined)c['push'](0x102);if(a['treasury_json']['receive'])c['push'](0xfd);if(c['length']>0x0){const e=a['current_permission_indexes_granted']??[],f=c['filter'](g=>!e['includes'](g));b['push']({'name':'signer_has_required_permissions','passed':f['length']===0x0,'message':f['length']===0x0?'Signer\x20has\x20all\x20required\x20indexes:\x20'+c['join'](','):'Signer\x20missing\x20required\x20indexes:\x20'+f['join'](',')+'\x20(granted:\x20'+e['join'](',')+')'});}(a['treasury_json']['deposit']?.['by_external_deposit_guard']||a['treasury_json']['withdraw']?.['amount']?.['by_external_withdraw_guard'])&&b['push']({'name':'passport_provided_for_external_ops','passed':!![],'message':'External\x20operations\x20require\x20Passport\x20submission\x20(verified\x20at\x20SDK\x20call\x20time)'});if(a['treasury_json']['withdraw']?.['amount']?.['fixed']&&a['current_balance']){const g=BigInt(a['treasury_json']['withdraw']['amount']['fixed']),h=BigInt(a['current_balance']),i=g<=h;b['push']({'name':'balance_sufficient_for_withdraw','passed':i,'message':i?'Balance\x20'+a['current_balance']+'\x20>=\x20withdraw\x20'+a['treasury_json']['withdraw']['amount']['fixed']:'Balance\x20'+a['current_balance']+'\x20<\x20withdraw\x20'+a['treasury_json']['withdraw']['amount']['fixed']+'\x20(E_WITHDRAW_INSUFFICIENT_AMOUNT)'});}const d=b['every'](j=>j['passed']);return{'passed':d,'checks':b};}export const TREASURY_CONFIRM_VERSION='1.0.0';export function runTreasuryConfirmGate(a){const b=[],c=[],d=runStaticChecklist(a);if(!d['all_passed'])return c['push']('L1_checklist'),{'status':'blocked_checklist','checklist_result':d,'confirmation_text':generateConfirmationText(a,d),'block_reason':'Checklist\x20failed:\x20'+d['items']['filter'](h=>!h['passed'])['map'](h=>h['id'])['join'](',\x20'),'decision_record':{'timestamp':new Date()['toISOString'](),'gate_version':TREASURY_CONFIRM_VERSION,'final_status':'blocked_checklist','layers_passed':b,'layers_failed':c}};b['push']('L1_checklist');const e=adaptRiskAssessment(a),f=e['risks']['some'](h=>h['level']==='CRITICAL');if(f)return c['push']('L2_risk'),{'status':'blocked_risk','checklist_result':d,'risk_result':e,'confirmation_text':generateConfirmationText(a,d,e),'block_reason':'CRITICAL\x20risks:\x20'+e['risks']['filter'](h=>h['level']==='CRITICAL')['map'](h=>h['id'])['join'](',\x20'),'decision_record':{'timestamp':new Date()['toISOString'](),'gate_version':TREASURY_CONFIRM_VERSION,'final_status':'blocked_risk','layers_passed':b,'layers_failed':c}};b['push']('L2_risk');const g=processUserConfirmation(a,e);if(!g['all_confirmed']){if(a['treasury_json']['withdraw']){const h=d['items']['find'](j=>j['id']==='C-T-09');if(h){const i=g['responses']['find'](l=>l['question_id']==='QT3'),j=g['responses']['find'](l=>l['question_id']==='QT4'),k=[i,j]['filter'](l=>l!==undefined);k['length']>0x0&&(h['passed']=k['every'](l=>l?.['response']==='yes'),h['message']=h['passed']?'':'Withdraw\x20not\x20confirmed\x20by\x20user');}}if(a['treasury_json']['withdraw']){const l=d['items']['find'](m=>m['id']==='C-T-09');if(l&&!l['passed'])return c['push']('L3_user'),{'status':'blocked_user','checklist_result':d,'risk_result':e,'user_confirmation':g,'confirmation_text':generateConfirmationText(a,d,e),'block_reason':'User\x20did\x20not\x20confirm\x20withdraw\x20operation','decision_record':{'timestamp':new Date()['toISOString'](),'gate_version':TREASURY_CONFIRM_VERSION,'final_status':'blocked_user','layers_passed':b,'layers_failed':c}};}}b['push']('L3_user');if(a['skip_environment_check'])b['push']('L4_environment');else{const m=verifyEnvironment(a);if(!m['passed'])return c['push']('L4_environment'),{'status':'blocked_environment','checklist_result':d,'risk_result':e,'user_confirmation':g,'environment_result':m,'confirmation_text':generateConfirmationText(a,d,e),'block_reason':'Environment\x20check\x20failed:\x20'+m['checks']['filter'](n=>!n['passed'])['map'](n=>n['name'])['join'](',\x20'),'decision_record':{'timestamp':new Date()['toISOString'](),'gate_version':TREASURY_CONFIRM_VERSION,'final_status':'blocked_environment','layers_passed':b,'layers_failed':c}};b['push']('L4_environment');}return{'status':'approved','checklist_result':d,'risk_result':e,'user_confirmation':g,'confirmation_text':generateConfirmationText(a,d,e),'decision_record':{'timestamp':new Date()['toISOString'](),'gate_version':TREASURY_CONFIRM_VERSION,'final_status':'approved','layers_passed':b,'layers_failed':c}};}function generateConfirmationText(a,b,c){const d=[],e=a['treasury_json'];d['push']('═══\x20Treasury\x20Confirmation\x20═══'),d['push']('');if(typeof e['object']==='string')d['push']('Treasury:\x20'+e['object']);else{if(typeof e['object']==='object'&&e['object']!==null){const f=e['object'];d['push']('Treasury:\x20NEW\x20(name='+(f['name']??'?')+',\x20T='+(f['type_parameter']??'?')+')');}else d['push']('Treasury:\x20(invalid\x20object\x20field)');}if(e['description'])d['push']('Description:\x20'+e['description']);if(a['type_parameter'])d['push']('Type\x20parameter:\x20'+a['type_parameter']);d['push'](''),d['push']('─\x20Checklist\x20──────────────────');for(const g of b['items']){const h=g['passed']?'✓':'✗';d['push']('\x20\x20'+h+'\x20'+g['id']+':\x20'+g['description']+(g['message']?'\x20—\x20'+g['message']:''));}d['push']('');if(c){d['push']('─\x20Risk\x20Assessment\x20──────────────────'),d['push']('Overall:\x20'+c['overall_risk']),d['push']('Detected:\x20'+c['risks']['length']+'\x20risk(s)');for(const i of c['risks']){d['push']('\x20\x20['+i['level']+']\x20'+i['id']+':\x20'+i['title']);}d['push']('');}d['push']('─\x20Operations\x20──────────────────');e['deposit']&&(e['deposit']['by_external_deposit_guard']?d['push']('-\x20External\x20deposit\x20via\x20guard:\x20'+e['deposit']['by_external_deposit_guard']):d['push']('-\x20Internal\x20deposit\x20(Permission\x20252)'));if(e['withdraw']){if(e['withdraw']['amount']?.['fixed'])d['push']('-\x20⚠️\x20Internal\x20withdraw\x20(Permission\x20254):\x20'+e['withdraw']['amount']['fixed']+'\x20to\x20'+(e['withdraw']['recipient']??'?'));else e['withdraw']['amount']?.['by_external_withdraw_guard']&&d['push']('-\x20⚠️\x20External\x20withdraw\x20via\x20guard:\x20'+e['withdraw']['amount']['by_external_withdraw_guard']+'\x20to\x20'+(e['withdraw']['recipient']??'?'));}if(e['receive'])d['push']('-\x20Receive\x20CoinWrapper\x20(Permission\x20253)');if(e['owner_receive'])d['push']('-\x20owner_receive\x20forward\x20(Permission\x20257)');if(e['external_deposit_guard'])d['push']('-\x20Manage\x20external_deposit_guard\x20(Permission\x20255):\x20op='+e['external_deposit_guard']['op']);if(e['external_withdraw_guard'])d['push']('-\x20Manage\x20external_withdraw_guard\x20(Permission\x20256):\x20op='+e['external_withdraw_guard']['op']);if(e['um']!==undefined)d['push']('-\x20UM:\x20'+(e['um']??'(revoke)'));return d['push'](''),d['join']('\x0a');}export function progressiveTreasuryCheck(a){const b=runStaticChecklist(a);if(!b['all_passed'])return{'stage':'checklist','status':'fail','message':'Checklist\x20failed:\x20'+b['items']['filter'](d=>!d['passed'])['map'](d=>d['id'])['join'](',\x20'),'next_action':'Fix\x20failing\x20checklist\x20items'};const c=adaptRiskAssessment(a);if(c['risks']['some'](d=>d['level']==='CRITICAL'))return{'stage':'risk','status':'fail','message':'CRITICAL\x20risks:\x20'+c['risks']['filter'](d=>d['level']==='CRITICAL')['map'](d=>d['id'])['join'](',\x20'),'next_action':'Resolve\x20CRITICAL\x20risks\x20before\x20proceeding\x20(especially\x20withdraw\x20irreversibility)'};if(c['needs_human_review'])return{'stage':'confirmation','status':'pending','message':'Human\x20review\x20required\x20for\x20HIGH\x20risks\x20(withdraw/external\x20operations)','next_action':'Confirm\x20risk\x20acceptance\x20via\x20QT1-QT6\x20questions'};return{'stage':'complete','status':'pass','message':'All\x20checks\x20passed'};}

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

@@ -1,64 +0,0 @@
-import { type TreasuryScene, type BuiltinTreasuryPermissionEntry } from "./treasury-ledger.js";
-import { type TreasuryTemplate } from "./treasury-templates.js";
-import { type SemanticToSchemaRule } from "./treasury-translation.js";
-import { type TreasuryRiskRule, type TreasuryRiskAssessment, type TreasuryStakeholder } from "./treasury-risk.js";
-import { type TreasuryPuzzle, type TreasuryPuzzleCompleteness } from "./treasury-puzzle.js";
-import { TREASURY_PUBLISH_CHECKLIST, TREASURY_CONFIRMATION_QUESTIONS, type TreasuryJsonForConfirm } from "./treasury-confirm.js";
-export declare const TREASURY_CONTEXT_VERSION = "1.0.0";
-export type TreasuryInjectionMode = "initial_design" | "mid_design_review" | "pre_publish" | "post_publish_modify" | "stakeholder_review" | "cross_object_check";
-export type TreasuryStakeholderPerspective = TreasuryStakeholder | "system";
-export interface TreasuryContextBundle {
-    version: string;
-    mode: TreasuryInjectionMode;
-    stakeholder_perspective?: TreasuryStakeholderPerspective;
-    matched_scene?: TreasuryScene;
-    matched_template?: TreasuryTemplate;
-    matched_pattern?: SemanticToSchemaRule;
-    puzzle_state?: TreasuryPuzzle;
-    puzzle_completeness?: TreasuryPuzzleCompleteness;
-    relevant_risks: TreasuryRiskRule[];
-    risk_assessment?: TreasuryRiskAssessment;
-    relevant_checklist: typeof TREASURY_PUBLISH_CHECKLIST;
-    relevant_questions: typeof TREASURY_CONFIRMATION_QUESTIONS;
-    relevant_builtin_permissions: BuiltinTreasuryPermissionEntry[];
-    reserved_builtin_permissions: BuiltinTreasuryPermissionEntry[];
-    cross_object_refs: TreasuryCrossObjectRef[];
-    onchain_constraints: TreasuryOnchainConstraint[];
-    rendering_hints: TreasuryRenderingHints;
-}
-export interface TreasuryCrossObjectRef {
-    object: "Permission" | "Guard" | "Passport" | "Payment" | "CoinWrapper" | "Contact" | "Allocator" | "Arbitration" | "Service" | "Registrar" | "Clock" | "ObjectLinkerCore";
-    field: string;
-    description: string;
-    collaboration_type: "dependency" | "referenced_by" | "parallel_design";
-}
-export interface TreasuryOnchainConstraint {
-    name: string;
-    value: string | number;
-    description: string;
-}
-export interface TreasuryRenderingHints {
-    include_puzzle_template: boolean;
-    include_risk_details: boolean;
-    include_questions: boolean;
-    include_irreversibility_warning: boolean;
-    include_external_guard_warning: boolean;
-    include_cross_object_warning: boolean;
-    max_length: number;
-}
-export interface BuildTreasuryContextInput {
-    mode: TreasuryInjectionMode;
-    intent?: string;
-    treasury_json?: TreasuryJsonForConfirm;
-    stakeholder?: TreasuryStakeholderPerspective;
-    target_permission_index?: number;
-    type_parameter?: string;
-    max_length?: number;
-    shared_with_service?: boolean;
-    shared_with_allocator?: boolean;
-    shared_with_arbitration?: boolean;
-    current_permission_indexes_granted?: number[];
-}
-export declare function buildTreasuryContext(input: BuildTreasuryContextInput): TreasuryContextBundle;
-export declare function buildPromptFromTreasuryContext(bundle: TreasuryContextBundle): string;
-export declare function getTreasuryContextSummary(bundle: TreasuryContextBundle): string;

package/dist/knowledge/treasury-context.js

@@ -1 +0,0 @@
-import{USER_DEFINED_PERM_INDEX_START,MAX_ADMIN_COUNT,MAX_PERM_FOR_ENTITY,MAX_ENTITY_COUNT}from'@wowok/wowok';import{findSceneById,findSceneByPermissionIndex,inferSceneFromIntent,getActiveBuiltinPermissions,getReservedBuiltinPermissions}from'./treasury-ledger.js';import{getTemplatesByScene}from'./treasury-templates.js';import{matchSemanticPattern}from'./treasury-translation.js';import{getAllTreasuryRiskRules,assessTreasuryRisks}from'./treasury-risk.js';import{initPuzzleFromIntent,checkPuzzleCompleteness,MAX_EXTERNAL_DEPOSIT_GUARD_COUNT,MAX_EXTERNAL_WITHDRAW_GUARD_COUNT,MAX_DESCRIPTION_LENGTH}from'./treasury-puzzle.js';import{TREASURY_PUBLISH_CHECKLIST,TREASURY_CONFIRMATION_QUESTIONS}from'./treasury-confirm.js';export const TREASURY_CONTEXT_VERSION='1.0.0';export function buildTreasuryContext(a){const b=a['max_length']??0xfa0;let c;if(a['intent'])c=inferSceneFromIntent(a['intent']);else a['target_permission_index']!==undefined&&(c=findSceneByPermissionIndex(a['target_permission_index']));!c&&a['intent']&&(c=findSceneById('treasury_fund_collection'));let d;if(c){const q=getTemplatesByScene(c['id']);if(q['length']>0x0)d=q[0x0];}let e;if(a['intent']){const r=matchSemanticPattern(a['intent']);if(r['length']>0x0)e=r[0x0];}let f,g;a['mode']==='initial_design'&&a['intent']&&(f=initPuzzleFromIntent({'rule_sentence':a['intent']}),g=checkPuzzleCompleteness(f));const h=filterRiskRules(a['mode'],a['stakeholder'],c);let i;if((a['mode']==='pre_publish'||a['mode']==='mid_design_review')&&a['treasury_json']){const s={'object':typeof a['treasury_json']['object']==='string'?a['treasury_json']['object']:null,'description':a['treasury_json']['description'],'deposit':a['treasury_json']['deposit']?{'coin_balance':a['treasury_json']['deposit']['coin']?.['balance'],'coin_object':a['treasury_json']['deposit']['coin']?.['coin_object'],'by_external_deposit_guard':a['treasury_json']['deposit']['by_external_deposit_guard']}:undefined,'withdraw':a['treasury_json']['withdraw']?{'amount_fixed':a['treasury_json']['withdraw']['amount']?.['fixed'],'amount_by_external_withdraw_guard':a['treasury_json']['withdraw']['amount']?.['by_external_withdraw_guard'],'recipient':a['treasury_json']['withdraw']['recipient']}:undefined,'external_deposit_guard':a['treasury_json']['external_deposit_guard'],'external_withdraw_guard':a['treasury_json']['external_withdraw_guard'],'owner_receive':a['treasury_json']['owner_receive'],'um':a['treasury_json']['um'],'type_parameter':a['type_parameter'],'shared_with_service':a['shared_with_service'],'shared_with_allocator':a['shared_with_allocator'],'shared_with_arbitration':a['shared_with_arbitration'],'current_permission_indexes_granted':a['current_permission_indexes_granted']};i=assessTreasuryRisks(s);}const j=filterChecklist(a['mode']),k=filterQuestions(a['mode']),l=c?c['builtin_indexes']['filter'](t=>t['active']):getActiveBuiltinPermissions(),m=getReservedBuiltinPermissions(),n=buildCrossObjectRefs(a['mode'],c),o=buildOnchainConstraints(),p=buildRenderingHints(a['mode'],b,!!a['treasury_json']?.['withdraw'],!!a['treasury_json']?.['external_deposit_guard']||!!a['treasury_json']?.['external_withdraw_guard'],!!a['shared_with_service']||!!a['shared_with_allocator']||!!a['shared_with_arbitration']);return{'version':TREASURY_CONTEXT_VERSION,'mode':a['mode'],'stakeholder_perspective':a['stakeholder'],'matched_scene':c,'matched_template':d,'matched_pattern':e,'puzzle_state':f,'puzzle_completeness':g,'relevant_risks':h,'risk_assessment':i,'relevant_checklist':j,'relevant_questions':k,'relevant_builtin_permissions':l,'reserved_builtin_permissions':m,'cross_object_refs':n,'onchain_constraints':o,'rendering_hints':p};}function filterRiskRules(a,b,c){let d=getAllTreasuryRiskRules();if(a==='initial_design')return d['filter'](e=>e['category']==='structural'||e['category']==='authority');if(a==='pre_publish')return d;if(a==='stakeholder_review'&&b){if(b==='owner')return d['filter'](e=>e['category']==='authority'||e['category']==='lifecycle');if(b==='admin')return d['filter'](e=>e['category']==='structural'||e['category']==='semantic');if(b==='depositor')return d['filter'](e=>e['id']==='R-T-2-02'||e['id']==='R-T-2-03'||e['category']==='structural');if(b==='withdrawer')return d['filter'](e=>e['id']==='R-T-4-01'||e['id']==='R-T-4-02'||e['id']==='R-T-3-01');if(b==='external_operator')return d['filter'](e=>e['id']==='R-T-2-01'||e['id']==='R-T-2-03'||e['id']==='R-T-4-02');if(b==='system')return d['filter'](e=>e['category']==='cross_object'||e['id']==='R-T-0-01');}if(a==='cross_object_check')return d['filter'](e=>e['category']==='cross_object');return d;}function filterChecklist(a){if(a==='initial_design')return TREASURY_PUBLISH_CHECKLIST['filter'](b=>['C-T-01','C-T-02','C-T-03','C-T-10']['includes'](b['id']));return TREASURY_PUBLISH_CHECKLIST;}function filterQuestions(a){if(a==='pre_publish')return TREASURY_CONFIRMATION_QUESTIONS;if(a==='post_publish_modify')return TREASURY_CONFIRMATION_QUESTIONS['filter'](b=>b['id']!=='QT1');return[];}function buildCrossObjectRefs(a,b){const c=[];return c['push']({'object':'Permission','field':'permission','description':'All\x20Treasury\x20write\x20operations\x20(except\x20external_deposit/withdraw)\x20require\x20Permission\x20authorization\x20via\x20indexes\x20250-258','collaboration_type':'dependency'}),c['push']({'object':'ObjectLinkerCore','field':'object_linker','description':'Tracks\x20object-linker\x20core\x20bindings\x20between\x20Treasury,\x20Permission,\x20and\x20UM\x20(Contact)\x20objects','collaboration_type':'dependency'}),c['push']({'object':'Clock','field':'clock','description':'Provides\x20timestamp\x20for\x20Record\x20entries\x20in\x20history\x20ParentTable','collaboration_type':'dependency'}),(b?.['id']==='treasury_external_ops'||b?.['id']==='treasury_guard_protection'||a==='cross_object_check')&&(c['push']({'object':'Guard','field':'external_deposit_guard\x20/\x20external_withdraw_guard','description':'Guard\x20objects\x20referenced\x20by\x20external_*_guard\x20lists;\x20provide\x20programmable\x20access\x20rules\x20for\x20external\x20deposit/withdraw','collaboration_type':'dependency'}),c['push']({'object':'Passport','field':'passport','description':'Required\x20for\x20every\x20external_deposit\x20/\x20external_withdraw\x20call;\x20carries\x20submission\x20values\x20verified\x20by\x20Guard','collaboration_type':'dependency'})),c['push']({'object':'Allocator','field':'sharing.who=Entity','description':'Allocator\x20can\x20reference\x20Treasury\x20address\x20as\x20fund\x20split\x20target;\x20Treasury.receive\x20(253)\x20converts\x20CoinWrapper\x20to\x20balance','collaboration_type':'referenced_by'}),c['push']({'object':'Arbitration','field':'fees_transfer','description':'Arbitration.fees_transfer\x20sends\x20Payment\x20to\x20Treasury\x20address;\x20Treasury.receive\x20(253)\x20required\x20to\x20intake','collaboration_type':'referenced_by'}),c['push']({'object':'Service','field':'compensation_fund\x20(parallel\x20design)','description':'Service.compensation_fund\x20is\x20a\x20parallel\x20design\x20(NOT\x20a\x20Treasury\x20object);\x20both\x20are\x20Balance<T>\x20containers\x20but\x20implementation-independent','collaboration_type':'parallel_design'}),c['push']({'object':'Contact','field':'um','description':'Optional\x20UM\x20(User\x20Manager)\x20Contact\x20object;\x20manages\x20user-tier\x20information\x20via\x20object_linker::affiliation_core','collaboration_type':'dependency'}),c['push']({'object':'Payment','field':'history\x20ParentTable','description':'Every\x20deposit/withdraw/receive\x20creates\x20a\x20Payment\x20object;\x20Payment\x20address\x20is\x20the\x20key\x20in\x20history\x20ParentTable','collaboration_type':'dependency'}),c['push']({'object':'CoinWrapper','field':'receive','description':'CoinWrapper\x20is\x20the\x20received\x20form\x20of\x20coins;\x20Treasury.receive\x20(253)\x20unwraps\x20CoinWrapper\x20to\x20balance','collaboration_type':'dependency'}),c;}function buildOnchainConstraints(){return[{'name':'MAX_EXTERNAL_DEPOSIT_GUARD_COUNT','value':MAX_EXTERNAL_DEPOSIT_GUARD_COUNT,'description':'Maximum\x20external_deposit_guard\x20entries\x20(Treasury-specific,\x20not\x20yet\x20in\x20onchain-constants.ts)'},{'name':'MAX_EXTERNAL_WITHDRAW_GUARD_COUNT','value':MAX_EXTERNAL_WITHDRAW_GUARD_COUNT,'description':'Maximum\x20external_withdraw_guard\x20entries\x20(Treasury-specific,\x20not\x20yet\x20in\x20onchain-constants.ts)'},{'name':'MAX_DESCRIPTION_LENGTH','value':MAX_DESCRIPTION_LENGTH,'description':'Maximum\x20description\x20length\x20(shared\x20across\x20all\x20objects)'},{'name':'USER_DEFINED_PERM_INDEX_START','value':USER_DEFINED_PERM_INDEX_START,'description':'Custom\x20permission\x20indexes\x20must\x20be\x20>=\x20this\x20value'},{'name':'MAX_ENTITY_COUNT','value':MAX_ENTITY_COUNT,'description':'Maximum\x20entities\x20per\x20Permission\x20(shared)'},{'name':'MAX_PERM_FOR_ENTITY','value':MAX_PERM_FOR_ENTITY,'description':'Maximum\x20permission\x20indexes\x20per\x20entity\x20(shared)'},{'name':'MAX_ADMIN_COUNT','value':MAX_ADMIN_COUNT,'description':'Maximum\x20admins\x20per\x20Permission\x20(shared)'}];}function buildRenderingHints(a,b,c,d,e){return{'include_puzzle_template':a==='initial_design','include_risk_details':a==='pre_publish'||a==='stakeholder_review'||a==='mid_design_review','include_questions':a==='pre_publish','include_irreversibility_warning':c,'include_external_guard_warning':d,'include_cross_object_warning':e||a==='cross_object_check','max_length':b};}export function buildPromptFromTreasuryContext(a){const b=[],d=a['rendering_hints'];b['push']('═══\x20Treasury\x20Context\x20(mode:\x20'+a['mode']+')\x20═══'),b['push']('');a['stakeholder_perspective']&&(b['push']('Stakeholder\x20perspective:\x20'+a['stakeholder_perspective']),b['push'](''));a['matched_scene']&&(b['push']('Scene:\x20'+a['matched_scene']['name']),b['push']('Scene\x20ID:\x20'+a['matched_scene']['id']),b['push']('Permission\x20range:\x20'+a['matched_scene']['permission_index_range']),b['push'](''));a['matched_template']&&(b['push']('Suggested\x20template:\x20'+a['matched_template']['id']+'\x20—\x20'+a['matched_template']['name']),b['push'](''));if(d['include_puzzle_template']&&a['puzzle_completeness']){const e=a['puzzle_completeness'];b['push']('─\x20Puzzle\x20Completeness\x20──────────────'),b['push']('Complete:\x20'+(e['complete']?'YES':'NO')),e['missing']['length']>0x0&&b['push']('Missing:\x20'+e['missing']['join'](',\x20')),b['push']('Next:\x20'+e['next_step']),b['push']('');}if(d['include_risk_details']&&a['relevant_risks']['length']>0x0){b['push']('─\x20Relevant\x20Risk\x20Rules\x20('+a['relevant_risks']['length']+')\x20──────────────');for(const f of a['relevant_risks']['slice'](0x0,0x8)){b['push']('\x20\x20'+f['id']+'\x20—\x20'+f['trigger']);}a['relevant_risks']['length']>0x8&&b['push']('\x20\x20...\x20and\x20'+(a['relevant_risks']['length']-0x8)+'\x20more'),b['push']('');}if(a['risk_assessment']){b['push']('─\x20Risk\x20Assessment\x20──────────────'),b['push']('Overall:\x20'+a['risk_assessment']['overall_risk']),b['push']('Detected:\x20'+a['risk_assessment']['risks']['length']+'\x20risk(s)');for(const g of a['risk_assessment']['risks']['slice'](0x0,0x5)){b['push']('\x20\x20['+g['level']+']\x20'+g['id']+':\x20'+g['title']);}b['push']('');}if(a['relevant_builtin_permissions']['length']>0x0){b['push']('─\x20Builtin\x20Treasury\x20Permissions\x20(active:\x20'+a['relevant_builtin_permissions']['length']+')\x20──────────────');for(const i of a['relevant_builtin_permissions']){b['push']('\x20\x20['+i['index']+']\x20'+i['name']+':\x20'+i['description']);}b['push']('');}if(a['reserved_builtin_permissions']['length']>0x0){b['push']('─\x20Reserved\x20(no\x20Permission\x20index)\x20──────────────');for(const j of a['reserved_builtin_permissions']){b['push']('\x20\x20'+j['name']+':\x20'+j['description']);}b['push']('');}d['include_irreversibility_warning']&&(b['push']('⚠️\x20WITHDRAW\x20OPERATION\x20DETECTED\x20—\x20IRREVERSIBLE'),b['push']('\x20\x20-\x20withdraw\x20(fixed)\x20and\x20external_withdraw\x20cannot\x20be\x20undone'),b['push']('\x20\x20-\x20verify\x20recipient\x20address\x20twice'),b['push']('\x20\x20-\x20ensure\x20balance\x20sufficiency'),b['push'](''));d['include_external_guard_warning']&&(b['push']('⚠️\x20EXTERNAL\x20GUARD\x20MANAGEMENT\x20—\x20Verify\x20Guard\x20table\x20fields'),b['push']('\x20\x20-\x20identifier\x20must\x20be\x20number-type\x20(u8/u16/u32/u64/u128/u256)'),b['push']('\x20\x20-\x20store_from_id\x20must\x20be\x20address-compatible'),b['push']('\x20\x20-\x20external_withdraw_guard.identifier\x20is\x20REQUIRED\x20(u8,\x20not\x20Option)'),b['push']('\x20\x20-\x20external_deposit_guard.identifier\x20is\x20Option<u8>\x20(None\x20=\x20no\x20amount\x20limit)'),b['push'](''));d['include_cross_object_warning']&&(b['push']('⚠️\x20CROSS-OBJECT\x20COLLABORATION\x20—\x20Verify\x20consistency'),b['push']('\x20\x20-\x20If\x20shared\x20with\x20Service:\x20verify\x20Permission\x20indexes\x20250-258\x20(Treasury)\x20and\x20300-320\x20(Service)\x20align'),b['push']('\x20\x20-\x20If\x20referenced\x20by\x20Allocator/Arbitration:\x20TREASURY_RECEIVE\x20(253)\x20must\x20be\x20granted\x20for\x20CoinWrapper\x20intake'),b['push'](''));if(a['cross_object_refs']['length']>0x0){b['push']('─\x20Cross-Object\x20References\x20('+a['cross_object_refs']['length']+')\x20──────────────');for(const k of a['cross_object_refs']['slice'](0x0,0x6)){b['push']('\x20\x20['+k['collaboration_type']+']\x20'+k['object']+'.'+k['field']),b['push']('\x20\x20\x20\x20'+k['description']);}a['cross_object_refs']['length']>0x6&&b['push']('\x20\x20...\x20and\x20'+(a['cross_object_refs']['length']-0x6)+'\x20more'),b['push']('');}if(a['onchain_constraints']['length']>0x0){b['push']('─\x20On-chain\x20Constraints\x20──────────────');for(const l of a['onchain_constraints']){b['push']('\x20\x20'+l['name']+'\x20=\x20'+l['value']+'\x20—\x20'+l['description']);}b['push']('');}if(d['include_questions']&&a['relevant_questions']['length']>0x0){b['push']('─\x20Confirmation\x20Questions\x20──────────────');for(const m of a['relevant_questions']){const n=m['requires_explicit_yes']?'\x20⚠️':'';b['push']('\x20\x20'+m['id']+n+':\x20'+m['question']);}b['push']('');}return b['join']('\x0a');}export function getTreasuryContextSummary(a){const b=['mode='+a['mode'],'scene='+(a['matched_scene']?.['id']??'none'),'risks='+a['relevant_risks']['length'],'permissions='+a['relevant_builtin_permissions']['length']];if(a['stakeholder_perspective'])b['push']('stakeholder='+a['stakeholder_perspective']);if(a['risk_assessment'])b['push']('overall_risk='+a['risk_assessment']['overall_risk']);if(a['matched_template'])b['push']('template='+a['matched_template']['id']);return b['join'](',\x20');}

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

@@ -1,78 +0,0 @@
-export interface SemanticToSchemaRule {
-    id: string;
-    pattern_name: string;
-    semantic_intent: string;
-    match_keywords: string[];
-    schema_fields: string[];
-    example_json: object;
-    reverse_explanation: string;
-}
-export interface SchemaToSemanticRule {
-    element_type: "field" | "op" | "index";
-    type_name: string;
-    semantic_explanation: string;
-    constraints?: string[];
-}
-export interface TreasuryConstraintRule {
-    id: string;
-    category: "structural" | "semantic" | "authority" | "lifecycle" | "cross_object";
-    rule: string;
-    applies_to: string[];
-}
-export declare const SEMANTIC_TO_SCHEMA_RULES: SemanticToSchemaRule[];
-export declare const SCHEMA_TO_SEMANTIC_RULES: SchemaToSemanticRule[];
-export declare const TREASURY_CONSTRAINT_RULES: TreasuryConstraintRule[];
-export declare const TREASURY_TRANSLATION_VERSION = "1.0.0";
-export declare function matchSemanticPattern(userIntent: string): SemanticToSchemaRule[];
-export interface TreasuryCallDataForExplanation {
-    object?: string | object | null;
-    description?: string;
-    receive?: string[] | "recently" | object;
-    deposit?: {
-        coin?: {
-            balance?: string;
-            coin_object?: string;
-        };
-        by_external_deposit_guard?: string;
-        payment_info?: {
-            remark?: string;
-            index: number;
-        };
-    };
-    withdraw?: {
-        amount?: {
-            fixed?: string;
-            by_external_withdraw_guard?: string;
-        };
-        recipient?: string;
-        payment_info?: {
-            remark?: string;
-            index: number;
-        };
-    };
-    external_deposit_guard?: {
-        op: "add" | "set";
-        guards: object[];
-    } | {
-        op: "remove";
-        guards: string[];
-    } | {
-        op: "clear";
-    };
-    external_withdraw_guard?: {
-        op: "add" | "set";
-        guards: object[];
-    } | {
-        op: "remove";
-        guards: string[];
-    } | {
-        op: "clear";
-    };
-    owner_receive?: string[] | "recently";
-    um?: string | null;
-}
-export declare function explainTreasuryCallData(data: TreasuryCallDataForExplanation): string;
-export declare function explainField(fieldName: string): SchemaToSemanticRule | undefined;
-export declare function explainOp(opName: string): SchemaToSemanticRule | undefined;
-export declare function getConstraintsByCategory(category: TreasuryConstraintRule["category"]): TreasuryConstraintRule[];
-export declare function explainTreasuryPermissionIndex(index: number): string;

package/dist/knowledge/treasury-translation.js

@@ -1 +0,0 @@
-import{isBuiltinTreasuryPermission,getBuiltinPermissionByIndex,findSceneByPermissionIndex}from'./treasury-ledger.js';export const SEMANTIC_TO_SCHEMA_RULES=[{'id':'T-T-01','pattern_name':'Create\x20new\x20Treasury','semantic_intent':'Create\x20a\x20new\x20Treasury\x20with\x20a\x20Coin\x20type\x20T\x20and\x20associated\x20Permission','match_keywords':['create','new'],'schema_fields':['object\x20(TypeNamedObjectWithPermission)','description'],'example_json':{'object':{'name':'myteam_treasury','type_parameter':'0x2::wow::WOW','permission':{'name':'myteam_treasury_permission','description':'Permission\x20for\x20myteam\x20treasury'}},'description':'Team\x20treasury\x20for\x20project\x20X\x20funding'},'reverse_explanation':'object\x20must\x20be\x20in\x20OBJECT\x20format\x20(not\x20STRING)\x20for\x20creation;\x20type_parameter\x20is\x20the\x20Coin\x20type\x20T;\x20permission\x20can\x20be\x20new\x20or\x20existing'},{'id':'T-T-02','pattern_name':'Internal\x20deposit\x20(Permission\x20path)','semantic_intent':'Deposit\x20funds\x20to\x20Treasury\x20via\x20Permission\x20authorization','match_keywords':['deposit'],'schema_fields':['object\x20(string)','deposit.coin','deposit.payment_info'],'example_json':{'object':'myteam_treasury','deposit':{'coin':{'balance':'1000000000'},'payment_info':{'remark':'Q3\x20budget\x20allocation','index':0x0}}},'reverse_explanation':'deposit.by_external_deposit_guard\x20omitted\x20→\x20Permission\x20path\x20(TREASURY_DEPOSIT=252);\x20coin\x20can\x20be\x20{balance}\x20or\x20{coin_object}'},{'id':'T-T-03','pattern_name':'Internal\x20withdraw\x20(Permission\x20path,\x20fixed\x20amount)','semantic_intent':'Withdraw\x20fixed\x20amount\x20from\x20Treasury\x20via\x20Permission\x20authorization','match_keywords':['withdraw'],'schema_fields':['object\x20(string)','withdraw.amount.fixed','withdraw.recipient','withdraw.payment_info'],'example_json':{'object':'myteam_treasury','withdraw':{'amount':{'fixed':'500000000'},'recipient':'0xRECIPIENT','payment_info':{'remark':'Vendor\x20payment','index':0x1}}},'reverse_explanation':'withdraw.amount.fixed\x20→\x20Permission\x20path\x20(TREASURY_WITHDRAW=254);\x20amount\x20is\x20fixed\x20u64;\x20irreversible'},{'id':'T-T-04','pattern_name':'External\x20deposit\x20(Guard\x20+\x20Passport\x20path)','semantic_intent':'External\x20user\x20deposits\x20via\x20preset\x20Guard\x20verification\x20(no\x20Permission\x20needed)','match_keywords':['external\x20deposit','guard\x20deposit'],'schema_fields':['object\x20(string)','deposit.coin','deposit.by_external_deposit_guard','deposit.payment_info','submission\x20(Passport)'],'example_json':{'object':'myteam_treasury','deposit':{'coin':{'balance':'200000000'},'by_external_deposit_guard':'deposit_guard_v1','payment_info':{'remark':'External\x20deposit\x20via\x20guard','index':0x2}}},'reverse_explanation':'deposit.by_external_deposit_guard\x20present\x20→\x20Guard\x20path\x20(NO\x20Permission\x20check);\x20Passport\x20required\x20via\x20submission\x20field;\x20amount\x20may\x20split\x20if\x20coin\x20>\x20guard-specified'},{'id':'T-T-05','pattern_name':'External\x20withdraw\x20(Guard\x20+\x20Passport\x20path,\x20amount\x20from\x20Guard)','semantic_intent':'External\x20user\x20withdraws\x20via\x20preset\x20Guard\x20verification;\x20amount\x20determined\x20by\x20Guard\x20table\x20identifier','match_keywords':['external\x20withdraw','guard\x20withdraw'],'schema_fields':['object\x20(string)','withdraw.amount.by_external_withdraw_guard','withdraw.recipient','withdraw.payment_info','submission\x20(Passport)'],'example_json':{'object':'myteam_treasury','withdraw':{'amount':{'by_external_withdraw_guard':'withdraw_guard_v1'},'recipient':'0xRECIPIENT','payment_info':{'remark':'External\x20withdraw\x20via\x20guard','index':0x3}}},'reverse_explanation':'withdraw.amount.by_external_withdraw_guard\x20→\x20Guard\x20path\x20(NO\x20Permission\x20check);\x20amount\x20comes\x20from\x20Guard\x20table\x20identifier\x20(u8,\x20required);\x20irreversible'},{'id':'T-T-06','pattern_name':'Manage\x20external\x20deposit/withdraw\x20Guard\x20(add/set/remove/clear)','semantic_intent':'Add,\x20set,\x20remove,\x20or\x20clear\x20external_deposit_guard\x20/\x20external_withdraw_guard\x20lists','match_keywords':['guard\x20add','guard\x20set','guard\x20remove','guard\x20clear'],'schema_fields':['object\x20(string)','external_deposit_guard\x20|\x20external_withdraw_guard'],'example_json':{'object':'myteam_treasury','external_deposit_guard':{'op':'add','guards':[{'guard':'deposit_guard_v1','identifier':0x2,'store_from_id':null}]}},'reverse_explanation':'op=\x27add\x27\x20(upsert)\x20/\x20\x27set\x27\x20(clear+add)\x20/\x20\x27remove\x27\x20(by\x20guard\x20address)\x20/\x20\x27clear\x27\x20(empty\x20list);\x20Permission\x20index\x20255\x20(deposit)\x20/\x20256\x20(withdraw)\x20required'},{'id':'T-T-07','pattern_name':'Receive\x20CoinWrapper\x20/\x20owner_receive\x20forward','semantic_intent':'Receive\x20CoinWrapper\x20into\x20balance,\x20or\x20forward\x20received\x20objects\x20to\x20Permission\x20owner','match_keywords':['receive','owner_receive','forward'],'schema_fields':['object\x20(string)','receive\x20|\x20owner_receive'],'example_json':{'object':'myteam_treasury','receive':'recently'},'reverse_explanation':'receive\x20→\x20TREASURY_RECEIVE=253,\x20converts\x20CoinWrapper\x20to\x20balance,\x20writes\x20Record;\x20owner_receive\x20→\x20TREASURY_OWNER_RECEIVE=257,\x20forwards\x20to\x20Permission.owner,\x20no\x20Record'},{'id':'T-T-08','pattern_name':'Set\x20UM\x20/\x20modify\x20description','semantic_intent':'Delegate\x20User\x20Manager\x20(Contact\x20object)\x20or\x20modify\x20Treasury\x20description','match_keywords':['um','um_set','um_none','description','delegate'],'schema_fields':['object\x20(string)','um\x20|\x20description'],'example_json':{'object':'myteam_treasury','um':'team_contact'},'reverse_explanation':'um=address\x20→\x20TREASURY_UM=258\x20(um_set);\x20um=null\x20→\x20TREASURY_UM=258\x20(um_none);\x20description=string\x20→\x20TREASURY_DESCRIPTION=251'}];export const SCHEMA_TO_SEMANTIC_RULES=[{'element_type':'field','type_name':'object','semantic_explanation':'Treasury\x20object\x20reference.\x20STRING=operate\x20existing;\x20OBJECT={name,\x20type_parameter,\x20permission}=create\x20new','constraints':['type_parameter\x20required\x20at\x20creation,\x20immutable\x20thereafter','permission\x20can\x20be\x20new\x20(TypeNamedObject)\x20or\x20existing\x20(string\x20address)']},{'element_type':'field','type_name':'description','semantic_explanation':'Human-readable\x20description\x20of\x20Treasury\x20purpose.\x20Max\x204000\x20chars\x20(MAX_DESCRIPTION_LENGTH).','constraints':['<=\x204000\x20chars','Modifiable\x20via\x20TREASURY_DESCRIPTION\x20(251)']},{'element_type':'field','type_name':'deposit','semantic_explanation':'Deposit\x20operation.\x20Two\x20access\x20paths:\x20(1)\x20Permission\x20path\x20(by_external_deposit_guard\x20omitted,\x20requires\x20TREASURY_DEPOSIT=252);\x20(2)\x20Guard\x20path\x20(by_external_deposit_guard\x20set,\x20requires\x20Passport,\x20no\x20Permission)'},{'element_type':'field','type_name':'deposit.coin','semantic_explanation':'Coin\x20to\x20deposit.\x20{balance:\x20string}\x20for\x20amount;\x20{coin_object:\x20string}\x20for\x20existing\x20Coin\x20object.\x20Type\x20T\x20must\x20match\x20Treasury\x27s\x20type_parameter.'},{'element_type':'field','type_name':'deposit.by_external_deposit_guard','semantic_explanation':'Guard\x20address\x20or\x20name\x20for\x20external\x20deposit\x20path.\x20Triggers\x20Guard\x20+\x20Passport\x20verification;\x20bypasses\x20Permission\x20check.','constraints':['Guard\x20must\x20be\x20in\x20external_deposit_guard\x20list\x20(else\x20E_EXTERNAL_DEPOSIT_GUARD_NOT_FOUND)','Passport\x20required']},{'element_type':'field','type_name':'withdraw','semantic_explanation':'Withdraw\x20operation.\x20Two\x20access\x20paths:\x20(1)\x20Permission\x20path\x20(amount.fixed,\x20requires\x20TREASURY_WITHDRAW=254);\x20(2)\x20Guard\x20path\x20(amount.by_external_withdraw_guard,\x20requires\x20Passport,\x20no\x20Permission)'},{'element_type':'field','type_name':'withdraw.amount.fixed','semantic_explanation':'Fixed\x20u64\x20withdraw\x20amount\x20(Permission\x20path).\x20Irreversible.\x20Recipient\x20specified\x20separately.','constraints':['Must\x20be\x20<=\x20balance\x20(else\x20E_WITHDRAW_INSUFFICIENT_AMOUNT)','u64\x20format']},{'element_type':'field','type_name':'withdraw.amount.by_external_withdraw_guard','semantic_explanation':'Guard\x20address/name\x20for\x20external\x20withdraw\x20path.\x20Amount\x20determined\x20by\x20Guard\x20table\x20identifier\x20(not\x20caller-specified).','constraints':['Guard\x20must\x20be\x20in\x20external_withdraw_guard\x20list','Passport\x20required','Amount\x20from\x20Guard\x20is\x20authoritative']},{'element_type':'field','type_name':'external_deposit_guard','semantic_explanation':'Manage\x20external_deposit_guard\x20list.\x20op:\x20add\x20(upsert)\x20/\x20set\x20(clear+add)\x20/\x20remove\x20(by\x20address)\x20/\x20clear\x20(empty).\x20Requires\x20TREASURY_EXTERNAL_DEPOSIT_GUARD=255.','constraints':['Max\x20100\x20guards\x20(MAX_EXTERNAL_DEPOSIT_GUARD_COUNT)','identifier\x20is\x20Option<u8>\x20(None\x20=\x20no\x20amount\x20limit)','store_from_id\x20is\x20Option<u8>']},{'element_type':'field','type_name':'external_withdraw_guard','semantic_explanation':'Manage\x20external_withdraw_guard\x20list.\x20op:\x20add/set/remove/clear.\x20Requires\x20TREASURY_EXTERNAL_WITHDRAW_GUARD=256.','constraints':['Max\x20200\x20guards\x20(MAX_EXTERNAL_WITHDRAW_GUARD_COUNT)','identifier\x20is\x20u8\x20(REQUIRED,\x20not\x20Option)','store_from_id\x20is\x20Option<u8>']},{'element_type':'field','type_name':'receive','semantic_explanation':'Receive\x20CoinWrapper\x20objects\x20into\x20balance.\x20Requires\x20TREASURY_RECEIVE=253.\x20Writes\x20Record(op=RECEIVE)\x20to\x20history.','constraints':['CoinWrapper\x20type\x20T\x20must\x20match\x20Treasury\x27s\x20T','\x27recently\x27\x20resolves\x20to\x20all\x20un-received\x20CoinWrapper']},{'element_type':'field','type_name':'owner_receive','semantic_explanation':'Unwrap\x20received\x20objects\x20(CoinWrapper\x20+\x20others)\x20and\x20forward\x20to\x20Permission.owner.\x20Requires\x20TREASURY_OWNER_RECEIVE=257.\x20Does\x20NOT\x20write\x20to\x20history.','constraints':['Irreversible\x20(funds\x20leave\x20Treasury)','Recipient\x20is\x20Permission.owner\x20(resolved\x20at\x20tx\x20time)']},{'element_type':'field','type_name':'um','semantic_explanation':'User\x20Manager\x20(Contact\x20object\x20address).\x20um=address\x20→\x20um_set;\x20um=null\x20→\x20um_none.\x20Requires\x20TREASURY_UM=258.','constraints':['Must\x20be\x20a\x20Contact\x20object\x20(not\x20user\x20wallet)','UM\x20≠\x20admin\x20(no\x20permission\x20management)']},{'element_type':'op','type_name':'add','semantic_explanation':'Upsert\x20semantics:\x20if\x20guard\x20exists,\x20update\x20identifier/store_from_id;\x20else\x20append\x20(after\x20count\x20check)'},{'element_type':'op','type_name':'set','semantic_explanation':'Replace\x20entire\x20list:\x20clear\x20first,\x20then\x20add.\x20Use\x20when\x20wholesale\x20replacement\x20is\x20intended.'},{'element_type':'op','type_name':'remove','semantic_explanation':'Remove\x20specific\x20guards\x20by\x20address.\x20Count\x20check\x20uses\x20MAX\x20as\x20upper\x20bound\x20(not\x20subtractive).'},{'element_type':'op','type_name':'clear','semantic_explanation':'Empty\x20the\x20entire\x20guard\x20list.\x20No\x20count\x20check\x20needed.'}];export const TREASURY_CONSTRAINT_RULES=[{'id':'MC-T-01','category':'structural','rule':'description\x20length\x20<=\x20MAX_DESCRIPTION_LENGTH\x20(4000)','applies_to':['description']},{'id':'MC-T-02','category':'structural','rule':'external_deposit_guard\x20count\x20<=\x20MAX_EXTERNAL_DEPOSIT_GUARD_COUNT\x20(100)','applies_to':['external_deposit_guard.guards']},{'id':'MC-T-03','category':'structural','rule':'external_withdraw_guard\x20count\x20<=\x20MAX_EXTERNAL_WITHDRAW_GUARD_COUNT\x20(200)','applies_to':['external_withdraw_guard.guards']},{'id':'MC-T-04','category':'structural','rule':'external_withdraw_guard.identifier\x20is\x20u8\x20(REQUIRED,\x20not\x20Option<u8>)','applies_to':['external_withdraw_guard.guards[].identifier']},{'id':'MC-T-05','category':'structural','rule':'external_deposit_guard.identifier\x20is\x20Option<u8>\x20(None\x20means\x20no\x20amount\x20limit)','applies_to':['external_deposit_guard.guards[].identifier']},{'id':'MC-T-06','category':'semantic','rule':'Coin\x20type\x20T\x20must\x20match\x20Treasury\x27s\x20type_parameter\x20for\x20all\x20deposit/withdraw/receive\x20operations','applies_to':['deposit.coin','withdraw.amount.fixed','receive']},{'id':'MC-T-07','category':'authority','rule':'deposit\x20via\x20Permission\x20path\x20requires\x20TREASURY_DEPOSIT\x20(252);\x20deposit\x20via\x20Guard\x20path\x20requires\x20no\x20Permission\x20(Guard+Passport\x20only)','applies_to':['deposit.by_external_deposit_guard']},{'id':'MC-T-08','category':'authority','rule':'withdraw.amount.fixed\x20requires\x20TREASURY_WITHDRAW\x20(254);\x20withdraw.amount.by_external_withdraw_guard\x20requires\x20no\x20Permission','applies_to':['withdraw.amount']},{'id':'MC-T-09','category':'authority','rule':'external_deposit_guard\x20management\x20requires\x20TREASURY_EXTERNAL_DEPOSIT_GUARD\x20(255);\x20external_withdraw_guard\x20management\x20requires\x20TREASURY_EXTERNAL_WITHDRAW_GUARD\x20(256)','applies_to':['external_deposit_guard','external_withdraw_guard']},{'id':'MC-T-10','category':'lifecycle','rule':'withdraw\x20(fixed)\x20and\x20external_withdraw\x20are\x20IRREVERSIBLE;\x20verify\x20recipient\x20and\x20amount\x20before\x20execution','applies_to':['withdraw.amount.fixed','withdraw.amount.by_external_withdraw_guard']},{'id':'MC-T-11','category':'lifecycle','rule':'owner_receive\x20forwards\x20assets\x20to\x20Permission.owner\x20and\x20does\x20NOT\x20write\x20to\x20history;\x20verify\x20owner\x20address\x20is\x20current','applies_to':['owner_receive']},{'id':'MC-T-12','category':'lifecycle','rule':'um_set\x20requires\x20Contact\x20object\x20address\x20(not\x20user\x20wallet);\x20um_set\x20vs\x20um_none\x20both\x20use\x20TREASURY_UM\x20(258)','applies_to':['um']},{'id':'MC-T-13','category':'cross_object','rule':'If\x20Treasury\x20is\x20referenced\x20by\x20Allocator/Arbitration,\x20TREASURY_RECEIVE\x20(253)\x20must\x20be\x20granted\x20to\x20a\x20trusted\x20operator\x20for\x20regular\x20intake','applies_to':['receive']},{'id':'MC-T-14','category':'semantic','rule':'external_deposit\x20may\x20split\x20coin\x20if\x20value\x20>\x20guard-specified\x20amount;\x20excess\x20refunded\x20to\x20sender','applies_to':['deposit.by_external_deposit_guard']},{'id':'MC-T-15','category':'semantic','rule':'inflow/outflow\x20are\x20monotonic\x20counters\x20(never\x20decrease);\x20used\x20for\x20audit\x20reconciliation:\x20theoretical\x20balance\x20=\x20inflow\x20-\x20outflow','applies_to':['(read-only\x20audit\x20fields)']}];export const TREASURY_TRANSLATION_VERSION='1.0.0';export function matchSemanticPattern(a){const b=a['toLowerCase'](),c=[];(b['includes']('create')||b['includes']('new'))&&c['push'](SEMANTIC_TO_SCHEMA_RULES[0x0]);b['includes']('deposit')&&(b['includes']('external')||b['includes']('guard')?c['push'](SEMANTIC_TO_SCHEMA_RULES[0x3]):c['push'](SEMANTIC_TO_SCHEMA_RULES[0x1]));b['includes']('withdraw')&&(b['includes']('external')||b['includes']('guard')?c['push'](SEMANTIC_TO_SCHEMA_RULES[0x4]):c['push'](SEMANTIC_TO_SCHEMA_RULES[0x2]));(b['includes']('guard\x20add')||b['includes']('guard\x20set')||b['includes']('guard\x20remove')||b['includes']('guard\x20clear'))&&c['push'](SEMANTIC_TO_SCHEMA_RULES[0x5]);(b['includes']('receive')||b['includes']('owner_receive')||b['includes']('forward'))&&c['push'](SEMANTIC_TO_SCHEMA_RULES[0x6]);(b['includes']('um')||b['includes']('delegate')||b['includes']('user\x20manager')||b['includes']('description'))&&c['push'](SEMANTIC_TO_SCHEMA_RULES[0x7]);if(c['length']===0x0)return[...SEMANTIC_TO_SCHEMA_RULES];return c;}export function explainTreasuryCallData(a){const b=[];if(a['object']===null||a['object']===undefined)b['push']('Operation:\x20INVALID\x20(object\x20field\x20required)');else{if(typeof a['object']==='string')b['push']('Operation:\x20OPERATE\x20existing\x20Treasury\x20at\x20'+a['object']);else{if(typeof a['object']==='object'){const c=a['object'];b['push']('Operation:\x20CREATE\x20new\x20Treasury');if(c['name'])b['push']('\x20\x20name:\x20'+c['name']);if(c['type_parameter'])b['push']('\x20\x20type_parameter\x20(T):\x20'+c['type_parameter']);c['permission']&&(typeof c['permission']==='string'?b['push']('\x20\x20permission:\x20existing\x20'+c['permission']):b['push']('\x20\x20permission:\x20new\x20(TypeNamedObject)'));}}}a['description']&&b['push']('-\x20Set\x20description:\x20\x22'+a['description']+'\x22');if(a['deposit']){const e=a['deposit'];if(e['by_external_deposit_guard']){b['push']('-\x20External\x20deposit\x20via\x20guard:\x20'+e['by_external_deposit_guard']);if(e['coin']?.['balance'])b['push']('\x20\x20coin\x20balance:\x20'+e['coin']['balance']+'\x20(may\x20split\x20if\x20>\x20guard\x20limit)');if(e['coin']?.['coin_object'])b['push']('\x20\x20coin\x20object:\x20'+e['coin']['coin_object']);b['push']('\x20\x20⚠️\x20No\x20Permission\x20check;\x20Passport\x20required');}else{b['push']('-\x20Internal\x20deposit\x20via\x20Permission\x20(TREASURY_DEPOSIT=252)');if(e['coin']?.['balance'])b['push']('\x20\x20coin\x20balance:\x20'+e['coin']['balance']);if(e['coin']?.['coin_object'])b['push']('\x20\x20coin\x20object:\x20'+e['coin']['coin_object']);}if(e['payment_info']?.['remark'])b['push']('\x20\x20payment\x20remark:\x20\x22'+e['payment_info']['remark']+'\x22');}if(a['withdraw']){const f=a['withdraw'];if(f['amount']?.['fixed'])b['push']('-\x20Internal\x20withdraw\x20via\x20Permission\x20(TREASURY_WITHDRAW=254)'),b['push']('\x20\x20amount:\x20'+f['amount']['fixed']+'\x20(fixed,\x20IRREVERSIBLE)');else f['amount']?.['by_external_withdraw_guard']&&(b['push']('-\x20External\x20withdraw\x20via\x20guard:\x20'+f['amount']['by_external_withdraw_guard']),b['push']('\x20\x20⚠️\x20Amount\x20determined\x20by\x20Guard\x20table\x20identifier\x20(not\x20caller-specified)'),b['push']('\x20\x20⚠️\x20IRREVERSIBLE;\x20No\x20Permission\x20check;\x20Passport\x20required'));if(f['recipient'])b['push']('\x20\x20recipient:\x20'+f['recipient']);if(f['payment_info']?.['remark'])b['push']('\x20\x20payment\x20remark:\x20\x22'+f['payment_info']['remark']+'\x22');}if(a['receive']){if(a['receive']==='recently')b['push']('-\x20Receive\x20all\x20recently-received\x20CoinWrapper\x20(TREASURY_RECEIVE=253)');else Array['isArray'](a['receive'])&&b['push']('-\x20Receive\x20'+a['receive']['length']+'\x20CoinWrapper\x20object(s)\x20(TREASURY_RECEIVE=253)');}if(a['external_deposit_guard']){const h=a['external_deposit_guard'];if(h['op']==='clear')b['push']('-\x20Clear\x20external_deposit_guard\x20list\x20(TREASURY_EXTERNAL_DEPOSIT_GUARD=255)');else{if(h['op']==='remove')b['push']('-\x20Remove\x20'+h['guards']['length']+'\x20guard(s)\x20from\x20external_deposit_guard\x20(Permission\x20255)');else{const i=h['guards']['length'];b['push']('-\x20'+(h['op']==='set'?'Set\x20(clear+add)':'Add\x20(upsert)')+'\x20'+i+'\x20external_deposit_guard(s)\x20(Permission\x20255)');}}}if(a['external_withdraw_guard']){const j=a['external_withdraw_guard'];if(j['op']==='clear')b['push']('-\x20Clear\x20external_withdraw_guard\x20list\x20(TREASURY_EXTERNAL_WITHDRAW_GUARD=256)');else{if(j['op']==='remove')b['push']('-\x20Remove\x20'+j['guards']['length']+'\x20guard(s)\x20from\x20external_withdraw_guard\x20(Permission\x20256)');else{const k=j['guards']['length'];b['push']('-\x20'+(j['op']==='set'?'Set\x20(clear+add)':'Add\x20(upsert)')+'\x20'+k+'\x20external_withdraw_guard(s)\x20(Permission\x20256)'),b['push']('\x20\x20⚠️\x20withdraw\x20guard\x20identifier\x20is\x20REQUIRED\x20(u8,\x20not\x20Option)');}}}if(a['owner_receive']){if(a['owner_receive']==='recently')b['push']('-\x20owner_receive:\x20forward\x20all\x20recently-received\x20objects\x20to\x20Permission.owner\x20(TREASURY_OWNER_RECEIVE=257)');else Array['isArray'](a['owner_receive'])&&b['push']('-\x20owner_receive:\x20forward\x20'+a['owner_receive']['length']+'\x20object(s)\x20to\x20Permission.owner\x20(Permission\x20257)');b['push']('\x20\x20⚠️\x20IRREVERSIBLE;\x20does\x20NOT\x20write\x20to\x20history');}return a['um']!==undefined&&(a['um']===null?b['push']('-\x20UM\x20revoke\x20(um_none,\x20TREASURY_UM=258)'):b['push']('-\x20UM\x20set\x20to\x20'+a['um']+'\x20(TREASURY_UM=258)')),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 TREASURY_CONSTRAINT_RULES['filter'](b=>b['category']===a);}export function explainTreasuryPermissionIndex(a){if(isBuiltinTreasuryPermission(a)){const b=getBuiltinPermissionByIndex(a),c=findSceneByPermissionIndex(a);return(b?.['name']??'Unknown')+'\x20('+a+')\x20—\x20'+(b?.['description']??'')+'\x20[scene:\x20'+(c?.['id']??'unknown')+']';}if(a===-0x1)return'Reserved\x20(no\x20Permission\x20index)\x20—\x20external\x20operations\x20use\x20Guard\x20+\x20Passport\x20instead';if(a>=0x3e8)return'Custom\x20permission\x20('+a+')\x20—\x20must\x20be\x20documented\x20via\x20Permission.remark;\x20not\x20used\x20by\x20Treasury\x20builtin\x20operations';if(a===0x103||a===0x104)return'STALE\x20index\x20'+a+'\x20—\x20was\x20pre-fix\x20SDK\x20value;\x20canonical\x20post-fix\x20indexes\x20are\x20255-258.\x20See\x20R-T-01.';return'Index\x20'+a+'\x20—\x20not\x20a\x20Treasury\x20builtin\x20permission\x20(range\x20250-258)';}

package/dist/knowledge/util-confirm.d.ts

@@ -1,24 +0,0 @@
-export declare const UTIL_CONFIRM_VERSION = "1.0.0";
-export type ConfirmSeverity = "block" | "warn" | "info";
-export interface UtilConfirmItem {
-    id: string;
-    severity: ConfirmSeverity;
-    title: string;
-    description: string;
-    passed: boolean;
-    evidence?: string;
-    fix_hint?: string;
-}
-export interface UtilCallCheckInput {
-    uses_typo_function_name?: boolean;
-    assumes_stable_address_bytes?: boolean;
-    bcs_manually_synced?: boolean;
-}
-export declare function preCheckUtilCall(input: UtilCallCheckInput): UtilConfirmItem[];
-export declare function canProceedUtilCall(input: UtilCallCheckInput): {
-    canProceed: boolean;
-    blockers: UtilConfirmItem[];
-    warnings: UtilConfirmItem[];
-    info: UtilConfirmItem[];
-};
-export declare function formatUtilCallSummary(input: UtilCallCheckInput): string;

package/dist/knowledge/util-confirm.js

@@ -1 +0,0 @@
-export const UTIL_CONFIRM_VERSION='1.0.0';function checkTypo(a){const b=!!a['uses_typo_function_name'];return{'id':'C-UTIL-01','severity':b?'info':'info','title':'Typo\x27d\x20function\x20name\x20is\x20handled\x20(is_chiild_object_address_byte)','description':'util.move\x20defines\x20is_chiild_object_address_byte\x20with\x20a\x20\x27chiild\x27\x20typo;\x20it\x20cannot\x20be\x20renamed\x20post-publish.\x20The\x20SDK\x20should\x20expose\x20a\x20correct\x20alias.','passed':!![],'evidence':b?'uses_typo_function_name=true\x20(must\x20use\x20\x27chiild\x27)':'typo\x20handled\x20via\x20alias'};}function checkAddressBytes(a){const b=!!a['assumes_stable_address_bytes'];return{'id':'C-UTIL-02','severity':b?'warn':'info','title':'Address-byte\x20thresholds\x20are\x20hardcoded','description':'util.move\x20classifies\x20addresses\x20by\x20first\x20byte\x20(user\x200x00,\x20object\x200xf1\x20or\x200x10..0x24,\x20child\x20unified\x20with\x20object).\x20A\x20Wow\x20protocol\x20upgrade\x20could\x20invalidate\x20them.','passed':!b,'evidence':b?'assumes_stable_address_bytes=true':'upgrade\x20coupling\x20understood','fix_hint':'Track\x20Wow\x20address-layout\x20upgrades;\x20ship\x20util.move\x20+\x20SDK\x20in\x20lockstep.'};}function checkBcs(a){const b=a['bcs_manually_synced']===!![];return{'id':'C-UTIL-03','severity':b?'warn':'info','title':'SDK\x20BCS\x20structures\x20stay\x20in\x20sync\x20with\x20Move\x20structs','description':'util.ts\x20defines\x20BCS\x20query\x20structures\x20that\x20must\x20match\x20Move\x20layouts\x20byte-for-byte;\x20drift\x20breaks\x20queries\x20silently.','passed':!b,'evidence':b?'bcs_manually_synced=true\x20(drift\x20risk)':'BCS\x20sync\x20safe','fix_hint':'Generate\x20BCS\x20from\x20Move\x20via\x20codegen,\x20or\x20run\x20a\x20layout\x20sync\x20test.'};}export function preCheckUtilCall(a){return[checkTypo(a),checkAddressBytes(a),checkBcs(a)];}export function canProceedUtilCall(a){const b=preCheckUtilCall(a);return{'canProceed':b['every'](c=>c['severity']!=='block'||c['passed']),'blockers':b['filter'](c=>c['severity']==='block'&&!c['passed']),'warnings':b['filter'](c=>c['severity']==='warn'&&!c['passed']),'info':b['filter'](c=>c['severity']==='info')};}export function formatUtilCallSummary(a){const {canProceed:b,warnings:c}=canProceedUtilCall(a),d=[b?'✓\x20Util\x20call\x20pre-check\x20PASSED':'✗\x20Util\x20call\x20pre-check\x20FAILED',''];return c['length']>0x0&&(d['push']('WARNINGS:'),c['forEach'](e=>d['push']('\x20\x20['+e['id']+']\x20'+e['title']+'\x20—\x20'+(e['evidence']??'')))),d['join']('\x0a');}

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

@@ -1,39 +0,0 @@
-export declare const UTIL_TRANSLATION_VERSION = "1.0.0";
-export declare const UTIL_ADDRESS_BYTES: {
-    readonly USER: 0;
-    readonly OBJECT: 241;
-    readonly TYPED_OBJECT_MIN: 16;
-    readonly TYPED_OBJECT_MAX: 36;
-};
-export interface SemanticToUtilSchemaRule {
-    id: string;
-    pattern_name: string;
-    semantic_intent: string;
-    match_keywords: string[];
-    example: Record<string, unknown>;
-}
-export declare const SEMANTIC_TO_UTIL_SCHEMA_RULES: SemanticToUtilSchemaRule[];
-export interface UtilFieldTranslation {
-    field_name: string;
-    value_type: string;
-    semantic: string;
-    format_example: string;
-    validation_rules: string[];
-}
-export declare const UTIL_FIELD_TRANSLATIONS: UtilFieldTranslation[];
-export interface UtilConstraintRule {
-    id: string;
-    name: string;
-    description: string;
-    related_field: string;
-}
-export declare const UTIL_CONSTRAINT_RULES: UtilConstraintRule[];
-export interface UtilExplainInput {
-    first_byte?: number;
-}
-export interface UtilExplanation {
-    summary: string;
-    classification: string;
-    warnings: string[];
-}
-export declare function explainUtil(input: UtilExplainInput): UtilExplanation;

package/dist/knowledge/util-translation.js

@@ -1 +0,0 @@
-export const UTIL_TRANSLATION_VERSION='1.0.0';export const UTIL_ADDRESS_BYTES={'USER':0x0,'OBJECT':0xf1,'TYPED_OBJECT_MIN':0x10,'TYPED_OBJECT_MAX':0x24};export const SEMANTIC_TO_UTIL_SCHEMA_RULES=[{'id':'P-UTIL-01','pattern_name':'Classify\x20address','semantic_intent':'Determine\x20whether\x20an\x20address\x20is\x20a\x20user,\x20object,\x20or\x20child-object.','match_keywords':['is\x20user\x20address','is\x20object\x20address','classify\x20address'],'example':{'addr':'0x...'}}];export const UTIL_FIELD_TRANSLATIONS=[{'field_name':'first_byte','value_type':'u8','semantic':'Address\x20classification\x20byte:\x20user\x200x00,\x20object\x200xf1\x20(regular/child)\x20or\x200x10..0x24\x20(typed\x20business).','format_example':'0xf1\x20(object)','validation_rules':['hardcoded\x20in\x20util.move']}];export const UTIL_CONSTRAINT_RULES=[{'id':'UTIL_C_01','name':'typo\x20function','description':'is_chiild_object_address_byte\x20has\x20a\x20\x27chiild\x27\x20typo;\x20cannot\x20rename\x20post-publish.','related_field':'first_byte'},{'id':'UTIL_C_02','name':'address-byte\x20stability','description':'byte\x20thresholds\x20are\x20hardcoded;\x20Wow\x20upgrade\x20could\x20invalidate\x20them.','related_field':'first_byte'},{'id':'UTIL_C_03','name':'BCS\x20sync','description':'SDK\x20BCS\x20structures\x20must\x20match\x20Move\x20layouts\x20byte-for-byte.','related_field':'first_byte'}];export function explainUtil(a){const b=[];let c='unknown';if(a['first_byte']!==undefined){if(a['first_byte']===UTIL_ADDRESS_BYTES['USER'])c='user\x20address';else{if(a['first_byte']===UTIL_ADDRESS_BYTES['OBJECT'])c='object\x20address\x20(regular/child)';else{if(a['first_byte']>=UTIL_ADDRESS_BYTES['TYPED_OBJECT_MIN']&&a['first_byte']<=UTIL_ADDRESS_BYTES['TYPED_OBJECT_MAX'])c='typed\x20business\x20object\x20address';else b['push']('first\x20byte\x200x'+a['first_byte']['toString'](0x10)+'\x20not\x20in\x20known\x20classification\x20range');}}}return{'summary':'Util\x20address\x20classification:\x20'+c+'.','classification':c,'warnings':b};}

package/dist/loop-engineering/aggregate.d.ts

@@ -1,50 +0,0 @@
-import type { TelemetryEvent } from "../telemetry/index.js";
-export interface ToolStats {
-    tool_name: string;
-    total_calls: number;
-    success_count: number;
-    failed_count: number;
-    pending_input_count: number;
-    success_rate: number;
-    avg_duration_ms: number;
-    p50_duration_ms: number;
-    p95_duration_ms: number;
-    semantic_hit_rate: number;
-    error_distribution: Record<string, number>;
-    top_error_messages: Array<{
-        message: string;
-        count: number;
-    }>;
-}
-export interface OperationStats {
-    operation_type: string;
-    total_calls: number;
-    success_rate: number;
-    semantic_hit_rate: number;
-    error_distribution: Record<string, number>;
-}
-export interface AggregatedStats {
-    aggregation_date: string;
-    total_events: number;
-    date_range: {
-        earliest: string;
-        latest: string;
-    };
-    per_tool: ToolStats[];
-    per_operation: OperationStats[];
-    overall: {
-        total_calls: number;
-        success_count: number;
-        failed_count: number;
-        success_rate: number;
-        semantic_hit_rate: number;
-        unknown_error_count: number;
-        unknown_error_rate: number;
-        avg_duration_ms: number;
-    };
-    error_code_distribution: Record<string, number>;
-    intent_distribution: Record<string, number>;
-}
-export declare function aggregateByTool(events: TelemetryEvent[]): ToolStats[];
-export declare function aggregateByOperation(events: TelemetryEvent[]): OperationStats[];
-export declare function aggregate(events: TelemetryEvent[]): AggregatedStats;

package/dist/loop-engineering/aggregate.js

@@ -1 +0,0 @@
-function percentile(a,b){if(a['length']===0x0)return 0x0;const c=Math['ceil'](b/0x64*a['length'])-0x1;return a[Math['max'](0x0,c)];}function topMessages(a,b=0x5){const c=new Map();for(const d of a){if(!d)continue;c['set'](d,(c['get'](d)||0x0)+0x1);}return Array['from'](c['entries']())['map'](([e,f])=>({'message':e,'count':f}))['sort']((e,f)=>f['count']-e['count'])['slice'](0x0,b);}export function aggregateByTool(a){const b=new Map();for(const d of a){const f=d['tool_name']||'unknown';if(!b['has'](f))b['set'](f,[]);b['get'](f)['push'](d);}const c=[];for(const [g,h]of b){const i=h['length'],j=h['filter'](q=>q['status']==='success')['length'],k=h['filter'](q=>q['status']==='failed')['length'],l=h['filter'](q=>q['status']==='pending_input')['length'],m=h['filter'](q=>q['semantic_hit'])['length'],n=h['map'](q=>q['duration_ms'])['sort']((q,r)=>q-r),o={},p=[];for(const q of h){q['error_code']&&(o[q['error_code']]=(o[q['error_code']]||0x0)+0x1);if(q['error_message'])p['push'](q['error_message']);}c['push']({'tool_name':g,'total_calls':i,'success_count':j,'failed_count':k,'pending_input_count':l,'success_rate':i>0x0?j/ i:0x0,'avg_duration_ms':n['length']>0x0?n['reduce']((r,s)=>r+s,0x0)/n['length']:0x0,'p50_duration_ms':percentile(n,0x32),'p95_duration_ms':percentile(n,0x5f),'semantic_hit_rate':i>0x0?m/ i:0x0,'error_distribution':o,'top_error_messages':topMessages(p)});}return c['sort']((r,s)=>s['total_calls']-r['total_calls']);}export function aggregateByOperation(a){const b=new Map();for(const d of a){const f=d['operation_type']||'unknown';if(!b['has'](f))b['set'](f,[]);b['get'](f)['push'](d);}const c=[];for(const [g,h]of b){const i=h['length'],j=h['filter'](m=>m['status']==='success')['length'],k=h['filter'](m=>m['semantic_hit'])['length'],l={};for(const m of h){m['error_code']&&(l[m['error_code']]=(l[m['error_code']]||0x0)+0x1);}c['push']({'operation_type':g,'total_calls':i,'success_rate':i>0x0?j/ i:0x0,'semantic_hit_rate':i>0x0?k/ i:0x0,'error_distribution':l});}return c['sort']((n,o)=>o['total_calls']-n['total_calls']);}export function aggregate(a){const b=a['length'],c=a['filter'](k=>k['status']==='success')['length'],d=a['filter'](k=>k['semantic_hit'])['length'],f=a['filter'](k=>k['error_code']==='unknown')['length'],g=a['map'](k=>k['duration_ms']),h={},i={};for(const k of a){k['error_code']&&(h[k['error_code']]=(h[k['error_code']]||0x0)+0x1),k['intent']&&(i[k['intent']]=(i[k['intent']]||0x0)+0x1);}const j=a['map'](l=>l['timestamp'])['filter'](Boolean)['sort']();return{'aggregation_date':new Date()['toISOString'](),'total_events':b,'date_range':{'earliest':j[0x0]||'','latest':j[j['length']-0x1]||''},'per_tool':aggregateByTool(a),'per_operation':aggregateByOperation(a),'overall':{'total_calls':b,'success_count':c,'failed_count':a['filter'](l=>l['status']==='failed')['length'],'success_rate':b>0x0?c/b:0x0,'semantic_hit_rate':b>0x0?d/b:0x0,'unknown_error_count':f,'unknown_error_rate':b>0x0?f/b:0x0,'avg_duration_ms':g['length']>0x0?g['reduce']((l,m)=>l+m,0x0)/g['length']:0x0},'error_code_distribution':h,'intent_distribution':i};}

package/dist/loop-engineering/context-collect.d.ts

@@ -1,7 +0,0 @@
-import type { AssembleContextResult } from "../playbooks/service-build/context-assembly.js";
-export interface ContextCollectionResult {
-    signature_recorded: boolean;
-    proposal_created: boolean;
-    proposal_id?: string;
-}
-export declare function collectContextExperience(result: AssembleContextResult, network: string): ContextCollectionResult;

package/dist/loop-engineering/context-collect.js

@@ -1 +0,0 @@
-import{recordSignature}from'../experience/index.js';import{persistImprovementQueue}from'./improve.js';export function collectContextExperience(a,b){const c=extractObjectTypes(a['objects']),d=!!a['embedded_history'],e=!!a['events']&&a['events']['length']>0x0,f={'intent':'assemble_context','signals':{'object_types':c,'object_count':a['objects']['length'],'has_embedded_history':d,'has_events':e,'context_digest':a['context_digest'],'network':b},'timestamp':Date['now'](),'outcome':'success'};let g=![];try{recordSignature(f),g=!![];}catch{}let h;if(c['length']>=0x3){h={'proposal_id':'PROP-CTX-'+Date['now']()+'-'+Math['random']()['toString'](0x24)['slice'](0x2,0x6),'source_diagnosis_id':'CTX-'+a['context_digest'],'type':'description_rewrite','priority':'P3','automation':'semi','apply_mode':'config_override','override_category':'descriptions','title':'Enrich\x20assemble_context\x20for\x20'+c['join']('+')+'\x20patterns','description':'Assembled\x20context\x20with\x20'+c['length']+'\x20object\x20types\x20('+c['join'](',\x20')+').\x20'+'Consider\x20enriching\x20the\x20assemble_context\x20action\x20description\x20to\x20guide\x20AI\x20toward\x20'+('common\x20'+c['join']('+')+'\x20business\x20patterns.'),'target':'assemble_context','proposed_change':{'action':'enrich_description','object_types':c,'has_embedded_history':d,'has_events':e,'context_digest':a['context_digest']},'evidence':{'context_digest':a['context_digest'],'object_count':a['objects']['length'],'object_types':c,'network':b},'review_status':'pending','ab_test_recommended':![]};try{persistImprovementQueue([h]);}catch{}}return{'signature_recorded':g,'proposal_created':!!h,'proposal_id':h?.['proposal_id']};}function extractObjectTypes(a){const b=new Set();for(const c of a){const d=c?.['data']??c,e=d?.['type'];if(typeof e==='string'){const f=e['match'](/::(\w+)$/);f&&b['add'](f[0x1]);}}return Array['from'](b);}