@wowok/agent-mcp 2.7.0 → 2.7.2

package/dist/knowledge/permission-context.js

@@ -1,224 +1 @@
-import { USER_DEFINED_PERM_INDEX_START, MAX_ENTITY_COUNT, MAX_PERM_FOR_ENTITY, MAX_ADMIN_COUNT, } from "@wowok/wowok";
-import { PERMISSION_SCENES, findSceneByPermissionIndex, inferSceneFromIntent, getScenesByHostObject, getAllBuiltinPermissions, } from "./permission-ledger.js";
-import { getTemplatesByScene, } from "./permission-templates.js";
-import { matchSemanticPattern, } from "./permission-translation.js";
-import { getAllRiskRules, assessPermissionRisks, } from "./permission-risk.js";
-import { initPuzzleFromIntent, checkPuzzleCompleteness, } from "./permission-puzzle.js";
-import { PERMISSION_PUBLISH_CHECKLIST, PERMISSION_CONFIRMATION_QUESTIONS, } from "./permission-confirm.js";
-export const PERMISSION_CONTEXT_VERSION = "1.0.0";
-export function buildPermissionContext(input) {
-    const max_length = input.max_length ?? 4000;
-    let matched_scene;
-    if (input.intent) {
-        matched_scene = inferSceneFromIntent(input.intent);
-    }
-    else if (input.target_permission_index !== undefined) {
-        matched_scene = findSceneByPermissionIndex(input.target_permission_index);
-    }
-    else if (input.target_host_object) {
-        const scenes = getScenesByHostObject(input.target_host_object);
-        if (scenes.length > 0)
-            matched_scene = scenes[0];
-    }
-    let matched_template;
-    if (matched_scene) {
-        const templates = getTemplatesByScene(matched_scene.id);
-        if (templates.length > 0)
-            matched_template = templates[0];
-    }
-    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({ rule_sentence: 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.permission_json) {
-        const ctx = {
-            object: input.permission_json.object,
-            admin: input.permission_json.admin,
-            table: input.permission_json.table,
-            entity: input.permission_json.entity,
-            remark: input.permission_json.remark,
-            apply: input.permission_json.apply,
-            builder: input.permission_json.builder,
-            um: input.permission_json.um,
-        };
-        risk_assessment = assessPermissionRisks(ctx);
-    }
-    const relevant_checklist = filterChecklist(input.mode);
-    const relevant_questions = filterQuestions(input.mode);
-    const relevant_builtin_permissions = matched_scene
-        ? matched_scene.builtin_indexes
-        : getAllBuiltinPermissions();
-    const cross_object_refs = buildCrossObjectRefs(matched_scene);
-    const onchain_constraints = buildOnchainConstraints();
-    const rendering_hints = buildRenderingHints(input.mode, max_length, !!input.permission_json?.builder);
-    return {
-        version: PERMISSION_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,
-        relevant_builtin_permissions,
-        cross_object_refs,
-        onchain_constraints,
-        rendering_hints,
-    };
-}
-function filterRiskRules(mode, stakeholder, scene) {
-    let rules = getAllRiskRules();
-    if (mode === "initial_design") {
-        return rules.filter(r => r.category === "structural" || r.category === "authority");
-    }
-    if (mode === "pre_publish") {
-        return rules;
-    }
-    if (mode === "stakeholder_review" && stakeholder) {
-        if (stakeholder === "owner") {
-            return rules.filter(r => r.category === "authority" || r.category === "lifecycle");
-        }
-        if (stakeholder === "admin") {
-            return rules.filter(r => r.category === "structural" || r.category === "semantic");
-        }
-    }
-    return rules;
-}
-function filterChecklist(mode) {
-    if (mode === "initial_design") {
-        return PERMISSION_PUBLISH_CHECKLIST.filter(i => ["C-P-01", "C-P-02", "C-P-03", "C-P-04"].includes(i.id));
-    }
-    return PERMISSION_PUBLISH_CHECKLIST;
-}
-function filterQuestions(mode) {
-    if (mode === "pre_publish") {
-        return PERMISSION_CONFIRMATION_QUESTIONS;
-    }
-    if (mode === "post_publish_modify") {
-        return PERMISSION_CONFIRMATION_QUESTIONS.filter(q => q.id !== "QP5");
-    }
-    return [];
-}
-function buildCrossObjectRefs(scene) {
-    if (!scene)
-        return [];
-    const refs = [];
-    for (const s of PERMISSION_SCENES) {
-        if (s.host_object === scene.host_object || s.id === scene.id)
-            continue;
-        refs.push({
-            object: s.host_object,
-            field: "permission",
-            scene_id: s.id,
-            description: `${s.host_object} uses permission indexes ${s.permission_index_range}`,
-        });
-    }
-    return refs;
-}
-function buildOnchainConstraints() {
-    return [
-        { name: "USER_DEFINED_PERM_INDEX_START", value: USER_DEFINED_PERM_INDEX_START, description: "Custom permission indexes must be >= this value" },
-        { name: "MAX_ENTITY_COUNT", value: MAX_ENTITY_COUNT, description: "Maximum entities per Permission" },
-        { name: "MAX_PERM_FOR_ENTITY", value: MAX_PERM_FOR_ENTITY, description: "Maximum permission indexes per entity" },
-        { name: "MAX_ADMIN_COUNT", value: MAX_ADMIN_COUNT, description: "Maximum admins per Permission" },
-    ];
-}
-function buildRenderingHints(mode, max_length, hasTransfer) {
-    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_transfer_warning: hasTransfer,
-        max_length,
-    };
-}
-export function buildPromptFromPermissionContext(bundle) {
-    const lines = [];
-    const h = bundle.rendering_hints;
-    lines.push("═══ Permission Context (mode: " + bundle.mode + ") ═══");
-    lines.push("");
-    if (bundle.matched_scene) {
-        lines.push(`Scene: ${bundle.matched_scene.name}`);
-        lines.push(`Host object: ${bundle.matched_scene.host_object}`);
-        lines.push(`Permission range: ${bundle.matched_scene.permission_index_range}`);
-        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.overall_risk}`);
-        lines.push(`Detected: ${bundle.risk_assessment.risks.length} risk(s)`);
-        lines.push("");
-    }
-    if (bundle.relevant_builtin_permissions.length > 0) {
-        lines.push(`─ Builtin Permissions (${bundle.relevant_builtin_permissions.length}) ──────────────`);
-        for (const p of bundle.relevant_builtin_permissions.slice(0, 8)) {
-            lines.push(`  [${p.index}] ${p.name}: ${p.description}`);
-        }
-        if (bundle.relevant_builtin_permissions.length > 8) {
-            lines.push(`  ... and ${bundle.relevant_builtin_permissions.length - 8} more`);
-        }
-        lines.push("");
-    }
-    if (h.include_transfer_warning) {
-        lines.push("⚠️ TRANSFER OPERATION DETECTED — This is IRREVERSIBLE");
-        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("");
-    }
-    return lines.join("\n");
-}
-export function getPermissionContextSummary(bundle) {
-    const parts = [
-        `mode=${bundle.mode}`,
-        `scene=${bundle.matched_scene?.id ?? "none"}`,
-        `risks=${bundle.relevant_risks.length}`,
-        `permissions=${bundle.relevant_builtin_permissions.length}`,
-    ];
-    if (bundle.risk_assessment)
-        parts.push(`overall_risk=${bundle.risk_assessment.overall_risk}`);
-    return parts.join(", ");
-}
+import{USER_DEFINED_PERM_INDEX_START,MAX_ENTITY_COUNT,MAX_PERM_FOR_ENTITY,MAX_ADMIN_COUNT}from'@wowok/wowok';import{PERMISSION_SCENES,findSceneByPermissionIndex,inferSceneFromIntent,getScenesByHostObject,getAllBuiltinPermissions}from'./permission-ledger.js';import{getTemplatesByScene}from'./permission-templates.js';import{matchSemanticPattern}from'./permission-translation.js';import{getAllRiskRules,assessPermissionRisks}from'./permission-risk.js';import{initPuzzleFromIntent,checkPuzzleCompleteness}from'./permission-puzzle.js';import{PERMISSION_PUBLISH_CHECKLIST,PERMISSION_CONFIRMATION_QUESTIONS}from'./permission-confirm.js';export const PERMISSION_CONTEXT_VERSION='1.0.0';export function buildPermissionContext(a){const b=a['max_length']??0xfa0;let c;if(a['intent'])c=inferSceneFromIntent(a['intent']);else{if(a['target_permission_index']!==undefined)c=findSceneByPermissionIndex(a['target_permission_index']);else{if(a['target_host_object']){const p=getScenesByHostObject(a['target_host_object']);if(p['length']>0x0)c=p[0x0];}}}let d;if(c){const q=getTemplatesByScene(c['id']);if(q['length']>0x0)d=q[0x0];}let e;if(a['intent']){const r=matchSemanticPattern(a['intent']);if(r['length']>0x0)e=r[0x0];}let f,g;a['mode']==='initial_design'&&a['intent']&&(f=initPuzzleFromIntent({'rule_sentence':a['intent']}),g=checkPuzzleCompleteness(f));const h=filterRiskRules(a['mode'],a['stakeholder'],c);let i;if(a['mode']==='pre_publish'&&a['permission_json']){const s={'object':a['permission_json']['object'],'admin':a['permission_json']['admin'],'table':a['permission_json']['table'],'entity':a['permission_json']['entity'],'remark':a['permission_json']['remark'],'apply':a['permission_json']['apply'],'builder':a['permission_json']['builder'],'um':a['permission_json']['um']};i=assessPermissionRisks(s);}const j=filterChecklist(a['mode']),k=filterQuestions(a['mode']),l=c?c['builtin_indexes']:getAllBuiltinPermissions(),m=buildCrossObjectRefs(c),n=buildOnchainConstraints(),o=buildRenderingHints(a['mode'],b,!!a['permission_json']?.['builder']);return{'version':PERMISSION_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,'relevant_builtin_permissions':l,'cross_object_refs':m,'onchain_constraints':n,'rendering_hints':o};}function filterRiskRules(a,b,c){let d=getAllRiskRules();if(a==='initial_design')return d['filter'](e=>e['category']==='structural'||e['category']==='authority');if(a==='pre_publish')return d;if(a==='stakeholder_review'&&b){if(b==='owner')return d['filter'](e=>e['category']==='authority'||e['category']==='lifecycle');if(b==='admin')return d['filter'](e=>e['category']==='structural'||e['category']==='semantic');}return d;}function filterChecklist(a){if(a==='initial_design')return PERMISSION_PUBLISH_CHECKLIST['filter'](b=>['C-P-01','C-P-02','C-P-03','C-P-04']['includes'](b['id']));return PERMISSION_PUBLISH_CHECKLIST;}function filterQuestions(a){if(a==='pre_publish')return PERMISSION_CONFIRMATION_QUESTIONS;if(a==='post_publish_modify')return PERMISSION_CONFIRMATION_QUESTIONS['filter'](b=>b['id']!=='QP5');return[];}function buildCrossObjectRefs(a){if(!a)return[];const b=[];for(const c of PERMISSION_SCENES){if(c['host_object']===a['host_object']||c['id']===a['id'])continue;b['push']({'object':c['host_object'],'field':'permission','scene_id':c['id'],'description':c['host_object']+'\x20uses\x20permission\x20indexes\x20'+c['permission_index_range']});}return b;}function buildOnchainConstraints(){return[{'name':'USER_DEFINED_PERM_INDEX_START','value':USER_DEFINED_PERM_INDEX_START,'description':'Custom\x20permission\x20indexes\x20must\x20be\x20>=\x20this\x20value'},{'name':'MAX_ENTITY_COUNT','value':MAX_ENTITY_COUNT,'description':'Maximum\x20entities\x20per\x20Permission'},{'name':'MAX_PERM_FOR_ENTITY','value':MAX_PERM_FOR_ENTITY,'description':'Maximum\x20permission\x20indexes\x20per\x20entity'},{'name':'MAX_ADMIN_COUNT','value':MAX_ADMIN_COUNT,'description':'Maximum\x20admins\x20per\x20Permission'}];}function buildRenderingHints(a,b,c){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_transfer_warning':c,'max_length':b};}export function buildPromptFromPermissionContext(a){const b=[],d=a['rendering_hints'];b['push']('═══\x20Permission\x20Context\x20(mode:\x20'+a['mode']+')\x20═══'),b['push']('');a['matched_scene']&&(b['push']('Scene:\x20'+a['matched_scene']['name']),b['push']('Host\x20object:\x20'+a['matched_scene']['host_object']),b['push']('Permission\x20range:\x20'+a['matched_scene']['permission_index_range']),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']['overall_risk']),b['push']('Detected:\x20'+a['risk_assessment']['risks']['length']+'\x20risk(s)'),b['push'](''));if(a['relevant_builtin_permissions']['length']>0x0){b['push']('─\x20Builtin\x20Permissions\x20('+a['relevant_builtin_permissions']['length']+')\x20──────────────');for(const g of a['relevant_builtin_permissions']['slice'](0x0,0x8)){b['push']('\x20\x20['+g['index']+']\x20'+g['name']+':\x20'+g['description']);}a['relevant_builtin_permissions']['length']>0x8&&b['push']('\x20\x20...\x20and\x20'+(a['relevant_builtin_permissions']['length']-0x8)+'\x20more'),b['push']('');}d['include_transfer_warning']&&(b['push']('⚠️\x20TRANSFER\x20OPERATION\x20DETECTED\x20—\x20This\x20is\x20IRREVERSIBLE'),b['push'](''));if(a['onchain_constraints']['length']>0x0){b['push']('─\x20On-chain\x20Constraints\x20──────────────');for(const i of a['onchain_constraints']){b['push']('\x20\x20'+i['name']+'\x20=\x20'+i['value']+'\x20—\x20'+i['description']);}b['push']('');}return b['join']('\x0a');}export function getPermissionContextSummary(a){const b=['mode='+a['mode'],'scene='+(a['matched_scene']?.['id']??'none'),'risks='+a['relevant_risks']['length'],'permissions='+a['relevant_builtin_permissions']['length']];if(a['risk_assessment'])b['push']('overall_risk='+a['risk_assessment']['overall_risk']);return b['join'](',\x20');}