@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/knowledge/trust-metrics.js

@@ -1,198 +1 @@
-export const TRUST_METRICS_VERSION = 1;
-const TRUST_LEVELS = [
-    { min: 75, level: "trusted", label: "High trust" },
-    { min: 50, level: "moderate", label: "Moderate trust" },
-    { min: 25, level: "caution", label: "Needs attention" },
-    { min: 0, level: "high_risk", label: "High risk" },
-];
-export function computeServiceTrustScore(metrics) {
-    const breakdown = [];
-    const warnings = [];
-    const arbScore = computeArbitrationDimension(metrics);
-    breakdown.push(arbScore);
-    if (arbScore.score < arbScore.maxScore * 0.3) {
-        warnings.push("Arbitration trust score is low; recommend checking arbitration records");
-    }
-    const reviewScore = computeReviewDimension(metrics);
-    breakdown.push(reviewScore);
-    if (reviewScore.score < reviewScore.maxScore * 0.3 && metrics.reviewStats) {
-        warnings.push(`Low like rate (${metrics.reviewStats.likes}/${metrics.reviewStats.totalReviews})`);
-    }
-    const fulfillmentScore = computeFulfillmentDimension(metrics);
-    breakdown.push(fulfillmentScore);
-    if (metrics.completedRate !== undefined && metrics.completedRate < 0.7) {
-        warnings.push(`Completion rate only ${Math.round(metrics.completedRate * 100)}%`);
-    }
-    const fundScore = computeFundDimension(metrics);
-    breakdown.push(fundScore);
-    if (metrics.compensationFundBalance === undefined || metrics.compensationFundBalance === 0n) {
-        warnings.push("No compensation fund; insufficient protection of customer rights");
-    }
-    const transparencyScore = computeTransparencyDimension(metrics);
-    breakdown.push(transparencyScore);
-    const totalScore = breakdown.reduce((sum, d) => sum + d.score, 0);
-    const level = TRUST_LEVELS.find((l) => totalScore >= l.min)?.level ?? "high_risk";
-    const label = TRUST_LEVELS.find((l) => totalScore >= l.min)?.label ?? "High risk";
-    const summary = buildSummary(totalScore, label, metrics, breakdown);
-    return { score: totalScore, level, breakdown, summary, warnings };
-}
-function computeArbitrationDimension(metrics) {
-    const maxScore = 30;
-    if (metrics.arbitrationScore === undefined && metrics.arbitrationVotingGuardCount === undefined) {
-        return {
-            name: "arbitration",
-            score: maxScore * 0.25,
-            maxScore,
-            description: "Arbitration trust score (no data; default low because arbitration is critical)",
-            humanReadable: "Arbitration: no data (default low — critical missing)",
-        };
-    }
-    let score = 0;
-    const parts = [];
-    if (metrics.arbitrationScore !== undefined) {
-        const baseScore = Math.round((metrics.arbitrationScore / 100) * 10);
-        score += baseScore;
-        parts.push(`score ${metrics.arbitrationScore}/100`);
-    }
-    else {
-        score += 3;
-    }
-    if (metrics.arbitrationVotingGuardCount !== undefined && metrics.arbitrationVotingGuardCount > 0) {
-        score += 5;
-        parts.push(`${metrics.arbitrationVotingGuardCount} voting_guard(s)`);
-    }
-    if (metrics.arbitrationFeeBalance !== undefined && metrics.arbitrationFeeBalance > 0n) {
-        score += 5;
-        parts.push("fee funded");
-    }
-    if (metrics.arbitrationPaused === false) {
-        score += 5;
-        parts.push("active");
-    }
-    else if (metrics.arbitrationPaused === true) {
-        parts.push("paused");
-    }
-    if (metrics.arbitrationCases !== undefined && metrics.arbitrationCases > 0) {
-        score += 5;
-        parts.push(`${metrics.arbitrationCases} case(s)`);
-    }
-    score = Math.min(maxScore, score);
-    return {
-        name: "arbitration",
-        score,
-        maxScore,
-        description: `Arbitration config: ${parts.join(", ")}`,
-        humanReadable: `Arbitration: ${parts.join(", ")}`,
-    };
-}
-function computeReviewDimension(metrics) {
-    const maxScore = 25;
-    if (!metrics.reviewStats || metrics.reviewStats.totalReviews === 0) {
-        return { name: "reviews", score: maxScore * 0.5, maxScore, description: "Review reputation (no review data)", humanReadable: "Reviews: no data" };
-    }
-    const { likes, dislikes, verifiedReviews, totalReviews } = metrics.reviewStats;
-    const likeRate = likes / Math.max(1, totalReviews);
-    const verifiedBoost = Math.min(5, verifiedReviews);
-    const score = Math.round(likeRate * (maxScore - 5) + verifiedBoost);
-    return {
-        name: "reviews",
-        score: Math.min(maxScore, score),
-        maxScore,
-        description: `Like rate ${Math.round(likeRate * 100)}% (${totalReviews} reviews, ${verifiedReviews} verified)`,
-        humanReadable: `Like rate ${Math.round(likeRate * 100)}% (${totalReviews} reviews)`,
-    };
-}
-function computeFulfillmentDimension(metrics) {
-    const maxScore = 20;
-    if (metrics.orderCount === undefined) {
-        return { name: "fulfillment", score: maxScore * 0.5, maxScore, description: "Fulfillment record (no order data)", humanReadable: "Fulfillment: no data" };
-    }
-    let score = 0;
-    const orderScore = Math.min(10, Math.floor(metrics.orderCount / 5));
-    score += orderScore;
-    if (metrics.completedRate !== undefined) {
-        score += Math.round(metrics.completedRate * 10);
-    }
-    else {
-        score += 5;
-    }
-    return {
-        name: "fulfillment",
-        score: Math.min(maxScore, score),
-        maxScore,
-        description: `Completed ${metrics.orderCount} orders, completion rate ${metrics.completedRate !== undefined ? Math.round(metrics.completedRate * 100) + "%" : "unknown"}`,
-        humanReadable: `Fulfillment: ${metrics.orderCount} orders${metrics.avgCompletionTime !== undefined ? `, avg ${metrics.avgCompletionTime}h` : ""}`,
-    };
-}
-function computeFundDimension(metrics) {
-    const maxScore = 15;
-    if (metrics.compensationFundBalance === undefined || metrics.compensationFundBalance === 0n) {
-        return { name: "fund_safety", score: 0, maxScore, description: "No compensation fund", humanReadable: "Compensation fund: none" };
-    }
-    const fund = metrics.compensationFundBalance;
-    if (metrics.typicalOrderAmount !== undefined && metrics.typicalOrderAmount > 0n) {
-        const ratio = Number((fund * 100n) / metrics.typicalOrderAmount) / 100;
-        let score;
-        let humanReadable;
-        if (ratio >= 10) {
-            score = maxScore;
-            humanReadable = `Compensation fund: ${ratio.toFixed(1)}x order amount (excellent)`;
-        }
-        else if (ratio >= 1) {
-            score = 10 + Math.round((ratio - 1) / 9 * 5);
-            humanReadable = `Compensation fund: ${ratio.toFixed(1)}x order amount (covers ≥1 payout)`;
-        }
-        else {
-            score = Math.round(ratio * 10);
-            humanReadable = `Compensation fund: ${ratio.toFixed(1)}x order amount (insufficient)`;
-        }
-        return {
-            name: "fund_safety",
-            score: Math.min(maxScore, score),
-            maxScore,
-            description: `Fund ${fund.toString()} / typical order ${metrics.typicalOrderAmount.toString()} = ${ratio.toFixed(2)}x`,
-            humanReadable,
-        };
-    }
-    const threshold = 1000000000000n;
-    const ratio = Number(metrics.compensationFundBalance * 100n / threshold) / 100;
-    const score = Math.min(maxScore, Math.round(ratio * maxScore));
-    return {
-        name: "fund_safety",
-        score,
-        maxScore,
-        description: `Compensation fund ${metrics.compensationFundBalance} smallest unit (absolute threshold fallback)`,
-        humanReadable: `Compensation fund: ${ratio.toFixed(2)}x absolute threshold`,
-    };
-}
-function computeTransparencyDimension(metrics) {
-    const maxScore = 10;
-    let score = 0;
-    if (metrics.hasPublishedEvents)
-        score += 4;
-    if (metrics.hasMachineBound)
-        score += 3;
-    if (metrics.hasBuyGuard)
-        score += 3;
-    return {
-        name: "transparency",
-        score: Math.min(maxScore, score),
-        maxScore,
-        description: `On-chain events ${metrics.hasPublishedEvents ? "✓" : "✗"}, Machine ${metrics.hasMachineBound ? "✓" : "✗"}, Guard ${metrics.hasBuyGuard ? "✓" : "✗"}`,
-        humanReadable: `Transparency: ${["Events", "Machine", "Guard"].filter((_, i) => [metrics.hasPublishedEvents, metrics.hasMachineBound, metrics.hasBuyGuard][i]).join("+") || "none"}`,
-    };
-}
-function buildSummary(score, label, metrics, breakdown) {
-    const parts = [`Trust score ${score}/100 (${label})`];
-    for (const d of breakdown) {
-        parts.push(`${d.humanReadable}`);
-    }
-    return parts.join("; ");
-}
-export function quickTrustCheck(metrics) {
-    const result = computeServiceTrustScore(metrics);
-    if (result.score < 25) {
-        return { pass: false, reason: `Trust score ${result.score}/100, high risk: ${result.warnings.join("; ")}` };
-    }
-    return { pass: true, reason: `Trust score ${result.score}/100 (${result.level})` };
-}
+export const TRUST_METRICS_VERSION=0x1;const TRUST_LEVELS=[{'min':0x4b,'level':'trusted','label':'High\x20trust'},{'min':0x32,'level':'moderate','label':'Moderate\x20trust'},{'min':0x19,'level':'caution','label':'Needs\x20attention'},{'min':0x0,'level':'high_risk','label':'High\x20risk'}];export function computeServiceTrustScore(a){const b=[],c=[],d=computeArbitrationDimension(a);b['push'](d);d['score']<d['maxScore']*0.3&&c['push']('Arbitration\x20trust\x20score\x20is\x20low;\x20recommend\x20checking\x20arbitration\x20records');const e=computeReviewDimension(a);b['push'](e);e['score']<e['maxScore']*0.3&&a['reviewStats']&&c['push']('Low\x20like\x20rate\x20('+a['reviewStats']['likes']+'/'+a['reviewStats']['totalReviews']+')');const f=computeFulfillmentDimension(a);b['push'](f);a['completedRate']!==undefined&&a['completedRate']<0.7&&c['push']('Completion\x20rate\x20only\x20'+Math['round'](a['completedRate']*0x64)+'%');const g=computeFundDimension(a);b['push'](g);(a['compensationFundBalance']===undefined||a['compensationFundBalance']===0x0n)&&c['push']('No\x20compensation\x20fund;\x20insufficient\x20protection\x20of\x20customer\x20rights');const h=computeTransparencyDimension(a);b['push'](h);const i=b['reduce']((m,n)=>m+n['score'],0x0),j=TRUST_LEVELS['find'](m=>i>=m['min'])?.['level']??'high_risk',k=TRUST_LEVELS['find'](m=>i>=m['min'])?.['label']??'High\x20risk',l=buildSummary(i,k,a,b);return{'score':i,'level':j,'breakdown':b,'summary':l,'warnings':c};}function computeArbitrationDimension(a){const b=0x1e;if(a['arbitrationScore']===undefined&&a['arbitrationVotingGuardCount']===undefined)return{'name':'arbitration','score':b*0.25,'maxScore':b,'description':'Arbitration\x20trust\x20score\x20(no\x20data;\x20default\x20low\x20because\x20arbitration\x20is\x20critical)','humanReadable':'Arbitration:\x20no\x20data\x20(default\x20low\x20—\x20critical\x20missing)'};let c=0x0;const d=[];if(a['arbitrationScore']!==undefined){const e=Math['round'](a['arbitrationScore']/0x64*0xa);c+=e,d['push']('score\x20'+a['arbitrationScore']+'/100');}else c+=0x3;a['arbitrationVotingGuardCount']!==undefined&&a['arbitrationVotingGuardCount']>0x0&&(c+=0x5,d['push'](a['arbitrationVotingGuardCount']+'\x20voting_guard(s)'));a['arbitrationFeeBalance']!==undefined&&a['arbitrationFeeBalance']>0x0n&&(c+=0x5,d['push']('fee\x20funded'));if(a['arbitrationPaused']===![])c+=0x5,d['push']('active');else a['arbitrationPaused']===!![]&&d['push']('paused');return a['arbitrationCases']!==undefined&&a['arbitrationCases']>0x0&&(c+=0x5,d['push'](a['arbitrationCases']+'\x20case(s)')),c=Math['min'](b,c),{'name':'arbitration','score':c,'maxScore':b,'description':'Arbitration\x20config:\x20'+d['join'](',\x20'),'humanReadable':'Arbitration:\x20'+d['join'](',\x20')};}function computeReviewDimension(a){const b=0x19;if(!a['reviewStats']||a['reviewStats']['totalReviews']===0x0)return{'name':'reviews','score':b*0.5,'maxScore':b,'description':'Review\x20reputation\x20(no\x20review\x20data)','humanReadable':'Reviews:\x20no\x20data'};const {likes:c,dislikes:d,verifiedReviews:e,totalReviews:f}=a['reviewStats'],g=c/Math['max'](0x1,f),h=Math['min'](0x5,e),i=Math['round'](g*(b-0x5)+h);return{'name':'reviews','score':Math['min'](b,i),'maxScore':b,'description':'Like\x20rate\x20'+Math['round'](g*0x64)+'%\x20('+f+'\x20reviews,\x20'+e+'\x20verified)','humanReadable':'Like\x20rate\x20'+Math['round'](g*0x64)+'%\x20('+f+'\x20reviews)'};}function computeFulfillmentDimension(a){const b=0x14;if(a['orderCount']===undefined)return{'name':'fulfillment','score':b*0.5,'maxScore':b,'description':'Fulfillment\x20record\x20(no\x20order\x20data)','humanReadable':'Fulfillment:\x20no\x20data'};let c=0x0;const d=Math['min'](0xa,Math['floor'](a['orderCount']/0x5));return c+=d,a['completedRate']!==undefined?c+=Math['round'](a['completedRate']*0xa):c+=0x5,{'name':'fulfillment','score':Math['min'](b,c),'maxScore':b,'description':'Completed\x20'+a['orderCount']+'\x20orders,\x20completion\x20rate\x20'+(a['completedRate']!==undefined?Math['round'](a['completedRate']*0x64)+'%':'unknown'),'humanReadable':'Fulfillment:\x20'+a['orderCount']+'\x20orders'+(a['avgCompletionTime']!==undefined?',\x20avg\x20'+a['avgCompletionTime']+'h':'')};}function computeFundDimension(a){const b=0xf;if(a['compensationFundBalance']===undefined||a['compensationFundBalance']===0x0n)return{'name':'fund_safety','score':0x0,'maxScore':b,'description':'No\x20compensation\x20fund','humanReadable':'Compensation\x20fund:\x20none'};const c=a['compensationFundBalance'];if(a['typicalOrderAmount']!==undefined&&a['typicalOrderAmount']>0x0n){const g=Number(c*0x64n/a['typicalOrderAmount'])/0x64;let h,i;if(g>=0xa)h=b,i='Compensation\x20fund:\x20'+g['toFixed'](0x1)+'x\x20order\x20amount\x20(excellent)';else g>=0x1?(h=0xa+Math['round']((g-0x1)/0x9*0x5),i='Compensation\x20fund:\x20'+g['toFixed'](0x1)+'x\x20order\x20amount\x20(covers\x20≥1\x20payout)'):(h=Math['round'](g*0xa),i='Compensation\x20fund:\x20'+g['toFixed'](0x1)+'x\x20order\x20amount\x20(insufficient)');return{'name':'fund_safety','score':Math['min'](b,h),'maxScore':b,'description':'Fund\x20'+c['toString']()+'\x20/\x20typical\x20order\x20'+a['typicalOrderAmount']['toString']()+'\x20=\x20'+g['toFixed'](0x2)+'x','humanReadable':i};}const d=0xe8d4a51000n,e=Number(a['compensationFundBalance']*0x64n/d)/0x64,f=Math['min'](b,Math['round'](e*b));return{'name':'fund_safety','score':f,'maxScore':b,'description':'Compensation\x20fund\x20'+a['compensationFundBalance']+'\x20smallest\x20unit\x20(absolute\x20threshold\x20fallback)','humanReadable':'Compensation\x20fund:\x20'+e['toFixed'](0x2)+'x\x20absolute\x20threshold'};}function computeTransparencyDimension(a){const b=0xa;let c=0x0;if(a['hasPublishedEvents'])c+=0x4;if(a['hasMachineBound'])c+=0x3;if(a['hasBuyGuard'])c+=0x3;return{'name':'transparency','score':Math['min'](b,c),'maxScore':b,'description':'On-chain\x20events\x20'+(a['hasPublishedEvents']?'✓':'✗')+',\x20Machine\x20'+(a['hasMachineBound']?'✓':'✗')+',\x20Guard\x20'+(a['hasBuyGuard']?'✓':'✗'),'humanReadable':'Transparency:\x20'+(['Events','Machine','Guard']['filter']((d,e)=>[a['hasPublishedEvents'],a['hasMachineBound'],a['hasBuyGuard']][e])['join']('+')||'none')};}function buildSummary(a,b,c,e){const f=['Trust\x20score\x20'+a+'/100\x20('+b+')'];for(const g of e){f['push'](''+g['humanReadable']);}return f['join'](';\x20');}export function quickTrustCheck(a){const b=computeServiceTrustScore(a);if(b['score']<0x19)return{'pass':![],'reason':'Trust\x20score\x20'+b['score']+'/100,\x20high\x20risk:\x20'+b['warnings']['join'](';\x20')};return{'pass':!![],'reason':'Trust\x20score\x20'+b['score']+'/100\x20('+b['level']+')'};}

