@wowok/agent-mcp 2.7.0 → 2.7.2

package/dist/knowledge/passport-context.js

@@ -1,306 +1 @@
-import { PASSPORT_SCENARIOS, MAX_GUARD_COUNT_PASSPORT, MAX_SUBMISSION_SIZE_PASSPORT, PASSPORT_ERROR_CODES, findScenarioById, inferScenarioFromIntent, getAllScenarios, } from "./passport-ledger.js";
-import { PASSPORT_TEMPLATES, PASSPORT_TEMPLATES_VERSION, getTemplateById, getTemplatesByScenario, suggestTemplateForScenario, } from "./passport-templates.js";
-import { SEMANTIC_TO_SCHEMA_RULES, PASSPORT_CONSTRAINT_RULES, matchSemanticPattern, explainPassport, passportJsonToSemantic, semanticToPassportJson, explainField, explainOp, explainImpack, explainReliesLogic, explainError, getConstraintsByCategory, } from "./passport-translation.js";
-import { getAllRiskRules, assessPassportRisks, PASSPORT_RISK_VERSION, } from "./passport-risk.js";
-import { initPuzzleFromIntent, checkPuzzleCompleteness, validateConstraints, buildPassportPuzzle, buildResultPuzzle, } from "./passport-puzzle.js";
-import { PASSPORT_CONFIRMATION_RULES, PASSPORT_CONFIRM_VERSION, preCheckPassportCreation, preCheckPassportOperation, checkPassportStateConsistency, runPassportConfirmGate, getAllConfirmationRules, } from "./passport-confirm.js";
-export const PASSPORT_CONTEXT_VERSION = "1.0.0";
-export function buildPassportContext(input) {
-    const max_length = input.max_length ?? 4000;
-    let matched_scenario;
-    if (input.intent) {
-        matched_scenario = inferScenarioFromIntent(input.intent);
-    }
-    if (!matched_scenario && input.target_consumer) {
-        const scenarios = getAllScenarios().filter(s => s.consumer_object === input.target_consumer);
-        if (scenarios.length > 0)
-            matched_scenario = scenarios[0];
-    }
-    let matched_template;
-    if (matched_scenario) {
-        const tpl = suggestTemplateForScenario(matched_scenario.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({ protected_operation: input.intent });
-        puzzle_completeness = checkPuzzleCompleteness(puzzle_state);
-    }
-    const relevant_risks = filterRiskRules(input.mode, input.stakeholder, matched_scenario);
-    let risk_assessment;
-    if (input.mode === "pre_verify" && input.passport_state) {
-        const ctx = {
-            object: input.passport_state.object,
-            has_verified: input.passport_state.has_verified,
-            guard_count: input.passport_state.info.length,
-            has_impack_guard: input.passport_state.info.some(g => g.impack),
-            operation_type: "verify",
-            constants_synced: true,
-            knowledge_files_present: true,
-            matched_scenario,
-        };
-        risk_assessment = assessPassportRisks(ctx);
-    }
-    const relevant_checklist = filterChecklist(input.mode);
-    const cross_object_refs = buildCrossObjectRefs(matched_scenario);
-    const onchain_constraints = buildOnchainConstraints();
-    const hasImpack = input.passport_state?.info.some(g => g.impack) ?? false;
-    const hasRelies = input.passport_state?.info.some(g => false) ?? false;
-    const rendering_hints = buildRenderingHints(input.mode, max_length, hasImpack, hasRelies);
-    return {
-        version: PASSPORT_CONTEXT_VERSION,
-        mode: input.mode,
-        stakeholder_perspective: input.stakeholder,
-        matched_scenario,
-        matched_template,
-        matched_pattern,
-        puzzle_state,
-        puzzle_completeness,
-        relevant_risks,
-        risk_assessment,
-        relevant_checklist,
-        cross_object_refs,
-        onchain_constraints,
-        rendering_hints,
-    };
-}
-export const getPassportContext = buildPassportContext;
-function filterRiskRules(mode, stakeholder, scenario) {
-    const rules = getAllRiskRules();
-    if (mode === "initial_design") {
-        return rules.filter(r => r.category === "structural" || r.category === "lifecycle");
-    }
-    if (mode === "pre_verify") {
-        return rules;
-    }
-    if (mode === "stakeholder_review" && stakeholder) {
-        if (stakeholder === "creator") {
-            return rules.filter(r => r.category === "lifecycle" || r.category === "logic");
-        }
-        if (stakeholder === "consumer") {
-            return rules.filter(r => r.category === "operational" || r.category === "lifecycle");
-        }
-        if (stakeholder === "guard_owner") {
-            return rules.filter(r => r.category === "logic");
-        }
-        if (stakeholder === "system") {
-            return rules.filter(r => r.category === "knowledge" || r.category === "operational");
-        }
-    }
-    return rules;
-}
-function filterChecklist(mode) {
-    if (mode === "initial_design") {
-        return PASSPORT_CONFIRMATION_RULES.creation;
-    }
-    if (mode === "pre_verify") {
-        return getAllConfirmationRules();
-    }
-    if (mode === "post_verify_use") {
-        return PASSPORT_CONFIRMATION_RULES.consistency;
-    }
-    return getAllConfirmationRules();
-}
-function buildCrossObjectRefs(scenario) {
-    const refs = [];
-    refs.push({
-        object: "Guard",
-        field: "guard_objects",
-        scenario_id: scenario?.id ?? "passport_generic",
-        description: "Passport.guard references Guard objects for verification (guard::relies, guard::verify_guard)",
-    });
-    refs.push({
-        object: "Clock",
-        field: "time",
-        scenario_id: scenario?.id ?? "passport_generic",
-        description: "Passport.time = clock::timestamp_ms(clock) at creation",
-    });
-    refs.push({
-        object: "Transaction",
-        field: "tx_hash",
-        scenario_id: scenario?.id ?? "passport_generic",
-        description: "Passport.tx_hash = tx_context::digest(ctx) — binds Passport to its creation transaction",
-    });
-    if (scenario) {
-        refs.push({
-            object: scenario.consumer_object,
-            field: scenario.sdk_entry,
-            scenario_id: scenario.id,
-            description: `${scenario.name}: ${scenario.passport_purpose}`,
-        });
-    }
-    for (const s of PASSPORT_SCENARIOS) {
-        if (scenario && s.id === scenario.id)
-            continue;
-        refs.push({
-            object: s.consumer_object,
-            field: s.sdk_entry,
-            scenario_id: s.id,
-            description: `${s.name} (alternative consumer)`,
-        });
-    }
-    return refs;
-}
-function buildOnchainConstraints() {
-    return [
-        {
-            name: "MAX_GUARD_COUNT_PASSPORT",
-            value: MAX_GUARD_COUNT_PASSPORT,
-            description: "Maximum Guard count per Passport (Move: passport.move:9)",
-        },
-        {
-            name: "MAX_SUBMISSION_SIZE_PASSPORT",
-            value: MAX_SUBMISSION_SIZE_PASSPORT,
-            description: "Maximum serialized byte size per submission entry (Move: passport.move:10)",
-        },
-        {
-            name: "E_GUARD_COUNT_EXCEEDED",
-            value: PASSPORT_ERROR_CODES.E_GUARD_COUNT_EXCEEDED,
-            description: "Guard count > 20 — abort guard_add",
-        },
-        {
-            name: "E_HAS_VERIFIED",
-            value: PASSPORT_ERROR_CODES.E_HAS_VERIFIED,
-            description: "verify() one-time — aborts guard_add/guard_clear/verify if already verified",
-        },
-        {
-            name: "E_IMPACK_GUARD_NOT_FOUND",
-            value: PASSPORT_ERROR_CODES.E_IMPACK_GUARD_NOT_FOUND,
-            description: "verify() requires at least 1 impack=true Guard",
-        },
-        {
-            name: "E_TX_NOT_MATCH",
-            value: PASSPORT_ERROR_CODES.E_TX_NOT_MATCH,
-            description: "result() requires tx_hash match — Passport is tx-bound",
-        },
-        {
-            name: "E_DIGEST_NOT_MATCH",
-            value: PASSPORT_ERROR_CODES.E_DIGEST_NOT_MATCH,
-            description: "guard_add/verify/guard_clear require tx_hash match (write ops are tx-bound)",
-        },
-        {
-            name: "E_RELIES_GUARD_NOT_ADDED",
-            value: PASSPORT_ERROR_CODES.E_RELIES_GUARD_NOT_ADDED,
-            description: "Relied Guard must be added before the dependent Guard (topological order)",
-        },
-    ];
-}
-function buildRenderingHints(mode, max_length, hasImpack, hasRelies) {
-    return {
-        include_puzzle_template: mode === "initial_design",
-        include_risk_details: mode === "pre_verify" || mode === "stakeholder_review",
-        include_tx_hash_warning: mode === "pre_verify" || mode === "post_verify_use",
-        include_one_time_verify_warning: mode === "pre_verify",
-        include_impack_warning: hasImpack || mode === "pre_verify",
-        include_relies_warning: hasRelies,
-        max_length,
-    };
-}
-export function buildPromptFromPassportContext(bundle) {
-    const lines = [];
-    const h = bundle.rendering_hints;
-    lines.push(`═══ Passport Context (mode: ${bundle.mode}) ═══`);
-    lines.push("");
-    if (bundle.matched_scenario) {
-        lines.push(`Scenario: ${bundle.matched_scenario.name}`);
-        lines.push(`Consumer: ${bundle.matched_scenario.consumer_object} (${bundle.matched_scenario.sdk_entry})`);
-        lines.push(`Purpose: ${bundle.matched_scenario.passport_purpose}`);
-        lines.push(`Typical impack: ${bundle.matched_scenario.typical_impack}`);
-        lines.push(`Uses relies: ${bundle.matched_scenario.uses_relies}`);
-        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(`Blocks publish: ${bundle.risk_assessment.blocks_publish ? "YES" : "no"}`);
-        lines.push("");
-    }
-    if (h.include_tx_hash_warning) {
-        lines.push("⚠️ TX_HASH BINDING — Passport is bound to its creation transaction.");
-        lines.push("   All write operations (guard_add/verify) and result queries MUST happen in the same tx.");
-        lines.push("");
-    }
-    if (h.include_one_time_verify_warning) {
-        lines.push("⚠️ ONE-TIME VERIFY — verify() is irreversible. After verify, Guard config cannot be modified.");
-        lines.push("   Double-confirm all Guard selections and submission data before calling verify().");
-        lines.push("");
-    }
-    if (h.include_impack_warning) {
-        lines.push("⚠️ IMPACK MECHANISM — At least 1 impack=true Guard is required.");
-        lines.push("   impack Guard failing → overall result=false (immediate return).");
-        lines.push("   non-impack Guards only record per-Guard result, do NOT affect final result.");
-        lines.push("");
-    }
-    if (h.include_relies_warning) {
-        lines.push("⚠️ RELIES LOGIC — Guards with relies must be added in topological order.");
-        lines.push("   AND logic: all relies must pass (short-circuit on first false).");
-        lines.push("   OR logic: any rely may pass (short-circuit on first true).");
-        lines.push("   Transitive dependencies are NOT allowed (relied Guard cannot have its own relies).");
-        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, 6)) {
-            lines.push(`  [${ref.object}] ${ref.scenario_id}: ${ref.description}`);
-        }
-        if (bundle.cross_object_refs.length > 6) {
-            lines.push(`  ... and ${bundle.cross_object_refs.length - 6} more`);
-        }
-        lines.push("");
-    }
-    return lines.join("\n");
-}
-export function getPassportContextSummary(bundle) {
-    const parts = [
-        `mode=${bundle.mode}`,
-        `scenario=${bundle.matched_scenario?.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(", ");
-}
-export { PASSPORT_SCENARIOS, MAX_GUARD_COUNT_PASSPORT, MAX_SUBMISSION_SIZE_PASSPORT, PASSPORT_ERROR_CODES, findScenarioById, inferScenarioFromIntent, getAllScenarios, PASSPORT_TEMPLATES, getTemplateById, getTemplatesByScenario, suggestTemplateForScenario, SEMANTIC_TO_SCHEMA_RULES, PASSPORT_CONSTRAINT_RULES, matchSemanticPattern, explainPassport, passportJsonToSemantic, semanticToPassportJson, explainField, explainOp, explainImpack, explainReliesLogic, explainError, getConstraintsByCategory, getAllRiskRules, assessPassportRisks, initPuzzleFromIntent, checkPuzzleCompleteness, validateConstraints, buildPassportPuzzle, buildResultPuzzle, PASSPORT_CONFIRMATION_RULES, preCheckPassportCreation, preCheckPassportOperation, checkPassportStateConsistency, runPassportConfirmGate, PASSPORT_RISK_VERSION, PASSPORT_CONFIRM_VERSION, PASSPORT_TEMPLATES_VERSION, };
+import{PASSPORT_SCENARIOS,MAX_GUARD_COUNT_PASSPORT,MAX_SUBMISSION_SIZE_PASSPORT,PASSPORT_ERROR_CODES,findScenarioById,inferScenarioFromIntent,getAllScenarios}from'./passport-ledger.js';import{PASSPORT_TEMPLATES,PASSPORT_TEMPLATES_VERSION,getTemplateById,getTemplatesByScenario,suggestTemplateForScenario}from'./passport-templates.js';import{SEMANTIC_TO_SCHEMA_RULES,PASSPORT_CONSTRAINT_RULES,matchSemanticPattern,explainPassport,passportJsonToSemantic,semanticToPassportJson,explainField,explainOp,explainImpack,explainReliesLogic,explainError,getConstraintsByCategory}from'./passport-translation.js';import{getAllRiskRules,assessPassportRisks,PASSPORT_RISK_VERSION}from'./passport-risk.js';import{initPuzzleFromIntent,checkPuzzleCompleteness,validateConstraints,buildPassportPuzzle,buildResultPuzzle}from'./passport-puzzle.js';import{PASSPORT_CONFIRMATION_RULES,PASSPORT_CONFIRM_VERSION,preCheckPassportCreation,preCheckPassportOperation,checkPassportStateConsistency,runPassportConfirmGate,getAllConfirmationRules}from'./passport-confirm.js';export const PASSPORT_CONTEXT_VERSION='1.0.0';export function buildPassportContext(a){const b=a['max_length']??0xfa0;let c;a['intent']&&(c=inferScenarioFromIntent(a['intent']));if(!c&&a['target_consumer']){const p=getAllScenarios()['filter'](q=>q['consumer_object']===a['target_consumer']);if(p['length']>0x0)c=p[0x0];}let d;if(c){const q=suggestTemplateForScenario(c['id']);if(q)d=q;}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({'protected_operation':a['intent']}),g=checkPuzzleCompleteness(f));const h=filterRiskRules(a['mode'],a['stakeholder'],c);let i;if(a['mode']==='pre_verify'&&a['passport_state']){const s={'object':a['passport_state']['object'],'has_verified':a['passport_state']['has_verified'],'guard_count':a['passport_state']['info']['length'],'has_impack_guard':a['passport_state']['info']['some'](t=>t['impack']),'operation_type':'verify','constants_synced':!![],'knowledge_files_present':!![],'matched_scenario':c};i=assessPassportRisks(s);}const j=filterChecklist(a['mode']),k=buildCrossObjectRefs(c),l=buildOnchainConstraints(),m=a['passport_state']?.['info']['some'](t=>t['impack'])??![],n=a['passport_state']?.['info']['some'](t=>![])??![],o=buildRenderingHints(a['mode'],b,m,n);return{'version':PASSPORT_CONTEXT_VERSION,'mode':a['mode'],'stakeholder_perspective':a['stakeholder'],'matched_scenario':c,'matched_template':d,'matched_pattern':e,'puzzle_state':f,'puzzle_completeness':g,'relevant_risks':h,'risk_assessment':i,'relevant_checklist':j,'cross_object_refs':k,'onchain_constraints':l,'rendering_hints':o};}export const getPassportContext=buildPassportContext;function filterRiskRules(a,b,c){const d=getAllRiskRules();if(a==='initial_design')return d['filter'](e=>e['category']==='structural'||e['category']==='lifecycle');if(a==='pre_verify')return d;if(a==='stakeholder_review'&&b){if(b==='creator')return d['filter'](e=>e['category']==='lifecycle'||e['category']==='logic');if(b==='consumer')return d['filter'](e=>e['category']==='operational'||e['category']==='lifecycle');if(b==='guard_owner')return d['filter'](e=>e['category']==='logic');if(b==='system')return d['filter'](e=>e['category']==='knowledge'||e['category']==='operational');}return d;}function filterChecklist(a){if(a==='initial_design')return PASSPORT_CONFIRMATION_RULES['creation'];if(a==='pre_verify')return getAllConfirmationRules();if(a==='post_verify_use')return PASSPORT_CONFIRMATION_RULES['consistency'];return getAllConfirmationRules();}function buildCrossObjectRefs(a){const b=[];b['push']({'object':'Guard','field':'guard_objects','scenario_id':a?.['id']??'passport_generic','description':'Passport.guard\x20references\x20Guard\x20objects\x20for\x20verification\x20(guard::relies,\x20guard::verify_guard)'}),b['push']({'object':'Clock','field':'time','scenario_id':a?.['id']??'passport_generic','description':'Passport.time\x20=\x20clock::timestamp_ms(clock)\x20at\x20creation'}),b['push']({'object':'Transaction','field':'tx_hash','scenario_id':a?.['id']??'passport_generic','description':'Passport.tx_hash\x20=\x20tx_context::digest(ctx)\x20—\x20binds\x20Passport\x20to\x20its\x20creation\x20transaction'});a&&b['push']({'object':a['consumer_object'],'field':a['sdk_entry'],'scenario_id':a['id'],'description':a['name']+':\x20'+a['passport_purpose']});for(const c of PASSPORT_SCENARIOS){if(a&&c['id']===a['id'])continue;b['push']({'object':c['consumer_object'],'field':c['sdk_entry'],'scenario_id':c['id'],'description':c['name']+'\x20(alternative\x20consumer)'});}return b;}function buildOnchainConstraints(){return[{'name':'MAX_GUARD_COUNT_PASSPORT','value':MAX_GUARD_COUNT_PASSPORT,'description':'Maximum\x20Guard\x20count\x20per\x20Passport\x20(Move:\x20passport.move:9)'},{'name':'MAX_SUBMISSION_SIZE_PASSPORT','value':MAX_SUBMISSION_SIZE_PASSPORT,'description':'Maximum\x20serialized\x20byte\x20size\x20per\x20submission\x20entry\x20(Move:\x20passport.move:10)'},{'name':'E_GUARD_COUNT_EXCEEDED','value':PASSPORT_ERROR_CODES['E_GUARD_COUNT_EXCEEDED'],'description':'Guard\x20count\x20>\x2020\x20—\x20abort\x20guard_add'},{'name':'E_HAS_VERIFIED','value':PASSPORT_ERROR_CODES['E_HAS_VERIFIED'],'description':'verify()\x20one-time\x20—\x20aborts\x20guard_add/guard_clear/verify\x20if\x20already\x20verified'},{'name':'E_IMPACK_GUARD_NOT_FOUND','value':PASSPORT_ERROR_CODES['E_IMPACK_GUARD_NOT_FOUND'],'description':'verify()\x20requires\x20at\x20least\x201\x20impack=true\x20Guard'},{'name':'E_TX_NOT_MATCH','value':PASSPORT_ERROR_CODES['E_TX_NOT_MATCH'],'description':'result()\x20requires\x20tx_hash\x20match\x20—\x20Passport\x20is\x20tx-bound'},{'name':'E_DIGEST_NOT_MATCH','value':PASSPORT_ERROR_CODES['E_DIGEST_NOT_MATCH'],'description':'guard_add/verify/guard_clear\x20require\x20tx_hash\x20match\x20(write\x20ops\x20are\x20tx-bound)'},{'name':'E_RELIES_GUARD_NOT_ADDED','value':PASSPORT_ERROR_CODES['E_RELIES_GUARD_NOT_ADDED'],'description':'Relied\x20Guard\x20must\x20be\x20added\x20before\x20the\x20dependent\x20Guard\x20(topological\x20order)'}];}function buildRenderingHints(a,b,c,d){return{'include_puzzle_template':a==='initial_design','include_risk_details':a==='pre_verify'||a==='stakeholder_review','include_tx_hash_warning':a==='pre_verify'||a==='post_verify_use','include_one_time_verify_warning':a==='pre_verify','include_impack_warning':c||a==='pre_verify','include_relies_warning':d,'max_length':b};}export function buildPromptFromPassportContext(a){const b=[],d=a['rendering_hints'];b['push']('═══\x20Passport\x20Context\x20(mode:\x20'+a['mode']+')\x20═══'),b['push']('');a['matched_scenario']&&(b['push']('Scenario:\x20'+a['matched_scenario']['name']),b['push']('Consumer:\x20'+a['matched_scenario']['consumer_object']+'\x20('+a['matched_scenario']['sdk_entry']+')'),b['push']('Purpose:\x20'+a['matched_scenario']['passport_purpose']),b['push']('Typical\x20impack:\x20'+a['matched_scenario']['typical_impack']),b['push']('Uses\x20relies:\x20'+a['matched_scenario']['uses_relies']),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']('Blocks\x20publish:\x20'+(a['risk_assessment']['blocks_publish']?'YES':'no')),b['push'](''));d['include_tx_hash_warning']&&(b['push']('⚠️\x20TX_HASH\x20BINDING\x20—\x20Passport\x20is\x20bound\x20to\x20its\x20creation\x20transaction.'),b['push']('\x20\x20\x20All\x20write\x20operations\x20(guard_add/verify)\x20and\x20result\x20queries\x20MUST\x20happen\x20in\x20the\x20same\x20tx.'),b['push'](''));d['include_one_time_verify_warning']&&(b['push']('⚠️\x20ONE-TIME\x20VERIFY\x20—\x20verify()\x20is\x20irreversible.\x20After\x20verify,\x20Guard\x20config\x20cannot\x20be\x20modified.'),b['push']('\x20\x20\x20Double-confirm\x20all\x20Guard\x20selections\x20and\x20submission\x20data\x20before\x20calling\x20verify().'),b['push'](''));d['include_impack_warning']&&(b['push']('⚠️\x20IMPACK\x20MECHANISM\x20—\x20At\x20least\x201\x20impack=true\x20Guard\x20is\x20required.'),b['push']('\x20\x20\x20impack\x20Guard\x20failing\x20→\x20overall\x20result=false\x20(immediate\x20return).'),b['push']('\x20\x20\x20non-impack\x20Guards\x20only\x20record\x20per-Guard\x20result,\x20do\x20NOT\x20affect\x20final\x20result.'),b['push'](''));d['include_relies_warning']&&(b['push']('⚠️\x20RELIES\x20LOGIC\x20—\x20Guards\x20with\x20relies\x20must\x20be\x20added\x20in\x20topological\x20order.'),b['push']('\x20\x20\x20AND\x20logic:\x20all\x20relies\x20must\x20pass\x20(short-circuit\x20on\x20first\x20false).'),b['push']('\x20\x20\x20OR\x20logic:\x20any\x20rely\x20may\x20pass\x20(short-circuit\x20on\x20first\x20true).'),b['push']('\x20\x20\x20Transitive\x20dependencies\x20are\x20NOT\x20allowed\x20(relied\x20Guard\x20cannot\x20have\x20its\x20own\x20relies).'),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,0x6)){b['push']('\x20\x20['+i['object']+']\x20'+i['scenario_id']+':\x20'+i['description']);}a['cross_object_refs']['length']>0x6&&b['push']('\x20\x20...\x20and\x20'+(a['cross_object_refs']['length']-0x6)+'\x20more'),b['push']('');}return b['join']('\x0a');}export function getPassportContextSummary(a){const b=['mode='+a['mode'],'scenario='+(a['matched_scenario']?.['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');}export{PASSPORT_SCENARIOS,MAX_GUARD_COUNT_PASSPORT,MAX_SUBMISSION_SIZE_PASSPORT,PASSPORT_ERROR_CODES,findScenarioById,inferScenarioFromIntent,getAllScenarios,PASSPORT_TEMPLATES,getTemplateById,getTemplatesByScenario,suggestTemplateForScenario,SEMANTIC_TO_SCHEMA_RULES,PASSPORT_CONSTRAINT_RULES,matchSemanticPattern,explainPassport,passportJsonToSemantic,semanticToPassportJson,explainField,explainOp,explainImpack,explainReliesLogic,explainError,getConstraintsByCategory,getAllRiskRules,assessPassportRisks,initPuzzleFromIntent,checkPuzzleCompleteness,validateConstraints,buildPassportPuzzle,buildResultPuzzle,PASSPORT_CONFIRMATION_RULES,preCheckPassportCreation,preCheckPassportOperation,checkPassportStateConsistency,runPassportConfirmGate,PASSPORT_RISK_VERSION,PASSPORT_CONFIRM_VERSION,PASSPORT_TEMPLATES_VERSION};

package/dist/knowledge/passport-ledger.js

@@ -1,282 +1 @@
-import { MAX_GUARD_COUNT_PASSPORT, MAX_SUBMISSION_SIZE_PASSPORT, } from "@wowok/wowok";
-export { MAX_GUARD_COUNT_PASSPORT };
-export { MAX_SUBMISSION_SIZE_PASSPORT };
-export const PASSPORT_ERROR_CODES = {
-    E_GUARD_COUNT_EXCEEDED: 1,
-    E_RELIES_GUARD_NOT_ADDED: 2,
-    E_SUBMISSION_SIZE_EXCEEDED: 3,
-    E_HAS_VERIFIED: 4,
-    E_NOT_VERIFIED: 5,
-    E_NOT_IMPACK_GUARD: 6,
-    E_VERIFY_FAILED: 7,
-    E_TX_NOT_MATCH: 8,
-    E_IMPACK_GUARD_NOT_FOUND: 9,
-    E_SUBMISSION_NOT_FOUND: 10,
-    E_DIGEST_NOT_MATCH: 11,
-};
-export const PASSPORT_SCENARIOS = [
-    {
-        id: "passport_service_buy",
-        name: "Service buy with Passport (verify buy_guard)",
-        consumer_object: "Service",
-        sdk_entry: "buy_with_passport",
-        passport_purpose: "Verify customer's eligibility to buy (buy_guard)",
-        typical_impack: "impack",
-        uses_relies: false,
-        lifecycle_stage: "use",
-        participants: ["customer", "merchant"],
-        risk_notes: [
-            "tx_hash binding requires Passport creation + buy in the same transaction",
-            "Service.buy_guard is typically configured as impack=true",
-        ],
-        dependencies: ["Service", "Guard"],
-    },
-    {
-        id: "passport_arbitration_compensation",
-        name: "Order arbitration compensation (verify arb permission)",
-        consumer_object: "Order",
-        sdk_entry: "arb_claim_compensation_with_passport",
-        passport_purpose: "Verify customer's right to claim arbitration compensation",
-        typical_impack: "impack",
-        uses_relies: false,
-        lifecycle_stage: "use",
-        participants: ["customer", "arbitrator"],
-        risk_notes: [
-            "Compensation is one-shot — Passport.tx_hash prevents replay",
-            "result_for_guard hard-verifies the impack Guard (E_VERIFY_FAILED if mismatch)",
-        ],
-        dependencies: ["Order", "Arbitration", "Guard"],
-    },
-    {
-        id: "passport_progress_next",
-        name: "Progress advance (verify Forward.guard)",
-        consumer_object: "Progress",
-        sdk_entry: "next_with_passport",
-        passport_purpose: "Verify that the next node's Forward.guard passes before advancing",
-        typical_impack: "impack",
-        uses_relies: true,
-        lifecycle_stage: "use",
-        participants: ["customer", "merchant"],
-        risk_notes: [
-            "Forward.guard may have relies on previous node Guards (AND/OR logic)",
-            "Relies Guards MUST be added in topological order (E_RELIES_GUARD_NOT_ADDED)",
-        ],
-        dependencies: ["Progress", "Machine", "Guard"],
-    },
-    {
-        id: "passport_arbitration_dispute",
-        name: "Arbitration dispute (verify usage_guard)",
-        consumer_object: "Arbitration",
-        sdk_entry: "dispute_with_passport",
-        passport_purpose: "Verify usage_guard before opening a dispute case",
-        typical_impack: "impack",
-        uses_relies: false,
-        lifecycle_stage: "use",
-        participants: ["customer", "arbitrator"],
-        risk_notes: [
-            "Arbitration.usage_guard determines who may open disputes",
-            "Dispute must be filed within the same transaction that created the Passport",
-        ],
-        dependencies: ["Arbitration", "Guard"],
-    },
-    {
-        id: "passport_arbitration_vote",
-        name: "Arbitration vote (resolve VoteValue::GuardIdentifier weight)",
-        consumer_object: "Arbitration",
-        sdk_entry: "vote_with_voting_guard",
-        passport_purpose: "Resolve voting weight from Passport submission (GuardIdentifier)",
-        typical_impack: "impack",
-        uses_relies: false,
-        lifecycle_stage: "use",
-        participants: ["arbitrator"],
-        risk_notes: [
-            "Voting weight is read via submission_get(guard, identifier)",
-            "Identifier type must match the voting_guard's expected type",
-        ],
-        dependencies: ["Arbitration", "Guard"],
-    },
-    {
-        id: "passport_reward_claim",
-        name: "Reward claim (verify Guard + resolve recipient/amount)",
-        consumer_object: "Reward",
-        sdk_entry: "claim_with_passport",
-        passport_purpose: "Verify claim eligibility and resolve dynamic recipient/amount from submission",
-        typical_impack: "impack",
-        uses_relies: false,
-        lifecycle_stage: "use",
-        participants: ["customer"],
-        risk_notes: [
-            "Guard may use GuardIdentifier to dynamically resolve recipient address",
-            "Claim is one-shot per Passport (tx_hash binding prevents replay)",
-        ],
-        dependencies: ["Reward", "Guard"],
-    },
-    {
-        id: "passport_permission_assert",
-        name: "Permission assert (Guard verification replaces owner check)",
-        consumer_object: "Permission",
-        sdk_entry: "assert_with_passport",
-        passport_purpose: "Use Guard verification as a dynamic substitute for static owner/admin check",
-        typical_impack: "impack",
-        uses_relies: true,
-        lifecycle_stage: "use",
-        participants: ["customer", "platform"],
-        risk_notes: [
-            "Allows composing multi-factor authorization via relies logic",
-            "Permission assert bypass requires the Passport to be verified in the same tx",
-        ],
-        dependencies: ["Permission", "Guard"],
-    },
-    {
-        id: "passport_allocation_alloc",
-        name: "Allocation distribute (verify alloc permission via Guard)",
-        consumer_object: "Allocation",
-        sdk_entry: "alloc_with_passport",
-        passport_purpose: "Verify the caller's right to trigger allocation distribution",
-        typical_impack: "impack",
-        uses_relies: false,
-        lifecycle_stage: "use",
-        participants: ["customer", "merchant"],
-        risk_notes: [
-            "Caller-specified guard: Passport must contain the specific Guard referenced by alloc_by_guard",
-            "result_for_guard hard-verifies (E_VERIFY_FAILED if the impack Guard fails)",
-        ],
-        dependencies: ["Allocation", "Guard"],
-    },
-    {
-        id: "passport_treasury_withdraw",
-        name: "Treasury withdraw (verify withdraw permission)",
-        consumer_object: "Treasury",
-        sdk_entry: "withdraw_with_passport",
-        passport_purpose: "Verify the caller's right to withdraw funds from Treasury",
-        typical_impack: "impack",
-        uses_relies: false,
-        lifecycle_stage: "use",
-        participants: ["customer", "platform"],
-        risk_notes: [
-            "Treasury withdraw is high-value — strongly recommend multi-Guard relies (AND)",
-            "Guard should bind Signer to prevent unauthorized withdraw",
-        ],
-        dependencies: ["Treasury", "Guard"],
-    },
-    {
-        id: "passport_repository_query",
-        name: "Repository query (verify read permission + extract data)",
-        consumer_object: "Repository",
-        sdk_entry: "query_with_passport",
-        passport_purpose: "Verify read permission and extract submission data for repository write",
-        typical_impack: "impack",
-        uses_relies: false,
-        lifecycle_stage: "use",
-        participants: ["customer", "merchant"],
-        risk_notes: [
-            "Repository policies may extract data from Passport submission (quote_guard pattern)",
-            "Submitted data must be ≤ 256 bytes per submission entry",
-        ],
-        dependencies: ["Repository", "Guard"],
-    },
-    {
-        id: "passport_demand_submit",
-        name: "Demand submit (verify demand permission)",
-        consumer_object: "Demand",
-        sdk_entry: "demand_with_passport",
-        passport_purpose: "Verify the caller's right to submit or match a Demand",
-        typical_impack: "impack",
-        uses_relies: false,
-        lifecycle_stage: "use",
-        participants: ["customer", "merchant"],
-        risk_notes: [
-            "Demand.guard may filter which submissions are eligible for matching",
-            "Demand uses MAX_GUARD_COUNT_DEMAND=20 (separate constant, do not confuse)",
-        ],
-        dependencies: ["Demand", "Guard"],
-    },
-];
-export const PASSPORT_LEDGER_VERSION = "1.0.0";
-export function getAllScenarios() {
-    return [...PASSPORT_SCENARIOS];
-}
-export function getScenariosCount() {
-    return PASSPORT_SCENARIOS.length;
-}
-export function findScenarioById(id) {
-    return PASSPORT_SCENARIOS.find(s => s.id === id);
-}
-export function getScenariosByConsumer(consumer) {
-    return PASSPORT_SCENARIOS.filter(s => s.consumer_object === consumer);
-}
-export function getScenariosUsingRelies() {
-    return PASSPORT_SCENARIOS.filter(s => s.uses_relies);
-}
-export function inferScenarioFromIntent(intent) {
-    const lower = intent.toLowerCase();
-    if (lower.includes("buy") || lower.includes("purchase") || lower.includes("service")) {
-        return findScenarioById("passport_service_buy");
-    }
-    if (lower.includes("compensation") || lower.includes("compensate") || lower.includes("arb_claim")) {
-        return findScenarioById("passport_arbitration_compensation");
-    }
-    if (lower.includes("progress") || lower.includes("advance") || lower.includes("next")) {
-        return findScenarioById("passport_progress_next");
-    }
-    if (lower.includes("dispute") || lower.includes("grievance")) {
-        return findScenarioById("passport_arbitration_dispute");
-    }
-    if (lower.includes("vote") || lower.includes("ballot") || lower.includes("voting")) {
-        return findScenarioById("passport_arbitration_vote");
-    }
-    if (lower.includes("reward") || lower.includes("claim") || lower.includes("redeem") || lower.includes("bonus")) {
-        return findScenarioById("passport_reward_claim");
-    }
-    if (lower.includes("permission") || lower.includes("assert") || lower.includes("authorize")) {
-        return findScenarioById("passport_permission_assert");
-    }
-    if (lower.includes("alloc") || lower.includes("distribute") || lower.includes("distribution")) {
-        return findScenarioById("passport_allocation_alloc");
-    }
-    if (lower.includes("withdraw") || lower.includes("extract") || lower.includes("treasury")) {
-        return findScenarioById("passport_treasury_withdraw");
-    }
-    if (lower.includes("repository") || lower.includes("query") || lower.includes("lookup")) {
-        return findScenarioById("passport_repository_query");
-    }
-    if (lower.includes("demand") || lower.includes("requirement")) {
-        return findScenarioById("passport_demand_submit");
-    }
-    return undefined;
-}
-export function impackRoleFromBoolean(impack) {
-    return impack ? "impack" : "non_impack";
-}
-export function impackRoleToBoolean(role) {
-    return role === "impack";
-}
-export function reliesLogicFromBoolean(relies_logic_and) {
-    return relies_logic_and ? "AND" : "OR";
-}
-export function reliesLogicToBoolean(logic) {
-    return logic === "AND";
-}
-export function getErrorName(code) {
-    for (const [name, c] of Object.entries(PASSPORT_ERROR_CODES)) {
-        if (c === code)
-            return name;
-    }
-    return undefined;
-}
-export function getErrorDescription(code) {
-    const descriptions = {
-        1: "Guard count exceeds MAX_GUARD_COUNT_PASSPORT (20)",
-        2: "Relied Guard not yet added to Passport (topological order required)",
-        3: "Submission serialized size exceeds MAX_SUBMISSION_SIZE_PASSPORT (256 bytes)",
-        4: "Passport already verified — verify is one-time, configuration is now immutable",
-        5: "result() called before verify() — Passport has not been verified yet",
-        6: "result_for_guard called on a non-impack Guard — only impack Guards can be hard-verified",
-        7: "result_for_guard / result_for_permission called when overall result=false",
-        8: "result() called from a different transaction — tx_hash does not match current tx",
-        9: "verify() found no impack Guard — at least 1 impack=true Guard is required",
-        10: "submission_get found no entry for the (guard, identifier) pair",
-        11: "guard_add / verify / guard_clear called from a different transaction — tx_hash mismatch",
-    };
-    return descriptions[code];
-}
+import{MAX_GUARD_COUNT_PASSPORT,MAX_SUBMISSION_SIZE_PASSPORT}from'@wowok/wowok';export{MAX_GUARD_COUNT_PASSPORT};export{MAX_SUBMISSION_SIZE_PASSPORT};export const PASSPORT_ERROR_CODES={'E_GUARD_COUNT_EXCEEDED':0x1,'E_RELIES_GUARD_NOT_ADDED':0x2,'E_SUBMISSION_SIZE_EXCEEDED':0x3,'E_HAS_VERIFIED':0x4,'E_NOT_VERIFIED':0x5,'E_NOT_IMPACK_GUARD':0x6,'E_VERIFY_FAILED':0x7,'E_TX_NOT_MATCH':0x8,'E_IMPACK_GUARD_NOT_FOUND':0x9,'E_SUBMISSION_NOT_FOUND':0xa,'E_DIGEST_NOT_MATCH':0xb};export const PASSPORT_SCENARIOS=[{'id':'passport_service_buy','name':'Service\x20buy\x20with\x20Passport\x20(verify\x20buy_guard)','consumer_object':'Service','sdk_entry':'buy_with_passport','passport_purpose':'Verify\x20customer\x27s\x20eligibility\x20to\x20buy\x20(buy_guard)','typical_impack':'impack','uses_relies':![],'lifecycle_stage':'use','participants':['customer','merchant'],'risk_notes':['tx_hash\x20binding\x20requires\x20Passport\x20creation\x20+\x20buy\x20in\x20the\x20same\x20transaction','Service.buy_guard\x20is\x20typically\x20configured\x20as\x20impack=true'],'dependencies':['Service','Guard']},{'id':'passport_arbitration_compensation','name':'Order\x20arbitration\x20compensation\x20(verify\x20arb\x20permission)','consumer_object':'Order','sdk_entry':'arb_claim_compensation_with_passport','passport_purpose':'Verify\x20customer\x27s\x20right\x20to\x20claim\x20arbitration\x20compensation','typical_impack':'impack','uses_relies':![],'lifecycle_stage':'use','participants':['customer','arbitrator'],'risk_notes':['Compensation\x20is\x20one-shot\x20—\x20Passport.tx_hash\x20prevents\x20replay','result_for_guard\x20hard-verifies\x20the\x20impack\x20Guard\x20(E_VERIFY_FAILED\x20if\x20mismatch)'],'dependencies':['Order','Arbitration','Guard']},{'id':'passport_progress_next','name':'Progress\x20advance\x20(verify\x20Forward.guard)','consumer_object':'Progress','sdk_entry':'next_with_passport','passport_purpose':'Verify\x20that\x20the\x20next\x20node\x27s\x20Forward.guard\x20passes\x20before\x20advancing','typical_impack':'impack','uses_relies':!![],'lifecycle_stage':'use','participants':['customer','merchant'],'risk_notes':['Forward.guard\x20may\x20have\x20relies\x20on\x20previous\x20node\x20Guards\x20(AND/OR\x20logic)','Relies\x20Guards\x20MUST\x20be\x20added\x20in\x20topological\x20order\x20(E_RELIES_GUARD_NOT_ADDED)'],'dependencies':['Progress','Machine','Guard']},{'id':'passport_arbitration_dispute','name':'Arbitration\x20dispute\x20(verify\x20usage_guard)','consumer_object':'Arbitration','sdk_entry':'dispute_with_passport','passport_purpose':'Verify\x20usage_guard\x20before\x20opening\x20a\x20dispute\x20case','typical_impack':'impack','uses_relies':![],'lifecycle_stage':'use','participants':['customer','arbitrator'],'risk_notes':['Arbitration.usage_guard\x20determines\x20who\x20may\x20open\x20disputes','Dispute\x20must\x20be\x20filed\x20within\x20the\x20same\x20transaction\x20that\x20created\x20the\x20Passport'],'dependencies':['Arbitration','Guard']},{'id':'passport_arbitration_vote','name':'Arbitration\x20vote\x20(resolve\x20VoteValue::GuardIdentifier\x20weight)','consumer_object':'Arbitration','sdk_entry':'vote_with_voting_guard','passport_purpose':'Resolve\x20voting\x20weight\x20from\x20Passport\x20submission\x20(GuardIdentifier)','typical_impack':'impack','uses_relies':![],'lifecycle_stage':'use','participants':['arbitrator'],'risk_notes':['Voting\x20weight\x20is\x20read\x20via\x20submission_get(guard,\x20identifier)','Identifier\x20type\x20must\x20match\x20the\x20voting_guard\x27s\x20expected\x20type'],'dependencies':['Arbitration','Guard']},{'id':'passport_reward_claim','name':'Reward\x20claim\x20(verify\x20Guard\x20+\x20resolve\x20recipient/amount)','consumer_object':'Reward','sdk_entry':'claim_with_passport','passport_purpose':'Verify\x20claim\x20eligibility\x20and\x20resolve\x20dynamic\x20recipient/amount\x20from\x20submission','typical_impack':'impack','uses_relies':![],'lifecycle_stage':'use','participants':['customer'],'risk_notes':['Guard\x20may\x20use\x20GuardIdentifier\x20to\x20dynamically\x20resolve\x20recipient\x20address','Claim\x20is\x20one-shot\x20per\x20Passport\x20(tx_hash\x20binding\x20prevents\x20replay)'],'dependencies':['Reward','Guard']},{'id':'passport_permission_assert','name':'Permission\x20assert\x20(Guard\x20verification\x20replaces\x20owner\x20check)','consumer_object':'Permission','sdk_entry':'assert_with_passport','passport_purpose':'Use\x20Guard\x20verification\x20as\x20a\x20dynamic\x20substitute\x20for\x20static\x20owner/admin\x20check','typical_impack':'impack','uses_relies':!![],'lifecycle_stage':'use','participants':['customer','platform'],'risk_notes':['Allows\x20composing\x20multi-factor\x20authorization\x20via\x20relies\x20logic','Permission\x20assert\x20bypass\x20requires\x20the\x20Passport\x20to\x20be\x20verified\x20in\x20the\x20same\x20tx'],'dependencies':['Permission','Guard']},{'id':'passport_allocation_alloc','name':'Allocation\x20distribute\x20(verify\x20alloc\x20permission\x20via\x20Guard)','consumer_object':'Allocation','sdk_entry':'alloc_with_passport','passport_purpose':'Verify\x20the\x20caller\x27s\x20right\x20to\x20trigger\x20allocation\x20distribution','typical_impack':'impack','uses_relies':![],'lifecycle_stage':'use','participants':['customer','merchant'],'risk_notes':['Caller-specified\x20guard:\x20Passport\x20must\x20contain\x20the\x20specific\x20Guard\x20referenced\x20by\x20alloc_by_guard','result_for_guard\x20hard-verifies\x20(E_VERIFY_FAILED\x20if\x20the\x20impack\x20Guard\x20fails)'],'dependencies':['Allocation','Guard']},{'id':'passport_treasury_withdraw','name':'Treasury\x20withdraw\x20(verify\x20withdraw\x20permission)','consumer_object':'Treasury','sdk_entry':'withdraw_with_passport','passport_purpose':'Verify\x20the\x20caller\x27s\x20right\x20to\x20withdraw\x20funds\x20from\x20Treasury','typical_impack':'impack','uses_relies':![],'lifecycle_stage':'use','participants':['customer','platform'],'risk_notes':['Treasury\x20withdraw\x20is\x20high-value\x20—\x20strongly\x20recommend\x20multi-Guard\x20relies\x20(AND)','Guard\x20should\x20bind\x20Signer\x20to\x20prevent\x20unauthorized\x20withdraw'],'dependencies':['Treasury','Guard']},{'id':'passport_repository_query','name':'Repository\x20query\x20(verify\x20read\x20permission\x20+\x20extract\x20data)','consumer_object':'Repository','sdk_entry':'query_with_passport','passport_purpose':'Verify\x20read\x20permission\x20and\x20extract\x20submission\x20data\x20for\x20repository\x20write','typical_impack':'impack','uses_relies':![],'lifecycle_stage':'use','participants':['customer','merchant'],'risk_notes':['Repository\x20policies\x20may\x20extract\x20data\x20from\x20Passport\x20submission\x20(quote_guard\x20pattern)','Submitted\x20data\x20must\x20be\x20≤\x20256\x20bytes\x20per\x20submission\x20entry'],'dependencies':['Repository','Guard']},{'id':'passport_demand_submit','name':'Demand\x20submit\x20(verify\x20demand\x20permission)','consumer_object':'Demand','sdk_entry':'demand_with_passport','passport_purpose':'Verify\x20the\x20caller\x27s\x20right\x20to\x20submit\x20or\x20match\x20a\x20Demand','typical_impack':'impack','uses_relies':![],'lifecycle_stage':'use','participants':['customer','merchant'],'risk_notes':['Demand.guard\x20may\x20filter\x20which\x20submissions\x20are\x20eligible\x20for\x20matching','Demand\x20uses\x20MAX_GUARD_COUNT_DEMAND=20\x20(separate\x20constant,\x20do\x20not\x20confuse)'],'dependencies':['Demand','Guard']}];export const PASSPORT_LEDGER_VERSION='1.0.0';export function getAllScenarios(){return[...PASSPORT_SCENARIOS];}export function getScenariosCount(){return PASSPORT_SCENARIOS['length'];}export function findScenarioById(a){return PASSPORT_SCENARIOS['find'](b=>b['id']===a);}export function getScenariosByConsumer(a){return PASSPORT_SCENARIOS['filter'](b=>b['consumer_object']===a);}export function getScenariosUsingRelies(){return PASSPORT_SCENARIOS['filter'](a=>a['uses_relies']);}export function inferScenarioFromIntent(a){const b=a['toLowerCase']();if(b['includes']('buy')||b['includes']('purchase')||b['includes']('service'))return findScenarioById('passport_service_buy');if(b['includes']('compensation')||b['includes']('compensate')||b['includes']('arb_claim'))return findScenarioById('passport_arbitration_compensation');if(b['includes']('progress')||b['includes']('advance')||b['includes']('next'))return findScenarioById('passport_progress_next');if(b['includes']('dispute')||b['includes']('grievance'))return findScenarioById('passport_arbitration_dispute');if(b['includes']('vote')||b['includes']('ballot')||b['includes']('voting'))return findScenarioById('passport_arbitration_vote');if(b['includes']('reward')||b['includes']('claim')||b['includes']('redeem')||b['includes']('bonus'))return findScenarioById('passport_reward_claim');if(b['includes']('permission')||b['includes']('assert')||b['includes']('authorize'))return findScenarioById('passport_permission_assert');if(b['includes']('alloc')||b['includes']('distribute')||b['includes']('distribution'))return findScenarioById('passport_allocation_alloc');if(b['includes']('withdraw')||b['includes']('extract')||b['includes']('treasury'))return findScenarioById('passport_treasury_withdraw');if(b['includes']('repository')||b['includes']('query')||b['includes']('lookup'))return findScenarioById('passport_repository_query');if(b['includes']('demand')||b['includes']('requirement'))return findScenarioById('passport_demand_submit');return undefined;}export function impackRoleFromBoolean(a){return a?'impack':'non_impack';}export function impackRoleToBoolean(a){return a==='impack';}export function reliesLogicFromBoolean(a){return a?'AND':'OR';}export function reliesLogicToBoolean(a){return a==='AND';}export function getErrorName(a){for(const [b,d]of Object['entries'](PASSPORT_ERROR_CODES)){if(d===a)return b;}return undefined;}export function getErrorDescription(a){const b={0x1:'Guard\x20count\x20exceeds\x20MAX_GUARD_COUNT_PASSPORT\x20(20)',0x2:'Relied\x20Guard\x20not\x20yet\x20added\x20to\x20Passport\x20(topological\x20order\x20required)',0x3:'Submission\x20serialized\x20size\x20exceeds\x20MAX_SUBMISSION_SIZE_PASSPORT\x20(256\x20bytes)',0x4:'Passport\x20already\x20verified\x20—\x20verify\x20is\x20one-time,\x20configuration\x20is\x20now\x20immutable',0x5:'result()\x20called\x20before\x20verify()\x20—\x20Passport\x20has\x20not\x20been\x20verified\x20yet',0x6:'result_for_guard\x20called\x20on\x20a\x20non-impack\x20Guard\x20—\x20only\x20impack\x20Guards\x20can\x20be\x20hard-verified',0x7:'result_for_guard\x20/\x20result_for_permission\x20called\x20when\x20overall\x20result=false',0x8:'result()\x20called\x20from\x20a\x20different\x20transaction\x20—\x20tx_hash\x20does\x20not\x20match\x20current\x20tx',0x9:'verify()\x20found\x20no\x20impack\x20Guard\x20—\x20at\x20least\x201\x20impack=true\x20Guard\x20is\x20required',0xa:'submission_get\x20found\x20no\x20entry\x20for\x20the\x20(guard,\x20identifier)\x20pair',0xb:'guard_add\x20/\x20verify\x20/\x20guard_clear\x20called\x20from\x20a\x20different\x20transaction\x20—\x20tx_hash\x20mismatch'};return b[a];}