@wowok/agent-mcp 2.7.0 → 2.7.2

package/dist/knowledge/progress-templates.js

@@ -1,228 +1 @@
-export const PROGRESS_TEMPLATES = [
-    {
-        id: "T-PR-01",
-        name: "Single named_operator workflow",
-        description: "Bind a single named_operator role (e.g. 'seller' or 'logistics') to a Progress. " +
-            "Suitable for linear flows with one external operator besides OrderHolder.",
-        applicable_scenes: ["progress_named_operator", "progress_task_submit"],
-        industry_tags: ["universal", "ecommerce"],
-        params: [
-            { name: "progress_address", type: "address", description: "Progress object address", required: true },
-            { name: "operator_name", type: "name", description: "named_operator name (e.g. 'seller', 'logistics')", required: true },
-            { name: "operator_address", type: "address", description: "Single operator address", required: true },
-        ],
-        body: (p) => ({
-            object: p.progress_address,
-            progress_namedOperator: {
-                op: "set",
-                name: p.operator_name,
-                operators: [p.operator_address],
-            },
-        }),
-        notes: [
-            "Use 'set' for initial assignment (REPLACE list); use 'add' for extending existing list",
-            "Operator name must be a valid NAME (common::NAME) — non-empty, length-bounded",
-            "Empty name '' is reserved for OrderHolder — do not use here",
-        ],
-    },
-    {
-        id: "T-PR-02",
-        name: "Multi named_operator collaborative workflow",
-        description: "Bind multiple named_operator roles in one transaction (e.g. seller + logistics + reviewer). " +
-            "Suitable for collaborative workflows where different roles advance different forwards.",
-        applicable_scenes: ["progress_named_operator"],
-        industry_tags: ["logistics", "arbitration", "freelance"],
-        params: [
-            { name: "progress_address", type: "address", description: "Progress object address", required: true },
-            { name: "roles", type: "string[]", description: "named_operator names (e.g. ['seller','logistics','reviewer'])", required: true },
-            { name: "addresses_per_role", type: "string", description: "Comma-separated addresses per role, semicolon-separated roles (e.g. '0xA,0xB;0xC;0xD,0xE')", required: true },
-        ],
-        body: (p) => {
-            const roles = p.roles;
-            const roleAddrStrings = p.addresses_per_role.split(";");
-            const operations = [];
-            for (let i = 0; i < roles.length; i++) {
-                const roleName = roles[i];
-                const addrs = (roleAddrStrings[i] ?? "").split(",").map(s => s.trim()).filter(s => s.length > 0);
-                operations.push({
-                    object: p.progress_address,
-                    progress_namedOperator: {
-                        op: "set",
-                        name: roleName,
-                        operators: addrs,
-                    },
-                });
-            }
-            return {
-                _batch: operations,
-                _note: "Each entry is a separate CallProgress_Data; submit all in one transaction",
-            };
-        },
-        notes: [
-            "Each role must satisfy common::NAME — non-empty, length-bounded",
-            "Total roles ≤ MAX_NAMED_OPERATOR_COUNT (60); each role's addresses ≤ MAX_NAMED_OPERATOR_ADDRESS_COUNT (80)",
-            "Submit all operations in a single transaction for atomicity",
-        ],
-    },
-    {
-        id: "T-PR-03",
-        name: "Context_repository binding workflow",
-        description: "Bind context Repository objects to a Progress for query-time context " +
-            "(learning progress, inspection records, bridge state). Up to 30 repositories.",
-        applicable_scenes: ["progress_context_repository"],
-        industry_tags: ["education", "content", "rental", "cross_chain"],
-        params: [
-            { name: "progress_address", type: "address", description: "Progress object address", required: true },
-            { name: "repository_addresses", type: "string[]", description: "Repository object addresses to bind", required: true },
-            { name: "op", type: "string", description: "Operation: 'add' (extend) | 'set' (replace) | 'remove' | 'clear'", required: false, default: "add" },
-        ],
-        body: (p) => ({
-            object: p.progress_address,
-            repository: {
-                op: p.op || "add",
-                objects: p.repository_addresses,
-            },
-        }),
-        notes: [
-            "op='add' is idempotent (vector::contains check); op='set' clears then adds",
-            "Total count ≤ MAX_CONTEXT_REPOSITORY_COUNT (30); E_MAX_CONTEXT_REPOSITORY_COUNT on overflow",
-            "Binding creates Registrar affiliation — remove before deleting Repository to avoid dangling refs",
-            "Bind BEFORE forward advance so on-chain guards can read context data",
-        ],
-    },
-    {
-        id: "T-PR-04",
-        name: "Forward advancement workflow",
-        description: "Advance a Progress forward (next or hold). Forwards are defined in the bound Machine; " +
-            "this template emits the operate payload for a single forward step.",
-        applicable_scenes: ["progress_completed", "progress_unhold"],
-        industry_tags: ["universal"],
-        params: [
-            { name: "progress_address", type: "address", description: "Progress object address", required: true },
-            { name: "next_node_name", type: "name", description: "Target node name (must exist in Machine)", required: true },
-            { name: "forward", type: "name", description: "Forward name (from current → next_node_name)", required: true },
-            { name: "op", type: "string", description: "'next' to advance the forward, 'hold' to lock the forward", required: false, default: "next" },
-            { name: "message", type: "string", description: "Deliverable message (≤ MAX_LONG_NAME_LENGTH)", required: false, default: "" },
-        ],
-        body: (p) => ({
-            object: p.progress_address,
-            operate: {
-                operation: {
-                    next_node_name: p.next_node_name,
-                    forward: p.forward,
-                },
-                op: p.op || "next",
-                message: p.message || "",
-            },
-        }),
-        notes: [
-            "Forward must exist in Machine: query machine::info_borrow(machine, current, next_node, forward)",
-            "If Forward.guard is Some, use *_with_passport variant (SDK auto-selects based on submission)",
-            "If Forward.namedOperator is set, caller must be in that operator list (IsNamedOperator short-circuit)",
-            "op='hold' blocks the forward; op='next' advances it; op='unhold' self-releases; op='adminUnhold' force-releases via 224",
-        ],
-    },
-    {
-        id: "T-PR-05",
-        name: "Unhold / adminUnhold workflow",
-        description: "Release a previously-held forward. Two modes: (a) self-unhold by original holder (op='unhold'); " +
-            "(b) adminUnhold via 224 permission to bypass holder check (op='adminUnhold', deadlock recovery).",
-        applicable_scenes: ["progress_unhold"],
-        industry_tags: ["content", "rental", "arbitration", "subscription"],
-        params: [
-            { name: "progress_address", type: "address", description: "Progress object address", required: true },
-            { name: "next_node_name", type: "name", description: "Target node name (matches the held forward)", required: true },
-            { name: "forward", type: "name", description: "Forward name (matches the held forward)", required: true },
-            { name: "admin_unhold", type: "string", description: "'true' to force-release via 224 permission (op='adminUnhold'); 'false' for self-unhold (op='unhold')", required: false, default: "false" },
-            { name: "message", type: "string", description: "Release message (≤ MAX_LONG_NAME_LENGTH)", required: false, default: "" },
-        ],
-        body: (p) => ({
-            object: p.progress_address,
-            operate: {
-                operation: {
-                    next_node_name: p.next_node_name,
-                    forward: p.forward,
-                },
-                op: p.admin_unhold === "true" ? "adminUnhold" : "unhold",
-                message: p.message || "",
-            },
-        }),
-        notes: [
-            "op='unhold': sender must == Holder.who; else E_NOT_THE_HOLDER",
-            "op='adminUnhold': requires 224 permission (PROGRESS_UNHOLD); bypasses holder check",
-            "Re-hold on already-accomplished forward → E_FORWARD_ALREADY_ACCOMPLISHED",
-            "Use adminUnhold sparingly — log every invocation for audit",
-        ],
-    },
-    {
-        id: "T-PR-06",
-        name: "Owner receive workflow",
-        description: "Owner receives Receiving<K> objects or CoinWrapper<T> coins at a terminal node. " +
-            "Unwraps via Payment.unwrap_with_check; forwards to Permission owner. " +
-            "Note: NOT exposed in CallProgress_Data — direct Move call required.",
-        applicable_scenes: ["progress_owner_receive"],
-        industry_tags: ["finance", "treasury", "rental", "freelance"],
-        params: [
-            { name: "progress_address", type: "address", description: "Progress object address", required: true },
-            { name: "machine_address", type: "address", description: "Bound Machine object address", required: true },
-            { name: "permission_address", type: "address", description: "Machine's Permission object address", required: true },
-            { name: "asset_type", type: "string", description: "'coin' or 'object'", required: true },
-            { name: "received_object", type: "address", description: "Receiving<K> object address (the received 'envelope')", required: true },
-            { name: "payment_object", type: "address", description: "Payment<T> object address (only for asset_type='coin')", required: false },
-        ],
-        body: (p) => ({
-            _note: "This operation is NOT exposed via CallProgress_Data; must be called via direct Move call.",
-            _move_target: p.asset_type === "coin"
-                ? "progress::owner_receive<T>"
-                : "progress::owner_receive_object<K>",
-            _arguments: p.asset_type === "coin"
-                ? [p.progress_address, p.machine_address, p.permission_address, p.received_object, p.payment_object]
-                : [p.progress_address, p.machine_address, p.permission_address, p.received_object],
-            _permission_required: 225,
-            _permission_label: "PROGRESS_OWNER_RECEIVE",
-        }),
-        notes: [
-            "Permission 225 (PROGRESS_OWNER_RECEIVE) is required; SDK CallProgress_Data does NOT expose this op",
-            "Recipient is Permission owner (Machine.permission's owner), NOT Progress creator",
-            "Triggered at terminal nodes: 'return_approved', 'completed', 'enforced', 'paid'",
-            "For coins: Payment.unwrap_with_check validates amount before forwarding to owner",
-            "For objects: generic K:key+store — forwarded directly via permission::owner_receive_inner",
-        ],
-    },
-];
-export const PROGRESS_TEMPLATES_VERSION = "1.0.0";
-export function getAllProgressTemplates() {
-    return [...PROGRESS_TEMPLATES];
-}
-export function getProgressTemplateById(id) {
-    return PROGRESS_TEMPLATES.find(t => t.id === id);
-}
-export function getProgressTemplatesByScene(sceneId) {
-    return PROGRESS_TEMPLATES.filter(t => t.applicable_scenes.includes(sceneId));
-}
-export function getProgressTemplatesByIndustry(industry) {
-    return PROGRESS_TEMPLATES.filter(t => t.industry_tags.includes(industry) || t.industry_tags.includes("universal"));
-}
-export function suggestProgressTemplateForScene(sceneId) {
-    const matches = getProgressTemplatesByScene(sceneId);
-    return matches.length > 0 ? matches[0] : undefined;
-}
-export function listProgressTemplates() {
-    return PROGRESS_TEMPLATES.map(t => ({
-        id: t.id,
-        name: t.name,
-        description: t.description,
-        scenes: t.applicable_scenes,
-    }));
-}
-export function fillProgressTemplate(templateId, params) {
-    const tpl = getProgressTemplateById(templateId);
-    if (!tpl)
-        return { ok: false, error: `Template ${templateId} not found` };
-    for (const p of tpl.params) {
-        if (p.required && !(p.name in params)) {
-            return { ok: false, error: `Missing required param: ${p.name}` };
-        }
-    }
-    return { ok: true, body: tpl.body(params) };
-}
+export const PROGRESS_TEMPLATES=[{'id':'T-PR-01','name':'Single\x20named_operator\x20workflow','description':'Bind\x20a\x20single\x20named_operator\x20role\x20(e.g.\x20\x27seller\x27\x20or\x20\x27logistics\x27)\x20to\x20a\x20Progress.\x20'+'Suitable\x20for\x20linear\x20flows\x20with\x20one\x20external\x20operator\x20besides\x20OrderHolder.','applicable_scenes':['progress_named_operator','progress_task_submit'],'industry_tags':['universal','ecommerce'],'params':[{'name':'progress_address','type':'address','description':'Progress\x20object\x20address','required':!![]},{'name':'operator_name','type':'name','description':'named_operator\x20name\x20(e.g.\x20\x27seller\x27,\x20\x27logistics\x27)','required':!![]},{'name':'operator_address','type':'address','description':'Single\x20operator\x20address','required':!![]}],'body':a=>({'object':a['progress_address'],'progress_namedOperator':{'op':'set','name':a['operator_name'],'operators':[a['operator_address']]}}),'notes':['Use\x20\x27set\x27\x20for\x20initial\x20assignment\x20(REPLACE\x20list);\x20use\x20\x27add\x27\x20for\x20extending\x20existing\x20list','Operator\x20name\x20must\x20be\x20a\x20valid\x20NAME\x20(common::NAME)\x20—\x20non-empty,\x20length-bounded','Empty\x20name\x20\x27\x27\x20is\x20reserved\x20for\x20OrderHolder\x20—\x20do\x20not\x20use\x20here']},{'id':'T-PR-02','name':'Multi\x20named_operator\x20collaborative\x20workflow','description':'Bind\x20multiple\x20named_operator\x20roles\x20in\x20one\x20transaction\x20(e.g.\x20seller\x20+\x20logistics\x20+\x20reviewer).\x20'+'Suitable\x20for\x20collaborative\x20workflows\x20where\x20different\x20roles\x20advance\x20different\x20forwards.','applicable_scenes':['progress_named_operator'],'industry_tags':['logistics','arbitration','freelance'],'params':[{'name':'progress_address','type':'address','description':'Progress\x20object\x20address','required':!![]},{'name':'roles','type':'string[]','description':'named_operator\x20names\x20(e.g.\x20[\x27seller\x27,\x27logistics\x27,\x27reviewer\x27])','required':!![]},{'name':'addresses_per_role','type':'string','description':'Comma-separated\x20addresses\x20per\x20role,\x20semicolon-separated\x20roles\x20(e.g.\x20\x270xA,0xB;0xC;0xD,0xE\x27)','required':!![]}],'body':a=>{const b=a['roles'],c=a['addresses_per_role']['split'](';'),d=[];for(let e=0x0;e<b['length'];e++){const f=b[e],g=(c[e]??'')['split'](',')['map'](h=>h['trim']())['filter'](h=>h['length']>0x0);d['push']({'object':a['progress_address'],'progress_namedOperator':{'op':'set','name':f,'operators':g}});}return{'_batch':d,'_note':'Each\x20entry\x20is\x20a\x20separate\x20CallProgress_Data;\x20submit\x20all\x20in\x20one\x20transaction'};},'notes':['Each\x20role\x20must\x20satisfy\x20common::NAME\x20—\x20non-empty,\x20length-bounded','Total\x20roles\x20≤\x20MAX_NAMED_OPERATOR_COUNT\x20(60);\x20each\x20role\x27s\x20addresses\x20≤\x20MAX_NAMED_OPERATOR_ADDRESS_COUNT\x20(80)','Submit\x20all\x20operations\x20in\x20a\x20single\x20transaction\x20for\x20atomicity']},{'id':'T-PR-03','name':'Context_repository\x20binding\x20workflow','description':'Bind\x20context\x20Repository\x20objects\x20to\x20a\x20Progress\x20for\x20query-time\x20context\x20'+'(learning\x20progress,\x20inspection\x20records,\x20bridge\x20state).\x20Up\x20to\x2030\x20repositories.','applicable_scenes':['progress_context_repository'],'industry_tags':['education','content','rental','cross_chain'],'params':[{'name':'progress_address','type':'address','description':'Progress\x20object\x20address','required':!![]},{'name':'repository_addresses','type':'string[]','description':'Repository\x20object\x20addresses\x20to\x20bind','required':!![]},{'name':'op','type':'string','description':'Operation:\x20\x27add\x27\x20(extend)\x20|\x20\x27set\x27\x20(replace)\x20|\x20\x27remove\x27\x20|\x20\x27clear\x27','required':![],'default':'add'}],'body':a=>({'object':a['progress_address'],'repository':{'op':a['op']||'add','objects':a['repository_addresses']}}),'notes':['op=\x27add\x27\x20is\x20idempotent\x20(vector::contains\x20check);\x20op=\x27set\x27\x20clears\x20then\x20adds','Total\x20count\x20≤\x20MAX_CONTEXT_REPOSITORY_COUNT\x20(30);\x20E_MAX_CONTEXT_REPOSITORY_COUNT\x20on\x20overflow','Binding\x20creates\x20Registrar\x20affiliation\x20—\x20remove\x20before\x20deleting\x20Repository\x20to\x20avoid\x20dangling\x20refs','Bind\x20BEFORE\x20forward\x20advance\x20so\x20on-chain\x20guards\x20can\x20read\x20context\x20data']},{'id':'T-PR-04','name':'Forward\x20advancement\x20workflow','description':'Advance\x20a\x20Progress\x20forward\x20(next\x20or\x20hold).\x20Forwards\x20are\x20defined\x20in\x20the\x20bound\x20Machine;\x20'+'this\x20template\x20emits\x20the\x20operate\x20payload\x20for\x20a\x20single\x20forward\x20step.','applicable_scenes':['progress_completed','progress_unhold'],'industry_tags':['universal'],'params':[{'name':'progress_address','type':'address','description':'Progress\x20object\x20address','required':!![]},{'name':'next_node_name','type':'name','description':'Target\x20node\x20name\x20(must\x20exist\x20in\x20Machine)','required':!![]},{'name':'forward','type':'name','description':'Forward\x20name\x20(from\x20current\x20→\x20next_node_name)','required':!![]},{'name':'op','type':'string','description':'\x27next\x27\x20to\x20advance\x20the\x20forward,\x20\x27hold\x27\x20to\x20lock\x20the\x20forward','required':![],'default':'next'},{'name':'message','type':'string','description':'Deliverable\x20message\x20(≤\x20MAX_LONG_NAME_LENGTH)','required':![],'default':''}],'body':a=>({'object':a['progress_address'],'operate':{'operation':{'next_node_name':a['next_node_name'],'forward':a['forward']},'op':a['op']||'next','message':a['message']||''}}),'notes':['Forward\x20must\x20exist\x20in\x20Machine:\x20query\x20machine::info_borrow(machine,\x20current,\x20next_node,\x20forward)','If\x20Forward.guard\x20is\x20Some,\x20use\x20*_with_passport\x20variant\x20(SDK\x20auto-selects\x20based\x20on\x20submission)','If\x20Forward.namedOperator\x20is\x20set,\x20caller\x20must\x20be\x20in\x20that\x20operator\x20list\x20(IsNamedOperator\x20short-circuit)','op=\x27hold\x27\x20blocks\x20the\x20forward;\x20op=\x27next\x27\x20advances\x20it;\x20op=\x27unhold\x27\x20self-releases;\x20op=\x27adminUnhold\x27\x20force-releases\x20via\x20224']},{'id':'T-PR-05','name':'Unhold\x20/\x20adminUnhold\x20workflow','description':'Release\x20a\x20previously-held\x20forward.\x20Two\x20modes:\x20(a)\x20self-unhold\x20by\x20original\x20holder\x20(op=\x27unhold\x27);\x20'+'(b)\x20adminUnhold\x20via\x20224\x20permission\x20to\x20bypass\x20holder\x20check\x20(op=\x27adminUnhold\x27,\x20deadlock\x20recovery).','applicable_scenes':['progress_unhold'],'industry_tags':['content','rental','arbitration','subscription'],'params':[{'name':'progress_address','type':'address','description':'Progress\x20object\x20address','required':!![]},{'name':'next_node_name','type':'name','description':'Target\x20node\x20name\x20(matches\x20the\x20held\x20forward)','required':!![]},{'name':'forward','type':'name','description':'Forward\x20name\x20(matches\x20the\x20held\x20forward)','required':!![]},{'name':'admin_unhold','type':'string','description':'\x27true\x27\x20to\x20force-release\x20via\x20224\x20permission\x20(op=\x27adminUnhold\x27);\x20\x27false\x27\x20for\x20self-unhold\x20(op=\x27unhold\x27)','required':![],'default':'false'},{'name':'message','type':'string','description':'Release\x20message\x20(≤\x20MAX_LONG_NAME_LENGTH)','required':![],'default':''}],'body':a=>({'object':a['progress_address'],'operate':{'operation':{'next_node_name':a['next_node_name'],'forward':a['forward']},'op':a['admin_unhold']==='true'?'adminUnhold':'unhold','message':a['message']||''}}),'notes':['op=\x27unhold\x27:\x20sender\x20must\x20==\x20Holder.who;\x20else\x20E_NOT_THE_HOLDER','op=\x27adminUnhold\x27:\x20requires\x20224\x20permission\x20(PROGRESS_UNHOLD);\x20bypasses\x20holder\x20check','Re-hold\x20on\x20already-accomplished\x20forward\x20→\x20E_FORWARD_ALREADY_ACCOMPLISHED','Use\x20adminUnhold\x20sparingly\x20—\x20log\x20every\x20invocation\x20for\x20audit']},{'id':'T-PR-06','name':'Owner\x20receive\x20workflow','description':'Owner\x20receives\x20Receiving<K>\x20objects\x20or\x20CoinWrapper<T>\x20coins\x20at\x20a\x20terminal\x20node.\x20'+'Unwraps\x20via\x20Payment.unwrap_with_check;\x20forwards\x20to\x20Permission\x20owner.\x20'+'Note:\x20NOT\x20exposed\x20in\x20CallProgress_Data\x20—\x20direct\x20Move\x20call\x20required.','applicable_scenes':['progress_owner_receive'],'industry_tags':['finance','treasury','rental','freelance'],'params':[{'name':'progress_address','type':'address','description':'Progress\x20object\x20address','required':!![]},{'name':'machine_address','type':'address','description':'Bound\x20Machine\x20object\x20address','required':!![]},{'name':'permission_address','type':'address','description':'Machine\x27s\x20Permission\x20object\x20address','required':!![]},{'name':'asset_type','type':'string','description':'\x27coin\x27\x20or\x20\x27object\x27','required':!![]},{'name':'received_object','type':'address','description':'Receiving<K>\x20object\x20address\x20(the\x20received\x20\x27envelope\x27)','required':!![]},{'name':'payment_object','type':'address','description':'Payment<T>\x20object\x20address\x20(only\x20for\x20asset_type=\x27coin\x27)','required':![]}],'body':a=>({'_note':'This\x20operation\x20is\x20NOT\x20exposed\x20via\x20CallProgress_Data;\x20must\x20be\x20called\x20via\x20direct\x20Move\x20call.','_move_target':a['asset_type']==='coin'?'progress::owner_receive<T>':'progress::owner_receive_object<K>','_arguments':a['asset_type']==='coin'?[a['progress_address'],a['machine_address'],a['permission_address'],a['received_object'],a['payment_object']]:[a['progress_address'],a['machine_address'],a['permission_address'],a['received_object']],'_permission_required':0xe1,'_permission_label':'PROGRESS_OWNER_RECEIVE'}),'notes':['Permission\x20225\x20(PROGRESS_OWNER_RECEIVE)\x20is\x20required;\x20SDK\x20CallProgress_Data\x20does\x20NOT\x20expose\x20this\x20op','Recipient\x20is\x20Permission\x20owner\x20(Machine.permission\x27s\x20owner),\x20NOT\x20Progress\x20creator','Triggered\x20at\x20terminal\x20nodes:\x20\x27return_approved\x27,\x20\x27completed\x27,\x20\x27enforced\x27,\x20\x27paid\x27','For\x20coins:\x20Payment.unwrap_with_check\x20validates\x20amount\x20before\x20forwarding\x20to\x20owner','For\x20objects:\x20generic\x20K:key+store\x20—\x20forwarded\x20directly\x20via\x20permission::owner_receive_inner']}];export const PROGRESS_TEMPLATES_VERSION='1.0.0';export function getAllProgressTemplates(){return[...PROGRESS_TEMPLATES];}export function getProgressTemplateById(a){return PROGRESS_TEMPLATES['find'](b=>b['id']===a);}export function getProgressTemplatesByScene(a){return PROGRESS_TEMPLATES['filter'](b=>b['applicable_scenes']['includes'](a));}export function getProgressTemplatesByIndustry(a){return PROGRESS_TEMPLATES['filter'](b=>b['industry_tags']['includes'](a)||b['industry_tags']['includes']('universal'));}export function suggestProgressTemplateForScene(a){const b=getProgressTemplatesByScene(a);return b['length']>0x0?b[0x0]:undefined;}export function listProgressTemplates(){return PROGRESS_TEMPLATES['map'](a=>({'id':a['id'],'name':a['name'],'description':a['description'],'scenes':a['applicable_scenes']}));}export function fillProgressTemplate(a,b){const c=getProgressTemplateById(a);if(!c)return{'ok':![],'error':'Template\x20'+a+'\x20not\x20found'};for(const d of c['params']){if(d['required']&&!(d['name']in b))return{'ok':![],'error':'Missing\x20required\x20param:\x20'+d['name']};}return{'ok':!![],'body':c['body'](b)};}