package/dist/knowledge/universal-template.d.ts

@@ -0,0 +1,22 @@
+export interface AntiCheatBaseline {
+    enabled: boolean;
+    rules: string[];
+}
+export interface UniversalTemplate {
+    template: "universal";
+    version: string;
+    anti_cheat_baseline: {
+        fake_orders: AntiCheatBaseline;
+        fake_reviews: AntiCheatBaseline;
+        shell_merchant: AntiCheatBaseline;
+        reputation_trade: AntiCheatBaseline;
+    };
+    pricing_redlines: string[];
+    governance_redlines: string[];
+    quality_signals: string[];
+    consumer_journey: string[];
+    north_star_metric: string;
+    revenue_boundary: string;
+}
+export declare const UNIVERSAL_TEMPLATE: UniversalTemplate;
+export declare function getUniversalTemplate(): UniversalTemplate;

package/dist/knowledge/universal-template.js

@@ -0,0 +1 @@
+export const UNIVERSAL_TEMPLATE={'template':'universal','version':'1.0.0','anti_cheat_baseline':{'fake_orders':{'enabled':!![],'rules':['self_trade','mutual_brush','no_fund_closure']},'fake_reviews':{'enabled':!![],'rules':['no_order_no_review','amount_weighted','small_order_decay']},'shell_merchant':{'enabled':!![],'rules':['no_arbitration','no_machine']},'reputation_trade':{'enabled':!![],'rules':['immune']}},'pricing_redlines':['profile_pricing','hidden_surcharge','post_order_price_change'],'governance_redlines':['no_bid_ranking','no_default_charge','no_take_rate','no_personal_info_on_chain'],'quality_signals':['trust_score','fund_visibility','fulfillment','review_reputation','tenure'],'consumer_journey':['awareness','diligence','compare','decide','fulfill','review','retain','repurchase'],'north_star_metric':'weekly_completed_orders','revenue_boundary':'no_take_rate'};export function getUniversalTemplate(){return UNIVERSAL_TEMPLATE;}

