@wowok/agent-mcp 3.3.0 → 3.3.2

package/dist/knowledge/guard-submission-prompt.js

@@ -1 +1 @@
-import{buildGuardSubmissionBrief,loadGuardJsonFromChain,renderSubmissionBrief}from'./guard-submission-brief.js';function inferValue(a,b,c){const d=a['toLowerCase']();if(d['includes']('order')||d['includes']('task')){if(c['order_address'])return{'value':c['order_address'],'reason':'Inferred\x20from\x20operation\x27s\x20order_address\x20context'};if(c['progress_address'])return{'value':c['progress_address'],'reason':'Progress.task\x20is\x20typically\x20the\x20order\x20—\x20query\x20Progress\x20to\x20get\x20the\x20actual\x20task\x20address'};}if(d['includes']('signer')||d['includes']('sender')||d['includes']('caller')){if(c['signer'])return{'value':c['signer'],'reason':'Inferred\x20from\x20env.account\x20(the\x20signing\x20account)'};}if(d['includes']('service')){if(c['service_address'])return{'value':c['service_address'],'reason':'Inferred\x20from\x20operation\x27s\x20service_address\x20context'};}if(d['includes']('machine')){if(c['machine_address'])return{'value':c['machine_address'],'reason':'Inferred\x20from\x20operation\x27s\x20machine_address\x20context'};}if(d['includes']('progress')||d['includes']('node')||d['includes']('current')){if(c['progress_current'])return{'value':c['progress_current'],'reason':'Inferred\x20from\x20Progress.current\x20node\x20name'};}if(d['includes']('allocation')||d['includes']('allocator')){if(c['allocation_address'])return{'value':c['allocation_address'],'reason':'Inferred\x20from\x20operation\x27s\x20allocation_address\x20context'};}if(c['extra'])for(const [e,f]of Object['entries'](c['extra'])){if(d['includes'](e['toLowerCase']()))return{'value':f,'reason':'Inferred\x20from\x20extra\x20context:\x20'+e};}return undefined;}function describeField(a,b){const c=a['toLowerCase']();if(c['includes']('order'))return'Order\x20object\x20address\x20(type:\x20'+b+')';if(c['includes']('signer')||c['includes']('sender'))return'Transaction\x20signer\x20address\x20(type:\x20'+b+')';if(c['includes']('service'))return'Service\x20object\x20address\x20(type:\x20'+b+')';if(c['includes']('machine'))return'Machine\x20object\x20address\x20(type:\x20'+b+')';if(c['includes']('progress'))return'Progress\x20object\x20address\x20(type:\x20'+b+')';if(c['includes']('node')||c['includes']('current'))return'Current\x20node\x20name\x20(type:\x20'+b+')';if(c['includes']('amount')||c['includes']('price')||c['includes']('balance'))return'Amount\x20in\x20smallest\x20unit\x20(type:\x20'+b+')';if(c['includes']('allocation'))return'Allocation\x20object\x20address\x20(type:\x20'+b+')';return'Field\x20\x22'+a+'\x22\x20(type:\x20'+b+')';}export function buildSubmissionFillExample(a,b){return JSON['stringify']({'type':'submission','guard':[{'object':a,'impack':!![]}],'submission':[{'guard':a,'submission':b['map'](c=>({'identifier':c['identifier'],'name':c['name'],'b_submission':!![],'value_type':c['value_type'],'value':c['suggested_value']??'<'+c['value_type']+'_value>'}))}]},null,0x2);}export async function generateGuardSubmissionPrompt(a,b){const c=await loadGuardJsonFromChain(a,b['network']);if(!c)return undefined;const {guard:d,name:e,json:f}=c,g=await buildGuardSubmissionBrief({'guard_json':f,'action':b['action'],'network':b['network']});if(!g)return undefined;const h=(f['table']??[])['filter'](p=>p['b_submission']===!![]);if(h['length']===0x0)return undefined;const i=new Map(g['submission_checklist']['map'](p=>[p['identifier'],p['feeds_recipient']])),j=h['map'](p=>{const q=p['name']??'identifier_'+p['identifier'],r=p['value_type']??'Address',s=inferValue(q,r,b);return{'identifier':p['identifier'],'name':q,'value_type':r,'required':!![],'suggested_value':s?.['value'],'suggestion_reason':s?.['reason'],'description':describeField(q,r),...i['get'](p['identifier'])?{'feeds_recipient':!![]}:{}};}),k=e??d,l=buildSubmissionFillExample(k,j),m=b['progress_address']!==undefined||b['progress_current']!==undefined||b['machine_address']!==undefined||b['order_address']!==undefined,n=(f['table']??[])['some'](p=>p['identifier']===0xfe&&p['b_submission']===!![]&&p['value_type']==='Address'),o=m&&!n?'PROTOCOL\x20SLOT\x20254\x20MISSING:\x20this\x20Guard\x27s\x20table\x20declares\x20no\x20{identifier:\x20254,\x20b_submission:\x20true,\x20value_type:\x20\x22Address\x22}\x20row\x20(task\x20binding).\x20On\x20an\x20order-driven\x20Progress\x20forward,\x20the\x20passport\x20only\x20carries\x20DECLARED\x20table\x20rows,\x20so\x20the\x20254\x20submission\x20can\x20never\x20be\x20emitted\x20and\x20the\x20on-chain\x20task-binding\x20check\x20will\x20abort\x20(code\x2011)\x20even\x20with\x20every\x20field\x20above\x20correctly\x20filled.\x20The\x20table\x20is\x20frozen\x20at\x20Guard\x20creation\x20—\x20export\x20it\x20(guard2file),\x20add\x20the\x20254\x20declaration,\x20create\x20a\x20NEW\x20Guard,\x20and\x20rebind\x20the\x20forward.':undefined;return{'guard_address':d,'guard_name':e,'operation':b['operation'],'required_fields':j,'context':'Operation\x20\x22'+b['operation']+'\x22\x20requires\x20Guard\x20\x22'+(e??d)+'\x22\x20verification.\x20'+('The\x20Guard\x20has\x20'+j['length']+'\x20field(s)\x20that\x20need\x20submission\x20data\x20(b_submission=true).\x20')+'Retry\x20the\x20SAME\x20operation\x20call\x20with\x20a\x20top-level\x20`submission`\x20field\x20(a\x20SIBLING\x20of\x20`data`\x20and\x20`env`,\x20NOT\x20inside\x20`data`)\x20using\x20the\x20exact\x20JSON\x20shape\x20shown\x20in\x20fill_example.\x20'+'Each\x20field\x20has\x20an\x20identifier\x20(number),\x20name,\x20and\x20expected\x20value_type.\x20'+'The\x20suggested_value\x20(if\x20provided)\x20is\x20inferred\x20from\x20the\x20operation\x20context\x20—\x20verify\x20before\x20using.','fill_example':l,...g['binding']?{'binding_semantics':{'action':g['binding']['action'],'role':g['binding']['semantics']['role'],'submission_meaning':g['binding']['semantics']['submission_meaning'],'on_pass':g['binding']['semantics']['on_pass'],'on_fail':g['binding']['semantics']['on_fail'],'stakes':g['binding']['semantics']['stakes']}}:{},...g['data_source_warnings']['length']>0x0?{'data_source_warnings':g['data_source_warnings']}:{},...o!==undefined?{'protocol_slot_warning':o}:{},'brief_text':renderSubmissionBrief(g)};}export function formatSubmissionPrompt(a){const b=[];b['push']('GUARD\x20SUBMISSION\x20REQUIRED\x20—\x20operation\x20cannot\x20proceed\x20without\x20submission\x20data.'),b['push']('Guard:\x20'+(a['guard_name']??a['guard_address'])+'\x20('+a['guard_address']+')'),b['push']('Operation:\x20'+a['operation']);a['binding_semantics']&&(b['push'](''),b['push']('Business\x20slot:\x20'+a['binding_semantics']['role']),b['push']('Your\x20submission\x20means:\x20'+a['binding_semantics']['submission_meaning']));b['push'](''),b['push']('Required\x20fields\x20(fill\x20these\x20in\x20the\x20submission):');for(const c of a['required_fields']){b['push']('\x20\x20['+c['identifier']+']\x20'+c['name']+'\x20('+c['value_type']+')\x20—\x20'+c['description']),c['suggested_value']?b['push']('\x20\x20\x20\x20\x20\x20Suggested:\x20'+c['suggested_value']+'\x20('+c['suggestion_reason']+')'):b['push']('\x20\x20\x20\x20\x20\x20No\x20suggestion\x20—\x20derive\x20value\x20from\x20context\x20or\x20ask\x20user.'),c['feeds_recipient']&&b['push']('\x20\x20\x20\x20\x20\x20⚠\x20this\x20value\x20can\x20determine\x20a\x20PAYMENT\x20RECIPIENT\x20—\x20wrong\x20address\x20=\x20funds\x20to\x20the\x20wrong\x20party');}a['binding_semantics']&&(b['push'](''),b['push']('If\x20verification\x20PASSES:\x20'+a['binding_semantics']['on_pass']),b['push']('If\x20verification\x20FAILS:\x20'+a['binding_semantics']['on_fail']),b['push']('Stakes:\x20'+a['binding_semantics']['stakes']));if(a['data_source_warnings']&&a['data_source_warnings']['length']>0x0){b['push'](''),b['push']('Data-source\x20warnings:');for(const d of a['data_source_warnings'])b['push']('\x20\x20-\x20'+d);}return a['protocol_slot_warning']&&(b['push'](''),b['push'](a['protocol_slot_warning'])),b['push'](''),b['push']('Fill\x20example\x20—\x20paste\x20as\x20the\x20top-level\x20`submission`\x20field\x20of\x20the\x20SAME\x20operation\x20call\x20(sibling\x20of\x20data/env):'),b['push'](a['fill_example']),b['join']('\x0a');}
+import{buildGuardSubmissionBrief,loadGuardJsonFromChain,renderSubmissionBrief,requiredSubmissionSlots}from'./guard-submission-brief.js';function inferValue(a,b,c){const d=a['toLowerCase']();if(d['includes']('order')||d['includes']('task')){if(c['order_address'])return{'value':c['order_address'],'reason':'Inferred\x20from\x20operation\x27s\x20order_address\x20context'};if(c['progress_address'])return{'value':c['progress_address'],'reason':'Progress.task\x20is\x20typically\x20the\x20order\x20—\x20query\x20Progress\x20to\x20get\x20the\x20actual\x20task\x20address'};}if(d['includes']('signer')||d['includes']('sender')||d['includes']('caller')){if(c['signer'])return{'value':c['signer'],'reason':'Inferred\x20from\x20env.account\x20(the\x20signing\x20account)'};}if(d['includes']('service')){if(c['service_address'])return{'value':c['service_address'],'reason':'Inferred\x20from\x20operation\x27s\x20service_address\x20context'};}if(d['includes']('machine')){if(c['machine_address'])return{'value':c['machine_address'],'reason':'Inferred\x20from\x20operation\x27s\x20machine_address\x20context'};}if(d['includes']('progress')||d['includes']('node')||d['includes']('current')){if(c['progress_current'])return{'value':c['progress_current'],'reason':'Inferred\x20from\x20Progress.current\x20node\x20name'};}if(d['includes']('allocation')||d['includes']('allocator')){if(c['allocation_address'])return{'value':c['allocation_address'],'reason':'Inferred\x20from\x20operation\x27s\x20allocation_address\x20context'};}if(c['extra'])for(const [e,f]of Object['entries'](c['extra'])){if(d['includes'](e['toLowerCase']()))return{'value':f,'reason':'Inferred\x20from\x20extra\x20context:\x20'+e};}return undefined;}function describeField(a,b){const c=a['toLowerCase']();if(c['includes']('order'))return'Order\x20object\x20address\x20(type:\x20'+b+')';if(c['includes']('signer')||c['includes']('sender'))return'Transaction\x20signer\x20address\x20(type:\x20'+b+')';if(c['includes']('service'))return'Service\x20object\x20address\x20(type:\x20'+b+')';if(c['includes']('machine'))return'Machine\x20object\x20address\x20(type:\x20'+b+')';if(c['includes']('progress'))return'Progress\x20object\x20address\x20(type:\x20'+b+')';if(c['includes']('node')||c['includes']('current'))return'Current\x20node\x20name\x20(type:\x20'+b+')';if(c['includes']('amount')||c['includes']('price')||c['includes']('balance'))return'Amount\x20in\x20smallest\x20unit\x20(type:\x20'+b+')';if(c['includes']('allocation'))return'Allocation\x20object\x20address\x20(type:\x20'+b+')';return'Field\x20\x22'+a+'\x22\x20(type:\x20'+b+')';}export function buildSubmissionFillExample(a,b){return JSON['stringify']({'type':'submission','guard':[{'object':a,'impack':!![]}],'submission':[{'guard':a,'submission':b['map'](c=>({'identifier':c['identifier'],'name':c['name'],'b_submission':!![],'value_type':c['value_type'],'value':c['suggested_value']??'<'+c['value_type']+'_value>'}))}]},null,0x2);}export async function generateGuardSubmissionPrompt(a,b){const c=await loadGuardJsonFromChain(a,b['network']);if(!c)return undefined;const {guard:d,name:e,json:f}=c,g=await buildGuardSubmissionBrief({'guard_json':f,'action':b['action'],'network':b['network']});if(!g)return undefined;const h=(f['table']??[])['filter'](q=>q['b_submission']===!![]);if(h['length']===0x0)return undefined;const i=new Map(g['submission_checklist']['map'](q=>[q['identifier'],q['feeds_recipient']])),j=h['map'](q=>{const r=q['name']??'identifier_'+q['identifier'],s=q['value_type']??'Address',t=inferValue(r,s,b);return{'identifier':q['identifier'],'name':r,'value_type':s,'required':!![],'suggested_value':t?.['value'],'suggestion_reason':t?.['reason'],'description':describeField(r,s),...i['get'](q['identifier'])?{'feeds_recipient':!![]}:{}};}),k=e??d,l=buildSubmissionFillExample(k,j),m=b['progress_address']!==undefined||b['progress_current']!==undefined||b['machine_address']!==undefined||b['order_address']!==undefined,n=(f['table']??[])['some'](q=>q['identifier']===0xfe&&q['b_submission']===!![]&&q['value_type']==='Address'),o=m&&!n?'PROTOCOL\x20SLOT\x20254\x20MISSING:\x20this\x20Guard\x27s\x20table\x20declares\x20no\x20{identifier:\x20254,\x20b_submission:\x20true,\x20value_type:\x20\x22Address\x22}\x20row\x20(task\x20binding).\x20On\x20an\x20order-driven\x20Progress\x20forward,\x20the\x20passport\x20only\x20carries\x20DECLARED\x20table\x20rows,\x20so\x20the\x20254\x20submission\x20can\x20never\x20be\x20emitted\x20and\x20the\x20on-chain\x20task-binding\x20check\x20will\x20abort\x20(code\x2011)\x20even\x20with\x20every\x20field\x20above\x20correctly\x20filled.\x20The\x20table\x20is\x20frozen\x20at\x20Guard\x20creation\x20—\x20export\x20it\x20(guard2file),\x20add\x20the\x20254\x20declaration,\x20create\x20a\x20NEW\x20Guard,\x20and\x20rebind\x20the\x20forward.':undefined,p=requiredSubmissionSlots(f['table']);return{'guard_address':d,'guard_name':e,'operation':b['operation'],'required_fields':j,...p?{'required_submission_slots':p}:{},'context':'Operation\x20\x22'+b['operation']+'\x22\x20requires\x20Guard\x20\x22'+(e??d)+'\x22\x20verification.\x20'+('The\x20Guard\x20has\x20'+j['length']+'\x20field(s)\x20that\x20need\x20submission\x20data\x20(b_submission=true).\x20')+'Retry\x20the\x20SAME\x20operation\x20call\x20with\x20a\x20top-level\x20`submission`\x20field\x20(a\x20SIBLING\x20of\x20`data`\x20and\x20`env`,\x20NOT\x20inside\x20`data`)\x20using\x20the\x20exact\x20JSON\x20shape\x20shown\x20in\x20fill_example.\x20'+'Each\x20field\x20has\x20an\x20identifier\x20(number),\x20name,\x20and\x20expected\x20value_type.\x20'+'The\x20suggested_value\x20(if\x20provided)\x20is\x20inferred\x20from\x20the\x20operation\x20context\x20—\x20verify\x20before\x20using.','fill_example':l,...g['binding']?{'binding_semantics':{'action':g['binding']['action'],'role':g['binding']['semantics']['role'],'submission_meaning':g['binding']['semantics']['submission_meaning'],'on_pass':g['binding']['semantics']['on_pass'],'on_fail':g['binding']['semantics']['on_fail'],'stakes':g['binding']['semantics']['stakes']}}:{},...g['data_source_warnings']['length']>0x0?{'data_source_warnings':g['data_source_warnings']}:{},...o!==undefined?{'protocol_slot_warning':o}:{},'brief_text':renderSubmissionBrief(g)};}export function formatSubmissionPrompt(a){const b=[];b['push']('GUARD\x20SUBMISSION\x20REQUIRED\x20—\x20operation\x20cannot\x20proceed\x20without\x20submission\x20data.'),b['push']('Guard:\x20'+(a['guard_name']??a['guard_address'])+'\x20('+a['guard_address']+')'),b['push']('Operation:\x20'+a['operation']);a['binding_semantics']&&(b['push'](''),b['push']('Business\x20slot:\x20'+a['binding_semantics']['role']),b['push']('Your\x20submission\x20means:\x20'+a['binding_semantics']['submission_meaning']));b['push'](''),b['push']('Required\x20fields\x20(fill\x20these\x20in\x20the\x20submission):');for(const c of a['required_fields']){b['push']('\x20\x20['+c['identifier']+']\x20'+c['name']+'\x20('+c['value_type']+')\x20—\x20'+c['description']),c['suggested_value']?b['push']('\x20\x20\x20\x20\x20\x20Suggested:\x20'+c['suggested_value']+'\x20('+c['suggestion_reason']+')'):b['push']('\x20\x20\x20\x20\x20\x20No\x20suggestion\x20—\x20derive\x20value\x20from\x20context\x20or\x20ask\x20user.'),c['feeds_recipient']&&b['push']('\x20\x20\x20\x20\x20\x20⚠\x20this\x20value\x20can\x20determine\x20a\x20PAYMENT\x20RECIPIENT\x20—\x20wrong\x20address\x20=\x20funds\x20to\x20the\x20wrong\x20party');}a['required_submission_slots']&&a['required_submission_slots']['length']>0x0&&(b['push'](''),b['push']('Required\x20submission\x20slots\x20(D-c):\x20EVERY\x20slot\x20below\x20must\x20appear\x20in\x20the\x20submission\x20identifier\x20list,\x20'+'or\x20the\x20on-chain\x20forward\x20aborts\x20(code\x2011)\x20—\x20copy\x20this\x20list\x20verbatim\x20into\x20the\x20retry\x20envelope:'),b['push'](JSON['stringify'](a['required_submission_slots'])));a['binding_semantics']&&(b['push'](''),b['push']('If\x20verification\x20PASSES:\x20'+a['binding_semantics']['on_pass']),b['push']('If\x20verification\x20FAILS:\x20'+a['binding_semantics']['on_fail']),b['push']('Stakes:\x20'+a['binding_semantics']['stakes']));if(a['data_source_warnings']&&a['data_source_warnings']['length']>0x0){b['push'](''),b['push']('Data-source\x20warnings:');for(const d of a['data_source_warnings'])b['push']('\x20\x20-\x20'+d);}return a['protocol_slot_warning']&&(b['push'](''),b['push'](a['protocol_slot_warning'])),b['push'](''),b['push']('Fill\x20example\x20—\x20paste\x20as\x20the\x20top-level\x20`submission`\x20field\x20of\x20the\x20SAME\x20operation\x20call\x20(sibling\x20of\x20data/env):'),b['push'](a['fill_example']),b['join']('\x0a');}

package/dist/knowledge/guard-templates.d.ts

@@ -45,5 +45,5 @@ export type FillGuardTemplateResult = {
     missing?: string[];
 };
 export declare function fillGuardTemplate(templateId: string, params: Record<string, unknown>): FillGuardTemplateResult;
-export declare const GUARD_TEMPLATES_VERSION = "1.13.0";
+export declare const GUARD_TEMPLATES_VERSION = "1.14.0";
 export declare const GUARD_TEMPLATES_COUNT: number;