@wowok/agent-mcp 2.7.0 → 2.7.2

package/dist/project/semantic-graph.js

@@ -1,245 +1 @@
-export function buildSemanticGraph(intent, adoptedModules) {
-    const nodes = [];
-    const edges = [];
-    const constraints = [];
-    nodes.push({
-        id: "main_permission",
-        type: "permission",
-        purpose: "Role-based access control for merchant, customer, and optional arbitrator",
-        derivedFrom: { intentField: "roles", rationale: "All WOW services require a Permission object for role management" },
-        config: {
-            name: { type: "string", value: `${intent.description.slice(0, 20)}_permission`, mapsTo: "object.name" },
-        },
-        expectedState: { published: true, paused: false },
-    });
-    if (intent.intent.startsWith("sell_") || intent.intent === "rent_asset") {
-        nodes.push({
-            id: "main_service",
-            type: "service",
-            purpose: `Main service offering: ${intent.description}`,
-            derivedFrom: { intentField: "description", rationale: "Service is the primary object representing the merchant offering" },
-            config: {
-                name: { type: "string", value: `${intent.description.slice(0, 20)}_service`, mapsTo: "object.name" },
-                type_parameter: { type: "string", value: intent.payment.currency, mapsTo: "object.type_parameter" },
-                permission: { type: "address_ref", targetId: "main_permission", mapsTo: "object.permission" },
-            },
-            expectedState: { published: true, paused: false },
-        });
-        edges.push({
-            from: "main_service",
-            to: "main_permission",
-            relation: "has_permission",
-            required: true,
-            derivedFrom: { intentField: "roles", rationale: "Service must reference its Permission object" },
-        });
-    }
-    if (intent.payment.model === "milestone" || intent.deliverables.length > 1) {
-        nodes.push({
-            id: "main_machine",
-            type: "machine",
-            purpose: "Workflow controlling deliverable milestones and acceptance",
-            derivedFrom: { intentField: "deliverables", rationale: "Multiple deliverables or milestone payment requires Machine workflow" },
-            config: {
-                name: { type: "string", value: `${intent.description.slice(0, 20)}_machine`, mapsTo: "object.name" },
-                permission: { type: "address_ref", targetId: "main_permission", mapsTo: "object.permission" },
-            },
-            expectedState: { published: true, paused: false },
-        });
-        if (nodes.find((n) => n.id === "main_service")) {
-            edges.push({
-                from: "main_service",
-                to: "main_machine",
-                relation: "uses_machine",
-                required: true,
-                derivedFrom: { intentField: "deliverables", rationale: "Service binds to Machine for workflow execution" },
-            });
-        }
-    }
-    if (intent.payment.model === "milestone" || intent.payment.model === "escrow" || intent.trust.escrow) {
-        nodes.push({
-            id: "main_allocation",
-            type: "allocation",
-            purpose: "Fund distribution among merchant and optional suppliers",
-            derivedFrom: { intentField: "payment.allocation", rationale: "Escrow/milestone requires Allocation for fund routing" },
-            config: {
-                name: { type: "string", value: `${intent.description.slice(0, 20)}_allocation`, mapsTo: "object.name" },
-                type_parameter: { type: "string", value: intent.payment.currency, mapsTo: "object.type_parameter" },
-                permission: { type: "address_ref", targetId: "main_permission", mapsTo: "object.permission" },
-            },
-            expectedState: { published: true, paused: false },
-        });
-        if (nodes.find((n) => n.id === "main_service")) {
-            edges.push({
-                from: "main_service",
-                to: "main_allocation",
-                relation: "has_order_allocators",
-                required: true,
-                derivedFrom: { intentField: "payment", rationale: "Service must bind Allocation for order fund routing" },
-            });
-        }
-    }
-    if (intent.trust.arbitration !== "none") {
-        nodes.push({
-            id: "main_arbitration",
-            type: "arb",
-            purpose: "Independent dispute resolution",
-            derivedFrom: { intentField: "trust.arbitration", rationale: "Arbitration object provides binding dispute resolution" },
-            config: {
-                name: { type: "string", value: `${intent.description.slice(0, 20)}_arbitration`, mapsTo: "object.name" },
-                type_parameter: { type: "string", value: intent.payment.currency, mapsTo: "object.type_parameter" },
-            },
-            expectedState: { published: true, paused: false },
-        });
-        nodes.push({
-            id: "arb_permission",
-            type: "permission",
-            purpose: "Independent permission for arbitration (MUST differ from Service.permission)",
-            derivedFrom: { intentField: "trust.arbitration", rationale: "Contract-enforced: arbitration.permission != service.permission (E_ARBITRATION_PERMISSION_CONFLICT=33)" },
-            config: {
-                name: { type: "string", value: `${intent.description.slice(0, 20)}_arb_permission`, mapsTo: "object.name" },
-            },
-            expectedState: { published: true, paused: false },
-        });
-        edges.push({
-            from: "main_arbitration",
-            to: "arb_permission",
-            relation: "has_permission",
-            required: true,
-            derivedFrom: { intentField: "trust.arbitration", rationale: "Arbitration requires its own Permission" },
-        });
-        if (nodes.find((n) => n.id === "main_service")) {
-            edges.push({
-                from: "main_service",
-                to: "main_arbitration",
-                relation: "has_arbitration",
-                required: false,
-                derivedFrom: { intentField: "trust.arbitration", rationale: "Service references Arbitration in arbitrations list" },
-            });
-        }
-    }
-    const needsRepository = adoptedModules.some((m) => m.id === "wip_provenance" || m.id === "subscription_with_proof" || m.id === "damage_attestation");
-    if (needsRepository) {
-        nodes.push({
-            id: "main_repository",
-            type: "repository",
-            purpose: "Store WIP hashes and delivery evidence",
-            derivedFrom: { intentField: "deliverables", rationale: "WIP provenance requires Repository for hash commitments" },
-            config: {
-                name: { type: "string", value: `${intent.description.slice(0, 20)}_repository`, mapsTo: "object.name" },
-                permission: { type: "address_ref", targetId: "main_permission", mapsTo: "object.permission" },
-            },
-            expectedState: { published: true, paused: false },
-        });
-    }
-    for (const mod of adoptedModules) {
-        for (const ref of mod.templateRefs) {
-            if (ref.object_type === "guard") {
-                nodes.push({
-                    id: `guard_${mod.id}`,
-                    type: "guard",
-                    purpose: ref.purpose,
-                    derivedFrom: { intentField: "trust", rationale: `Guard for ${mod.name} module` },
-                    config: {
-                        name: { type: "string", value: `${intent.description.slice(0, 20)}_${mod.id}_guard`, mapsTo: "object.name" },
-                    },
-                    expectedState: { published: true, paused: false },
-                });
-            }
-        }
-    }
-    constraints.push({
-        id: "service_permission_bound",
-        level: "hard",
-        description: "Service must be bound to a Permission object",
-        source: { layer: "contract", reference: "service.move: permission field is required" },
-        fixSuggestion: "Create Permission object first, then reference it in Service.object.permission",
-    });
-    if (intent.trust.arbitration !== "none") {
-        constraints.push({
-            id: "arbitration_permission_independent",
-            level: "hard",
-            description: "Arbitration.permission MUST be different from Service.permission",
-            source: { layer: "contract", reference: "service.move:433-436 E_ARBITRATION_PERMISSION_CONFLICT=33" },
-            fixSuggestion: "Create a dedicated Permission object for Arbitration, do NOT reuse Service.permission",
-        });
-    }
-    if (intent.payment.model === "milestone") {
-        constraints.push({
-            id: "machine_bound_before_publish",
-            level: "hard",
-            description: "Machine must be published and bound to Service before Service.publish",
-            source: { layer: "contract", reference: "service.move: machine is IMMUTABLE after publish" },
-            fixSuggestion: "Create and publish Machine before calling Service.publish. Machine cannot be changed after Service is published.",
-        });
-    }
-    const moduleBoosts = calculateModuleScoreBoost(adoptedModules);
-    const estimatedRiskScore = Math.min(100, 40 + Object.values(moduleBoosts).reduce((a, b) => a + b, 0) / 2);
-    const estimatedTrustScore = Math.min(100, 50 + (moduleBoosts["trust"] ?? 0) + (moduleBoosts["fund_safety"] ?? 0));
-    const estimatedCompletenessScore = Math.min(100, 30 + adoptedModules.length * 8);
-    const evaluationPreview = {
-        estimatedRiskScore,
-        estimatedTrustScore,
-        estimatedCompletenessScore,
-        keyRisks: [
-            ...(intent.trust.arbitration === "none" ? ["No arbitration configured — disputes have no resolution path"] : []),
-            ...(intent.payment.model === "upfront" && intent.trust.refundPolicy === "no_refund" ? ["Full upfront + no refund = high user risk"] : []),
-        ],
-        strengths: adoptedModules.map((m) => `${m.name}: ${m.description.slice(0, 60)}...`),
-        moduleBoosts,
-    };
-    return {
-        nodes,
-        edges,
-        constraints,
-        evaluationPreview,
-        adoptedModules: adoptedModules.map((m) => m.id),
-        businessIntent: intent,
-    };
-}
-function calculateModuleScoreBoost(modules) {
-    const boosts = {};
-    for (const m of modules) {
-        for (const impact of m.evaluationImpact) {
-            const increment = impact.effect === "required" ? 15 : impact.effect === "boost" ? 8 : 3;
-            boosts[impact.dimension] = (boosts[impact.dimension] ?? 0) + increment;
-        }
-    }
-    return boosts;
-}
-export function validateGraph(graph) {
-    const hardViolations = [];
-    const softViolations = [];
-    const infoNotes = [];
-    for (const constraint of graph.constraints) {
-        if (constraint.id === "service_permission_bound") {
-            const hasService = graph.nodes.some((n) => n.type === "service");
-            const hasPermissionEdge = graph.edges.some((e) => e.relation === "has_permission" && e.from.startsWith("main_service"));
-            if (hasService && !hasPermissionEdge) {
-                hardViolations.push(constraint);
-            }
-        }
-        if (constraint.id === "arbitration_permission_independent") {
-            const serviceNode = graph.nodes.find((n) => n.id === "main_service");
-            const arbNode = graph.nodes.find((n) => n.id === "main_arbitration");
-            if (serviceNode && arbNode) {
-                const servicePerm = graph.edges.find((e) => e.from === "main_service" && e.relation === "has_permission")?.to;
-                const arbPerm = graph.edges.find((e) => e.from === "main_arbitration" && e.relation === "has_permission")?.to;
-                if (servicePerm && arbPerm && servicePerm === arbPerm) {
-                    hardViolations.push(constraint);
-                }
-            }
-        }
-        if (constraint.level === "soft") {
-            softViolations.push(constraint);
-        }
-        else if (constraint.level === "info") {
-            infoNotes.push(constraint);
-        }
-    }
-    return {
-        valid: hardViolations.length === 0,
-        hardViolations,
-        softViolations,
-        infoNotes,
-    };
-}
+export function buildSemanticGraph(a,b){const c=[],d=[],e=[];c['push']({'id':'main_permission','type':'permission','purpose':'Role-based\x20access\x20control\x20for\x20merchant,\x20customer,\x20and\x20optional\x20arbitrator','derivedFrom':{'intentField':'roles','rationale':'All\x20WOW\x20services\x20require\x20a\x20Permission\x20object\x20for\x20role\x20management'},'config':{'name':{'type':'string','value':a['description']['slice'](0x0,0x14)+'_permission','mapsTo':'object.name'}},'expectedState':{'published':!![],'paused':![]}});(a['intent']['startsWith']('sell_')||a['intent']==='rent_asset')&&(c['push']({'id':'main_service','type':'service','purpose':'Main\x20service\x20offering:\x20'+a['description'],'derivedFrom':{'intentField':'description','rationale':'Service\x20is\x20the\x20primary\x20object\x20representing\x20the\x20merchant\x20offering'},'config':{'name':{'type':'string','value':a['description']['slice'](0x0,0x14)+'_service','mapsTo':'object.name'},'type_parameter':{'type':'string','value':a['payment']['currency'],'mapsTo':'object.type_parameter'},'permission':{'type':'address_ref','targetId':'main_permission','mapsTo':'object.permission'}},'expectedState':{'published':!![],'paused':![]}}),d['push']({'from':'main_service','to':'main_permission','relation':'has_permission','required':!![],'derivedFrom':{'intentField':'roles','rationale':'Service\x20must\x20reference\x20its\x20Permission\x20object'}}));(a['payment']['model']==='milestone'||a['deliverables']['length']>0x1)&&(c['push']({'id':'main_machine','type':'machine','purpose':'Workflow\x20controlling\x20deliverable\x20milestones\x20and\x20acceptance','derivedFrom':{'intentField':'deliverables','rationale':'Multiple\x20deliverables\x20or\x20milestone\x20payment\x20requires\x20Machine\x20workflow'},'config':{'name':{'type':'string','value':a['description']['slice'](0x0,0x14)+'_machine','mapsTo':'object.name'},'permission':{'type':'address_ref','targetId':'main_permission','mapsTo':'object.permission'}},'expectedState':{'published':!![],'paused':![]}}),c['find'](l=>l['id']==='main_service')&&d['push']({'from':'main_service','to':'main_machine','relation':'uses_machine','required':!![],'derivedFrom':{'intentField':'deliverables','rationale':'Service\x20binds\x20to\x20Machine\x20for\x20workflow\x20execution'}}));(a['payment']['model']==='milestone'||a['payment']['model']==='escrow'||a['trust']['escrow'])&&(c['push']({'id':'main_allocation','type':'allocation','purpose':'Fund\x20distribution\x20among\x20merchant\x20and\x20optional\x20suppliers','derivedFrom':{'intentField':'payment.allocation','rationale':'Escrow/milestone\x20requires\x20Allocation\x20for\x20fund\x20routing'},'config':{'name':{'type':'string','value':a['description']['slice'](0x0,0x14)+'_allocation','mapsTo':'object.name'},'type_parameter':{'type':'string','value':a['payment']['currency'],'mapsTo':'object.type_parameter'},'permission':{'type':'address_ref','targetId':'main_permission','mapsTo':'object.permission'}},'expectedState':{'published':!![],'paused':![]}}),c['find'](l=>l['id']==='main_service')&&d['push']({'from':'main_service','to':'main_allocation','relation':'has_order_allocators','required':!![],'derivedFrom':{'intentField':'payment','rationale':'Service\x20must\x20bind\x20Allocation\x20for\x20order\x20fund\x20routing'}}));a['trust']['arbitration']!=='none'&&(c['push']({'id':'main_arbitration','type':'arb','purpose':'Independent\x20dispute\x20resolution','derivedFrom':{'intentField':'trust.arbitration','rationale':'Arbitration\x20object\x20provides\x20binding\x20dispute\x20resolution'},'config':{'name':{'type':'string','value':a['description']['slice'](0x0,0x14)+'_arbitration','mapsTo':'object.name'},'type_parameter':{'type':'string','value':a['payment']['currency'],'mapsTo':'object.type_parameter'}},'expectedState':{'published':!![],'paused':![]}}),c['push']({'id':'arb_permission','type':'permission','purpose':'Independent\x20permission\x20for\x20arbitration\x20(MUST\x20differ\x20from\x20Service.permission)','derivedFrom':{'intentField':'trust.arbitration','rationale':'Contract-enforced:\x20arbitration.permission\x20!=\x20service.permission\x20(E_ARBITRATION_PERMISSION_CONFLICT=33)'},'config':{'name':{'type':'string','value':a['description']['slice'](0x0,0x14)+'_arb_permission','mapsTo':'object.name'}},'expectedState':{'published':!![],'paused':![]}}),d['push']({'from':'main_arbitration','to':'arb_permission','relation':'has_permission','required':!![],'derivedFrom':{'intentField':'trust.arbitration','rationale':'Arbitration\x20requires\x20its\x20own\x20Permission'}}),c['find'](l=>l['id']==='main_service')&&d['push']({'from':'main_service','to':'main_arbitration','relation':'has_arbitration','required':![],'derivedFrom':{'intentField':'trust.arbitration','rationale':'Service\x20references\x20Arbitration\x20in\x20arbitrations\x20list'}}));const f=b['some'](l=>l['id']==='wip_provenance'||l['id']==='subscription_with_proof'||l['id']==='damage_attestation');f&&c['push']({'id':'main_repository','type':'repository','purpose':'Store\x20WIP\x20hashes\x20and\x20delivery\x20evidence','derivedFrom':{'intentField':'deliverables','rationale':'WIP\x20provenance\x20requires\x20Repository\x20for\x20hash\x20commitments'},'config':{'name':{'type':'string','value':a['description']['slice'](0x0,0x14)+'_repository','mapsTo':'object.name'},'permission':{'type':'address_ref','targetId':'main_permission','mapsTo':'object.permission'}},'expectedState':{'published':!![],'paused':![]}});for(const l of b){for(const m of l['templateRefs']){if(m['object_type']==='guard')c['push']({'id':'guard_'+l['id'],'type':'guard','purpose':m['purpose'],'derivedFrom':{'intentField':'trust','rationale':'Guard\x20for\x20'+l['name']+'\x20module'},'config':{'name':{'type':'string','value':a['description']['slice'](0x0,0x14)+'_'+l['id']+'_guard','mapsTo':'object.name'}},'expectedState':{'published':!![],'paused':![]}});else{if(m['template_id']['startsWith']('supplier-')){const n='supplier_'+l['id']+'_'+m['object_type'];if(c['some'](p=>p['id']===n))continue;c['push']({'id':n,'type':m['object_type'],'purpose':m['purpose'],'derivedFrom':{'intentField':'roles.suppliers','rationale':'Supplier\x20'+m['object_type']+'\x20for\x20'+l['name']+'\x20(B-6\x20two-hop\x20waterfall)'},'config':{'name':{'type':'string','value':a['description']['slice'](0x0,0x14)+'_'+l['id']+'_'+m['object_type'],'mapsTo':'object.name'}},'expectedState':{'published':!![],'paused':![]}});const o=c['find'](p=>p['id']==='main_service');o&&d['push']({'from':'main_service','to':n,'relation':'sub_order','required':![],'derivedFrom':{'intentField':'payment.allocation','rationale':'Two-hop\x20waterfall:\x20main\x20order\x20→\x20tier-1\x20allocation\x20→\x20supplier\x20sub-order\x20→\x20tier-2\x20allocation\x20('+l['name']+')'}});}}}}if(a['intent']['startsWith']('sell_')||a['intent']==='rent_asset'){c['push']({'id':'main_contact','type':'contact','purpose':'Public\x20contact/IM\x20channel\x20so\x20customers\x20can\x20reach\x20the\x20merchant\x20before\x20ordering','derivedFrom':{'intentField':'description','rationale':'A\x20discoverable\x20contact\x20object\x20improves\x20customer\x20trust\x20and\x20order\x20conversion'},'config':{'name':{'type':'string','value':a['description']['slice'](0x0,0x14)+'_contact','mapsTo':'object.name'},'description':{'type':'string','value':a['description'],'mapsTo':'object.description'}},'expectedState':{'published':!![],'paused':![]}});const p=c['find'](q=>q['id']==='main_service');p&&(p['config']['um']={'type':'address_ref','targetId':'main_contact','mapsTo':'object.um'},d['push']({'from':'main_service','to':'main_contact','relation':'has_contact','required':![],'derivedFrom':{'intentField':'description','rationale':'Service\x20binds\x20Contact\x20via\x20um\x20so\x20customers\x20can\x20reach\x20the\x20merchant'}}));}(a['intent']['startsWith']('sell_')||a['intent']==='rent_asset')&&(c['push']({'id':'main_reward','type':'reward','purpose':'Optional\x20incentive\x20pool\x20(discount/referral)\x20to\x20attract\x20and\x20retain\x20customers','derivedFrom':{'intentField':'payment','rationale':'Rewards\x20lower\x20acquisition\x20cost\x20and\x20boost\x20conversion'},'config':{'name':{'type':'string','value':a['description']['slice'](0x0,0x14)+'_reward','mapsTo':'object.name'},'type_parameter':{'type':'string','value':a['payment']['currency'],'mapsTo':'object.type_parameter'},'permission':{'type':'address_ref','targetId':'main_permission','mapsTo':'object.permission'}},'expectedState':{'published':!![],'paused':![]}}),c['find'](q=>q['id']==='main_service')&&d['push']({'from':'main_service','to':'main_reward','relation':'has_rewards','required':![],'derivedFrom':{'intentField':'payment','rationale':'Service\x20can\x20reference\x20Reward\x20in\x20its\x20rewards\x20list'}}));e['push']({'id':'service_permission_bound','level':'hard','description':'Service\x20must\x20be\x20bound\x20to\x20a\x20Permission\x20object','source':{'layer':'contract','reference':'service.move:\x20permission\x20field\x20is\x20required'},'fixSuggestion':'Create\x20Permission\x20object\x20first,\x20then\x20reference\x20it\x20in\x20Service.object.permission'});a['trust']['arbitration']!=='none'&&e['push']({'id':'arbitration_permission_independent','level':'hard','description':'Arbitration.permission\x20MUST\x20be\x20different\x20from\x20Service.permission','source':{'layer':'contract','reference':'service.move:433-436\x20E_ARBITRATION_PERMISSION_CONFLICT=33'},'fixSuggestion':'Create\x20a\x20dedicated\x20Permission\x20object\x20for\x20Arbitration,\x20do\x20NOT\x20reuse\x20Service.permission'});a['payment']['model']==='milestone'&&e['push']({'id':'machine_bound_before_publish','level':'hard','description':'Machine\x20must\x20be\x20published\x20and\x20bound\x20to\x20Service\x20before\x20Service.publish','source':{'layer':'contract','reference':'service.move:\x20machine\x20is\x20IMMUTABLE\x20after\x20publish'},'fixSuggestion':'Create\x20and\x20publish\x20Machine\x20before\x20calling\x20Service.publish.\x20Machine\x20cannot\x20be\x20changed\x20after\x20Service\x20is\x20published.'});const g=calculateModuleScoreBoost(b),h=Math['min'](0x64,0x28+Object['values'](g)['reduce']((q,r)=>q+r,0x0)/0x2),i=Math['min'](0x64,0x32+(g['trust']??0x0)+(g['fund_safety']??0x0)),j=Math['min'](0x64,0x1e+b['length']*0x8),k={'estimatedRiskScore':h,'estimatedTrustScore':i,'estimatedCompletenessScore':j,'keyRisks':[...a['trust']['arbitration']==='none'?['No\x20arbitration\x20configured\x20—\x20disputes\x20have\x20no\x20resolution\x20path']:[],...a['payment']['model']==='upfront'&&a['trust']['refundPolicy']==='no_refund'?['Full\x20upfront\x20+\x20no\x20refund\x20=\x20high\x20user\x20risk']:[]],'strengths':b['map'](q=>q['name']+':\x20'+q['description']['slice'](0x0,0x3c)+'...'),'moduleBoosts':g};return{'nodes':c,'edges':d,'constraints':e,'evaluationPreview':k,'adoptedModules':b['map'](q=>q['id']),'businessIntent':a};}function calculateModuleScoreBoost(a){const b={};for(const c of a){for(const d of c['evaluationImpact']){const e=d['effect']==='required'?0xf:d['effect']==='boost'?0x8:0x3;b[d['dimension']]=(b[d['dimension']]??0x0)+e;}}return b;}export function validateGraph(a){const b=[],c=[],d=[];for(const e of a['constraints']){if(e['id']==='service_permission_bound'){const f=a['nodes']['some'](h=>h['type']==='service'),g=a['edges']['some'](h=>h['relation']==='has_permission'&&h['from']['startsWith']('main_service'));f&&!g&&b['push'](e);}if(e['id']==='arbitration_permission_independent'){const h=a['nodes']['find'](j=>j['id']==='main_service'),i=a['nodes']['find'](j=>j['id']==='main_arbitration');if(h&&i){const j=a['edges']['find'](l=>l['from']==='main_service'&&l['relation']==='has_permission')?.['to'],k=a['edges']['find'](l=>l['from']==='main_arbitration'&&l['relation']==='has_permission')?.['to'];j&&k&&j===k&&b['push'](e);}}if(e['level']==='soft')c['push'](e);else e['level']==='info'&&d['push'](e);}return{'valid':b['length']===0x0,'hardViolations':b,'softViolations':c,'infoNotes':d};}