package/dist/knowledge/util-confirm.d.ts

@@ -0,0 +1,24 @@
+export declare const UTIL_CONFIRM_VERSION = "1.0.0";
+export type ConfirmSeverity = "block" | "warn" | "info";
+export interface UtilConfirmItem {
+    id: string;
+    severity: ConfirmSeverity;
+    title: string;
+    description: string;
+    passed: boolean;
+    evidence?: string;
+    fix_hint?: string;
+}
+export interface UtilCallCheckInput {
+    uses_typo_function_name?: boolean;
+    assumes_stable_address_bytes?: boolean;
+    bcs_manually_synced?: boolean;
+}
+export declare function preCheckUtilCall(input: UtilCallCheckInput): UtilConfirmItem[];
+export declare function canProceedUtilCall(input: UtilCallCheckInput): {
+    canProceed: boolean;
+    blockers: UtilConfirmItem[];
+    warnings: UtilConfirmItem[];
+    info: UtilConfirmItem[];
+};
+export declare function formatUtilCallSummary(input: UtilCallCheckInput): string;

package/dist/knowledge/util-confirm.js

@@ -0,0 +1 @@
+export const UTIL_CONFIRM_VERSION='1.0.0';function checkTypo(a){const b=!!a['uses_typo_function_name'];return{'id':'C-UTIL-01','severity':b?'info':'info','title':'Typo\x27d\x20function\x20name\x20is\x20handled\x20(is_chiild_object_address_byte)','description':'util.move\x20defines\x20is_chiild_object_address_byte\x20with\x20a\x20\x27chiild\x27\x20typo;\x20it\x20cannot\x20be\x20renamed\x20post-publish.\x20The\x20SDK\x20should\x20expose\x20a\x20correct\x20alias.','passed':!![],'evidence':b?'uses_typo_function_name=true\x20(must\x20use\x20\x27chiild\x27)':'typo\x20handled\x20via\x20alias'};}function checkAddressBytes(a){const b=!!a['assumes_stable_address_bytes'];return{'id':'C-UTIL-02','severity':b?'warn':'info','title':'Address-byte\x20thresholds\x20are\x20hardcoded','description':'util.move\x20classifies\x20addresses\x20by\x20first\x20byte\x20(user\x20≤0x06,\x20object\x200xf1,\x20child_object\x200xf0).\x20A\x20Wow\x20protocol\x20upgrade\x20could\x20invalidate\x20them.','passed':!b,'evidence':b?'assumes_stable_address_bytes=true':'upgrade\x20coupling\x20understood','fix_hint':'Track\x20Wow\x20address-layout\x20upgrades;\x20ship\x20util.move\x20+\x20SDK\x20in\x20lockstep.'};}function checkBcs(a){const b=a['bcs_manually_synced']===!![];return{'id':'C-UTIL-03','severity':b?'warn':'info','title':'SDK\x20BCS\x20structures\x20stay\x20in\x20sync\x20with\x20Move\x20structs','description':'util.ts\x20defines\x20BCS\x20query\x20structures\x20that\x20must\x20match\x20Move\x20layouts\x20byte-for-byte;\x20drift\x20breaks\x20queries\x20silently.','passed':!b,'evidence':b?'bcs_manually_synced=true\x20(drift\x20risk)':'BCS\x20sync\x20safe','fix_hint':'Generate\x20BCS\x20from\x20Move\x20via\x20codegen,\x20or\x20run\x20a\x20layout\x20sync\x20test.'};}export function preCheckUtilCall(a){return[checkTypo(a),checkAddressBytes(a),checkBcs(a)];}export function canProceedUtilCall(a){const b=preCheckUtilCall(a);return{'canProceed':b['every'](c=>c['severity']!=='block'||c['passed']),'blockers':b['filter'](c=>c['severity']==='block'&&!c['passed']),'warnings':b['filter'](c=>c['severity']==='warn'&&!c['passed']),'info':b['filter'](c=>c['severity']==='info')};}export function formatUtilCallSummary(a){const {canProceed:b,warnings:c}=canProceedUtilCall(a),d=[b?'✓\x20Util\x20call\x20pre-check\x20PASSED':'✗\x20Util\x20call\x20pre-check\x20FAILED',''];return c['length']>0x0&&(d['push']('WARNINGS:'),c['forEach'](e=>d['push']('\x20\x20['+e['id']+']\x20'+e['title']+'\x20—\x20'+(e['evidence']??'')))),d['join']('\x0a');}

package/dist/knowledge/util-risk.js

