@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/schema/utils/node-parser.js

@@ -1,369 +1 @@
-import { NodeSchema } from '../call/machine.js';
-import { MachineNodeSchema, MachineNodePairSchema, MachineForwardSchema } from '../query/index.js';
-import { writeFileSync } from 'fs';
-function detectFormat(text) {
-    const trimmed = text.trim();
-    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
-        return 'json';
-    }
-    return 'markdown';
-}
-function extractJsonFromMarkdown(markdown) {
-    const codeBlockRegex = /```(?:json)?\s*\n([\s\S]*?)```/g;
-    let match;
-    let lastMatch = null;
-    while ((match = codeBlockRegex.exec(markdown)) !== null) {
-        const jsonContent = match[1].trim();
-        if (jsonContent.startsWith('[') || jsonContent.startsWith('{')) {
-            const beforeMatch = markdown.substring(0, match.index);
-            const lineOffset = (beforeMatch.match(/\n/g) || []).length + 1;
-            lastMatch = { json: jsonContent, lineOffset };
-        }
-    }
-    return lastMatch;
-}
-function parseMarkdownToNodeData(markdown) {
-    const errors = [];
-    const jsonMatch = extractJsonFromMarkdown(markdown);
-    if (jsonMatch) {
-        try {
-            const data = JSON.parse(jsonMatch.json);
-            return { data, errors: [] };
-        }
-        catch (e) {
-            errors.push({
-                message: `Failed to parse JSON from markdown: ${e.message}`,
-                path: '/',
-            });
-            return { data: null, errors };
-        }
-    }
-    const result = { op: 'add' };
-    const nodes = [];
-    const opMatch = markdown.match(/(?:^|\n)#+\s*Operation[^\n]*\n+[-*]\s*op\s*:\s*(\w+)/i);
-    if (opMatch) {
-        result.op = opMatch[1].toLowerCase();
-    }
-    const replaceMatch = markdown.match(/(?:^|\n)#+\s*Options[^\n]*\n+[-*]\s*bReplace\s*:\s*(true|false)/i);
-    if (replaceMatch) {
-        result.bReplace = replaceMatch[1].toLowerCase() === 'true';
-    }
-    const nodeSections = markdown.split(/(?=^##\s*Node[:\s])/m);
-    for (const section of nodeSections.slice(1)) {
-        const nodeNameMatch = section.match(/^##\s*Node[:\s]+(.+?)(?:\n|$)/im);
-        if (!nodeNameMatch)
-            continue;
-        const nodeName = nodeNameMatch[1].trim();
-        const node = { name: nodeName, pairs: [] };
-        const pairSections = section.split(/(?=^###\s*(?:Pair|Previous Node)[:\s])/m);
-        for (const pairSection of pairSections.slice(1)) {
-            const prevNodeMatch = pairSection.match(/(?:^|\n)[-*]\s*prev_node\s*[:]\s*(.+?)(?:\n|$)/im) ||
-                pairSection.match(/^###\s*(?:Pair|Previous Node)[:\s]+(.+?)(?:\n|$)/im);
-            const thresholdMatch = pairSection.match(/(?:^|\n)[-*]\s*threshold\s*[:]\s*(\d+)/i);
-            if (!prevNodeMatch)
-                continue;
-            const pair = {
-                prev_node: prevNodeMatch[1].trim(),
-                threshold: thresholdMatch ? parseInt(thresholdMatch[1], 10) : 0,
-                forwards: []
-            };
-            const tableRows = pairSection.match(/\|[^\n]+\|/g);
-            if (tableRows && tableRows.length > 2) {
-                for (const row of tableRows.slice(2)) {
-                    const cells = row.split('|').filter(c => c.trim()).map(c => c.trim());
-                    if (cells.length >= 2) {
-                        const forward = {
-                            name: cells[0],
-                            weight: parseInt(cells[1], 10) || 0
-                        };
-                        if (cells.length >= 3 && cells[2] && cells[2] !== '-') {
-                            forward.namedOperator = cells[2];
-                        }
-                        if (cells.length >= 4 && cells[3] && cells[3] !== '-') {
-                            forward.permissionIndex = parseInt(cells[3], 10);
-                        }
-                        if (cells.length >= 5 && cells[4] && cells[4] !== '-') {
-                            forward.guard = cells[4];
-                        }
-                        pair.forwards.push(forward);
-                    }
-                }
-            }
-            const forwardMatches = pairSection.matchAll(/(?:^|\n)[-*]\s*(?:forward)?\s*[:]?\s*\n?([\s\S]*?)(?=(?:\n[-*]\s*(?:forward|prev_node|threshold))|\n###|\n##|$)/gi);
-            for (const forwardMatch of forwardMatches) {
-                const forwardSection = forwardMatch[1];
-                const nameMatch = forwardSection.match(/\s*name\s*[:]\s*(.+?)(?:\n|$)/im);
-                const weightMatch = forwardSection.match(/\s*weight\s*[:]\s*(\d+)/i);
-                if (nameMatch && weightMatch) {
-                    const forward = {
-                        name: nameMatch[1].trim(),
-                        weight: parseInt(weightMatch[1], 10)
-                    };
-                    const namedOperatorMatch = forwardSection.match(/\s*namedOperator\s*[:]\s*(.+?)(?:\n|$)/im);
-                    const permissionIndexMatch = forwardSection.match(/\s*permissionIndex\s*[:]\s*(\d+)/i);
-                    const guardMatch = forwardSection.match(/\s*guard\s*[:]\s*(.+?)(?:\n|$)/im);
-                    if (namedOperatorMatch) {
-                        forward.namedOperator = namedOperatorMatch[1].trim();
-                    }
-                    if (permissionIndexMatch) {
-                        forward.permissionIndex = parseInt(permissionIndexMatch[1], 10);
-                    }
-                    if (guardMatch) {
-                        forward.guard = guardMatch[1].trim();
-                    }
-                    pair.forwards.push(forward);
-                }
-            }
-            node.pairs.push(pair);
-        }
-        nodes.push(node);
-    }
-    if (nodes.length > 0) {
-        result.nodes = nodes;
-    }
-    return { data: result, errors };
-}
-function formatZodPath(path) {
-    return '/' + path.map(p => String(p).replace(/~/g, '~0').replace(/\//g, '~1')).join('/');
-}
-function parseJsonWithErrors(text) {
-    const errors = [];
-    try {
-        const data = JSON.parse(text);
-        return { data, errors: [] };
-    }
-    catch (e) {
-        const jsonError = e;
-        const lineMatch = jsonError.message.match(/position\s+(\d+)/);
-        let line = 1;
-        let column = 1;
-        if (lineMatch) {
-            const pos = parseInt(lineMatch[1], 10);
-            const lines = text.substring(0, pos).split('\n');
-            line = lines.length;
-            column = lines[lines.length - 1].length + 1;
-        }
-        errors.push({
-            message: `JSON parse error: ${jsonError.message}`,
-            path: '/',
-            line,
-            column,
-        });
-        return { data: null, errors };
-    }
-}
-function validateWithZod(schema, data, basePath = '') {
-    const errors = [];
-    const result = schema.safeParse(data);
-    if (result.success) {
-        return { success: true, data: result.data, errors: [] };
-    }
-    for (const issue of result.error.issues) {
-        const path = basePath + formatZodPath(issue.path);
-        errors.push({
-            message: issue.message,
-            path,
-        });
-    }
-    return { success: false, errors };
-}
-export function parseNodeFromText(text) {
-    const trimmed = text.trim();
-    const format = detectFormat(trimmed);
-    let parsedData;
-    let errors = [];
-    if (format === 'markdown') {
-        const mdResult = parseMarkdownToNodeData(trimmed);
-        if (mdResult.errors.length > 0) {
-            return { success: false, errors: mdResult.errors };
-        }
-        parsedData = mdResult.data;
-    }
-    else {
-        const jsonResult = parseJsonWithErrors(trimmed);
-        if (jsonResult.errors.length > 0) {
-            return { success: false, errors: jsonResult.errors };
-        }
-        parsedData = jsonResult.data;
-    }
-    const validation = validateWithZod(NodeSchema, parsedData);
-    return {
-        success: validation.success,
-        data: validation.data,
-        errors: validation.errors,
-    };
-}
-export function parseMachineNodesFromText(text) {
-    const trimmed = text.trim();
-    const format = detectFormat(trimmed);
-    let parsedData;
-    let errors = [];
-    if (format === 'markdown') {
-        const mdResult = parseMarkdownToNodeData(trimmed);
-        if (mdResult.errors.length > 0) {
-            return { success: false, errors: mdResult.errors };
-        }
-        if (typeof mdResult.data === 'object' && mdResult.data !== null && 'nodes' in mdResult.data) {
-            parsedData = mdResult.data.nodes;
-        }
-        else {
-            parsedData = mdResult.data;
-        }
-    }
-    else {
-        const jsonResult = parseJsonWithErrors(trimmed);
-        if (jsonResult.errors.length > 0) {
-            return { success: false, errors: jsonResult.errors };
-        }
-        parsedData = jsonResult.data;
-    }
-    if (!Array.isArray(parsedData)) {
-        if (typeof parsedData === 'object' && parsedData !== null && 'op' in parsedData) {
-            return {
-                success: false,
-                errors: [{
-                        message: 'Expected JSON array of nodes for json_or_markdown mode. Use schema mode for operations with "op" field.',
-                        path: '/',
-                    }]
-            };
-        }
-        return {
-            success: false,
-            errors: [{
-                    message: 'Expected JSON array of nodes',
-                    path: '/',
-                }]
-        };
-    }
-    const nodes = [];
-    for (let i = 0; i < parsedData.length; i++) {
-        const nodeData = parsedData[i];
-        const validation = validateWithZod(MachineNodeSchema, nodeData, `/${i}`);
-        if (validation.success && validation.data) {
-            nodes.push(validation.data);
-        }
-        else {
-            errors.push(...validation.errors);
-        }
-    }
-    if (errors.length > 0) {
-        return { success: false, errors };
-    }
-    const hasEntryForward = nodes.some(node => node.pairs.some(pair => pair.prev_node === ""));
-    if (!hasEntryForward) {
-        return {
-            success: false,
-            errors: [{
-                    message: 'Machine has no entry forward. At least one node must have a pair with prev_node="" (empty string), ' +
-                        'which defines how Progress advances from the initial state (current="") to the first node. ' +
-                        'Without an entry forward, the workflow will be permanently stuck. ' +
-                        'Example: {name: "Subscribed", pairs: [{prev_node: "", forwards: [{name: "Subscribe", weight: 1}]}]}',
-                    path: '/',
-                }]
-        };
-    }
-    return { success: true, data: nodes, errors: [] };
-}
-export function formatNodeErrors(errors) {
-    return errors.map(e => {
-        let msg = `Path: ${e.path}`;
-        if (e.line !== undefined && e.column !== undefined) {
-            msg += ` (line ${e.line}, column ${e.column})`;
-        }
-        msg += `\n  Error: ${e.message}`;
-        return msg;
-    }).join('\n\n');
-}
-export function validateMachineNode(node) {
-    return validateWithZod(MachineNodeSchema, node);
-}
-export function validateMachineNodePair(pair) {
-    const result = MachineNodePairSchema.safeParse(pair);
-    if (result.success) {
-        return { success: true, errors: [] };
-    }
-    const errors = result.error.issues.map(issue => ({
-        message: issue.message,
-        path: formatZodPath(issue.path),
-    }));
-    return { success: false, errors };
-}
-export function validateMachineForward(forward) {
-    const result = MachineForwardSchema.safeParse(forward);
-    if (result.success) {
-        return { success: true, errors: [] };
-    }
-    const errors = result.error.issues.map(issue => ({
-        message: issue.message,
-        path: formatZodPath(issue.path),
-    }));
-    return { success: false, errors };
-}
-export function machineNodesToJson(nodes, options = {}) {
-    const { machineId, includeComments = true } = options;
-    let result = '';
-    if (includeComments && machineId) {
-        result += `// Machine ID: ${machineId}\n`;
-    }
-    result += JSON.stringify(nodes, null, 2);
-    return result;
-}
-export function machineNodesToMarkdown(nodes, options = {}) {
-    const { machineName, machineAddress, machineId, includeComments = true } = options;
-    let md = `# Machine Node Definition\n\n`;
-    if (machineName) {
-        md += `**Machine:** ${machineName}\n\n`;
-    }
-    if (machineAddress) {
-        md += `**Address:** ${machineAddress}\n\n`;
-    }
-    if (machineId) {
-        md += `**ID:** ${machineId}\n\n`;
-    }
-    md += `**Total Nodes:** ${nodes.length}\n\n`;
-    md += `---\n\n`;
-    for (const node of nodes) {
-        md += `## Node: ${node.name}\n\n`;
-        if (includeComments) {
-            md += `<!-- Node definition with pairs and forwards -->\n\n`;
-        }
-        for (const pair of node.pairs) {
-            md += `### Pair: ${pair.prev_node}\n\n`;
-            md += `- **prev_node**: ${pair.prev_node}\n`;
-            md += `- **threshold**: ${pair.threshold}\n\n`;
-            if (pair.forwards && pair.forwards.length > 0) {
-                md += `#### Forwards\n\n`;
-                md += `| name | weight | namedOperator | permissionIndex | guard |\n`;
-                md += `|------|--------|---------------|-----------------|-------|\n`;
-                for (const forward of pair.forwards) {
-                    const namedOp = forward.namedOperator || '';
-                    const permIdx = forward.permissionIndex?.toString() || '';
-                    const guardRaw = forward.guard;
-                    const guard = typeof guardRaw === 'string'
-                        ? guardRaw
-                        : (guardRaw?.guard || '');
-                    md += `| ${forward.name} | ${forward.weight} | ${namedOp} | ${permIdx} | ${guard} |\n`;
-                }
-                md += `\n`;
-            }
-        }
-        md += `---\n\n`;
-    }
-    md += `## JSON Definition\n\n`;
-    if (includeComments) {
-        md += `<!-- You can also use the JSON format below -->\n\n`;
-    }
-    md += `\`\`\`json\n`;
-    if (includeComments && machineId) {
-        md += `// Machine ID: ${machineId}\n`;
-    }
-    md += JSON.stringify(nodes, null, 2);
-    md += `\n\`\`\`\n`;
-    return md;
-}
-export function saveMachineNodesToFile(nodes, filePath, format = 'json', options = {}) {
-    const content = format === 'json'
-        ? machineNodesToJson(nodes, options)
-        : machineNodesToMarkdown(nodes, options);
-    writeFileSync(filePath, content, 'utf-8');
-}
+import{NodeSchema}from'../call/machine.js';import{MachineNodeSchema,MachineNodePairSchema,MachineForwardSchema}from'../query/index.js';import{writeFileSync}from'fs';function detectFormat(a){const b=a['trim']();if(b['startsWith']('{')||b['startsWith']('['))return'json';return'markdown';}function extractJsonFromMarkdown(a){const b=/```(?:json)?\s*\n([\s\S]*?)```/g;let c,d=null;while((c=b['exec'](a))!==null){const e=c[0x1]['trim']();if(e['startsWith']('[')||e['startsWith']('{')){const f=a['substring'](0x0,c['index']),g=(f['match'](/\n/g)||[])['length']+0x1;d={'json':e,'lineOffset':g};}}return d;}function parseMarkdownToNodeData(a){const b=[],c=extractJsonFromMarkdown(a);if(c)try{const j=JSON['parse'](c['json']);return{'data':j,'errors':[]};}catch(k){return b['push']({'message':'Failed\x20to\x20parse\x20JSON\x20from\x20markdown:\x20'+k['message'],'path':'/'}),{'data':null,'errors':b};}const d={'op':'add'},f=[],g=a['match'](/(?:^|\n)#+\s*Operation[^\n]*\n+[-*]\s*op\s*:\s*(\w+)/i);g&&(d['op']=g[0x1]['toLowerCase']());const h=a['match'](/(?:^|\n)#+\s*Options[^\n]*\n+[-*]\s*bReplace\s*:\s*(true|false)/i);h&&(d['bReplace']=h[0x1]['toLowerCase']()==='true');const i=a['split'](/(?=^##\s*Node[:\s])/m);for(const l of i['slice'](0x1)){const m=l['match'](/^##\s*Node[:\s]+(.+?)(?:\n|$)/im);if(!m)continue;const n=m[0x1]['trim'](),o={'name':n,'pairs':[]},p=l['split'](/(?=^###\s*(?:Pair|Previous Node)[:\s])/m);for(const q of p['slice'](0x1)){const r=q['match'](/(?:^|\n)[-*]\s*prev_node\s*[:]\s*(.+?)(?:\n|$)/im)||q['match'](/^###\s*(?:Pair|Previous Node)[:\s]+(.+?)(?:\n|$)/im),s=q['match'](/(?:^|\n)[-*]\s*threshold\s*[:]\s*(\d+)/i);if(!r)continue;const t={'prev_node':r[0x1]['trim'](),'threshold':s?parseInt(s[0x1],0xa):0x0,'forwards':[]},u=q['match'](/\|[^\n]+\|/g);if(u&&u['length']>0x2)for(const w of u['slice'](0x2)){const x=w['split']('|')['filter'](y=>y['trim']())['map'](y=>y['trim']());if(x['length']>=0x2){const y={'name':x[0x0],'weight':parseInt(x[0x1],0xa)||0x0};x['length']>=0x3&&x[0x2]&&x[0x2]!=='-'&&(y['namedOperator']=x[0x2]),x['length']>=0x4&&x[0x3]&&x[0x3]!=='-'&&(y['permissionIndex']=parseInt(x[0x3],0xa)),x['length']>=0x5&&x[0x4]&&x[0x4]!=='-'&&(y['guard']=x[0x4]),t['forwards']['push'](y);}}const v=q['matchAll'](/(?:^|\n)[-*]\s*(?:forward)?\s*[:]?\s*\n?([\s\S]*?)(?=(?:\n[-*]\s*(?:forward|prev_node|threshold))|\n###|\n##|$)/gi);for(const z of v){const A=z[0x1],B=A['match'](/\s*name\s*[:]\s*(.+?)(?:\n|$)/im),C=A['match'](/\s*weight\s*[:]\s*(\d+)/i);if(B&&C){const D={'name':B[0x1]['trim'](),'weight':parseInt(C[0x1],0xa)},E=A['match'](/\s*namedOperator\s*[:]\s*(.+?)(?:\n|$)/im),F=A['match'](/\s*permissionIndex\s*[:]\s*(\d+)/i),G=A['match'](/\s*guard\s*[:]\s*(.+?)(?:\n|$)/im);E&&(D['namedOperator']=E[0x1]['trim']()),F&&(D['permissionIndex']=parseInt(F[0x1],0xa)),G&&(D['guard']=G[0x1]['trim']()),t['forwards']['push'](D);}}o['pairs']['push'](t);}f['push'](o);}return f['length']>0x0&&(d['nodes']=f),{'data':d,'errors':b};}function formatZodPath(a){return'/'+a['map'](b=>String(b)['replace'](/~/g,'~0')['replace'](/\//g,'~1'))['join']('/');}function parseJsonWithErrors(a){const b=[];try{const c=JSON['parse'](a);return{'data':c,'errors':[]};}catch(d){const f=d,g=f['message']['match'](/position\s+(\d+)/);let h=0x1,i=0x1;if(g){const j=parseInt(g[0x1],0xa),k=a['substring'](0x0,j)['split']('\x0a');h=k['length'],i=k[k['length']-0x1]['length']+0x1;}return b['push']({'message':'JSON\x20parse\x20error:\x20'+f['message'],'path':'/','line':h,'column':i}),{'data':null,'errors':b};}}function validateWithZod(a,b,c=''){const d=[],e=a['safeParse'](b);if(e['success'])return{'success':!![],'data':e['data'],'errors':[]};for(const f of e['error']['issues']){const g=c+formatZodPath(f['path']);d['push']({'message':f['message'],'path':g});}return{'success':![],'errors':d};}export function parseNodeFromText(a){const b=a['trim'](),c=detectFormat(b);let d;if(c==='markdown'){const f=parseMarkdownToNodeData(b);if(f['errors']['length']>0x0)return{'success':![],'errors':f['errors']};d=f['data'];}else{const g=parseJsonWithErrors(b);if(g['errors']['length']>0x0)return{'success':![],'errors':g['errors']};d=g['data'];}const e=validateWithZod(NodeSchema,d);return{'success':e['success'],'data':e['data'],'errors':e['errors']};}export function parseMachineNodesFromText(a){const b=a['trim'](),c=detectFormat(b);let d,e=[];if(c==='markdown'){const h=parseMarkdownToNodeData(b);if(h['errors']['length']>0x0)return{'success':![],'errors':h['errors']};typeof h['data']==='object'&&h['data']!==null&&'nodes'in h['data']?d=h['data']['nodes']:d=h['data'];}else{const j=parseJsonWithErrors(b);if(j['errors']['length']>0x0)return{'success':![],'errors':j['errors']};d=j['data'];}if(!Array['isArray'](d)){if(typeof d==='object'&&d!==null&&'op'in d)return{'success':![],'errors':[{'message':'Expected\x20JSON\x20array\x20of\x20nodes\x20for\x20json_or_markdown\x20mode.\x20Use\x20schema\x20mode\x20for\x20operations\x20with\x20\x22op\x22\x20field.','path':'/'}]};return{'success':![],'errors':[{'message':'Expected\x20JSON\x20array\x20of\x20nodes','path':'/'}]};}const f=[];for(let k=0x0;k<d['length'];k++){const l=d[k],m=validateWithZod(MachineNodeSchema,l,'/'+k);m['success']&&m['data']?f['push'](m['data']):e['push'](...m['errors']);}if(e['length']>0x0)return{'success':![],'errors':e};const g=f['some'](n=>n['pairs']['some'](o=>o['prev_node']===''));if(!g)return{'success':![],'errors':[{'message':'Machine\x20has\x20no\x20entry\x20forward.\x20At\x20least\x20one\x20node\x20must\x20have\x20a\x20pair\x20with\x20prev_node=\x22\x22\x20(empty\x20string),\x20'+'which\x20defines\x20how\x20Progress\x20advances\x20from\x20the\x20initial\x20state\x20(current=\x22\x22)\x20to\x20the\x20first\x20node.\x20'+'Without\x20an\x20entry\x20forward,\x20the\x20workflow\x20will\x20be\x20permanently\x20stuck.\x20'+'Example:\x20{name:\x20\x22Subscribed\x22,\x20pairs:\x20[{prev_node:\x20\x22\x22,\x20forwards:\x20[{name:\x20\x22Subscribe\x22,\x20weight:\x201}]}]}','path':'/'}]};return{'success':!![],'data':f,'errors':[]};}export function formatNodeErrors(a){return a['map'](b=>{let c='Path:\x20'+b['path'];return b['line']!==undefined&&b['column']!==undefined&&(c+='\x20(line\x20'+b['line']+',\x20column\x20'+b['column']+')'),c+='\x0a\x20\x20Error:\x20'+b['message'],c;})['join']('\x0a\x0a');}export function validateMachineNode(a){return validateWithZod(MachineNodeSchema,a);}export function validateMachineNodePair(a){const b=MachineNodePairSchema['safeParse'](a);if(b['success'])return{'success':!![],'errors':[]};const c=b['error']['issues']['map'](d=>({'message':d['message'],'path':formatZodPath(d['path'])}));return{'success':![],'errors':c};}export function validateMachineForward(a){const b=MachineForwardSchema['safeParse'](a);if(b['success'])return{'success':!![],'errors':[]};const c=b['error']['issues']['map'](d=>({'message':d['message'],'path':formatZodPath(d['path'])}));return{'success':![],'errors':c};}export function machineNodesToJson(a,b={}){const {machineId:c,includeComments:includeComments=!![]}=b;let d='';return includeComments&&c&&(d+='//\x20Machine\x20ID:\x20'+c+'\x0a'),d+=JSON['stringify'](a,null,0x2),d;}export function machineNodesToMarkdown(a,b={}){const {machineName:c,machineAddress:d,machineId:e,includeComments:includeComments=!![]}=b;let f='#\x20Machine\x20Node\x20Definition\x0a\x0a';c&&(f+='**Machine:**\x20'+c+'\x0a\x0a');d&&(f+='**Address:**\x20'+d+'\x0a\x0a');e&&(f+='**ID:**\x20'+e+'\x0a\x0a');f+='**Total\x20Nodes:**\x20'+a['length']+'\x0a\x0a',f+='---\x0a\x0a';for(const g of a){f+='##\x20Node:\x20'+g['name']+'\x0a\x0a';includeComments&&(f+='<!--\x20Node\x20definition\x20with\x20pairs\x20and\x20forwards\x20-->\x0a\x0a');for(const h of g['pairs']){f+='###\x20Pair:\x20'+h['prev_node']+'\x0a\x0a',f+='-\x20**prev_node**:\x20'+h['prev_node']+'\x0a',f+='-\x20**threshold**:\x20'+h['threshold']+'\x0a\x0a';if(h['forwards']&&h['forwards']['length']>0x0){f+='####\x20Forwards\x0a\x0a',f+='|\x20name\x20|\x20weight\x20|\x20namedOperator\x20|\x20permissionIndex\x20|\x20guard\x20|\x0a',f+='|------|--------|---------------|-----------------|-------|\x0a';for(const i of h['forwards']){const j=i['namedOperator']||'',k=i['permissionIndex']?.['toString']()||'',l=i['guard'],m=typeof l==='string'?l:l?.['guard']||'';f+='|\x20'+i['name']+'\x20|\x20'+i['weight']+'\x20|\x20'+j+'\x20|\x20'+k+'\x20|\x20'+m+'\x20|\x0a';}f+='\x0a';}}f+='---\x0a\x0a';}return f+='##\x20JSON\x20Definition\x0a\x0a',includeComments&&(f+='<!--\x20You\x20can\x20also\x20use\x20the\x20JSON\x20format\x20below\x20-->\x0a\x0a'),f+='```json\x0a',includeComments&&e&&(f+='//\x20Machine\x20ID:\x20'+e+'\x0a'),f+=JSON['stringify'](a,null,0x2),f+='\x0a```\x0a',f;}export function saveMachineNodesToFile(a,b,c='json',d={}){const e=c==='json'?machineNodesToJson(a,d):machineNodesToMarkdown(a,d);writeFileSync(b,e,'utf-8');}

package/dist/schema/utils/object-type-utils.js

@@ -1,35 +1 @@
-export function shortTypeName(objectType) {
-    if (!objectType)
-        return "unknown";
-    const base = objectType.replace(/<.*>/, "").trim();
-    const segments = base.split("::");
-    const shortName = segments[segments.length - 1] || "unknown";
-    if (shortName.length > 0 && shortName === shortName.toLowerCase()) {
-        return shortName.charAt(0).toUpperCase() + shortName.slice(1);
-    }
-    return shortName;
-}
-export function normalizeObjectType(objectType) {
-    return shortTypeName(objectType).toLowerCase();
-}
-export function isObjectOfType(objectType, expectedShortName) {
-    const normalized = normalizeObjectType(objectType);
-    const expected = expectedShortName.toLowerCase();
-    return normalized === expected;
-}
-export function groupObjectsByType(objects) {
-    const byType = new Map();
-    for (const obj of objects) {
-        const t = shortTypeName(obj.objectType);
-        if (!byType.has(t))
-            byType.set(t, []);
-        byType.get(t).push(obj);
-    }
-    return byType;
-}
-export function findObjectByType(objects, expectedShortName) {
-    return objects.find(o => isObjectOfType(o.objectType, expectedShortName));
-}
-export function countObjectsByType(objects, expectedShortName) {
-    return objects.filter(o => isObjectOfType(o.objectType, expectedShortName)).length;
-}
+export function shortTypeName(a){if(!a)return'unknown';const b=a['replace'](/<.*>/,'')['trim'](),c=b['split']('::'),d=c[c['length']-0x1]||'unknown';if(d['length']>0x0&&d===d['toLowerCase']())return d['charAt'](0x0)['toUpperCase']()+d['slice'](0x1);return d;}export function normalizeObjectType(a){return shortTypeName(a)['toLowerCase']();}export function isObjectOfType(a,b){const c=normalizeObjectType(a),d=b['toLowerCase']();return c===d;}export function groupObjectsByType(a){const b=new Map();for(const c of a){const d=shortTypeName(c['objectType']);if(!b['has'](d))b['set'](d,[]);b['get'](d)['push'](c);}return b;}export function findObjectByType(a,b){return a['find'](c=>isObjectOfType(c['objectType'],b));}export function countObjectsByType(a,b){return a['filter'](c=>isObjectOfType(c['objectType'],b))['length'];}

package/dist/schema/utils/permission-index-utils.js

@@ -1,7 +1 @@
-import { BuiltinPermissionIndex } from "@wowok/wowok";
-export const getValidBuiltinPermissionIndexes = () => {
-    return new Set(Object.values(BuiltinPermissionIndex).filter(value => typeof value === 'number'));
-};
-export const isValidPermissionIndex = (index) => {
-    return getValidBuiltinPermissionIndexes().has(index) || (index >= 1000 && index <= 65535);
-};
+import{BuiltinPermissionIndex}from'@wowok/wowok';export const getValidBuiltinPermissionIndexes=()=>{return new Set(Object['values'](BuiltinPermissionIndex)['filter'](a=>typeof a==='number'));};export const isValidPermissionIndex=a=>{return getValidBuiltinPermissionIndexes()['has'](a)||a>=0x3e8&&a<=0xffff;};

package/dist/schema/utils/permission-machine-check.js

@@ -1,121 +1 @@
-export function collectPermissionIndexes(nodes) {
-    const indexRefs = [];
-    const namedRefs = [];
-    const missingRefs = [];
-    const requiredIndexSet = new Set();
-    for (const node of nodes) {
-        if (!node.pairs)
-            continue;
-        for (const pair of node.pairs) {
-            if (!pair.forwards)
-                continue;
-            for (const forward of pair.forwards) {
-                const ref = {
-                    nodeName: node.name,
-                    prevNode: pair.prev_node,
-                    forwardName: forward.name,
-                    permissionIndex: forward.permissionIndex ?? null,
-                    namedOperator: forward.namedOperator ?? null,
-                };
-                if (ref.permissionIndex != null) {
-                    indexRefs.push(ref);
-                    requiredIndexSet.add(ref.permissionIndex);
-                }
-                else if (ref.namedOperator != null && ref.namedOperator !== "") {
-                    namedRefs.push(ref);
-                }
-                else {
-                    missingRefs.push(ref);
-                }
-            }
-        }
-    }
-    return {
-        indexRefs,
-        namedRefs,
-        missingRefs,
-        requiredIndexes: Array.from(requiredIndexSet).sort((a, b) => a - b),
-    };
-}
-export function checkPermissionAuthorization(requiredIndexes, permission) {
-    const BUILTIN_THRESHOLD = 1000;
-    const statuses = [];
-    const missingIndexes = [];
-    const authorizedIndexes = [];
-    for (const index of requiredIndexes) {
-        if (index < BUILTIN_THRESHOLD) {
-            statuses.push({ index, authorized: true, entityCount: -1 });
-            authorizedIndexes.push(index);
-            continue;
-        }
-        let authorized = false;
-        let entityCount = 0;
-        if (permission?.entityPermissions) {
-            for (const perms of permission.entityPermissions.values()) {
-                if (perms.includes(index)) {
-                    entityCount++;
-                }
-            }
-            authorized = entityCount > 0;
-        }
-        else if (permission?.perm_remark && permission.perm_remark.length > 0) {
-            authorized = permission.perm_remark.some(r => r.index === index);
-            entityCount = authorized ? -1 : 0;
-        }
-        else {
-            authorized = true;
-            entityCount = -1;
-        }
-        statuses.push({ index, authorized, entityCount });
-        if (authorized) {
-            authorizedIndexes.push(index);
-        }
-        else {
-            missingIndexes.push(index);
-        }
-    }
-    const allAuthorized = missingIndexes.length === 0;
-    const summary = allAuthorized
-        ? `All ${requiredIndexes.length} required permission index(es) are authorized.`
-        : `${missingIndexes.length}/${requiredIndexes.length} required permission index(es) are NOT authorized: [${missingIndexes.join(", ")}]. ` +
-            `Forwards using these indexes will be un-executable — Progress will be stuck. ` +
-            `Grant entities for these indexes via permission.op="add perm by index" before publishing the Machine.`;
-    return {
-        statuses,
-        missingIndexes,
-        authorizedIndexes,
-        allAuthorized,
-        summary,
-    };
-}
-export function formatPermissionWarning(report) {
-    if (report.allAuthorized) {
-        return "";
-    }
-    const lines = [
-        "CRITICAL PRE-PUBLISH: Machine forwards reference permission indexes that are NOT authorized in the Permission object.",
-        "",
-        `Missing indexes (no entities granted): ${report.missingIndexes.join(", ")}`,
-        "",
-        "Impact: Forwards using these indexes can NEVER be executed — Progress will be permanently stuck at the source node.",
-        "Buyer funds may be trapped if the workflow cannot advance past the stuck node.",
-        "",
-        "To fix BEFORE publishing:",
-        '  1. Call onchain_operations with op="permission"',
-        '  2. Set object=<your_permission_name_or_address>',
-        '  3. Set permission.op="add perm by index"',
-        "  4. Set index=<missing_index> for each missing index",
-        '  5. Set entity=["<entity_address>"] — the address that should be authorized',
-        "  6. After granting all missing indexes, re-attempt the Machine publish.",
-        "",
-        "Required permission indexes for this Machine:",
-    ];
-    for (const status of report.statuses) {
-        const state = status.authorized ? "AUTHORIZED" : "MISSING";
-        const count = status.entityCount === -1
-            ? "(built-in or heuristic)"
-            : `(${status.entityCount} entity/entities)`;
-        lines.push(`  - Index ${status.index}: ${state} ${count}`);
-    }
-    return lines.join("\n");
-}
+export function collectPermissionIndexes(a){const b=[],c=[],d=[],e=new Set();for(const f of a){if(!f['pairs'])continue;for(const g of f['pairs']){if(!g['forwards'])continue;for(const h of g['forwards']){const i={'nodeName':f['name'],'prevNode':g['prev_node'],'forwardName':h['name'],'permissionIndex':h['permissionIndex']??null,'namedOperator':h['namedOperator']??null};if(i['permissionIndex']!=null)b['push'](i),e['add'](i['permissionIndex']);else i['namedOperator']!=null&&i['namedOperator']!==''?c['push'](i):d['push'](i);}}}return{'indexRefs':b,'namedRefs':c,'missingRefs':d,'requiredIndexes':Array['from'](e)['sort']((j,k)=>j-k)};}export function checkPermissionAuthorization(a,b){const c=0x3e8,d=[],e=[],f=[];for(const i of a){if(i<c){d['push']({'index':i,'authorized':!![],'entityCount':-0x1}),f['push'](i);continue;}let j=![],k=0x0;if(b?.['entityPermissions']){for(const l of b['entityPermissions']['values']()){l['includes'](i)&&k++;}j=k>0x0;}else b?.['perm_remark']&&b['perm_remark']['length']>0x0?(j=b['perm_remark']['some'](m=>m['index']===i),k=j?-0x1:0x0):(j=!![],k=-0x1);d['push']({'index':i,'authorized':j,'entityCount':k}),j?f['push'](i):e['push'](i);}const g=e['length']===0x0,h=g?'All\x20'+a['length']+'\x20required\x20permission\x20index(es)\x20are\x20authorized.':e['length']+'/'+a['length']+'\x20required\x20permission\x20index(es)\x20are\x20NOT\x20authorized:\x20['+e['join'](',\x20')+'].\x20'+'Forwards\x20using\x20these\x20indexes\x20will\x20be\x20un-executable\x20—\x20Progress\x20will\x20be\x20stuck.\x20'+'Grant\x20entities\x20for\x20these\x20indexes\x20via\x20permission.op=\x22add\x20perm\x20by\x20index\x22\x20before\x20publishing\x20the\x20Machine.';return{'statuses':d,'missingIndexes':e,'authorizedIndexes':f,'allAuthorized':g,'summary':h};}export function formatPermissionWarning(a){if(a['allAuthorized'])return'';const b=['CRITICAL\x20PRE-PUBLISH:\x20Machine\x20forwards\x20reference\x20permission\x20indexes\x20that\x20are\x20NOT\x20authorized\x20in\x20the\x20Permission\x20object.','','Missing\x20indexes\x20(no\x20entities\x20granted):\x20'+a['missingIndexes']['join'](',\x20'),'','Impact:\x20Forwards\x20using\x20these\x20indexes\x20can\x20NEVER\x20be\x20executed\x20—\x20Progress\x20will\x20be\x20permanently\x20stuck\x20at\x20the\x20source\x20node.','Buyer\x20funds\x20may\x20be\x20trapped\x20if\x20the\x20workflow\x20cannot\x20advance\x20past\x20the\x20stuck\x20node.','','To\x20fix\x20BEFORE\x20publishing:','\x20\x201.\x20Call\x20onchain_operations\x20with\x20op=\x22permission\x22','\x20\x202.\x20Set\x20object=<your_permission_name_or_address>','\x20\x203.\x20Set\x20permission.op=\x22add\x20perm\x20by\x20index\x22','\x20\x204.\x20Set\x20index=<missing_index>\x20for\x20each\x20missing\x20index','\x20\x205.\x20Set\x20entity=[\x22<entity_address>\x22]\x20—\x20the\x20address\x20that\x20should\x20be\x20authorized','\x20\x206.\x20After\x20granting\x20all\x20missing\x20indexes,\x20re-attempt\x20the\x20Machine\x20publish.','','Required\x20permission\x20indexes\x20for\x20this\x20Machine:'];for(const c of a['statuses']){const d=c['authorized']?'AUTHORIZED':'MISSING',e=c['entityCount']===-0x1?'(built-in\x20or\x20heuristic)':'('+c['entityCount']+'\x20entity/entities)';b['push']('\x20\x20-\x20Index\x20'+c['index']+':\x20'+d+'\x20'+e);}return b['join']('\x0a');}

package/dist/schema/utils/skills-recommendation.d.ts

@@ -1,2 +1,3 @@
 export declare function getSkillsHintForOnchain(operationType: string, data?: unknown): string | undefined;
 export declare function getSkillsHintForProject(action: string): string | undefined;
+export declare function getSkillsHintForEvaluation(action: string): string | undefined;

package/dist/schema/utils/skills-recommendation.js

@@ -1,77 +1 @@
-const SKILLS_BY_OPERATION_TYPE = {
-    service: ["wowok-provider", "wowok-safety"],
-    machine: ["wowok-machine"],
-    guard: ["wowok-guard"],
-    arbitration: ["wowok-arbitrator"],
-    allocation: ["wowok-provider"],
-    permission: ["wowok-safety"],
-    treasury: ["wowok-provider", "wowok-safety"],
-    reward: ["wowok-provider"],
-    repository: ["wowok-provider"],
-    demand: ["wowok-provider"],
-    contact: ["wowok-messenger"],
-    order: ["wowok-order"],
-    progress: [],
-    personal: [],
-    payment: [],
-    proof: [],
-};
-const SKILLS_BY_PROJECT_ACTION = {
-    create_project: ["wowok-onboard", "wowok-planner"],
-    create_project_from_onchain: ["wowok-onboard"],
-    evaluate_project: ["wowok-auditor"],
-    pre_evaluate_check: ["wowok-auditor"],
-    verify_deployment: ["wowok-auditor"],
-    generate_deployment_doc: ["wowok-planner"],
-    migrate_to_mainnet: ["wowok-onboard", "wowok-safety"],
-    migrate_network: ["wowok-onboard"],
-    clone_project_to_network: ["wowok-onboard"],
-    build_graph: ["wowok-planner"],
-    list_projects: [],
-    get_project_detail: [],
-    update_project: [],
-    add_object: [],
-    remove_object: [],
-    update_object: [],
-    create_version: [],
-    get_graph: [],
-    save_evaluation: [],
-    compare_projects: [],
-    refresh_objects: [],
-    get_object_diff: [],
-    delete_project: [],
-    assemble_context: [],
-    get_machine_graph: ["wowok-machine"],
-    get_guard_graph: ["wowok-guard"],
-    plan_object_edit: ["wowok-machine", "wowok-guard", "wowok-auditor"],
-    apply_object_edit: ["wowok-safety"],
-    patch_machine_nodes: ["wowok-machine"],
-    patch_guard_tree: ["wowok-guard"],
-    participation_radar: ["wowok-order", "wowok-messenger"],
-};
-export function getSkillsHintForOnchain(operationType, data) {
-    const skills = SKILLS_BY_OPERATION_TYPE[operationType];
-    if (!skills || skills.length === 0)
-        return undefined;
-    const isPublish = data?.publish === true;
-    const hasOrderAllocators = !!data?.order_allocators;
-    const isComplex = isPublish || hasOrderAllocators;
-    const prefix = isComplex
-        ? "SKILLS RECOMMENDED (complex operation — skills provide business-semantic guidance):"
-        : "SKILLS RECOMMENDED (optional — skills provide deeper guidance):";
-    return `${prefix} ${skills.join(", ")}. ` +
-        `skills focus on business intent → object parameter translation; ` +
-        `MCP handles object structure and on-chain execution. ` +
-        `If skills are installed, consult them BEFORE this call for design rationale. ` +
-        `If not installed, MCP executes independently — this hint is informational only.`;
-}
-export function getSkillsHintForProject(action) {
-    const skills = SKILLS_BY_PROJECT_ACTION[action];
-    if (!skills || skills.length === 0)
-        return undefined;
-    return `SKILLS RECOMMENDED (optional — skills provide deeper guidance): ${skills.join(", ")}. ` +
-        `skills focus on business intent → object parameter translation; ` +
-        `MCP handles project structure and evaluation. ` +
-        `If skills are installed, consult them for design/planning rationale. ` +
-        `If not installed, MCP executes independently — this hint is informational only.`;
-}
+const SKILLS_BY_OPERATION_TYPE={'service':['wowok-provider'],'machine':['wowok-machine'],'guard':[],'arbitration':['wowok-arbitrator'],'allocation':['wowok-provider'],'permission':[],'treasury':['wowok-provider'],'reward':['wowok-provider'],'repository':['wowok-provider'],'demand':['wowok-provider','wowok-supplier'],'contact':['wowok-messenger'],'order':['wowok-order'],'progress':['wowok-collaborator'],'personal':[],'payment':[],'proof':[]},SKILLS_BY_PROJECT_ACTION={'create_project':['wowok-onboard','wowok-planner'],'create_project_from_onchain':['wowok-onboard'],'evaluate_project':['wowok-auditor'],'pre_evaluate_check':['wowok-auditor'],'verify_deployment':['wowok-auditor'],'generate_deployment_doc':['wowok-planner'],'migrate_to_mainnet':['wowok-onboard'],'migrate_network':['wowok-onboard'],'clone_project_to_network':['wowok-onboard'],'build_graph':['wowok-planner'],'list_projects':[],'get_project_detail':[],'update_project':[],'add_object':[],'remove_object':[],'update_object':[],'create_version':[],'get_graph':[],'save_evaluation':[],'compare_projects':[],'refresh_objects':[],'get_object_diff':[],'delete_project':[],'assemble_context':[],'get_machine_graph':['wowok-machine'],'get_guard_graph':[],'plan_object_edit':['wowok-machine','wowok-auditor'],'apply_object_edit':[],'patch_machine_nodes':['wowok-machine'],'patch_guard_tree':[],'participation_radar':['wowok-order','wowok-supplier','wowok-collaborator','wowok-messenger']};export function getSkillsHintForOnchain(a,b){const c=SKILLS_BY_OPERATION_TYPE[a];if(!c||c['length']===0x0)return undefined;const d=b?.['publish']===!![],e=!!b?.['order_allocators'],f=d||e,g=f?'SKILLS\x20RECOMMENDED\x20(complex\x20operation\x20—\x20skills\x20provide\x20business-semantic\x20guidance):':'SKILLS\x20RECOMMENDED\x20(optional\x20—\x20skills\x20provide\x20deeper\x20guidance):';return g+'\x20'+c['join'](',\x20')+'.\x20'+'skills\x20focus\x20on\x20business\x20intent\x20→\x20object\x20parameter\x20translation;\x20'+'MCP\x20handles\x20object\x20structure\x20and\x20on-chain\x20execution.\x20'+'If\x20skills\x20are\x20installed,\x20consult\x20them\x20BEFORE\x20this\x20call\x20for\x20design\x20rationale.\x20'+'If\x20not\x20installed,\x20MCP\x20executes\x20independently\x20—\x20this\x20hint\x20is\x20informational\x20only.';}export function getSkillsHintForProject(a){const b=SKILLS_BY_PROJECT_ACTION[a];if(!b||b['length']===0x0)return undefined;return'SKILLS\x20RECOMMENDED\x20(optional\x20—\x20skills\x20provide\x20deeper\x20guidance):\x20'+b['join'](',\x20')+'.\x20'+'skills\x20focus\x20on\x20business\x20intent\x20→\x20object\x20parameter\x20translation;\x20'+'MCP\x20handles\x20project\x20structure\x20and\x20evaluation.\x20'+'If\x20skills\x20are\x20installed,\x20consult\x20them\x20for\x20design/planning\x20rationale.\x20'+'If\x20not\x20installed,\x20MCP\x20executes\x20independently\x20—\x20this\x20hint\x20is\x20informational\x20only.';}const SKILLS_BY_EVALUATION_ACTION={'match_discover':['wowok-market'],'discover_services':['wowok-market'],'discover_demands':['wowok-market'],'arbitration_score':['wowok-market','wowok-arbitrator'],'account_events':['wowok-market'],'market_metrics':['wowok-market'],'anti_cheat':['wowok-market'],'market_operations':['wowok-market']};export function getSkillsHintForEvaluation(a){const b=SKILLS_BY_EVALUATION_ACTION[a];if(!b||b['length']===0x0)return undefined;return'SKILLS\x20RECOMMENDED\x20(optional\x20—\x20skills\x20provide\x20deeper\x20guidance):\x20'+b['join'](',\x20')+'.\x20'+'skills\x20focus\x20on\x20market/operational\x20intent\x20→\x20action\x20parameters;\x20'+'MCP\x20handles\x20enumeration,\x20scoring\x20and\x20on-chain\x20execution.\x20'+'If\x20not\x20installed,\x20MCP\x20executes\x20independently\x20—\x20this\x20hint\x20is\x20informational\x20only.';}