@wowok/agent-mcp 2.7.0 → 2.7.2

package/dist/knowledge/allocation-context.js

@@ -1,249 +1 @@
-import { MAX_SHARING_COUNT } from "@wowok/wowok";
-import { ALLOCATION_SCENES, MAX_ALLOCATOR_COUNT, ALLOCATION_MAX_SHARING_COUNT, ALLOCATION_MODE_AMOUNT, ALLOCATION_MODE_RATE, ALLOCATION_MODE_SURPLUS, RATE_TOTAL_FULL, inferSceneFromIntent, getAllScenes, } from "./allocation-ledger.js";
-import { suggestTemplateForScene, } from "./allocation-templates.js";
-import { matchSemanticPattern, } from "./allocation-translation.js";
-import { getAllRiskRules, assessAllocationRisks, } from "./allocation-risk.js";
-import { initPuzzleFromIntent, checkPuzzleCompleteness, } from "./allocation-puzzle.js";
-import { ALLOCATION_PUBLISH_CHECKLIST, ALLOCATION_CONFIRMATION_QUESTIONS, } from "./allocation-confirm.js";
-export const ALLOCATION_CONTEXT_VERSION = "1.0.0";
-export function buildAllocationContext(input) {
-    const max_length = input.max_length ?? 4000;
-    let matched_scene;
-    if (input.intent) {
-        matched_scene = inferSceneFromIntent(input.intent);
-    }
-    if (!matched_scene && input.target_trigger_source) {
-        const scenes = getAllScenes().filter(s => s.trigger_source === input.target_trigger_source);
-        if (scenes.length > 0)
-            matched_scene = scenes[0];
-    }
-    if (!matched_scene && input.target_mode) {
-        const scenes = getAllScenes().filter(s => s.modes_used.includes(input.target_mode));
-        if (scenes.length > 0)
-            matched_scene = scenes[0];
-    }
-    let matched_template;
-    if (matched_scene) {
-        const tpl = suggestTemplateForScene(matched_scene.id);
-        if (tpl)
-            matched_template = tpl;
-    }
-    let matched_pattern;
-    if (input.intent) {
-        const patterns = matchSemanticPattern(input.intent);
-        if (patterns.length > 0)
-            matched_pattern = patterns[0];
-    }
-    let puzzle_state;
-    let puzzle_completeness;
-    if (input.mode === "initial_design" && input.intent) {
-        puzzle_state = initPuzzleFromIntent({ distribution_goal: input.intent });
-        puzzle_completeness = checkPuzzleCompleteness(puzzle_state);
-    }
-    const relevant_risks = filterRiskRules(input.mode, input.stakeholder, matched_scene);
-    let risk_assessment;
-    if (input.mode === "pre_publish" && input.allocation_json) {
-        const ctx = {
-            object: input.allocation_json.object,
-            allocators_config: input.allocation_json.allocators,
-            coin_type: typeof input.allocation_json.coin === "string"
-                ? input.allocation_json.coin
-                : input.allocation_json.coin?.name,
-            has_payment_info: !!input.allocation_json.payment_info,
-        };
-        risk_assessment = assessAllocationRisks(ctx);
-    }
-    const relevant_checklist = filterChecklist(input.mode);
-    const relevant_questions = filterQuestions(input.mode);
-    const cross_object_refs = buildCrossObjectRefs(matched_scene);
-    const onchain_constraints = buildOnchainConstraints();
-    const has_rate_mode = input.allocation_json?.allocators?.allocators?.some(a => a.sharing.some(s => s.mode === "Rate")) ?? false;
-    const has_trigger = !!matched_scene && matched_scene.trigger_source !== "standalone";
-    const rendering_hints = buildRenderingHints(input.mode, max_length, has_trigger, has_rate_mode);
-    return {
-        version: ALLOCATION_CONTEXT_VERSION,
-        mode: input.mode,
-        stakeholder_perspective: input.stakeholder,
-        matched_scene,
-        matched_template,
-        matched_pattern,
-        puzzle_state,
-        puzzle_completeness,
-        relevant_risks,
-        risk_assessment,
-        relevant_checklist,
-        relevant_questions,
-        cross_object_refs,
-        onchain_constraints,
-        rendering_hints,
-    };
-}
-function filterRiskRules(mode, stakeholder, scene) {
-    const rules = getAllRiskRules();
-    if (mode === "initial_design") {
-        return rules.filter(r => r.category === "structural");
-    }
-    if (mode === "pre_publish") {
-        return rules;
-    }
-    if (mode === "stakeholder_review" && stakeholder) {
-        if (stakeholder === "owner") {
-            return rules.filter(r => r.category === "structural" || r.category === "lifecycle");
-        }
-        if (stakeholder === "allocator") {
-            return rules.filter(r => r.category === "structural" || r.category === "semantic");
-        }
-        if (stakeholder === "recipient") {
-            return rules.filter(r => r.category === "semantic");
-        }
-        if (stakeholder === "service_provider") {
-            return rules.filter(r => r.category === "cross_object" || r.category === "lifecycle");
-        }
-    }
-    return rules;
-}
-function filterChecklist(mode) {
-    if (mode === "initial_design") {
-        return ALLOCATION_PUBLISH_CHECKLIST.filter(i => ["C-A-01", "C-A-02", "C-A-03", "C-A-04"].includes(i.id));
-    }
-    if (mode === "post_publish_modify") {
-        return ALLOCATION_PUBLISH_CHECKLIST.filter(i => ["C-A-09", "C-A-10", "C-A-11", "C-A-12"].includes(i.id));
-    }
-    return ALLOCATION_PUBLISH_CHECKLIST;
-}
-function filterQuestions(mode) {
-    if (mode === "pre_publish") {
-        return ALLOCATION_CONFIRMATION_QUESTIONS;
-    }
-    if (mode === "post_publish_modify") {
-        return ALLOCATION_CONFIRMATION_QUESTIONS.filter(q => ["QA4", "QA5", "QA6"].includes(q.id));
-    }
-    return [];
-}
-function buildCrossObjectRefs(scene) {
-    if (!scene)
-        return [];
-    const refs = [];
-    for (const s of ALLOCATION_SCENES) {
-        if (s.id === scene.id)
-            continue;
-        refs.push({
-            object: s.dependencies[0] ?? "Service",
-            field: "allocation",
-            scene_id: s.id,
-            description: `${s.name} (trigger: ${s.trigger_source})`,
-        });
-    }
-    return refs;
-}
-function buildOnchainConstraints() {
-    return [
-        { name: "MAX_SHARING_COUNT", value: MAX_SHARING_COUNT, description: "Maximum sharing entries per allocator (Move: allocation.move:17)" },
-        { name: "MAX_ALLOCATOR_COUNT", value: MAX_ALLOCATOR_COUNT, description: "Maximum allocators per Allocation object (Move: allocation.move:16)" },
-        { name: "ALLOCATION_MAX_SHARING_COUNT", value: ALLOCATION_MAX_SHARING_COUNT, description: "Alias of MAX_SHARING_COUNT (knowledge-layer mirror)" },
-        { name: "ALLOCATION_MODE_AMOUNT", value: ALLOCATION_MODE_AMOUNT, description: "Mode 0: fixed amount distribution" },
-        { name: "ALLOCATION_MODE_RATE", value: ALLOCATION_MODE_RATE, description: "Mode 1: percentage rate (basis points, total = RATE_TOTAL_FULL)" },
-        { name: "ALLOCATION_MODE_SURPLUS", value: ALLOCATION_MODE_SURPLUS, description: "Mode 2: surplus (remainder) distribution" },
-        { name: "RATE_TOTAL_FULL", value: RATE_TOTAL_FULL, description: "100% in basis points (10000) — Rate mode shares must sum to this" },
-    ];
-}
-function buildRenderingHints(mode, max_length, hasTrigger, hasRateMode) {
-    return {
-        include_puzzle_template: mode === "initial_design",
-        include_risk_details: mode === "pre_publish" || mode === "stakeholder_review",
-        include_questions: mode === "pre_publish",
-        include_immutability_warning: mode === "post_publish_modify",
-        include_trigger_warning: hasTrigger,
-        include_rate_overflow_warning: hasRateMode,
-        max_length,
-    };
-}
-export function buildPromptFromAllocationContext(bundle) {
-    const lines = [];
-    const h = bundle.rendering_hints;
-    lines.push(`═══ Allocation Context (mode: ${bundle.mode}) ═══`);
-    lines.push("");
-    if (bundle.matched_scene) {
-        lines.push(`Scene: ${bundle.matched_scene.name}`);
-        lines.push(`Trigger source: ${bundle.matched_scene.trigger_source}`);
-        lines.push(`Distribution strategy: ${bundle.matched_scene.distribution_strategy}`);
-        lines.push(`Typical allocator count: ${bundle.matched_scene.typical_allocator_count}`);
-        lines.push("");
-    }
-    if (bundle.matched_template) {
-        lines.push(`Suggested template: ${bundle.matched_template.id} — ${bundle.matched_template.name}`);
-        lines.push("");
-    }
-    if (h.include_puzzle_template && bundle.puzzle_completeness) {
-        const c = bundle.puzzle_completeness;
-        lines.push("─ Puzzle Completeness ──────────────");
-        lines.push(`Complete: ${c.complete ? "YES" : "NO"}`);
-        if (c.missing.length > 0) {
-            lines.push(`Missing: ${c.missing.join(", ")}`);
-        }
-        lines.push(`Next: ${c.next_step}`);
-        lines.push("");
-    }
-    if (h.include_risk_details && bundle.relevant_risks.length > 0) {
-        lines.push(`─ Relevant Risk Rules (${bundle.relevant_risks.length}) ──────────────`);
-        for (const r of bundle.relevant_risks.slice(0, 5)) {
-            lines.push(`  ${r.id} — ${r.trigger}`);
-        }
-        if (bundle.relevant_risks.length > 5) {
-            lines.push(`  ... and ${bundle.relevant_risks.length - 5} more`);
-        }
-        lines.push("");
-    }
-    if (bundle.risk_assessment) {
-        lines.push("─ Risk Assessment ──────────────");
-        lines.push(`Overall: ${bundle.risk_assessment.summary}`);
-        lines.push(`Detected: ${bundle.risk_assessment.risks.length} risk(s)`);
-        lines.push("");
-    }
-    if (h.include_trigger_warning) {
-        lines.push("⚠️ TRIGGER-AWARE — This Allocation is bound to a trigger source (Service/Arbitration).");
-        lines.push("   Funds flow is automated by on-chain events, not manual invocation.");
-        lines.push("");
-    }
-    if (h.include_rate_overflow_warning) {
-        lines.push("⚠️ RATE MODE — Sharing rates must sum to exactly RATE_TOTAL_FULL (10000 basis points).");
-        lines.push("   Underflow → remaining funds stuck; Overflow → transaction aborts.");
-        lines.push("");
-    }
-    if (h.include_immutability_warning) {
-        lines.push("⚠️ POST-PUBLISH OPERATE — Allocation object is on-chain.");
-        lines.push("   Only receive / alloc_by_guard operations are permitted; allocators are immutable.");
-        lines.push("");
-    }
-    if (bundle.onchain_constraints.length > 0) {
-        lines.push("─ On-chain Constraints ──────────────");
-        for (const c of bundle.onchain_constraints) {
-            lines.push(`  ${c.name} = ${c.value} — ${c.description}`);
-        }
-        lines.push("");
-    }
-    if (bundle.cross_object_refs.length > 0) {
-        lines.push(`─ Cross-object References (${bundle.cross_object_refs.length}) ──────────────`);
-        for (const ref of bundle.cross_object_refs.slice(0, 5)) {
-            lines.push(`  [${ref.object}] ${ref.scene_id}: ${ref.description}`);
-        }
-        if (bundle.cross_object_refs.length > 5) {
-            lines.push(`  ... and ${bundle.cross_object_refs.length - 5} more`);
-        }
-        lines.push("");
-    }
-    return lines.join("\n");
-}
-export function getAllocationContextSummary(bundle) {
-    const parts = [
-        `mode=${bundle.mode}`,
-        `scene=${bundle.matched_scene?.id ?? "none"}`,
-        `risks=${bundle.relevant_risks.length}`,
-        `refs=${bundle.cross_object_refs.length}`,
-    ];
-    if (bundle.stakeholder_perspective)
-        parts.push(`stakeholder=${bundle.stakeholder_perspective}`);
-    if (bundle.risk_assessment)
-        parts.push(`summary=${bundle.risk_assessment.summary}`);
-    return parts.join(", ");
-}
+import{MAX_SHARING_COUNT}from'@wowok/wowok';import{ALLOCATION_SCENES,MAX_ALLOCATOR_COUNT,ALLOCATION_MAX_SHARING_COUNT,ALLOCATION_MODE_AMOUNT,ALLOCATION_MODE_RATE,ALLOCATION_MODE_SURPLUS,RATE_TOTAL_FULL,inferSceneFromIntent,getAllScenes}from'./allocation-ledger.js';import{suggestTemplateForScene}from'./allocation-templates.js';import{matchSemanticPattern}from'./allocation-translation.js';import{getAllRiskRules,assessAllocationRisks}from'./allocation-risk.js';import{initPuzzleFromIntent,checkPuzzleCompleteness}from'./allocation-puzzle.js';import{ALLOCATION_PUBLISH_CHECKLIST,ALLOCATION_CONFIRMATION_QUESTIONS}from'./allocation-confirm.js';export const ALLOCATION_CONTEXT_VERSION='1.0.0';export function buildAllocationContext(a){const b=a['max_length']??0xfa0;let c;a['intent']&&(c=inferSceneFromIntent(a['intent']));if(!c&&a['target_trigger_source']){const q=getAllScenes()['filter'](r=>r['trigger_source']===a['target_trigger_source']);if(q['length']>0x0)c=q[0x0];}if(!c&&a['target_mode']){const r=getAllScenes()['filter'](t=>t['modes_used']['includes'](a['target_mode']));if(r['length']>0x0)c=r[0x0];}let d;if(c){const s=suggestTemplateForScene(c['id']);if(s)d=s;}let e;if(a['intent']){const t=matchSemanticPattern(a['intent']);if(t['length']>0x0)e=t[0x0];}let f,g;a['mode']==='initial_design'&&a['intent']&&(f=initPuzzleFromIntent({'distribution_goal':a['intent']}),g=checkPuzzleCompleteness(f));const h=filterRiskRules(a['mode'],a['stakeholder'],c);let i;if(a['mode']==='pre_publish'&&a['allocation_json']){const u={'object':a['allocation_json']['object'],'allocators_config':a['allocation_json']['allocators'],'coin_type':typeof a['allocation_json']['coin']==='string'?a['allocation_json']['coin']:a['allocation_json']['coin']?.['name'],'has_payment_info':!!a['allocation_json']['payment_info']};i=assessAllocationRisks(u);}const j=filterChecklist(a['mode']),k=filterQuestions(a['mode']),l=buildCrossObjectRefs(c),m=buildOnchainConstraints(),n=a['allocation_json']?.['allocators']?.['allocators']?.['some'](v=>v['sharing']['some'](w=>w['mode']==='Rate'))??![],o=!!c&&c['trigger_source']!=='standalone',p=buildRenderingHints(a['mode'],b,o,n);return{'version':ALLOCATION_CONTEXT_VERSION,'mode':a['mode'],'stakeholder_perspective':a['stakeholder'],'matched_scene':c,'matched_template':d,'matched_pattern':e,'puzzle_state':f,'puzzle_completeness':g,'relevant_risks':h,'risk_assessment':i,'relevant_checklist':j,'relevant_questions':k,'cross_object_refs':l,'onchain_constraints':m,'rendering_hints':p};}function filterRiskRules(a,b,c){const d=getAllRiskRules();if(a==='initial_design')return d['filter'](e=>e['category']==='structural');if(a==='pre_publish')return d;if(a==='stakeholder_review'&&b){if(b==='owner')return d['filter'](e=>e['category']==='structural'||e['category']==='lifecycle');if(b==='allocator')return d['filter'](e=>e['category']==='structural'||e['category']==='semantic');if(b==='recipient')return d['filter'](e=>e['category']==='semantic');if(b==='service_provider')return d['filter'](e=>e['category']==='cross_object'||e['category']==='lifecycle');}return d;}function filterChecklist(a){if(a==='initial_design')return ALLOCATION_PUBLISH_CHECKLIST['filter'](b=>['C-A-01','C-A-02','C-A-03','C-A-04']['includes'](b['id']));if(a==='post_publish_modify')return ALLOCATION_PUBLISH_CHECKLIST['filter'](b=>['C-A-09','C-A-10','C-A-11','C-A-12']['includes'](b['id']));return ALLOCATION_PUBLISH_CHECKLIST;}function filterQuestions(a){if(a==='pre_publish')return ALLOCATION_CONFIRMATION_QUESTIONS;if(a==='post_publish_modify')return ALLOCATION_CONFIRMATION_QUESTIONS['filter'](b=>['QA4','QA5','QA6']['includes'](b['id']));return[];}function buildCrossObjectRefs(a){if(!a)return[];const b=[];for(const c of ALLOCATION_SCENES){if(c['id']===a['id'])continue;b['push']({'object':c['dependencies'][0x0]??'Service','field':'allocation','scene_id':c['id'],'description':c['name']+'\x20(trigger:\x20'+c['trigger_source']+')'});}return b;}function buildOnchainConstraints(){return[{'name':'MAX_SHARING_COUNT','value':MAX_SHARING_COUNT,'description':'Maximum\x20sharing\x20entries\x20per\x20allocator\x20(Move:\x20allocation.move:17)'},{'name':'MAX_ALLOCATOR_COUNT','value':MAX_ALLOCATOR_COUNT,'description':'Maximum\x20allocators\x20per\x20Allocation\x20object\x20(Move:\x20allocation.move:16)'},{'name':'ALLOCATION_MAX_SHARING_COUNT','value':ALLOCATION_MAX_SHARING_COUNT,'description':'Alias\x20of\x20MAX_SHARING_COUNT\x20(knowledge-layer\x20mirror)'},{'name':'ALLOCATION_MODE_AMOUNT','value':ALLOCATION_MODE_AMOUNT,'description':'Mode\x200:\x20fixed\x20amount\x20distribution'},{'name':'ALLOCATION_MODE_RATE','value':ALLOCATION_MODE_RATE,'description':'Mode\x201:\x20percentage\x20rate\x20(basis\x20points,\x20total\x20=\x20RATE_TOTAL_FULL)'},{'name':'ALLOCATION_MODE_SURPLUS','value':ALLOCATION_MODE_SURPLUS,'description':'Mode\x202:\x20surplus\x20(remainder)\x20distribution'},{'name':'RATE_TOTAL_FULL','value':RATE_TOTAL_FULL,'description':'100%\x20in\x20basis\x20points\x20(10000)\x20—\x20Rate\x20mode\x20shares\x20must\x20sum\x20to\x20this'}];}function buildRenderingHints(a,b,c,d){return{'include_puzzle_template':a==='initial_design','include_risk_details':a==='pre_publish'||a==='stakeholder_review','include_questions':a==='pre_publish','include_immutability_warning':a==='post_publish_modify','include_trigger_warning':c,'include_rate_overflow_warning':d,'max_length':b};}export function buildPromptFromAllocationContext(a){const b=[],d=a['rendering_hints'];b['push']('═══\x20Allocation\x20Context\x20(mode:\x20'+a['mode']+')\x20═══'),b['push']('');a['matched_scene']&&(b['push']('Scene:\x20'+a['matched_scene']['name']),b['push']('Trigger\x20source:\x20'+a['matched_scene']['trigger_source']),b['push']('Distribution\x20strategy:\x20'+a['matched_scene']['distribution_strategy']),b['push']('Typical\x20allocator\x20count:\x20'+a['matched_scene']['typical_allocator_count']),b['push'](''));a['matched_template']&&(b['push']('Suggested\x20template:\x20'+a['matched_template']['id']+'\x20—\x20'+a['matched_template']['name']),b['push'](''));if(d['include_puzzle_template']&&a['puzzle_completeness']){const e=a['puzzle_completeness'];b['push']('─\x20Puzzle\x20Completeness\x20──────────────'),b['push']('Complete:\x20'+(e['complete']?'YES':'NO')),e['missing']['length']>0x0&&b['push']('Missing:\x20'+e['missing']['join'](',\x20')),b['push']('Next:\x20'+e['next_step']),b['push']('');}if(d['include_risk_details']&&a['relevant_risks']['length']>0x0){b['push']('─\x20Relevant\x20Risk\x20Rules\x20('+a['relevant_risks']['length']+')\x20──────────────');for(const f of a['relevant_risks']['slice'](0x0,0x5)){b['push']('\x20\x20'+f['id']+'\x20—\x20'+f['trigger']);}a['relevant_risks']['length']>0x5&&b['push']('\x20\x20...\x20and\x20'+(a['relevant_risks']['length']-0x5)+'\x20more'),b['push']('');}a['risk_assessment']&&(b['push']('─\x20Risk\x20Assessment\x20──────────────'),b['push']('Overall:\x20'+a['risk_assessment']['summary']),b['push']('Detected:\x20'+a['risk_assessment']['risks']['length']+'\x20risk(s)'),b['push'](''));d['include_trigger_warning']&&(b['push']('⚠️\x20TRIGGER-AWARE\x20—\x20This\x20Allocation\x20is\x20bound\x20to\x20a\x20trigger\x20source\x20(Service/Arbitration).'),b['push']('\x20\x20\x20Funds\x20flow\x20is\x20automated\x20by\x20on-chain\x20events,\x20not\x20manual\x20invocation.'),b['push'](''));d['include_rate_overflow_warning']&&(b['push']('⚠️\x20RATE\x20MODE\x20—\x20Sharing\x20rates\x20must\x20sum\x20to\x20exactly\x20RATE_TOTAL_FULL\x20(10000\x20basis\x20points).'),b['push']('\x20\x20\x20Underflow\x20→\x20remaining\x20funds\x20stuck;\x20Overflow\x20→\x20transaction\x20aborts.'),b['push'](''));d['include_immutability_warning']&&(b['push']('⚠️\x20POST-PUBLISH\x20OPERATE\x20—\x20Allocation\x20object\x20is\x20on-chain.'),b['push']('\x20\x20\x20Only\x20receive\x20/\x20alloc_by_guard\x20operations\x20are\x20permitted;\x20allocators\x20are\x20immutable.'),b['push'](''));if(a['onchain_constraints']['length']>0x0){b['push']('─\x20On-chain\x20Constraints\x20──────────────');for(const g of a['onchain_constraints']){b['push']('\x20\x20'+g['name']+'\x20=\x20'+g['value']+'\x20—\x20'+g['description']);}b['push']('');}if(a['cross_object_refs']['length']>0x0){b['push']('─\x20Cross-object\x20References\x20('+a['cross_object_refs']['length']+')\x20──────────────');for(const i of a['cross_object_refs']['slice'](0x0,0x5)){b['push']('\x20\x20['+i['object']+']\x20'+i['scene_id']+':\x20'+i['description']);}a['cross_object_refs']['length']>0x5&&b['push']('\x20\x20...\x20and\x20'+(a['cross_object_refs']['length']-0x5)+'\x20more'),b['push']('');}return b['join']('\x0a');}export function getAllocationContextSummary(a){const b=['mode='+a['mode'],'scene='+(a['matched_scene']?.['id']??'none'),'risks='+a['relevant_risks']['length'],'refs='+a['cross_object_refs']['length']];if(a['stakeholder_perspective'])b['push']('stakeholder='+a['stakeholder_perspective']);if(a['risk_assessment'])b['push']('summary='+a['risk_assessment']['summary']);return b['join'](',\x20');}