@@ -1,135 +1 @@
-const USER_ADDRESS_BYTE_MAX = 0x06;
-const OBJECT_ADDRESS_BYTE = 0xf1;
-const CHILD_OBJECT_ADDRESS_BYTE = 0xf0;
-const R_U_01 = {
-    rule: {
-        id: "R-UTIL-01",
-        level: "LOW",
-        category: "semantic",
-        title: "is_chiild_object_address_byte has a typo ('chiild') — cannot be renamed post-publish",
-        description: "util.move:30 defines is_chiild_object_address_byte (note the 'chiild' typo). The " +
-            "function is already published on mainnet, so the name cannot be fixed without a " +
-            "breaking package upgrade. Callers must use the misspelled name exactly; SDK wrappers " +
-            "should expose a correctly-spelled alias and route to the typo function.",
-        affected_stakeholders: ["caller"],
-        scenario: "Caller writes is_child_object_address_byte; Move linker cannot resolve the symbol",
-        mitigation: "SDK should expose isChildObjectAddressByte as the public API and internally call the " +
-            "typo'd Move function. Document the typo so future maintainers don't 'fix' it.",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (!ctx.uses_typo_function_name)
-            return null;
-        return { ...R_U_01.rule, evidence: "uses_typo_function_name=true (must use 'chiild')" };
-    },
-};
-const R_U_02 = {
-    rule: {
-        id: "R-UTIL-02",
-        level: "MEDIUM",
-        category: "semantic",
-        title: "Address-byte thresholds are hardcoded — Wow protocol upgrades could invalidate them",
-        description: `util.move classifies addresses by first byte: user (≤ ${USER_ADDRESS_BYTE_MAX}), ` +
-            `object (${OBJECT_ADDRESS_BYTE}), child_object (${CHILD_OBJECT_ADDRESS_BYTE}). ` +
-            `These thresholds are hardcoded as Move constants, not configurable. If a future Wow ` +
-            `protocol upgrade changes the address byte layout (e.g. reserves a new prefix), Util ` +
-            `would silently misclassify addresses until the Move code is upgraded.`,
-        affected_stakeholders: ["caller", "system"],
-        scenario: "Wow protocol upgrade introduces a new address prefix; Util misclassifies it as user",
-        mitigation: "Track Wow protocol upgrades that touch address layout. When a change ships, upgrade " +
-            "util.move and the SDK in lockstep. Add a sync test that asserts the byte values.",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (!ctx.assumes_stable_address_bytes)
-            return null;
-        return { ...R_U_02.rule, evidence: `assumes_stable_address_bytes=true (hardcoded ${USER_ADDRESS_BYTE_MAX}/${OBJECT_ADDRESS_BYTE}/${CHILD_OBJECT_ADDRESS_BYTE})` };
-    },
-};
-const R_U_03 = {
-    rule: {
-        id: "R-UTIL-03",
-        level: "LOW",
-        category: "structural",
-        title: "util.ts is ~50KB — over-concentrated, hard to navigate",
-        description: "The SDK util.ts is ~50428 bytes, mixing BCS structure definitions, query condition " +
-            "builders, Guard query helpers, and address utilities. The size makes it hard to " +
-            "navigate and increases the risk of accidental circular imports. New contributors " +
-            "often import the wrong symbol because so many are exported from one file.",
-        affected_stakeholders: ["caller", "system"],
-        scenario: "Developer imports ProgressHistoryFindConditionsBCS and accidentally pulls in unrelated code",
-        mitigation: "Consider splitting util.ts into focused sub-modules (bcs.ts, query.ts, address.ts). " +
-            "Until then, prefer named imports over namespace imports to keep bundles lean.",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (!ctx.large_util_import)
-            return null;
-        return { ...R_U_03.rule, evidence: "large_util_import=true (consider sub-modules)" };
-    },
-};
-const R_U_04 = {
-    rule: {
-        id: "R-UTIL-04",
-        level: "LOW",
-        category: "lifecycle",
-        title: "Util emits no events — tool-call observability is caller's responsibility",
-        description: "Util functions are pure: they neither emit nor consume events. Callers cannot rely on " +
-            "an event stream to trace Util invocations. For audit and debugging, the calling " +
-            "module must record its own log entries around Util calls.",
-        affected_stakeholders: ["caller"],
-        scenario: "Auditor expects Util-call events; none exist, the call chain is invisible",
-        mitigation: "Callers should emit their own events or write logs around Util calls when auditability " +
-            "is required. Treat Util as an opaque library function.",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (!ctx.expects_util_events)
-            return null;
-        return { ...R_U_04.rule, evidence: "expects_util_events=true (none emitted)" };
-    },
-};
-const R_U_05 = {
-    rule: {
-        id: "R-UTIL-05",
-        level: "MEDIUM",
-        category: "cross_object",
-        title: "SDK BCS structures must stay in sync with Move structs — drift breaks queries",
-        description: "util.ts defines BCS structures for Progress History / Session / Forward / Record " +
-            "query conditions. These must match the Move struct layouts byte-for-byte. If a Move " +
-            "struct adds a field and the SDK BCS is not regenerated, query submissions will " +
-            "deserialize incorrectly on-chain, producing silent failures or aborts.",
-        affected_stakeholders: ["caller", "system"],
-        scenario: "Progress struct adds a field; SDK BCS is stale; queries return wrong results",
-        mitigation: "Generate BCS structures from Move source via codegen, or run a sync test that " +
-            "compares SDK BCS layouts against Move structs on every release.",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (ctx.bcs_manually_synced === undefined)
-            return null;
-        if (!ctx.bcs_manually_synced)
-            return null;
-        return { ...R_U_05.rule, evidence: "bcs_manually_synced=true (drift risk)" };
-    },
-};
-export const UTIL_RISK_RULES = [
-    R_U_01,
-    R_U_02,
-    R_U_03,
-    R_U_04,
-    R_U_05,
-];
-export const UTIL_RISK_VERSION = "1.0.0";
-export function checkUtilRisks(ctx) {
-    const risks = [];
-    for (const rule of UTIL_RISK_RULES) {
-        const r = rule.check(ctx);
-        if (r)
-            risks.push(r);
-    }
-    return risks;
-}
-export function getUtilRiskById(id) {
-    return UTIL_RISK_RULES.find(r => r.rule.id === id)?.rule;
-}
+const USER_ADDRESS_BYTE_MAX=0x6,OBJECT_ADDRESS_BYTE=0xf1,CHILD_OBJECT_ADDRESS_BYTE=0xf0,R_U_01={'rule':{'id':'R-UTIL-01','level':'LOW','category':'semantic','title':'is_chiild_object_address_byte\x20has\x20a\x20typo\x20(\x27chiild\x27)\x20—\x20cannot\x20be\x20renamed\x20post-publish','description':'util.move:30\x20defines\x20is_chiild_object_address_byte\x20(note\x20the\x20\x27chiild\x27\x20typo).\x20The\x20'+'function\x20is\x20already\x20published\x20on\x20mainnet,\x20so\x20the\x20name\x20cannot\x20be\x20fixed\x20without\x20a\x20'+'breaking\x20package\x20upgrade.\x20Callers\x20must\x20use\x20the\x20misspelled\x20name\x20exactly;\x20SDK\x20wrappers\x20'+'should\x20expose\x20a\x20correctly-spelled\x20alias\x20and\x20route\x20to\x20the\x20typo\x20function.','affected_stakeholders':['caller'],'scenario':'Caller\x20writes\x20is_child_object_address_byte;\x20Move\x20linker\x20cannot\x20resolve\x20the\x20symbol','mitigation':'SDK\x20should\x20expose\x20isChildObjectAddressByte\x20as\x20the\x20public\x20API\x20and\x20internally\x20call\x20the\x20'+'typo\x27d\x20Move\x20function.\x20Document\x20the\x20typo\x20so\x20future\x20maintainers\x20don\x27t\x20\x27fix\x27\x20it.','auto_fixable':![]},'check':a=>{if(!a['uses_typo_function_name'])return null;return{...R_U_01['rule'],'evidence':'uses_typo_function_name=true\x20(must\x20use\x20\x27chiild\x27)'};}},R_U_02={'rule':{'id':'R-UTIL-02','level':'MEDIUM','category':'semantic','title':'Address-byte\x20thresholds\x20are\x20hardcoded\x20—\x20Wow\x20protocol\x20upgrades\x20could\x20invalidate\x20them','description':'util.move\x20classifies\x20addresses\x20by\x20first\x20byte:\x20user\x20(≤\x20'+USER_ADDRESS_BYTE_MAX+'),\x20'+('object\x20('+OBJECT_ADDRESS_BYTE+'),\x20child_object\x20('+CHILD_OBJECT_ADDRESS_BYTE+').\x20')+'These\x20thresholds\x20are\x20hardcoded\x20as\x20Move\x20constants,\x20not\x20configurable.\x20If\x20a\x20future\x20Wow\x20'+'protocol\x20upgrade\x20changes\x20the\x20address\x20byte\x20layout\x20(e.g.\x20reserves\x20a\x20new\x20prefix),\x20Util\x20'+'would\x20silently\x20misclassify\x20addresses\x20until\x20the\x20Move\x20code\x20is\x20upgraded.','affected_stakeholders':['caller','system'],'scenario':'Wow\x20protocol\x20upgrade\x20introduces\x20a\x20new\x20address\x20prefix;\x20Util\x20misclassifies\x20it\x20as\x20user','mitigation':'Track\x20Wow\x20protocol\x20upgrades\x20that\x20touch\x20address\x20layout.\x20When\x20a\x20change\x20ships,\x20upgrade\x20'+'util.move\x20and\x20the\x20SDK\x20in\x20lockstep.\x20Add\x20a\x20sync\x20test\x20that\x20asserts\x20the\x20byte\x20values.','auto_fixable':![]},'check':a=>{if(!a['assumes_stable_address_bytes'])return null;return{...R_U_02['rule'],'evidence':'assumes_stable_address_bytes=true\x20(hardcoded\x20'+USER_ADDRESS_BYTE_MAX+'/'+OBJECT_ADDRESS_BYTE+'/'+CHILD_OBJECT_ADDRESS_BYTE+')'};}},R_U_03={'rule':{'id':'R-UTIL-03','level':'LOW','category':'structural','title':'util.ts\x20is\x20~50KB\x20—\x20over-concentrated,\x20hard\x20to\x20navigate','description':'The\x20SDK\x20util.ts\x20is\x20~50428\x20bytes,\x20mixing\x20BCS\x20structure\x20definitions,\x20query\x20condition\x20'+'builders,\x20Guard\x20query\x20helpers,\x20and\x20address\x20utilities.\x20The\x20size\x20makes\x20it\x20hard\x20to\x20'+'navigate\x20and\x20increases\x20the\x20risk\x20of\x20accidental\x20circular\x20imports.\x20New\x20contributors\x20'+'often\x20import\x20the\x20wrong\x20symbol\x20because\x20so\x20many\x20are\x20exported\x20from\x20one\x20file.','affected_stakeholders':['caller','system'],'scenario':'Developer\x20imports\x20ProgressHistoryFindConditionsBCS\x20and\x20accidentally\x20pulls\x20in\x20unrelated\x20code','mitigation':'Consider\x20splitting\x20util.ts\x20into\x20focused\x20sub-modules\x20(bcs.ts,\x20query.ts,\x20address.ts).\x20'+'Until\x20then,\x20prefer\x20named\x20imports\x20over\x20namespace\x20imports\x20to\x20keep\x20bundles\x20lean.','auto_fixable':![]},'check':a=>{if(!a['large_util_import'])return null;return{...R_U_03['rule'],'evidence':'large_util_import=true\x20(consider\x20sub-modules)'};}},R_U_04={'rule':{'id':'R-UTIL-04','level':'LOW','category':'lifecycle','title':'Util\x20emits\x20no\x20events\x20—\x20tool-call\x20observability\x20is\x20caller\x27s\x20responsibility','description':'Util\x20functions\x20are\x20pure:\x20they\x20neither\x20emit\x20nor\x20consume\x20events.\x20Callers\x20cannot\x20rely\x20on\x20'+'an\x20event\x20stream\x20to\x20trace\x20Util\x20invocations.\x20For\x20audit\x20and\x20debugging,\x20the\x20calling\x20'+'module\x20must\x20record\x20its\x20own\x20log\x20entries\x20around\x20Util\x20calls.','affected_stakeholders':['caller'],'scenario':'Auditor\x20expects\x20Util-call\x20events;\x20none\x20exist,\x20the\x20call\x20chain\x20is\x20invisible','mitigation':'Callers\x20should\x20emit\x20their\x20own\x20events\x20or\x20write\x20logs\x20around\x20Util\x20calls\x20when\x20auditability\x20'+'is\x20required.\x20Treat\x20Util\x20as\x20an\x20opaque\x20library\x20function.','auto_fixable':![]},'check':a=>{if(!a['expects_util_events'])return null;return{...R_U_04['rule'],'evidence':'expects_util_events=true\x20(none\x20emitted)'};}},R_U_05={'rule':{'id':'R-UTIL-05','level':'MEDIUM','category':'cross_object','title':'SDK\x20BCS\x20structures\x20must\x20stay\x20in\x20sync\x20with\x20Move\x20structs\x20—\x20drift\x20breaks\x20queries','description':'util.ts\x20defines\x20BCS\x20structures\x20for\x20Progress\x20History\x20/\x20Session\x20/\x20Forward\x20/\x20Record\x20'+'query\x20conditions.\x20These\x20must\x20match\x20the\x20Move\x20struct\x20layouts\x20byte-for-byte.\x20If\x20a\x20Move\x20'+'struct\x20adds\x20a\x20field\x20and\x20the\x20SDK\x20BCS\x20is\x20not\x20regenerated,\x20query\x20submissions\x20will\x20'+'deserialize\x20incorrectly\x20on-chain,\x20producing\x20silent\x20failures\x20or\x20aborts.','affected_stakeholders':['caller','system'],'scenario':'Progress\x20struct\x20adds\x20a\x20field;\x20SDK\x20BCS\x20is\x20stale;\x20queries\x20return\x20wrong\x20results','mitigation':'Generate\x20BCS\x20structures\x20from\x20Move\x20source\x20via\x20codegen,\x20or\x20run\x20a\x20sync\x20test\x20that\x20'+'compares\x20SDK\x20BCS\x20layouts\x20against\x20Move\x20structs\x20on\x20every\x20release.','auto_fixable':![]},'check':a=>{if(a['bcs_manually_synced']===undefined)return null;if(!a['bcs_manually_synced'])return null;return{...R_U_05['rule'],'evidence':'bcs_manually_synced=true\x20(drift\x20risk)'};}};export const UTIL_RISK_RULES=[R_U_01,R_U_02,R_U_03,R_U_04,R_U_05];export const UTIL_RISK_VERSION='1.0.0';export function checkUtilRisks(a){const b=[];for(const c of UTIL_RISK_RULES){const d=c['check'](a);if(d)b['push'](d);}return b;}export function getUtilRiskById(a){return UTIL_RISK_RULES['find'](b=>b['rule']['id']===a)?.['rule'];}

