@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/knowledge/reward-confirm.js

@@ -1,526 +1 @@
-import { MAX_GUARD_COUNT_REWARD, MAX_RECORD_COUNT_REWARD, } from "./onchain-constants.js";
-import { assessRewardRisks, } from "./reward-risk.js";
-export const REWARD_OPERATION_CHECKLIST = [
-    { id: "C-R-01", description: "guard_add count < MAX_GUARD_COUNT_REWARD (200)", passed: false, message: "" },
-    { id: "C-R-02", description: "Per-recipient record count < MAX_RECORD_COUNT_REWARD (5200)", passed: false, message: "" },
-    { id: "C-R-03", description: "claim: balance ≥ amount (E_INSUFFICIENT_BALANCE)", passed: false, message: "" },
-    { id: "C-R-04", description: "guard_add: clock > guard_not_added_expiration_time (if Some)", passed: false, message: "" },
-    { id: "C-R-05", description: "guard_add / claim: clock ≤ guard.expiration_time (if Some)", passed: false, message: "" },
-    { id: "C-R-06", description: "guard_add: valid Recipient × Amount pairing (6 constructors)", passed: false, message: "" },
-    { id: "C-R-07", description: "coin_add: coin type T matches Reward<T>", passed: false, message: "" },
-    { id: "C-R-08", description: "claim: Passport is provided (SDK W_ERROR if missing)", passed: false, message: "" },
-    { id: "C-R-09", description: "owner_receive (156): user double-confirms blast radius", passed: false, message: "" },
-    { id: "C-R-10", description: "guard_expiration_time_add (155): new time > current clock", passed: false, message: "" },
-    { id: "C-R-11", description: "guard_add: Guard's progress.current expected value matches business intent (praise→wonder, completion→completed)", passed: false, message: "" },
-];
-function runStaticChecklist(input) {
-    const items = REWARD_OPERATION_CHECKLIST.map(c => ({ ...c }));
-    const data = input.reward_json;
-    const cr01 = items.find(i => i.id === "C-R-01");
-    if (data.guard_add && data.guard_add.length > 0) {
-        const current = input.current_guard_count ?? 0;
-        if (current + data.guard_add.length > MAX_GUARD_COUNT_REWARD) {
-            cr01.passed = false;
-            cr01.message = `${current + data.guard_add.length} > ${MAX_GUARD_COUNT_REWARD}`;
-        }
-        else {
-            cr01.passed = true;
-        }
-    }
-    else {
-        cr01.passed = true;
-    }
-    const cr02 = items.find(i => i.id === "C-R-02");
-    if (data.claim) {
-        const records = input.current_record_count_for_recipient ?? 0;
-        if (records >= MAX_RECORD_COUNT_REWARD) {
-            cr02.passed = false;
-            cr02.message = `${records} ≥ ${MAX_RECORD_COUNT_REWARD}`;
-        }
-        else {
-            cr02.passed = true;
-        }
-    }
-    else {
-        cr02.passed = true;
-    }
-    const cr03 = items.find(i => i.id === "C-R-03");
-    if (data.claim && input.current_balance !== undefined) {
-        const balance = BigInt(input.current_balance);
-        if (balance === 0n) {
-            cr03.passed = false;
-            cr03.message = `balance=0 — claim will abort E_INSUFFICIENT_BALANCE`;
-        }
-        else {
-            cr03.passed = true;
-        }
-    }
-    else {
-        cr03.passed = true;
-    }
-    const cr04 = items.find(i => i.id === "C-R-04");
-    if (data.guard_add && data.guard_add.length > 0 && input.current_guard_not_added_expiration_time != null) {
-        const clock = input.current_clock_ms ?? Date.now();
-        if (clock <= input.current_guard_not_added_expiration_time) {
-            cr04.passed = false;
-            cr04.message = `clock ${clock} ≤ lock ${input.current_guard_not_added_expiration_time}`;
-        }
-        else {
-            cr04.passed = true;
-        }
-    }
-    else {
-        cr04.passed = true;
-    }
-    const cr05 = items.find(i => i.id === "C-R-05");
-    cr05.passed = true;
-    const cr06 = items.find(i => i.id === "C-R-06");
-    if (data.guard_add) {
-        const validRecipientKeys = ["GuardIdentifier", "Entity", "Signer"];
-        const validAmountTypes = ["Fixed", "GuardU64Identifier", "GUARDU64IDENTIFIER", "GUARD_U64_IDENTIFIER"];
-        let allValid = true;
-        for (const g of data.guard_add) {
-            const rKeys = Object.keys(g.recipient);
-            if (rKeys.length !== 1 || !validRecipientKeys.includes(rKeys[0])) {
-                allValid = false;
-                break;
-            }
-            if (!validAmountTypes.includes(String(g.amount.type).toUpperCase())) {
-                allValid = false;
-                break;
-            }
-        }
-        cr06.passed = allValid;
-        cr06.message = allValid ? "" : "Invalid Recipient × Amount pairing";
-    }
-    else {
-        cr06.passed = true;
-    }
-    const cr07 = items.find(i => i.id === "C-R-07");
-    if (data.coin_add && input.reward_type) {
-        cr07.passed = data.coin_add.coin_type === input.reward_type;
-        cr07.message = cr07.passed ? "" : `${data.coin_add.coin_type} ≠ ${input.reward_type}`;
-    }
-    else {
-        cr07.passed = true;
-    }
-    const cr08 = items.find(i => i.id === "C-R-08");
-    if (data.claim) {
-        cr08.passed = true;
-        cr08.message = "Passport presence verified by SDK operate()";
-    }
-    else {
-        cr08.passed = true;
-    }
-    const cr09 = items.find(i => i.id === "C-R-09");
-    if (data.owner_receive != null) {
-        cr09.passed = false;
-        cr09.message = "Pending user confirmation in L3 (QRW3)";
-    }
-    else {
-        cr09.passed = true;
-    }
-    const cr10 = items.find(i => i.id === "C-R-10");
-    if (data.guard_expiration_time !== undefined && data.guard_expiration_time !== null) {
-        const clock = input.current_clock_ms ?? Date.now();
-        if (data.guard_expiration_time <= clock) {
-            cr10.passed = false;
-            cr10.message = `${data.guard_expiration_time} ≤ clock ${clock}`;
-        }
-        else {
-            cr10.passed = true;
-        }
-    }
-    else {
-        cr10.passed = true;
-    }
-    const cr11 = items.find(i => i.id === "C-R-11");
-    if (data.guard_expected_progress_state && input.user_intent_phrases && input.user_intent_phrases.length > 0) {
-        const intentLower = input.user_intent_phrases.join(" ").toLowerCase();
-        const praiseKeywords = ["praise", "wonder", "thumbs_up", "positive review", "satisfaction reward", "praise reward"];
-        const isPraiseIntent = praiseKeywords.some(kw => intentLower.includes(kw.toLowerCase()));
-        if (isPraiseIntent && input.machine_has_wonder_node !== false && data.guard_expected_progress_state !== "wonder") {
-            cr11.passed = false;
-            cr11.message = `intent=praise but Guard checks "${data.guard_expected_progress_state}" instead of "wonder" — R-R-6-01 violation`;
-        }
-        else {
-            cr11.passed = true;
-        }
-    }
-    else {
-        cr11.passed = true;
-    }
-    return {
-        all_passed: items.filter(i => i.id !== "C-R-09").every(i => i.passed),
-        items,
-    };
-}
-function adaptRiskAssessment(input) {
-    const ctx = {
-        object: input.reward_json.object,
-        claim: input.reward_json.claim,
-        description: input.reward_json.description,
-        coin_add: input.reward_json.coin_add,
-        receive: input.reward_json.receive,
-        guard_add: input.reward_json.guard_add,
-        guard_remove_expired: input.reward_json.guard_remove_expired,
-        guard_expiration_time: input.reward_json.guard_expiration_time,
-        owner_receive: input.reward_json.owner_receive,
-        um: input.reward_json.um,
-        reward_type: input.reward_type,
-        current_balance: input.current_balance,
-        current_guard_count: input.current_guard_count,
-        current_record_count_for_recipient: input.current_record_count_for_recipient,
-        current_guard_not_added_expiration_time: input.current_guard_not_added_expiration_time,
-        current_clock_ms: input.current_clock_ms,
-        permission_address: input.permission_address,
-        signer: input.signer,
-        target_guard_addresses: input.target_guard_addresses,
-        passport_submission_value_types: input.passport_submission_value_types,
-        passport_identifier_is_address: input.passport_identifier_is_address,
-        guard_store_from_id_compatible: input.guard_store_from_id_compatible,
-        user_intent_phrases: input.user_intent_phrases,
-        guard_expected_progress_state: input.reward_json.guard_expected_progress_state,
-        machine_has_wonder_node: input.machine_has_wonder_node,
-    };
-    return assessRewardRisks(ctx);
-}
-export const REWARD_CONFIRMATION_QUESTIONS = [
-    {
-        id: "QRW1",
-        question: "Is the target Reward object address correct, and does its coin type T match the intended token?",
-        requires_explicit_yes: true,
-    },
-    {
-        id: "QRW2",
-        question: "For guard_add: is the Guard address valid and added to this Reward (E_GUARD_NOT_FOUND on claim if not)?",
-        requires_explicit_yes: true,
-        related_risk_ids: ["R-R-5-01"],
-    },
-    {
-        id: "QRW3",
-        question: "⚠️ For owner_receive (156): do you confirm sweeping receivables to the Permission owner? Grant 156 only to dedicated addresses.",
-        requires_explicit_yes: true,
-        related_risk_ids: ["R-R-3-02"],
-    },
-    {
-        id: "QRW4",
-        question: "For guard_expiration_time_add (155): do you acknowledge this sets a time-lock on guard additions (cannot be shortened below current clock)?",
-        requires_explicit_yes: true,
-        related_risk_ids: ["R-R-3-03", "R-R-4-04"],
-    },
-    {
-        id: "QRW5",
-        question: "For claim: is the Passport provided with valid submissions for the Guard (recipient + amount + store_from_id if set)?",
-        requires_explicit_yes: true,
-        related_risk_ids: ["R-R-2-01", "R-R-2-02", "R-R-2-03"],
-    },
-    {
-        id: "QRW6",
-        question: "For coin_add: have you verified the coin type T matches Reward<T> (type mismatch will abort in SDK operate)?",
-        requires_explicit_yes: false,
-        related_risk_ids: ["R-R-5-02"],
-    },
-    {
-        id: "QRW7",
-        question: "⚠️ For guard_add with progress.current check: does the Guard's expected progress node match the business intent? " +
-            "If intent is 'praise/positive review', Guard must check 'wonder' (NOT 'completed'). " +
-            "Premature claim at wrong node drains reward pool — Guard is immutable after creation.",
-        requires_explicit_yes: true,
-        related_risk_ids: ["R-R-6-01", "R-R-6-02"],
-    },
-];
-function processUserConfirmation(input, assessment) {
-    const questions = [...REWARD_CONFIRMATION_QUESTIONS];
-    const data = input.reward_json;
-    const filtered = [];
-    for (const q of questions) {
-        if (q.id === "QRW2" && !data.guard_add)
-            continue;
-        if (q.id === "QRW3" && data.owner_receive == null)
-            continue;
-        if (q.id === "QRW4" && data.guard_expiration_time === undefined)
-            continue;
-        if (q.id === "QRW5" && !data.claim)
-            continue;
-        if (q.id === "QRW6" && !data.coin_add)
-            continue;
-        if (q.id === "QRW7" && (!data.guard_add || !data.guard_expected_progress_state))
-            continue;
-        filtered.push(q);
-    }
-    if (input.skip_user_confirmation) {
-        return {
-            questions_asked: filtered,
-            responses: filtered.map(q => ({ question_id: q.id, response: "yes" })),
-            all_confirmed: true,
-        };
-    }
-    return {
-        questions_asked: filtered,
-        responses: [],
-        all_confirmed: false,
-    };
-}
-function verifyEnvironment(input) {
-    const checks = [];
-    if (input.reward_json.object) {
-        checks.push({
-            name: "reward_exists",
-            passed: true,
-            message: `Reward ${input.reward_json.object} assumed to exist`,
-        });
-    }
-    if (input.permission_address) {
-        checks.push({
-            name: "permission_exists",
-            passed: true,
-            message: `Permission ${input.permission_address} assumed to exist`,
-        });
-    }
-    if (input.reward_json.claim && input.target_guard_addresses) {
-        const isBound = input.target_guard_addresses.includes(input.reward_json.claim);
-        checks.push({
-            name: "guard_bound_to_reward",
-            passed: isBound,
-            message: isBound
-                ? `Guard ${input.reward_json.claim} is in Reward.guards`
-                : `Guard ${input.reward_json.claim} NOT in Reward.guards — E_GUARD_NOT_FOUND will abort`,
-        });
-    }
-    if (input.reward_json.claim && input.current_balance !== undefined) {
-        const balance = BigInt(input.current_balance);
-        checks.push({
-            name: "balance_positive_for_claim",
-            passed: balance > 0n,
-            message: balance > 0n
-                ? `Balance ${input.current_balance} > 0`
-                : `Balance is 0 — E_INSUFFICIENT_BALANCE will abort`,
-        });
-    }
-    if (input.signer && input.permission_address) {
-        checks.push({
-            name: "signer_authorization",
-            passed: true,
-            message: `Signer ${input.signer} assumed authorized (verify via queryObjectPermission)`,
-        });
-    }
-    const allPassed = checks.every(c => c.passed);
-    return { passed: allPassed, checks };
-}
-export const REWARD_CONFIRM_VERSION = "1.0.0";
-export function runRewardConfirmGate(input) {
-    const layersPassed = [];
-    const layersFailed = [];
-    const checklist = runStaticChecklist(input);
-    if (!checklist.all_passed) {
-        layersFailed.push("L1_checklist");
-        return {
-            status: "blocked_checklist",
-            checklist_result: checklist,
-            confirmation_text: generateConfirmationText(input, checklist),
-            block_reason: `Checklist failed: ${checklist.items.filter(i => !i.passed).map(i => i.id).join(", ")}`,
-            decision_record: {
-                timestamp: new Date().toISOString(),
-                gate_version: REWARD_CONFIRM_VERSION,
-                final_status: "blocked_checklist",
-                layers_passed: layersPassed,
-                layers_failed: layersFailed,
-            },
-        };
-    }
-    layersPassed.push("L1_checklist");
-    const assessment = adaptRiskAssessment(input);
-    const hasCritical = assessment.risks.some(r => r.level === "CRITICAL");
-    if (hasCritical) {
-        layersFailed.push("L2_risk");
-        return {
-            status: "blocked_risk",
-            checklist_result: checklist,
-            risk_result: assessment,
-            confirmation_text: generateConfirmationText(input, checklist, assessment),
-            block_reason: `CRITICAL risks: ${assessment.risks.filter(r => r.level === "CRITICAL").map(r => r.id).join(", ")}`,
-            decision_record: {
-                timestamp: new Date().toISOString(),
-                gate_version: REWARD_CONFIRM_VERSION,
-                final_status: "blocked_risk",
-                layers_passed: layersPassed,
-                layers_failed: layersFailed,
-            },
-        };
-    }
-    layersPassed.push("L2_risk");
-    const userConf = processUserConfirmation(input, assessment);
-    if (!userConf.all_confirmed) {
-        if (input.reward_json.owner_receive != null) {
-            const cr09 = checklist.items.find(i => i.id === "C-R-09");
-            if (cr09) {
-                const qrw3 = userConf.responses.find(r => r.question_id === "QRW3");
-                cr09.passed = qrw3?.response === "yes";
-                cr09.message = cr09.passed ? "" : "owner_receive not confirmed by user (QRW3)";
-            }
-        }
-        if (input.reward_json.owner_receive != null) {
-            const cr09 = checklist.items.find(i => i.id === "C-R-09");
-            if (cr09 && !cr09.passed) {
-                layersFailed.push("L3_user");
-                return {
-                    status: "blocked_user",
-                    checklist_result: checklist,
-                    risk_result: assessment,
-                    user_confirmation: userConf,
-                    confirmation_text: generateConfirmationText(input, checklist, assessment),
-                    block_reason: "User did not confirm owner_receive (QRW3)",
-                    decision_record: {
-                        timestamp: new Date().toISOString(),
-                        gate_version: REWARD_CONFIRM_VERSION,
-                        final_status: "blocked_user",
-                        layers_passed: layersPassed,
-                        layers_failed: layersFailed,
-                    },
-                };
-            }
-        }
-    }
-    layersPassed.push("L3_user");
-    if (input.skip_environment_check) {
-        layersPassed.push("L4_environment");
-    }
-    else {
-        const env = verifyEnvironment(input);
-        if (!env.passed) {
-            layersFailed.push("L4_environment");
-            return {
-                status: "blocked_environment",
-                checklist_result: checklist,
-                risk_result: assessment,
-                user_confirmation: userConf,
-                environment_result: env,
-                confirmation_text: generateConfirmationText(input, checklist, assessment),
-                block_reason: `Environment check failed: ${env.checks.filter(c => !c.passed).map(c => c.name).join(", ")}`,
-                decision_record: {
-                    timestamp: new Date().toISOString(),
-                    gate_version: REWARD_CONFIRM_VERSION,
-                    final_status: "blocked_environment",
-                    layers_passed: layersPassed,
-                    layers_failed: layersFailed,
-                },
-            };
-        }
-        layersPassed.push("L4_environment");
-    }
-    return {
-        status: "approved",
-        checklist_result: checklist,
-        risk_result: assessment,
-        user_confirmation: userConf,
-        confirmation_text: generateConfirmationText(input, checklist, assessment),
-        decision_record: {
-            timestamp: new Date().toISOString(),
-            gate_version: REWARD_CONFIRM_VERSION,
-            final_status: "approved",
-            layers_passed: layersPassed,
-            layers_failed: layersFailed,
-        },
-    };
-}
-function generateConfirmationText(input, checklist, assessment) {
-    const lines = [];
-    const data = input.reward_json;
-    lines.push("═══ Reward Operation Confirmation ═══");
-    lines.push("");
-    if (data.object) {
-        lines.push(`Reward: ${data.object}`);
-    }
-    else {
-        lines.push("Reward: NEW (will be created in this tx)");
-    }
-    if (input.reward_type) {
-        lines.push(`Coin type T: ${input.reward_type}`);
-    }
-    if (input.current_balance !== undefined) {
-        lines.push(`Current balance: ${input.current_balance}`);
-    }
-    if (input.current_guard_count !== undefined) {
-        lines.push(`Current guard count: ${input.current_guard_count}/${MAX_GUARD_COUNT_REWARD}`);
-    }
-    lines.push("");
-    lines.push("─ Checklist ──────────────────");
-    for (const item of checklist.items) {
-        const mark = item.passed ? "✓" : "✗";
-        lines.push(`  ${mark} ${item.id}: ${item.description}${item.message ? " — " + item.message : ""}`);
-    }
-    lines.push("");
-    if (assessment) {
-        lines.push("─ Risk Assessment ──────────────────");
-        lines.push(`Overall: ${assessment.overall_risk}`);
-        lines.push(`Detected: ${assessment.risks.length} risk(s)`);
-        for (const r of assessment.risks) {
-            lines.push(`  [${r.level}] ${r.id}: ${r.title}`);
-        }
-        lines.push("");
-    }
-    lines.push("─ Operations ──────────────────");
-    if (data.claim)
-        lines.push(`- claim: guard=${data.claim} (passport-driven, no permission)`);
-    if (data.description != null)
-        lines.push(`- description_set: "${data.description}"`);
-    if (data.coin_add)
-        lines.push(`- coin_add: ${data.coin_add.amount} of ${data.coin_add.coin_type}`);
-    if (data.receive)
-        lines.push(`- receive: payment token=${data.receive.token_type}`);
-    if (data.guard_add) {
-        lines.push(`- guard_add: ${data.guard_add.length} guard(s)`);
-        for (let i = 0; i < data.guard_add.length; i++) {
-            const g = data.guard_add[i];
-            const rKey = Object.keys(g.recipient)[0];
-            lines.push(`  [${i}] guard=${g.guard}, recipient=${rKey}, amount=${g.amount.type}(${g.amount.value})`);
-        }
-    }
-    if (data.guard_remove_expired)
-        lines.push(`- guard_remove_expired: true`);
-    if (data.guard_expiration_time !== undefined) {
-        const t = data.guard_expiration_time;
-        lines.push(`- guard_expiration_time_add: ${t === null ? "null (cancel lock)" : t}`);
-    }
-    if (data.owner_receive != null)
-        lines.push(`- ⚠️ owner_receive (156): unwrap to Permission owner`);
-    if (data.um !== undefined) {
-        lines.push(`- um_${data.um ? "set" : "none"}: ${data.um ?? "(unbind)"}`);
-    }
-    lines.push("");
-    return lines.join("\n");
-}
-export function progressiveRewardCheck(input) {
-    const checklist = runStaticChecklist(input);
-    if (!checklist.all_passed) {
-        return {
-            stage: "checklist",
-            status: "fail",
-            message: `Checklist failed: ${checklist.items.filter(i => !i.passed).map(i => i.id).join(", ")}`,
-            next_action: "Fix failing checklist items",
-        };
-    }
-    const assessment = adaptRiskAssessment(input);
-    if (assessment.risks.some(r => r.level === "CRITICAL")) {
-        return {
-            stage: "risk",
-            status: "fail",
-            message: `CRITICAL risks: ${assessment.risks.filter(r => r.level === "CRITICAL").map(r => r.id).join(", ")}`,
-            next_action: "Resolve CRITICAL risks before proceeding",
-        };
-    }
-    if (assessment.needs_human_review) {
-        return {
-            stage: "confirmation",
-            status: "pending",
-            message: "Human review required for HIGH risks",
-            next_action: "Confirm risk acceptance",
-        };
-    }
-    return {
-        stage: "complete",
-        status: "pass",
-        message: "All checks passed",
-    };
-}
+import{MAX_GUARD_COUNT_REWARD,MAX_RECORD_COUNT_REWARD}from'./onchain-constants.js';import{assessRewardRisks}from'./reward-risk.js';export const REWARD_OPERATION_CHECKLIST=[{'id':'C-R-01','description':'guard_add\x20count\x20<\x20MAX_GUARD_COUNT_REWARD\x20(200)','passed':![],'message':''},{'id':'C-R-02','description':'Per-recipient\x20record\x20count\x20<\x20MAX_RECORD_COUNT_REWARD\x20(5200)','passed':![],'message':''},{'id':'C-R-03','description':'claim:\x20balance\x20≥\x20amount\x20(E_INSUFFICIENT_BALANCE)','passed':![],'message':''},{'id':'C-R-04','description':'guard_add:\x20clock\x20>\x20guard_not_added_expiration_time\x20(if\x20Some)','passed':![],'message':''},{'id':'C-R-05','description':'guard_add\x20/\x20claim:\x20clock\x20≤\x20guard.expiration_time\x20(if\x20Some)','passed':![],'message':''},{'id':'C-R-06','description':'guard_add:\x20valid\x20Recipient\x20×\x20Amount\x20pairing\x20(6\x20constructors)','passed':![],'message':''},{'id':'C-R-07','description':'coin_add:\x20coin\x20type\x20T\x20matches\x20Reward<T>','passed':![],'message':''},{'id':'C-R-08','description':'claim:\x20Passport\x20is\x20provided\x20(SDK\x20W_ERROR\x20if\x20missing)','passed':![],'message':''},{'id':'C-R-09','description':'owner_receive\x20(156):\x20user\x20double-confirms\x20blast\x20radius','passed':![],'message':''},{'id':'C-R-10','description':'guard_expiration_time_add\x20(155):\x20new\x20time\x20>\x20current\x20clock','passed':![],'message':''},{'id':'C-R-11','description':'guard_add:\x20Guard\x27s\x20progress.current\x20expected\x20value\x20matches\x20business\x20intent\x20(praise→wonder,\x20completion→completed)','passed':![],'message':''}];function runStaticChecklist(a){const b=REWARD_OPERATION_CHECKLIST['map'](p=>({...p})),c=a['reward_json'],d=b['find'](p=>p['id']==='C-R-01');if(c['guard_add']&&c['guard_add']['length']>0x0){const p=a['current_guard_count']??0x0;p+c['guard_add']['length']>MAX_GUARD_COUNT_REWARD?(d['passed']=![],d['message']=p+c['guard_add']['length']+'\x20>\x20'+MAX_GUARD_COUNT_REWARD):d['passed']=!![];}else d['passed']=!![];const e=b['find'](q=>q['id']==='C-R-02');if(c['claim']){const q=a['current_record_count_for_recipient']??0x0;q>=MAX_RECORD_COUNT_REWARD?(e['passed']=![],e['message']=q+'\x20≥\x20'+MAX_RECORD_COUNT_REWARD):e['passed']=!![];}else e['passed']=!![];const f=b['find'](r=>r['id']==='C-R-03');if(c['claim']&&a['current_balance']!==undefined){const r=BigInt(a['current_balance']);r===0x0n?(f['passed']=![],f['message']='balance=0\x20—\x20claim\x20will\x20abort\x20E_INSUFFICIENT_BALANCE'):f['passed']=!![];}else f['passed']=!![];const h=b['find'](s=>s['id']==='C-R-04');if(c['guard_add']&&c['guard_add']['length']>0x0&&a['current_guard_not_added_expiration_time']!=null){const s=a['current_clock_ms']??Date['now']();s<=a['current_guard_not_added_expiration_time']?(h['passed']=![],h['message']='clock\x20'+s+'\x20≤\x20lock\x20'+a['current_guard_not_added_expiration_time']):h['passed']=!![];}else h['passed']=!![];const i=b['find'](t=>t['id']==='C-R-05');i['passed']=!![];const j=b['find'](t=>t['id']==='C-R-06');if(c['guard_add']){const t=['GuardIdentifier','Entity','Signer'],u=['Fixed','GuardU64Identifier','GUARDU64IDENTIFIER','GUARD_U64_IDENTIFIER'];let v=!![];for(const w of c['guard_add']){const x=Object['keys'](w['recipient']);if(x['length']!==0x1||!t['includes'](x[0x0])){v=![];break;}if(!u['includes'](String(w['amount']['type'])['toUpperCase']())){v=![];break;}}j['passed']=v,j['message']=v?'':'Invalid\x20Recipient\x20×\x20Amount\x20pairing';}else j['passed']=!![];const k=b['find'](y=>y['id']==='C-R-07');c['coin_add']&&a['reward_type']?(k['passed']=c['coin_add']['coin_type']===a['reward_type'],k['message']=k['passed']?'':c['coin_add']['coin_type']+'\x20≠\x20'+a['reward_type']):k['passed']=!![];const l=b['find'](y=>y['id']==='C-R-08');c['claim']?(l['passed']=!![],l['message']='Passport\x20presence\x20verified\x20by\x20SDK\x20operate()'):l['passed']=!![];const m=b['find'](y=>y['id']==='C-R-09');c['owner_receive']!=null?(m['passed']=![],m['message']='Pending\x20user\x20confirmation\x20in\x20L3\x20(QRW3)'):m['passed']=!![];const n=b['find'](y=>y['id']==='C-R-10');if(c['guard_expiration_time']!==undefined&&c['guard_expiration_time']!==null){const y=a['current_clock_ms']??Date['now']();c['guard_expiration_time']<=y?(n['passed']=![],n['message']=c['guard_expiration_time']+'\x20≤\x20clock\x20'+y):n['passed']=!![];}else n['passed']=!![];const o=b['find'](z=>z['id']==='C-R-11');if(c['guard_expected_progress_state']&&a['user_intent_phrases']&&a['user_intent_phrases']['length']>0x0){const z=a['user_intent_phrases']['join']('\x20')['toLowerCase'](),A=['praise','wonder','thumbs_up','positive\x20review','satisfaction\x20reward','praise\x20reward'],B=A['some'](C=>z['includes'](C['toLowerCase']()));B&&a['machine_has_wonder_node']!==![]&&c['guard_expected_progress_state']!=='wonder'?(o['passed']=![],o['message']='intent=praise\x20but\x20Guard\x20checks\x20\x22'+c['guard_expected_progress_state']+'\x22\x20instead\x20of\x20\x22wonder\x22\x20—\x20R-R-6-01\x20violation'):o['passed']=!![];}else o['passed']=!![];return{'all_passed':b['filter'](C=>C['id']!=='C-R-09')['every'](C=>C['passed']),'items':b};}function adaptRiskAssessment(a){const b={'object':a['reward_json']['object'],'claim':a['reward_json']['claim'],'description':a['reward_json']['description'],'coin_add':a['reward_json']['coin_add'],'receive':a['reward_json']['receive'],'guard_add':a['reward_json']['guard_add'],'guard_remove_expired':a['reward_json']['guard_remove_expired'],'guard_expiration_time':a['reward_json']['guard_expiration_time'],'owner_receive':a['reward_json']['owner_receive'],'um':a['reward_json']['um'],'reward_type':a['reward_type'],'current_balance':a['current_balance'],'current_guard_count':a['current_guard_count'],'current_record_count_for_recipient':a['current_record_count_for_recipient'],'current_guard_not_added_expiration_time':a['current_guard_not_added_expiration_time'],'current_clock_ms':a['current_clock_ms'],'permission_address':a['permission_address'],'signer':a['signer'],'target_guard_addresses':a['target_guard_addresses'],'passport_submission_value_types':a['passport_submission_value_types'],'passport_identifier_is_address':a['passport_identifier_is_address'],'guard_store_from_id_compatible':a['guard_store_from_id_compatible'],'user_intent_phrases':a['user_intent_phrases'],'guard_expected_progress_state':a['reward_json']['guard_expected_progress_state'],'machine_has_wonder_node':a['machine_has_wonder_node']};return assessRewardRisks(b);}export const REWARD_CONFIRMATION_QUESTIONS=[{'id':'QRW1','question':'Is\x20the\x20target\x20Reward\x20object\x20address\x20correct,\x20and\x20does\x20its\x20coin\x20type\x20T\x20match\x20the\x20intended\x20token?','requires_explicit_yes':!![]},{'id':'QRW2','question':'For\x20guard_add:\x20is\x20the\x20Guard\x20address\x20valid\x20and\x20added\x20to\x20this\x20Reward\x20(E_GUARD_NOT_FOUND\x20on\x20claim\x20if\x20not)?','requires_explicit_yes':!![],'related_risk_ids':['R-R-5-01']},{'id':'QRW3','question':'⚠️\x20For\x20owner_receive\x20(156):\x20do\x20you\x20confirm\x20sweeping\x20receivables\x20to\x20the\x20Permission\x20owner?\x20Grant\x20156\x20only\x20to\x20dedicated\x20addresses.','requires_explicit_yes':!![],'related_risk_ids':['R-R-3-02']},{'id':'QRW4','question':'For\x20guard_expiration_time_add\x20(155):\x20do\x20you\x20acknowledge\x20this\x20sets\x20a\x20time-lock\x20on\x20guard\x20additions\x20(cannot\x20be\x20shortened\x20below\x20current\x20clock)?','requires_explicit_yes':!![],'related_risk_ids':['R-R-3-03','R-R-4-04']},{'id':'QRW5','question':'For\x20claim:\x20is\x20the\x20Passport\x20provided\x20with\x20valid\x20submissions\x20for\x20the\x20Guard\x20(recipient\x20+\x20amount\x20+\x20store_from_id\x20if\x20set)?','requires_explicit_yes':!![],'related_risk_ids':['R-R-2-01','R-R-2-02','R-R-2-03']},{'id':'QRW6','question':'For\x20coin_add:\x20have\x20you\x20verified\x20the\x20coin\x20type\x20T\x20matches\x20Reward<T>\x20(type\x20mismatch\x20will\x20abort\x20in\x20SDK\x20operate)?','requires_explicit_yes':![],'related_risk_ids':['R-R-5-02']},{'id':'QRW7','question':'⚠️\x20For\x20guard_add\x20with\x20progress.current\x20check:\x20does\x20the\x20Guard\x27s\x20expected\x20progress\x20node\x20match\x20the\x20business\x20intent?\x20'+'If\x20intent\x20is\x20\x27praise/positive\x20review\x27,\x20Guard\x20must\x20check\x20\x27wonder\x27\x20(NOT\x20\x27completed\x27).\x20'+'Premature\x20claim\x20at\x20wrong\x20node\x20drains\x20reward\x20pool\x20—\x20Guard\x20is\x20immutable\x20after\x20creation.','requires_explicit_yes':!![],'related_risk_ids':['R-R-6-01','R-R-6-02']}];function processUserConfirmation(a,b){const c=[...REWARD_CONFIRMATION_QUESTIONS],d=a['reward_json'],e=[];for(const f of c){if(f['id']==='QRW2'&&!d['guard_add'])continue;if(f['id']==='QRW3'&&d['owner_receive']==null)continue;if(f['id']==='QRW4'&&d['guard_expiration_time']===undefined)continue;if(f['id']==='QRW5'&&!d['claim'])continue;if(f['id']==='QRW6'&&!d['coin_add'])continue;if(f['id']==='QRW7'&&(!d['guard_add']||!d['guard_expected_progress_state']))continue;e['push'](f);}if(a['skip_user_confirmation'])return{'questions_asked':e,'responses':e['map'](g=>({'question_id':g['id'],'response':'yes'})),'all_confirmed':!![]};return{'questions_asked':e,'responses':[],'all_confirmed':![]};}function verifyEnvironment(a){const b=[];a['reward_json']['object']&&b['push']({'name':'reward_exists','passed':!![],'message':'Reward\x20'+a['reward_json']['object']+'\x20assumed\x20to\x20exist'});a['permission_address']&&b['push']({'name':'permission_exists','passed':!![],'message':'Permission\x20'+a['permission_address']+'\x20assumed\x20to\x20exist'});if(a['reward_json']['claim']&&a['target_guard_addresses']){const d=a['target_guard_addresses']['includes'](a['reward_json']['claim']);b['push']({'name':'guard_bound_to_reward','passed':d,'message':d?'Guard\x20'+a['reward_json']['claim']+'\x20is\x20in\x20Reward.guards':'Guard\x20'+a['reward_json']['claim']+'\x20NOT\x20in\x20Reward.guards\x20—\x20E_GUARD_NOT_FOUND\x20will\x20abort'});}if(a['reward_json']['claim']&&a['current_balance']!==undefined){const e=BigInt(a['current_balance']);b['push']({'name':'balance_positive_for_claim','passed':e>0x0n,'message':e>0x0n?'Balance\x20'+a['current_balance']+'\x20>\x200':'Balance\x20is\x200\x20—\x20E_INSUFFICIENT_BALANCE\x20will\x20abort'});}a['signer']&&a['permission_address']&&b['push']({'name':'signer_authorization','passed':!![],'message':'Signer\x20'+a['signer']+'\x20assumed\x20authorized\x20(verify\x20via\x20queryObjectPermission)'});const c=b['every'](f=>f['passed']);return{'passed':c,'checks':b};}export const REWARD_CONFIRM_VERSION='1.0.0';export function runRewardConfirmGate(a){const b=[],c=[],d=runStaticChecklist(a);if(!d['all_passed'])return c['push']('L1_checklist'),{'status':'blocked_checklist','checklist_result':d,'confirmation_text':generateConfirmationText(a,d),'block_reason':'Checklist\x20failed:\x20'+d['items']['filter'](h=>!h['passed'])['map'](h=>h['id'])['join'](',\x20'),'decision_record':{'timestamp':new Date()['toISOString'](),'gate_version':REWARD_CONFIRM_VERSION,'final_status':'blocked_checklist','layers_passed':b,'layers_failed':c}};b['push']('L1_checklist');const e=adaptRiskAssessment(a),f=e['risks']['some'](h=>h['level']==='CRITICAL');if(f)return c['push']('L2_risk'),{'status':'blocked_risk','checklist_result':d,'risk_result':e,'confirmation_text':generateConfirmationText(a,d,e),'block_reason':'CRITICAL\x20risks:\x20'+e['risks']['filter'](h=>h['level']==='CRITICAL')['map'](h=>h['id'])['join'](',\x20'),'decision_record':{'timestamp':new Date()['toISOString'](),'gate_version':REWARD_CONFIRM_VERSION,'final_status':'blocked_risk','layers_passed':b,'layers_failed':c}};b['push']('L2_risk');const g=processUserConfirmation(a,e);if(!g['all_confirmed']){if(a['reward_json']['owner_receive']!=null){const h=d['items']['find'](j=>j['id']==='C-R-09');if(h){const i=g['responses']['find'](j=>j['question_id']==='QRW3');h['passed']=i?.['response']==='yes',h['message']=h['passed']?'':'owner_receive\x20not\x20confirmed\x20by\x20user\x20(QRW3)';}}if(a['reward_json']['owner_receive']!=null){const j=d['items']['find'](k=>k['id']==='C-R-09');if(j&&!j['passed'])return c['push']('L3_user'),{'status':'blocked_user','checklist_result':d,'risk_result':e,'user_confirmation':g,'confirmation_text':generateConfirmationText(a,d,e),'block_reason':'User\x20did\x20not\x20confirm\x20owner_receive\x20(QRW3)','decision_record':{'timestamp':new Date()['toISOString'](),'gate_version':REWARD_CONFIRM_VERSION,'final_status':'blocked_user','layers_passed':b,'layers_failed':c}};}}b['push']('L3_user');if(a['skip_environment_check'])b['push']('L4_environment');else{const k=verifyEnvironment(a);if(!k['passed'])return c['push']('L4_environment'),{'status':'blocked_environment','checklist_result':d,'risk_result':e,'user_confirmation':g,'environment_result':k,'confirmation_text':generateConfirmationText(a,d,e),'block_reason':'Environment\x20check\x20failed:\x20'+k['checks']['filter'](l=>!l['passed'])['map'](l=>l['name'])['join'](',\x20'),'decision_record':{'timestamp':new Date()['toISOString'](),'gate_version':REWARD_CONFIRM_VERSION,'final_status':'blocked_environment','layers_passed':b,'layers_failed':c}};b['push']('L4_environment');}return{'status':'approved','checklist_result':d,'risk_result':e,'user_confirmation':g,'confirmation_text':generateConfirmationText(a,d,e),'decision_record':{'timestamp':new Date()['toISOString'](),'gate_version':REWARD_CONFIRM_VERSION,'final_status':'approved','layers_passed':b,'layers_failed':c}};}function generateConfirmationText(a,b,c){const d=[],e=a['reward_json'];d['push']('═══\x20Reward\x20Operation\x20Confirmation\x20═══'),d['push']('');e['object']?d['push']('Reward:\x20'+e['object']):d['push']('Reward:\x20NEW\x20(will\x20be\x20created\x20in\x20this\x20tx)');a['reward_type']&&d['push']('Coin\x20type\x20T:\x20'+a['reward_type']);a['current_balance']!==undefined&&d['push']('Current\x20balance:\x20'+a['current_balance']);a['current_guard_count']!==undefined&&d['push']('Current\x20guard\x20count:\x20'+a['current_guard_count']+'/'+MAX_GUARD_COUNT_REWARD);d['push'](''),d['push']('─\x20Checklist\x20──────────────────');for(const f of b['items']){const h=f['passed']?'✓':'✗';d['push']('\x20\x20'+h+'\x20'+f['id']+':\x20'+f['description']+(f['message']?'\x20—\x20'+f['message']:''));}d['push']('');if(c){d['push']('─\x20Risk\x20Assessment\x20──────────────────'),d['push']('Overall:\x20'+c['overall_risk']),d['push']('Detected:\x20'+c['risks']['length']+'\x20risk(s)');for(const j of c['risks']){d['push']('\x20\x20['+j['level']+']\x20'+j['id']+':\x20'+j['title']);}d['push']('');}d['push']('─\x20Operations\x20──────────────────');if(e['claim'])d['push']('-\x20claim:\x20guard='+e['claim']+'\x20(passport-driven,\x20no\x20permission)');if(e['description']!=null)d['push']('-\x20description_set:\x20\x22'+e['description']+'\x22');if(e['coin_add'])d['push']('-\x20coin_add:\x20'+e['coin_add']['amount']+'\x20of\x20'+e['coin_add']['coin_type']);if(e['receive'])d['push']('-\x20receive:\x20payment\x20token='+e['receive']['token_type']);if(e['guard_add']){d['push']('-\x20guard_add:\x20'+e['guard_add']['length']+'\x20guard(s)');for(let k=0x0;k<e['guard_add']['length'];k++){const l=e['guard_add'][k],m=Object['keys'](l['recipient'])[0x0];d['push']('\x20\x20['+k+']\x20guard='+l['guard']+',\x20recipient='+m+',\x20amount='+l['amount']['type']+'('+l['amount']['value']+')');}}if(e['guard_remove_expired'])d['push']('-\x20guard_remove_expired:\x20true');if(e['guard_expiration_time']!==undefined){const n=e['guard_expiration_time'];d['push']('-\x20guard_expiration_time_add:\x20'+(n===null?'null\x20(cancel\x20lock)':n));}if(e['owner_receive']!=null)d['push']('-\x20⚠️\x20owner_receive\x20(156):\x20unwrap\x20to\x20Permission\x20owner');return e['um']!==undefined&&d['push']('-\x20um_'+(e['um']?'set':'none')+':\x20'+(e['um']??'(unbind)')),d['push'](''),d['join']('\x0a');}export function progressiveRewardCheck(a){const b=runStaticChecklist(a);if(!b['all_passed'])return{'stage':'checklist','status':'fail','message':'Checklist\x20failed:\x20'+b['items']['filter'](d=>!d['passed'])['map'](d=>d['id'])['join'](',\x20'),'next_action':'Fix\x20failing\x20checklist\x20items'};const c=adaptRiskAssessment(a);if(c['risks']['some'](d=>d['level']==='CRITICAL'))return{'stage':'risk','status':'fail','message':'CRITICAL\x20risks:\x20'+c['risks']['filter'](d=>d['level']==='CRITICAL')['map'](d=>d['id'])['join'](',\x20'),'next_action':'Resolve\x20CRITICAL\x20risks\x20before\x20proceeding'};if(c['needs_human_review'])return{'stage':'confirmation','status':'pending','message':'Human\x20review\x20required\x20for\x20HIGH\x20risks','next_action':'Confirm\x20risk\x20acceptance'};return{'stage':'complete','status':'pass','message':'All\x20checks\x20passed'};}

package/dist/knowledge/reward-context.d.ts

@@ -1,4 +1,4 @@
-import { type RewardScene, type RewardBuiltinPermissionEntry, type RewardGuardConstructor, type RewardGuardConstructorSpec, type RewardPhase, type RewardRecipientType, type RewardAmountType } from "./reward-ledger.js";
+import { type RewardScene, type RewardBuiltinPermissionEntry, type RewardGuardConstructorSpec, type RewardPhase, type RewardRecipientType, type RewardAmountType } from "./reward-ledger.js";
 import { type RewardPuzzle, type RewardPuzzleCompleteness } from "./reward-puzzle.js";
 import { type RewardRiskAssessment, type RewardRiskRule, type RewardStakeholder } from "./reward-risk.js";
 import { type RewardSemanticToSchemaRule } from "./reward-translation.js";
@@ -104,7 +104,7 @@ export declare function getRewardKnowledgeSnapshot(): {
     }[];
     guard_constructors_count: number;
     guard_constructors: {
-        constructor: RewardGuardConstructor;
+        constructor: import("./reward-ledger.js").RewardGuardConstructor;
         recipient_type: RewardRecipientType;
         amount_type: RewardAmountType;
     }[];