@wowok/agent-mcp 2.7.1 → 2.7.3

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

@@ -1,171 +1 @@
-import { query_objects, LocalMark } from "@wowok/wowok";
-function inferValue(fieldName, valueType, ctx) {
-    const name = fieldName.toLowerCase();
-    if (name.includes("order") || name.includes("task")) {
-        if (ctx.order_address) {
-            return { value: ctx.order_address, reason: "Inferred from operation's order_address context" };
-        }
-        if (ctx.progress_address) {
-            return { value: ctx.progress_address, reason: "Progress.task is typically the order — query Progress to get the actual task address" };
-        }
-    }
-    if (name.includes("signer") || name.includes("sender") || name.includes("caller")) {
-        if (ctx.signer) {
-            return { value: ctx.signer, reason: "Inferred from env.account (the signing account)" };
-        }
-    }
-    if (name.includes("service")) {
-        if (ctx.service_address) {
-            return { value: ctx.service_address, reason: "Inferred from operation's service_address context" };
-        }
-    }
-    if (name.includes("machine")) {
-        if (ctx.machine_address) {
-            return { value: ctx.machine_address, reason: "Inferred from operation's machine_address context" };
-        }
-    }
-    if (name.includes("progress") || name.includes("node") || name.includes("current")) {
-        if (ctx.progress_current) {
-            return { value: ctx.progress_current, reason: "Inferred from Progress.current node name" };
-        }
-    }
-    if (name.includes("allocation") || name.includes("allocator")) {
-        if (ctx.allocation_address) {
-            return { value: ctx.allocation_address, reason: "Inferred from operation's allocation_address context" };
-        }
-    }
-    if (ctx.extra) {
-        for (const [key, val] of Object.entries(ctx.extra)) {
-            if (name.includes(key.toLowerCase())) {
-                return { value: val, reason: `Inferred from extra context: ${key}` };
-            }
-        }
-    }
-    return undefined;
-}
-function describeField(name, valueType) {
-    const n = name.toLowerCase();
-    if (n.includes("order"))
-        return `Order object address (type: ${valueType})`;
-    if (n.includes("signer") || n.includes("sender"))
-        return `Transaction signer address (type: ${valueType})`;
-    if (n.includes("service"))
-        return `Service object address (type: ${valueType})`;
-    if (n.includes("machine"))
-        return `Machine object address (type: ${valueType})`;
-    if (n.includes("progress"))
-        return `Progress object address (type: ${valueType})`;
-    if (n.includes("node") || n.includes("current"))
-        return `Current node name (type: ${valueType})`;
-    if (n.includes("amount") || n.includes("price") || n.includes("balance"))
-        return `Amount in smallest unit (type: ${valueType})`;
-    if (n.includes("allocation"))
-        return `Allocation object address (type: ${valueType})`;
-    return `Field "${name}" (type: ${valueType})`;
-}
-export async function generateGuardSubmissionPrompt(guardRef, ctx) {
-    let guardAddress = guardRef;
-    let guardName;
-    if (!guardRef.startsWith("0x")) {
-        try {
-            const mark = await LocalMark.Instance().get(guardRef);
-            if (mark?.address) {
-                guardAddress = mark.address;
-                guardName = guardRef;
-            }
-            else {
-                return undefined;
-            }
-        }
-        catch {
-            return undefined;
-        }
-    }
-    let guardObj;
-    try {
-        const result = await query_objects({
-            objects: [guardAddress],
-            network: ctx.network,
-        });
-        guardObj = result?.objects?.[0];
-    }
-    catch {
-        return undefined;
-    }
-    if (!guardObj)
-        return undefined;
-    const table = guardObj.table ?? guardObj.b_table ?? [];
-    if (!Array.isArray(table) || table.length === 0)
-        return undefined;
-    const submissionItems = table.filter((item) => item.b_submission === true);
-    if (submissionItems.length === 0)
-        return undefined;
-    const requiredFields = submissionItems.map((item) => {
-        const fieldName = item.name ?? `identifier_${item.identifier}`;
-        const valueType = typeof item.value_type === "number"
-            ? ValueTypeNames[item.value_type] ?? String(item.value_type)
-            : String(item.value_type);
-        const inferred = inferValue(fieldName, valueType, ctx);
-        return {
-            identifier: item.identifier,
-            name: fieldName,
-            value_type: valueType,
-            required: true,
-            suggested_value: inferred?.value,
-            suggestion_reason: inferred?.reason,
-            description: describeField(fieldName, valueType),
-        };
-    });
-    const fillLines = requiredFields.map((f) => {
-        const val = f.suggested_value ?? `<${f.value_type}_value>`;
-        return `      { identifier: ${f.identifier}, name: "${f.name}", value_type: "${f.value_type}", value: ${val} }`;
-    });
-    const fillExample = `submission: {
-    guard: "${guardName ?? guardAddress}",
-    submission: [
-${fillLines.join(",\n")}
-    ]
-  }`;
-    return {
-        guard_address: guardAddress,
-        guard_name: guardName,
-        operation: ctx.operation,
-        required_fields: requiredFields,
-        context: `Operation "${ctx.operation}" requires Guard "${guardName ?? guardAddress}" verification. ` +
-            `The Guard has ${requiredFields.length} field(s) that need submission data (b_submission=true). ` +
-            `Fill the submission with the required values and retry the operation using call_with_submission. ` +
-            `Each field has an identifier (number), name, and expected value_type. ` +
-            `The suggested_value (if provided) is inferred from the operation context — verify before using.`,
-        fill_example: fillExample,
-    };
-}
-export function formatSubmissionPrompt(prompt) {
-    const lines = [];
-    lines.push("GUARD SUBMISSION REQUIRED — operation cannot proceed without submission data.");
-    lines.push(`Guard: ${prompt.guard_name ?? prompt.guard_address} (${prompt.guard_address})`);
-    lines.push(`Operation: ${prompt.operation}`);
-    lines.push("");
-    lines.push("Required fields (fill these in the submission):");
-    for (const f of prompt.required_fields) {
-        lines.push(`  [${f.identifier}] ${f.name} (${f.value_type}) — ${f.description}`);
-        if (f.suggested_value) {
-            lines.push(`      Suggested: ${f.suggested_value} (${f.suggestion_reason})`);
-        }
-        else {
-            lines.push(`      No suggestion — derive value from context or ask user.`);
-        }
-    }
-    lines.push("");
-    lines.push("Fill example (use in the next call with submission):");
-    lines.push(prompt.fill_example);
-    return lines.join("\n");
-}
-const ValueTypeNames = {
-    0: "Bool",
-    1: "Address",
-    2: "U64",
-    3: "String",
-    4: "Vec",
-    5: "U256",
-    6: "Object",
-};
+import{query_objects,LocalMark}from'@wowok/wowok';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 async function generateGuardSubmissionPrompt(a,b){let c=a,d;if(!a['startsWith']('0x'))try{const k=await LocalMark['Instance']()['get'](a);if(k?.['address'])c=k['address'],d=a;else return undefined;}catch{return undefined;}let e;try{const l=await query_objects({'objects':[c],'network':b['network']});e=l?.['objects']?.[0x0];}catch{return undefined;}if(!e)return undefined;const f=e['table']??e['b_table']??[];if(!Array['isArray'](f)||f['length']===0x0)return undefined;const g=f['filter'](m=>m['b_submission']===!![]);if(g['length']===0x0)return undefined;const h=g['map'](m=>{const n=m['name']??'identifier_'+m['identifier'],o=typeof m['value_type']==='number'?ValueTypeNames[m['value_type']]??String(m['value_type']):String(m['value_type']),p=inferValue(n,o,b);return{'identifier':m['identifier'],'name':n,'value_type':o,'required':!![],'suggested_value':p?.['value'],'suggestion_reason':p?.['reason'],'description':describeField(n,o)};}),i=h['map'](m=>{const n=m['suggested_value']??'<'+m['value_type']+'_value>';return'\x20\x20\x20\x20\x20\x20{\x20identifier:\x20'+m['identifier']+',\x20name:\x20\x22'+m['name']+'\x22,\x20value_type:\x20\x22'+m['value_type']+'\x22,\x20value:\x20'+n+'\x20}';}),j='submission:\x20{\x0a\x20\x20\x20\x20guard:\x20\x22'+(d??c)+'\x22,\x0a\x20\x20\x20\x20submission:\x20[\x0a'+i['join'](',\x0a')+'\x0a\x20\x20\x20\x20]\x0a\x20\x20}';return{'guard_address':c,'guard_name':d,'operation':b['operation'],'required_fields':h,'context':'Operation\x20\x22'+b['operation']+'\x22\x20requires\x20Guard\x20\x22'+(d??c)+'\x22\x20verification.\x20'+('The\x20Guard\x20has\x20'+h['length']+'\x20field(s)\x20that\x20need\x20submission\x20data\x20(b_submission=true).\x20')+'Fill\x20the\x20submission\x20with\x20the\x20required\x20values\x20and\x20retry\x20the\x20operation\x20using\x20call_with_submission.\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':j};}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']),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.');}return b['push'](''),b['push']('Fill\x20example\x20(use\x20in\x20the\x20next\x20call\x20with\x20submission):'),b['push'](a['fill_example']),b['join']('\x0a');}const ValueTypeNames={0x0:'Bool',0x1:'Address',0x2:'U64',0x3:'String',0x4:'Vec',0x5:'U256',0x6:'Object'};