package/dist/knowledge/util-translation.d.ts

@@ -0,0 +1,38 @@
+export declare const UTIL_TRANSLATION_VERSION = "1.0.0";
+export declare const UTIL_ADDRESS_BYTES: {
+    readonly USER_MAX: 6;
+    readonly OBJECT: 241;
+    readonly CHILD_OBJECT: 240;
+};
+export interface SemanticToUtilSchemaRule {
+    id: string;
+    pattern_name: string;
+    semantic_intent: string;
+    match_keywords: string[];
+    example: Record<string, unknown>;
+}
+export declare const SEMANTIC_TO_UTIL_SCHEMA_RULES: SemanticToUtilSchemaRule[];
+export interface UtilFieldTranslation {
+    field_name: string;
+    value_type: string;
+    semantic: string;
+    format_example: string;
+    validation_rules: string[];
+}
+export declare const UTIL_FIELD_TRANSLATIONS: UtilFieldTranslation[];
+export interface UtilConstraintRule {
+    id: string;
+    name: string;
+    description: string;
+    related_field: string;
+}
+export declare const UTIL_CONSTRAINT_RULES: UtilConstraintRule[];
+export interface UtilExplainInput {
+    first_byte?: number;
+}
+export interface UtilExplanation {
+    summary: string;
+    classification: string;
+    warnings: string[];
+}
+export declare function explainUtil(input: UtilExplainInput): UtilExplanation;

package/dist/knowledge/util-translation.js

@@ -0,0 +1 @@
+export const UTIL_TRANSLATION_VERSION='1.0.0';export const UTIL_ADDRESS_BYTES={'USER_MAX':0x6,'OBJECT':0xf1,'CHILD_OBJECT':0xf0};export const SEMANTIC_TO_UTIL_SCHEMA_RULES=[{'id':'P-UTIL-01','pattern_name':'Classify\x20address','semantic_intent':'Determine\x20whether\x20an\x20address\x20is\x20a\x20user,\x20object,\x20or\x20child-object.','match_keywords':['is\x20user\x20address','is\x20object\x20address','classify\x20address'],'example':{'addr':'0x...'}}];export const UTIL_FIELD_TRANSLATIONS=[{'field_name':'first_byte','value_type':'u8','semantic':'Address\x20classification\x20byte:\x20user\x20≤\x200x06,\x20object\x200xf1,\x20child_object\x200xf0.','format_example':'0xf1\x20(object)','validation_rules':['hardcoded\x20in\x20util.move']}];export const UTIL_CONSTRAINT_RULES=[{'id':'UTIL_C_01','name':'typo\x20function','description':'is_chiild_object_address_byte\x20has\x20a\x20\x27chiild\x27\x20typo;\x20cannot\x20rename\x20post-publish.','related_field':'first_byte'},{'id':'UTIL_C_02','name':'address-byte\x20stability','description':'byte\x20thresholds\x20are\x20hardcoded;\x20Wow\x20upgrade\x20could\x20invalidate\x20them.','related_field':'first_byte'},{'id':'UTIL_C_03','name':'BCS\x20sync','description':'SDK\x20BCS\x20structures\x20must\x20match\x20Move\x20layouts\x20byte-for-byte.','related_field':'first_byte'}];export function explainUtil(a){const b=[];let c='unknown';if(a['first_byte']!==undefined){if(a['first_byte']<=UTIL_ADDRESS_BYTES['USER_MAX'])c='user\x20address';else{if(a['first_byte']===UTIL_ADDRESS_BYTES['OBJECT'])c='object\x20address';else{if(a['first_byte']===UTIL_ADDRESS_BYTES['CHILD_OBJECT'])c='child\x20object\x20address';else b['push']('first\x20byte\x200x'+a['first_byte']['toString'](0x10)+'\x20not\x20in\x20known\x20classification\x20range');}}}return{'summary':'Util\x20address\x20classification:\x20'+c+'.','classification':c,'warnings':b};}

package/dist/knowledge/workflow-guidance.d.ts

@@ -0,0 +1,116 @@
+export interface ParsedForward {
+    name: string;
+    weight: number;
+    namedOperator?: string | null;
+    permissionIndex?: number | null;
+    guard?: string;
+}
+export interface ParsedPair {
+    prev_node: string;
+    threshold: number;
+    forwards: ParsedForward[];
+}
+export interface ParsedMachineNode {
+    name: string;
+    pairs: ParsedPair[];
+}
+export type NameResolver = (addr: string | undefined | null) => string | undefined;
+export declare function resolvePermissionRole(index: number | undefined | null, permissionDescription?: string): string;
+export declare function fetchMachineNodes(machine: string, network?: string, noCache?: boolean): Promise<ParsedMachineNode[]>;
+export interface GuidanceInput {
+    current: string;
+    nodes: ParsedMachineNode[];
+    caller?: string;
+    orderHolderAddresses?: string[];
+    permissionDescription?: string;
+    nameResolver?: NameResolver;
+}
+export interface OperatorInfo {
+    kind: "order_holder" | "permission_index" | "named_operator";
+    permission_index?: number;
+    role_name?: string;
+    account_name?: string;
+    named_operator?: string;
+}
+export interface OptionInfo {
+    next_node: string;
+    forward: string;
+    weight: number;
+    operator: OperatorInfo;
+    guard?: string;
+    business_meaning: string;
+    gains: string[];
+    risks: string[];
+    consistency: number;
+    recommended: boolean;
+}
+export interface GuidanceResult {
+    current_node: string;
+    caller?: string;
+    options: OptionInfo[];
+    recommendation?: {
+        best?: string;
+        rationale?: string;
+        caveat?: string;
+    };
+    note?: string;
+}
+export declare function buildWorkflowGuidance(input: GuidanceInput): GuidanceResult;
+export interface ReceiptInput extends GuidanceInput {
+    callerName: string;
+    forward: string;
+    targetNode: string;
+    op?: string;
+    session?: Array<{
+        next_node?: string;
+        forwards?: Array<{
+            forward?: string;
+            accomplished?: boolean;
+        }>;
+        weights?: number;
+        threshold?: number;
+    }>;
+}
+export interface WaitingInfo {
+    forward: string;
+    operator: OperatorInfo;
+}
+export interface ReceiptResult {
+    account: string;
+    action: string;
+    forward: string;
+    target_node: string;
+    op?: string;
+    migrated: boolean;
+    current_node: string;
+    threshold?: number;
+    accumulated_weight?: number;
+    remaining?: number;
+    waiting_on?: WaitingInfo[];
+    next_guidance?: GuidanceResult;
+    note?: string;
+}
+export declare function buildWorkflowReceipt(input: ReceiptInput): ReceiptResult;
+export declare function renderGuidanceText(g: GuidanceResult): string;
+export declare function renderReceiptText(r: ReceiptResult): string;
+export interface EnrichOptions {
+    progressRef: string;
+    network?: string;
+    accountName?: string;
+    operate?: {
+        forward?: string;
+        next_node_name?: string;
+        op?: string;
+    };
+    noCache?: boolean;
+}
+export interface EnrichResult {
+    guidance?: GuidanceResult;
+    receipt?: ReceiptResult;
+    text?: string;
+}
+export declare function enrichWorkflowGuidance(opts: EnrichOptions): Promise<EnrichResult | undefined>;
+export declare function mergeGuidanceIntoOutput<T extends {
+    content: any[];
+    structuredContent: any;
+}>(output: T, enrichment: EnrichResult | undefined): T;

package/dist/knowledge/workflow-guidance.js

@@ -0,0 +1 @@
+import{query_objects,query_table,LocalMark,GetLocalNamesByAddresses}from'@wowok/wowok';import{REPOSITORY_PERMISSIONS,REWARD_PERMISSIONS,MACHINE_PERMISSIONS,PROGRESS_PERMISSIONS,TREASURY_PERMISSIONS,SERVICE_PERMISSIONS,ARBITRATION_PERMISSIONS,DEMAND_PERMISSIONS,CONTACT_PERMISSIONS}from'./permission-ledger.js';const BUILTIN_PERMISSION_MAP=new Map();for(const entry of[...REPOSITORY_PERMISSIONS,...REWARD_PERMISSIONS,...MACHINE_PERMISSIONS,...PROGRESS_PERMISSIONS,...TREASURY_PERMISSIONS,...SERVICE_PERMISSIONS,...ARBITRATION_PERMISSIONS,...DEMAND_PERMISSIONS,...CONTACT_PERMISSIONS]){BUILTIN_PERMISSION_MAP['set'](entry['index'],entry['name']);}export function resolvePermissionRole(a,b){if(a===undefined||a===null)return'unknown\x20role';if(b){const d=/([A-Za-z][A-Za-z0-9_]*)\s*=\s*(\d+)/g;let e;while((e=d['exec'](b))!==null){if(Number(e[0x2])===a)return e[0x1]+'\x20(permission\x20'+a+')';}}const c=BUILTIN_PERMISSION_MAP['get'](a);if(c)return c+'\x20(permission\x20'+a+')';return'permission\x20'+a;}export async function fetchMachineNodes(a,b,c){const d=await query_objects({'objects':[a],'no_cache':c,'network':b}),e=d?.['objects']?.[0x0],f=e?.['object']??(typeof a==='string'&&a['startsWith']('0x')?a:undefined);if(!f)return[];const g=await query_table({'parent':f,'no_cache':c,'network':b}),h=(g?.['items']??[])['map'](j=>j?.['object'])['filter'](j=>typeof j==='string');if(h['length']===0x0)return[];const i=await query_objects({'objects':h,'no_cache':c,'network':b});return(i?.['objects']??[])['filter'](j=>j?.['type']==='TableItem_MachineNode')['map'](j=>{const k=j?.['data']??j,l=typeof k?.['name']==='string'?k['name']:'',m=Array['isArray'](k?.['value'])?k['value']:Array['isArray'](k?.['pairs'])?k['pairs']:[];if(!l)return null;return{'name':l,'pairs':m['map'](n=>({'prev_node':String(n?.['prev_node']??''),'threshold':Number(n?.['threshold']??0x0),'forwards':Array['isArray'](n?.['forwards'])?n['forwards']['map'](q=>{const r=typeof q?.['guard']==='object'&&q?.['guard']!==null?q['guard']['guard']??undefined:typeof q?.['guard']==='string'?q['guard']:undefined;return{'name':String(q?.['name']??''),'weight':Number(q?.['weight']??0x0),'namedOperator':q?.['namedOperator']!==undefined&&q?.['namedOperator']!==null?String(q['namedOperator']):undefined,'permissionIndex':q?.['permissionIndex']!==undefined&&q?.['permissionIndex']!==null?Number(q['permissionIndex']):undefined,'guard':r};}):[]}))};})['filter'](j=>j!==null);}const COMPLETE_RE=/(^|_)(completed?|done|finished|received|delivered|accepted|confirmed|finalized|success|approved)(_|$)/i,REFUND_RE=/(^|_)(cancel(led)?|refund(ed)?|return(ed|_approved)?)(_|$)/i,EXCEPTION_RE=/(^|_)(interrupt(ed)?|exception|dispute(d)?|fail(ed)?|abort(ed)?|reject(ed)?)(_|$)/i;function classifyNode(a){if(COMPLETE_RE['test'](a))return'complete';if(REFUND_RE['test'](a))return'refund';if(EXCEPTION_RE['test'](a))return'exception';return'advance';}function businessMeaning(a,b){switch(b){case'complete':return'Service/deliverable\x20accepted\x20at\x20\x22'+a+'\x22\x20—\x20triggers\x20settlement\x20allocation\x20(funds\x20released\x20to\x20the\x20provider)';case'refund':return'Order\x20cancelled/returned\x20at\x20\x22'+a+'\x22\x20—\x20triggers\x20refund\x20allocation\x20(funds\x20back\x20to\x20the\x20customer)';case'exception':return'Exception\x20path\x20at\x20\x22'+a+'\x22\x20—\x20typically\x20routes\x20to\x20arbitration\x20or\x20partial-refund\x20handling';default:return'Progress\x20to\x20\x22'+a+'\x22';}}function shortAddr(a){if(!a)return undefined;if(a['length']>0xe)return a['slice'](0x0,0x8)+'...'+a['slice'](-0x4);return a;}function callerIsOrderHolder(a,b){if(!a||!b?.['length'])return![];const d=a['toLowerCase']();return b['some'](e=>e?.['toLowerCase']()===d);}function resolveOperator(a,b,c,d){if(a['namedOperator']===''){const e=b?.[0x0];return{'kind':'order_holder','role_name':'order\x20holder\x20(customer)','account_name':d?d(e):shortAddr(e)};}if(typeof a['namedOperator']==='string'&&a['namedOperator']['length']>0x0)return{'kind':'named_operator','named_operator':a['namedOperator'],'role_name':'named\x20operator\x20\x22'+a['namedOperator']+'\x22'};if(a['permissionIndex']!==undefined&&a['permissionIndex']!==null)return{'kind':'permission_index','permission_index':a['permissionIndex'],'role_name':resolvePermissionRole(a['permissionIndex'],c)};return{'kind':'order_holder','role_name':'unknown\x20operator'};}function gainsRisksFor(a,b,c){if(!c)return{'gains':[],'risks':[]};if(b)switch(a){case'complete':return{'gains':['Flow\x20advances','Settlement\x20triggered\x20(funds\x20released)'],'risks':['Funds\x20released\x20to\x20provider','Refund\x20leverage\x20lost\x20—\x20confirm\x20only\x20if\x20service\x20verified']};case'refund':return{'gains':['Funds\x20returned\x20to\x20you'],'risks':['If\x20service\x20was\x20already\x20rendered,\x20cancellation\x20may\x20be\x20disputed']};case'exception':return{'gains':['Avoids\x20stalemate'],'risks':['May\x20trigger\x20arbitration\x20/\x20reputation\x20impact']};default:return{'gains':['Flow\x20advances'],'risks':[]};}switch(a){case'complete':return{'gains':['Settlement\x20triggered\x20—\x20funds\x20released\x20to\x20provider'],'risks':[]};case'refund':return{'gains':['Clean\x20closure'],'risks':['Lost\x20revenue\x20for\x20this\x20order']};case'exception':return{'gains':['Avoids\x20stalemate'],'risks':['May\x20trigger\x20arbitration\x20/\x20compensation\x20fund']};default:return{'gains':['Flow\x20advances'],'risks':[]};}}function consistencyFor(a,b,c,d,e){let f;if(!e)f=a==='exception'?0x2d:0x32;else b?f=a==='refund'?0x46:a==='complete'?0x37:a==='exception'?0x23:0x32:f=a==='complete'?0x4b:a==='refund'?0x1e:a==='exception'?0x23:0x32;if(e&&c)f+=0x14;if(d)f-=0xa;return Math['max'](0x0,Math['min'](0x64,f));}export function buildWorkflowGuidance(a){const b=[];for(const i of a['nodes']){for(const j of i['pairs']){if(j['prev_node']!==a['current'])continue;for(const k of j['forwards']){if(!k['name'])continue;const l=resolveOperator(k,a['orderHolderAddresses'],a['permissionDescription'],a['nameResolver']),m=callerIsOrderHolder(a['caller'],a['orderHolderAddresses']);let n=![];if(l['kind']==='order_holder'&&a['caller']){const u=a['caller']['toLowerCase']();n=!!a['orderHolderAddresses']?.['some'](v=>v?.['toLowerCase']()===u)||u===(l['account_name']??'')['toLowerCase']();}else{if(l['kind']==='named_operator')n=!![];else l['kind']==='permission_index'&&(n=!![]);}const p=classifyNode(i['name']),q=!!a['caller'],{gains:r,risks:s}=gainsRisksFor(p,m,q),t=consistencyFor(p,m,n,!!k['guard'],q);b['push']({'next_node':i['name'],'forward':k['name'],'weight':k['weight'],'operator':l,'guard':k['guard'],'business_meaning':businessMeaning(i['name'],p),'gains':r,'risks':s,'consistency':t,'recommended':![]});}}}if(b['length']===0x0)return{'current_node':a['current'],'caller':a['caller'],'options':[],'note':'Node\x20\x22'+a['current']+'\x22\x20has\x20no\x20outgoing\x20forwards\x20—\x20it\x20is\x20a\x20terminal\x20node\x20(or\x20the\x20workflow\x20is\x20stuck).\x20No\x20further\x20progress\x20operation\x20is\x20available\x20here.'};b['sort']((v,w)=>w['consistency']-v['consistency']);const c=b[0x0];b[0x0]={...c,'recommended':!![]};const d=[];for(const v of b){v!==c&&v['consistency']>0x0&&v['forward']!==c['forward']&&d['push']('Choosing\x20\x22'+v['forward']+'\x20→\x20'+v['next_node']+'\x22\x20forfeits\x20the\x20faster/more\x20aligned\x20path\x20\x22'+c['forward']+'\x20→\x20'+c['next_node']+'\x22');}const e=[],g=b['filter'](w=>w['operator']['kind']==='order_holder'&&w['forward']!==c['forward']&&c['forward']!==w['forward']),h=b['filter'](w=>w['operator']['account_name']&&w['operator']['account_name']!==a['caller']);return h['length']>0x0&&!b['some'](w=>w['recommended']&&w['operator']['account_name']===a['caller'])&&e['push']('The\x20recommended\x20action\x20is\x20executed\x20by\x20another\x20account\x20('+h[0x0]['operator']['account_name']+');\x20switch\x20the\x20signing\x20account\x20(env.account)\x20before\x20operating.'),{'current_node':a['current'],'caller':a['caller'],'options':b,'recommendation':{'best':c['forward']+'\x20→\x20'+c['next_node'],'rationale':'Highest\x20consistency\x20('+c['consistency']+'/100)\x20with\x20the\x20caller\x27s\x20interests.\x20Gains:\x20'+(c['gains']['join'](';\x20')||'none')+'.\x20Risks:\x20'+(c['risks']['join'](';\x20')||'none')+'.\x20Operator:\x20'+(c['operator']['role_name']??c['operator']['kind'])+(c['operator']['account_name']?'\x20('+c['operator']['account_name']+')':'')+'.'+(c['guard']?'\x20Guard\x20to\x20satisfy:\x20'+c['guard']+'.':''),'caveat':d['length']?d['join']('.\x20'):undefined},'note':e['length']?e['join']('\x20'):undefined};}export function buildWorkflowReceipt(a){const b=a['current']===a['targetNode'],c={'account':a['callerName'],'action':a['callerName']+'\x20executed\x20'+a['forward']+'\x20(→\x20'+a['targetNode']+')','forward':a['forward'],'target_node':a['targetNode'],'op':a['op'],'migrated':b,'current_node':a['current']};if(!b){const e=a['nodes']['filter'](j=>j['name']===a['targetNode'])['flatMap'](j=>j['pairs'])['find'](j=>j['prev_node']===a['current']),g=a['session']?.['slice'](-0x1)[0x0],h=g?.['threshold']??e?.['threshold']??0x0,i=g?.['weights']??0x0;if(h>0x0){c['threshold']=h,c['accumulated_weight']=i,c['remaining']=Math['max'](0x0,h-i);const j=new Set((g?.['forwards']??[])['filter'](l=>l?.['accomplished']!==![])['map'](l=>l?.['forward'])['filter'](l=>!!l)),k=[];for(const l of e?.['forwards']??[]){if(!l['name']||j['has'](l['name']))continue;k['push']({'forward':l['name'],'operator':resolveOperator(l,a['orderHolderAddresses'],a['permissionDescription'],a['nameResolver'])});}if(k['length'])c['waiting_on']=k;c['note']='Node\x20did\x20not\x20migrate:\x20threshold\x20'+h+',\x20accumulated\x20weight\x20'+i+',\x20remaining\x20'+Math['max'](0x0,h-i)+'.\x20'+(k['length']?'Waiting\x20for:\x20'+k['map'](m=>m['forward']+'\x20('+(m['operator']['role_name']??m['operator']['kind'])+')')['join'](';\x20'):'All\x20forwards\x20on\x20this\x20pair\x20are\x20accomplished\x20—\x20the\x20node\x20should\x20migrate\x20on\x20the\x20next\x20operation.');}else c['note']='Node\x20did\x20not\x20migrate\x20(threshold\x200)\x20—\x20no\x20further\x20weight\x20cooperation\x20required;\x20verify\x20the\x20operation\x20outcome.';}const d=buildWorkflowGuidance({'current':a['current'],'nodes':a['nodes'],'caller':a['caller'],'orderHolderAddresses':a['orderHolderAddresses'],'permissionDescription':a['permissionDescription'],'nameResolver':a['nameResolver']});if(d['options']['length']>0x0)c['next_guidance']=d;return c;}function operatorText(a){const b=[a['role_name']??a['kind']];if(a['account_name'])b['push'](a['account_name']);return b['join']('\x20/\x20');}export function renderGuidanceText(a){const b=['[WORKFLOW\x20GUIDANCE]\x20current\x20node:\x20\x22'+a['current_node']+'\x22'+(a['caller']?'\x20(caller:\x20'+a['caller']+')':'')];if(a['options']['length']===0x0)return b['push']('\x20\x20•\x20'+(a['note']??'No\x20reachable\x20next\x20nodes.')),b['join']('\x0a');for(const c of a['options']){const d=['\x22'+c['forward']+'\x22\x20→\x20\x22'+c['next_node']+'\x22','operator:\x20'+operatorText(c['operator']),'weight:\x20'+c['weight'],'consistency:\x20'+c['consistency']+'/100'+(c['recommended']?'\x20[RECOMMENDED]':'')];if(c['guard'])d['push']('guard:\x20'+c['guard']);d['push']('meaning:\x20'+c['business_meaning']);if(c['gains']['length'])d['push']('gains:\x20'+c['gains']['join'](';\x20'));if(c['risks']['length'])d['push']('risks:\x20'+c['risks']['join'](';\x20'));b['push']('\x20\x20•\x20'+d['join']('\x20|\x20'));}if(a['recommendation']?.['best']){b['push']('\x20\x20RECOMMENDED:\x20'+a['recommendation']['best']+'.\x20'+(a['recommendation']['rationale']??''));if(a['recommendation']['caveat'])b['push']('\x20\x20CAVEAT\x20(opportunity\x20cost):\x20'+a['recommendation']['caveat']);}if(a['note'])b['push']('\x20\x20NOTE:\x20'+a['note']);return b['push']('\x20\x20(AI\x20recommendation\x20only\x20—\x20the\x20account\x20decides;\x20switch\x20env.account\x20if\x20another\x20operator\x20must\x20act.)'),b['join']('\x0a');}export function renderReceiptText(a){const b=['[WORKFLOW\x20RECEIPT]\x20'+a['action']];b['push']('\x20\x20•\x20node\x20migrated:\x20'+(a['migrated']?'yes\x20→\x20current:\x20\x22'+a['current_node']+'\x22':'no\x20→\x20current:\x20\x22'+a['current_node']+'\x22'));if(!a['migrated']){a['threshold']!==undefined&&a['threshold']>0x0&&(b['push']('\x20\x20•\x20threshold:\x20'+a['threshold']+'\x20|\x20accumulated\x20weight:\x20'+(a['accumulated_weight']??0x0)+'\x20|\x20remaining:\x20'+(a['remaining']??0x0)),a['waiting_on']?.['length']&&b['push']('\x20\x20•\x20waiting\x20on:\x20'+a['waiting_on']['map'](c=>'\x22'+c['forward']+'\x22\x20('+operatorText(c['operator'])+')')['join'](';\x20')));if(a['note'])b['push']('\x20\x20•\x20note:\x20'+a['note']);}return a['next_guidance']&&a['next_guidance']['options']['length']>0x0&&b['push'](renderGuidanceText(a['next_guidance'])),b['join']('\x0a');}async function makeNameResolver(a){const b=[...new Set(a['filter'](d=>!!d))],c=new Map();if(b['length'])try{const d=await GetLocalNamesByAddresses(b);for(const e of d){const f=e?.['account']??e?.['local_mark'];if(f)c['set'](e['address']['toLowerCase'](),f);}}catch{}return g=>{if(!g)return undefined;const h=c['get'](g['toLowerCase']());return h??shortAddr(g);};}export async function enrichWorkflowGuidance(a){try{let b;if(a['progressRef']['startsWith']('0x'))b=a['progressRef'];else b=await LocalMark['Instance']()['get_address'](a['progressRef'])??undefined;if(!b)return undefined;const c=await query_objects({'objects':[b],'no_cache':a['noCache'],'network':a['network']}),d=c?.['objects']?.[0x0],e=d?.['data']??d;if((d?.['type']??e?.['type'])!=='Progress')return undefined;const f=e['current']??'',g=e['machine'],h=Array['isArray'](e['session'])?e['session']:[],i=(Array['isArray'](e['namedOperator'])?e['namedOperator']['find'](q=>q?.['name']==='')?.['operators']:undefined)??[];if(!g)return undefined;const j=await fetchMachineNodes(g,a['network'],a['noCache']);let k;try{const q=await query_objects({'objects':[g],'no_cache':a['noCache'],'network':a['network']}),r=q?.['objects']?.[0x0],s=r?.['data']??r,t=s?.['permission'];if(t){const u=await query_objects({'objects':[t],'no_cache':a['noCache'],'network':a['network']}),v=u?.['objects']?.[0x0];k=(v?.['data']??v)?.['description']??undefined;}}catch{}const l=await makeNameResolver([a['accountName'],...i]),m={'current':f,'nodes':j,'caller':a['accountName'],'orderHolderAddresses':i,'permissionDescription':k,'nameResolver':l},n=buildWorkflowGuidance(m);let o;a['operate']?.['forward']&&a['operate']?.['next_node_name']&&(o=buildWorkflowReceipt({...m,'callerName':a['accountName']??b,'forward':a['operate']['forward'],'targetNode':a['operate']['next_node_name'],'op':a['operate']['op'],'session':h}));const p=[o?renderReceiptText(o):undefined,n['options']['length']?renderGuidanceText(n):undefined]['filter'](w=>!!w)['join']('\x0a\x0a');return{'guidance':n,'receipt':o,'text':p};}catch{return undefined;}}export function mergeGuidanceIntoOutput(a,b){if(!b)return a;try{const c=a?.['structuredContent'];if(c&&typeof c==='object'){const d=c['semantic'];if(d&&typeof d==='object'){if(b['guidance'])d['workflow_guidance']=b['guidance'];if(b['receipt'])d['workflow_receipt']=b['receipt'];}}b['text']&&Array['isArray'](a?.['content'])&&a['content'][0x0]?.['text']!==undefined&&(a['content'][0x0]['text']=b['text']+'\x0a\x0a'+a['content'][0x0]['text']);}catch{}return a;}