@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/evaluation/game-strategy.d.ts

@@ -0,0 +1,27 @@
+import type { CommercialRole } from "../role/types.js";
+export type OperationOutcome = "completion" | "refund" | "advance";
+export type RiskAppetite = "conservative" | "balanced" | "aggressive";
+export declare const OUTCOME_SEMANTICS: Record<OperationOutcome, string[]>;
+export interface RoleInterests {
+    prefer: string[];
+    avoid: string[];
+    sensitivity: number;
+}
+export declare const ROLE_INTERESTS: Record<CommercialRole, RoleInterests>;
+export declare function classifyOutcome(consequence?: string): OperationOutcome;
+export declare function appetiteMultiplier(appetite?: RiskAppetite): number;
+export declare function interestsOf(role: CommercialRole): RoleInterests;
+export interface PersonaDrive {
+    risk_appetite?: RiskAppetite;
+    requirements?: string[];
+}
+export declare function resolveInterests(role: CommercialRole, drive?: PersonaDrive): RoleInterests;
+export interface OutcomeEvaluation {
+    gain_score: number;
+    risk_score: number;
+    net_score: number;
+    gains: string[];
+    risks: string[];
+}
+export declare function evaluateOutcome(outcome: OperationOutcome, role: CommercialRole, drive?: PersonaDrive): OutcomeEvaluation;
+export declare function consistencyScore(outcome: OperationOutcome, role: CommercialRole): number;

package/dist/evaluation/game-strategy.js

@@ -0,0 +1 @@
+export const OUTCOME_SEMANTICS={'completion':['fund_released_to_merchant','refund_leverage_given_up'],'refund':['fund_returned_to_buyer','arbitration_review_triggered'],'advance':['node_advanced']};export const ROLE_INTERESTS={'customer':{'prefer':['fund_returned_to_buyer'],'avoid':['fund_released_to_merchant','refund_leverage_given_up'],'sensitivity':0x1},'merchant':{'prefer':['fund_released_to_merchant'],'avoid':['fund_returned_to_buyer','arbitration_review_triggered'],'sensitivity':0x1},'collaborator':{'prefer':['node_advanced'],'avoid':[],'sensitivity':0x1},'supplier':{'prefer':['fund_released_to_merchant','node_advanced'],'avoid':['fund_returned_to_buyer'],'sensitivity':0x1},'prospect':{'prefer':['fund_returned_to_buyer'],'avoid':['fund_released_to_merchant','arbitration_review_triggered','refund_leverage_given_up'],'sensitivity':0x1},'arbitrator':{'prefer':[],'avoid':['arbitration_review_triggered'],'sensitivity':0x1},'system':{'prefer':[],'avoid':[],'sensitivity':0x1}};export function classifyOutcome(a){if(a?.['startsWith']('Completion'))return'completion';if(a?.['startsWith']('Refund'))return'refund';return'advance';}export function appetiteMultiplier(a){switch(a){case'conservative':return 1.5;case'aggressive':return 0.6;default:return 0x1;}}export function interestsOf(a){return ROLE_INTERESTS[a]??{'prefer':[],'avoid':[],'sensitivity':0x1};}function dedupe(a){return Array['from'](new Set(a));}export function resolveInterests(a,b){const c=interestsOf(a),d=c['sensitivity']*appetiteMultiplier(b?.['risk_appetite']),e=[...c['prefer']],f=[...c['avoid']];for(const g of b?.['requirements']??[]){const h=g['toLowerCase'](),i=/forbid|never|\bno\b/['test'](h);if(h['includes']('arbitration')&&i)f['push']('arbitration_review_triggered');if(h['includes']('refund')&&!i)e['push']('fund_returned_to_buyer');if((h['includes']('upfront')||h['includes']('before\x20delivery'))&&i)f['push']('fund_released_to_merchant');if(h['includes']('milestone')&&!i)e['push']('node_advanced');}return{'prefer':dedupe(e),'avoid':dedupe(f),'sensitivity':d};}export function evaluateOutcome(a,b,c){const d=OUTCOME_SEMANTICS[a]??[],e=resolveInterests(b,c),f=e['sensitivity'],g=[],h=[];for(const l of d){if(e['prefer']['includes'](l))g['push'](l);if(e['avoid']['includes'](l))h['push'](l);}const i=g['length']*0x14,j=Math['round'](h['length']*0x19*f),k=Math['max'](0x0,Math['min'](0x64,0x3c+i-j));return{'gain_score':i,'risk_score':j,'net_score':k,'gains':g,'risks':h};}export function consistencyScore(a,b){return evaluateOutcome(a,b)['net_score'];}

package/dist/evaluation/gap.js

@@ -1,100 +1 @@
-import { requiredCapabilities } from "./capability.js";
-import { relateRegion } from "./region.js";
-const IMPACT = {
-    has_arbitration: "critical",
-    has_refund_path: "critical",
-    has_compensation_fund: "major",
-    has_wip_verification: "major",
-    has_milestone_nodes: "minor",
-    has_messenger: "minor",
-    has_buy_guard: "minor",
-    has_dynamic_pricing: "minor",
-};
-const SUGGEST = {
-    has_arbitration: "bind an independent Arbitration object to the Service",
-    has_refund_path: "configure a refund path (Arbitration + compensation_fund, or a refund Allocator)",
-    has_compensation_fund: "deposit compensation_fund to cover the order amount",
-    has_wip_verification: "set a wip_hash on the sale to prevent tampering",
-    has_milestone_nodes: "add milestone nodes to the Machine workflow",
-    has_messenger: "bind a Contact (um) to enable Messenger",
-    has_buy_guard: "configure a buy_guard for purchase eligibility",
-    has_dynamic_pricing: "configure discount/dynamic pricing",
-};
-export function summarizeCapabilityGaps(demand, service) {
-    const satisfied = [];
-    const missing = [];
-    for (const k of requiredCapabilities(demand.capabilities)) {
-        const ok = service.capabilities[k];
-        const gap = {
-            dimension: k,
-            requirement: `requires ${k}`,
-            provided: ok ? "provided" : "missing",
-            status: ok ? "satisfied" : "missing",
-            impact: ok ? "minor" : (IMPACT[k] ?? "minor"),
-            suggestion: ok ? "" : (SUGGEST[k] ?? ""),
-        };
-        (ok ? satisfied : missing).push(gap);
-    }
-    if (demand.industry !== "general" && demand.industry !== service.industry) {
-        missing.push({
-            dimension: "industry",
-            requirement: demand.industry,
-            provided: service.industry,
-            status: "missing",
-            impact: "major",
-            suggestion: `switch to a service in the '${demand.industry}' industry`,
-        });
-    }
-    const rel = relateRegion(demand.region, service.region);
-    if (rel === "mismatch") {
-        missing.push({
-            dimension: "region",
-            requirement: demand.region.raw,
-            provided: service.region.raw,
-            status: "missing",
-            impact: "critical",
-            suggestion: "choose a service in a compatible region",
-        });
-    }
-    else if (rel === "overlap") {
-        missing.push({
-            dimension: "region",
-            requirement: demand.region.raw,
-            provided: service.region.raw,
-            status: "partial",
-            impact: "minor",
-            suggestion: "different city in the same province",
-        });
-    }
-    if (demand.price_max !== undefined && service.price_min !== undefined && service.price_min > demand.price_max) {
-        missing.push({
-            dimension: "price",
-            requirement: `≤ ${demand.price_max}`,
-            provided: `${service.price_min}`,
-            status: "missing",
-            impact: "major",
-            suggestion: "negotiate a lower price or raise the budget",
-        });
-    }
-    if (service.trust_score < demand.trust_score) {
-        missing.push({
-            dimension: "trust",
-            requirement: `≥ ${demand.trust_score}`,
-            provided: `${service.trust_score}`,
-            status: "missing",
-            impact: "major",
-            suggestion: "find a more trustworthy merchant or require more safeguards",
-        });
-    }
-    const total = satisfied.length + missing.length;
-    const coverage = total === 0 ? 100 : Math.round((satisfied.length / total) * 100);
-    return {
-        entity_id: service.id,
-        satisfied,
-        missing,
-        coverage_score: coverage,
-        summary: missing.length === 0
-            ? `Service fully covers the demand's requirements (${coverage}/100)`
-            : `${missing.length} requirement(s) unmet (coverage ${coverage}/100): ${missing.map((m) => m.dimension).join(", ")}`,
-    };
-}
+import{requiredCapabilities}from'./capability.js';import{relateRegion}from'./region.js';const IMPACT={'has_arbitration':'critical','has_refund_path':'critical','has_compensation_fund':'major','has_wip_verification':'major','has_milestone_nodes':'minor','has_messenger':'minor','has_buy_guard':'minor','has_dynamic_pricing':'minor'},SUGGEST={'has_arbitration':'bind\x20an\x20independent\x20Arbitration\x20object\x20to\x20the\x20Service','has_refund_path':'configure\x20a\x20refund\x20path\x20(Arbitration\x20+\x20compensation_fund,\x20or\x20a\x20refund\x20Allocator)','has_compensation_fund':'deposit\x20compensation_fund\x20to\x20cover\x20the\x20order\x20amount','has_wip_verification':'set\x20a\x20wip_hash\x20on\x20the\x20sale\x20to\x20prevent\x20tampering','has_milestone_nodes':'add\x20milestone\x20nodes\x20to\x20the\x20Machine\x20workflow','has_messenger':'bind\x20a\x20Contact\x20(um)\x20to\x20enable\x20Messenger','has_buy_guard':'configure\x20a\x20buy_guard\x20for\x20purchase\x20eligibility','has_dynamic_pricing':'configure\x20discount/dynamic\x20pricing'};export function summarizeCapabilityGaps(a,b){const c=[],d=[];for(const h of requiredCapabilities(a['capabilities'])){const i=b['capabilities'][h],j={'dimension':h,'requirement':'requires\x20'+h,'provided':i?'provided':'missing','status':i?'satisfied':'missing','impact':i?'minor':IMPACT[h]??'minor','suggestion':i?'':SUGGEST[h]??''};(i?c:d)['push'](j);}a['industry']!=='general'&&a['industry']!==b['industry']&&d['push']({'dimension':'industry','requirement':a['industry'],'provided':b['industry'],'status':'missing','impact':'major','suggestion':'switch\x20to\x20a\x20service\x20in\x20the\x20\x27'+a['industry']+'\x27\x20industry'});const e=relateRegion(a['region'],b['region']);if(e==='mismatch')d['push']({'dimension':'region','requirement':a['region']['raw'],'provided':b['region']['raw'],'status':'missing','impact':'critical','suggestion':'choose\x20a\x20service\x20in\x20a\x20compatible\x20region'});else e==='overlap'&&d['push']({'dimension':'region','requirement':a['region']['raw'],'provided':b['region']['raw'],'status':'partial','impact':'minor','suggestion':'different\x20city\x20in\x20the\x20same\x20province'});a['price_max']!==undefined&&b['price_min']!==undefined&&b['price_min']>a['price_max']&&d['push']({'dimension':'price','requirement':'≤\x20'+a['price_max'],'provided':''+b['price_min'],'status':'missing','impact':'major','suggestion':'negotiate\x20a\x20lower\x20price\x20or\x20raise\x20the\x20budget'});b['trust_score']<a['trust_score']&&d['push']({'dimension':'trust','requirement':'≥\x20'+a['trust_score'],'provided':''+b['trust_score'],'status':'missing','impact':'major','suggestion':'find\x20a\x20more\x20trustworthy\x20merchant\x20or\x20require\x20more\x20safeguards'});const f=c['length']+d['length'],g=f===0x0?0x64:Math['round'](c['length']/f*0x64);return{'entity_id':b['id'],'satisfied':c,'missing':d,'coverage_score':g,'summary':d['length']===0x0?'Service\x20fully\x20covers\x20the\x20demand\x27s\x20requirements\x20('+g+'/100)':d['length']+'\x20requirement(s)\x20unmet\x20(coverage\x20'+g+'/100):\x20'+d['map'](l=>l['dimension'])['join'](',\x20')};}

package/dist/evaluation/index.d.ts

@@ -5,7 +5,9 @@ export * from "./capability.js";
 export * from "./extract.js";
 export * from "./gap.js";
 export * from "./composer.js";
+export * from "./game-strategy.js";
 export * from "./node-game.js";
 export * from "./arbitration-game.js";
+export * from "./path-reasoning.js";
 export * from "./builtins/index.js";
 export { EvaluationEngine, getEvaluationEngine, levelFromScore } from "./engine.js";

package/dist/evaluation/index.js

@@ -1,11 +1 @@
-export * from "./types.js";
-export * from "./user-injection.js";
-export * from "./region.js";
-export * from "./capability.js";
-export * from "./extract.js";
-export * from "./gap.js";
-export * from "./composer.js";
-export * from "./node-game.js";
-export * from "./arbitration-game.js";
-export * from "./builtins/index.js";
-export { EvaluationEngine, getEvaluationEngine, levelFromScore } from "./engine.js";
+export*from'./types.js';export*from'./user-injection.js';export*from'./region.js';export*from'./capability.js';export*from'./extract.js';export*from'./gap.js';export*from'./composer.js';export*from'./game-strategy.js';export*from'./node-game.js';export*from'./arbitration-game.js';export*from'./path-reasoning.js';export*from'./builtins/index.js';export{EvaluationEngine,getEvaluationEngine,levelFromScore}from'./engine.js';

package/dist/evaluation/location-match.d.ts

@@ -0,0 +1,42 @@
+import { type RegionRelation } from "./region.js";
+export type LocationSensitivity = "strict" | "near" | "logistics";
+export interface RegionEnrichment {
+    country?: string;
+    province?: string;
+    city?: string;
+}
+export type LocationInput = string | ({
+    raw: string;
+} & RegionEnrichment);
+export interface LocationGateResult {
+    relation: RegionRelation;
+    satisfied: boolean;
+    score: number;
+    reason: string;
+}
+export interface ServiceLocationInput {
+    id: string;
+    name?: string;
+    location?: LocationInput;
+}
+export interface RankedServiceLocation {
+    id: string;
+    name?: string;
+    location?: string;
+    relation: RegionRelation;
+    satisfied: boolean;
+    score: number;
+    reason: string;
+}
+export interface ScopeExpansionAdvice {
+    sensitivity: LocationSensitivity;
+    search_terms: string[];
+    ai_enrichment_note: string;
+}
+export declare function gateLocation(sensitivity: LocationSensitivity, demandLocation: LocationInput, serviceLocation: LocationInput | undefined): LocationGateResult;
+export declare function rankByLocation(sensitivity: LocationSensitivity, demandLocation: LocationInput, services: ServiceLocationInput[]): RankedServiceLocation[];
+export declare function expandSearchScope(sensitivity: LocationSensitivity, demandLocation: LocationInput): ScopeExpansionAdvice;
+export declare function inferSensitivity(description: string): {
+    sensitivity: LocationSensitivity;
+    signals: string[];
+};

package/dist/evaluation/location-match.js

@@ -0,0 +1 @@
+import{parseRegion,relateRegion}from'./region.js';function toRegion(a){if(a===undefined)return parseRegion('');if(typeof a==='string')return parseRegion(a);const b=parseRegion(a['raw']);return{...b,'country':a['country']??b['country'],'province':a['province']??b['province'],'city':a['city']??b['city']};}export function gateLocation(a,b,c){const d=toRegion(b),e=toRegion(c);if(!d['raw']?.['trim']())return{'relation':'mismatch','satisfied':a!=='strict','score':0.5,'reason':'No\x20demand-side\x20location\x20stated\x20—\x20location\x20is\x20not\x20discriminating;\x20other\x20dimensions\x20decide.'};if(!e['raw']?.['trim']())return{'relation':'mismatch','satisfied':a!=='strict','score':a==='strict'?0x0:0.3,'reason':a==='strict'?'Service\x20has\x20NO\x20location\x20set\x20—\x20merchant\x20location\x20hygiene\x20issue;\x20excluded\x20under\x20strict\x20sensitivity.':'Service\x20has\x20no\x20location\x20set\x20—\x20kept\x20(soft\x20signal)\x20because\x20sensitivity\x20is\x20not\x20strict.'};const f=relateRegion(d,e),{satisfied:g,score:h,reason:i}=judge(a,f);return{'relation':f,'satisfied':g,'score':h,'reason':i};}function judge(a,b){switch(b){case'exact':return{'satisfied':!![],'score':0x1,'reason':'Location\x20exact\x20match.'};case'contains':return{'satisfied':!![],'score':0.9,'reason':'Location\x20containment\x20match\x20(one\x20region\x20covers\x20the\x20other).'};case'overlap':if(a==='strict')return{'satisfied':![],'score':0.4,'reason':'Same\x20province\x20but\x20different\x20city\x20—\x20fails\x20the\x20100%\x20location\x20gate\x20(strict).\x20Consider\x20\x27near\x27\x20sensitivity\x20to\x20accept\x20neighboring\x20cities.'};return{'satisfied':!![],'score':0.6,'reason':'Neighboring\x20city\x20within\x20the\x20same\x20province\x20—\x20accepted\x20(near/logistics).'};case'compatible':return{'satisfied':!![],'score':0.8,'reason':'Remote\x20service\x20serves\x20any\x20physical\x20region\x20(or\x20vice\x20versa).'};case'mismatch':default:return{'satisfied':a==='logistics','score':0x0,'reason':a==='logistics'?'Region\x20mismatch\x20—\x20soft\x20warning\x20only\x20(goods\x20can\x20ship\x20via\x20logistics).':'Region\x20mismatch\x20—\x20excluded\x20under\x20strict/near\x20sensitivity.'};}}export function rankByLocation(a,b,c){return c['map'](d=>{const e=gateLocation(a,b,d['location']);return{'id':d['id'],'name':d['name'],'location':typeof d['location']==='string'?d['location']:d['location']?.['raw'],'relation':e['relation'],'satisfied':e['satisfied'],'score':e['score'],'reason':e['reason']};})['sort']((d,e)=>{if(d['satisfied']!==e['satisfied'])return d['satisfied']?-0x1:0x1;if(e['score']!==d['score'])return e['score']-d['score'];return 0x0;});}export function expandSearchScope(a,b){const c=toRegion(b),d=c['city']?.['trim'](),e=c['province']?.['trim']();if(a==='strict')return{'sensitivity':a,'search_terms':d?[d]:[c['raw']]['filter'](Boolean),'ai_enrichment_note':'Strict:\x20do\x20NOT\x20widen\x20geographically.\x20If\x20nothing\x20matches,\x20report\x20honestly\x20and\x20suggest\x20switching\x20sensitivity\x20to\x20\x27near\x27\x20(user\x20decision)\x20instead\x20of\x20silently\x20expanding.'};if(a==='near'){const f=[c['raw'],d,e]['filter'](Boolean);return{'sensitivity':a,'search_terms':f,'ai_enrichment_note':'Near:\x20AI\x20enriches\x20neighboring\x20cities\x20of\x20the\x20demand\x20city\x20from\x20public\x20web\x20data\x20(authoritative\x20preferred),\x20confirms\x20the\x20list\x20with\x20the\x20user,\x20then\x20re-runs\x20discovery\x20with\x20the\x20expanded\x20terms.'};}return{'sensitivity':a,'search_terms':[c['raw'],e,'remote','online','nationwide','china','global']['filter'](Boolean),'ai_enrichment_note':'Logistics:\x20location\x20is\x20a\x20soft\x20signal.\x20Enumerate\x20broadly\x20(nationwide/remote\x20services),\x20rank\x20by\x20location\x20fit,\x20but\x20let\x20price/trust/tags\x20dominate\x20the\x20final\x20recommendation.'};}const ON_SITE_EN=/\b(hotel|accommodation|restaurant|dining|gym)\b/,ON_SITE_CJK=['民宿','酒店','餐厅','健身房'],LOGISTICS_EN=/\b(shipping|delivery|ship to home|mail)\b/,LOGISTICS_CJK=['快递','物流','邮寄','配送到家'],REMOTE_EN=/\b(online|remote)\b/,REMOTE_CJK=['在线','远程'],hits=(a,b,c)=>b['test'](a)||c['some'](d=>a['includes'](d));export function inferSensitivity(a){const b=(a??'')['toLowerCase'](),c=[];hits(b,ON_SITE_EN,ON_SITE_CJK)&&c['push']('on-site\x20consumption');hits(b,LOGISTICS_EN,LOGISTICS_CJK)&&c['push']('physical\x20logistics');hits(b,REMOTE_EN,REMOTE_CJK)&&c['push']('remote\x20service');if(c['includes']('on-site\x20consumption')&&!c['includes']('physical\x20logistics'))return{'sensitivity':'strict','signals':c};if(c['includes']('physical\x20logistics'))return{'sensitivity':'logistics','signals':c};if(c['includes']('remote\x20service'))return{'sensitivity':'near','signals':c};return{'sensitivity':'near','signals':c['length']?c:['no\x20explicit\x20signal\x20—\x20defaulted\x20to\x20near']};}

package/dist/evaluation/node-game.d.ts

@@ -1,14 +1,29 @@
-import type { ExecutionPath, ParticipationPerspective } from "../participation/radar-core.js";
+import type { ExecutionPath } from "../participation/radar-core.js";
+import type { CommercialRole } from "../role/types.js";
+import { type RiskAppetite } from "./game-strategy.js";
 export interface NodeForwardInput {
     name: string;
     to_node: string;
     execution_path: ExecutionPath;
     guard?: string;
     consequence?: string;
+    weight?: number;
+}
+export interface AllocationSummary {
+    recipient_slots: number;
+    guard_gated_slots: number;
+    direct_to_me_slots: number;
+    to_payer_slots: number;
 }
 export interface NodeGameInput {
     current_node: string;
-    perspective: ParticipationPerspective;
+    perspective: CommercialRole;
+    appetite?: RiskAppetite;
+    threshold?: number;
+    allocation?: AllocationSummary;
+    requirements?: string[];
+    order_amount?: string;
+    compensation_fund?: string;
     operable: NodeForwardInput[];
     waiting_on: Array<{
         role: string;
@@ -21,14 +36,27 @@ export interface NodeGameAction {
     execution_path: ExecutionPath;
     guard?: string;
     favorability: number;
+    gain_score: number;
+    risk_score: number;
     is_optimal: boolean;
     payoff_note: string;
     risk: "low" | "medium" | "high";
 }
+export interface CooperationInfo {
+    threshold: number;
+    my_weight: number;
+    needed_from_others: number;
+    collaborators: string[];
+    allocation?: AllocationSummary;
+    allocation_note?: string;
+}
 export interface NodeGameAdvice {
     current_node: string;
-    perspective: ParticipationPerspective;
+    perspective: CommercialRole;
     actions: NodeGameAction[];
+    cooperation?: CooperationInfo;
+    value_at_stake?: string;
+    risk_exposure?: string;
     summary: string;
 }
 export declare function evaluateNodeGame(input: NodeGameInput): NodeGameAdvice;

package/dist/evaluation/node-game.js

@@ -1,57 +1 @@
-export function evaluateNodeGame(input) {
-    const actions = input.operable.map((f) => {
-        const s = scoreForward(f, input.perspective);
-        return {
-            forward: f.name,
-            to_node: f.to_node,
-            execution_path: f.execution_path,
-            guard: f.guard,
-            favorability: s.favorability,
-            is_optimal: false,
-            payoff_note: s.payoff,
-            risk: s.risk,
-        };
-    });
-    actions.sort((a, b) => b.favorability - a.favorability);
-    if (actions.length > 0) {
-        actions[0].is_optimal = true;
-    }
-    return {
-        current_node: input.current_node,
-        perspective: input.perspective,
-        actions,
-        summary: buildSummary(input, actions),
-    };
-}
-function scoreForward(f, perspective) {
-    const isCompletion = !!f.consequence?.startsWith("Completion");
-    const isRefund = !!f.consequence?.startsWith("Refund");
-    if (perspective === "customer") {
-        if (isRefund) {
-            return { favorability: 90, payoff: "funds return to you (refund/cancel path)", risk: "low" };
-        }
-        if (isCompletion) {
-            return { favorability: 40, payoff: "releases escrowed funds to the merchant — only confirm if the deliverable matches the agreement", risk: "high" };
-        }
-        return { favorability: 60, payoff: "advances the order to the next node", risk: "medium" };
-    }
-    if (perspective === "operator") {
-        if (isCompletion) {
-            return { favorability: 90, payoff: "settlement + shorter fund-settlement cycle", risk: "low" };
-        }
-        if (isRefund) {
-            return { favorability: 20, payoff: "refund — downside, recorded on-chain (arb-loss/stall stats)", risk: "high" };
-        }
-        return { favorability: 70, payoff: "advance the workflow to shorten settlement", risk: "low" };
-    }
-    return { favorability: 50, payoff: "neutral (observer)", risk: "medium" };
-}
-function buildSummary(input, actions) {
-    if (actions.length === 0) {
-        return input.waiting_on.length > 0
-            ? `Waiting on ${input.waiting_on.map((w) => w.role).join(", ")}`
-            : `No operable actions at node '${input.current_node || "(entry)"}'`;
-    }
-    const top = actions[0];
-    return `Optimal for ${input.perspective}: '${top.forward}' → '${top.to_node}' (${top.payoff_note})`;
-}
+import{classifyOutcome,evaluateOutcome}from'./game-strategy.js';export function evaluateNodeGame(a){const b=a['operable']['map'](c=>{const d=scoreForward(c,a['perspective'],{'risk_appetite':a['appetite'],'requirements':a['requirements']},a['order_amount']);return{'forward':c['name'],'to_node':c['to_node'],'execution_path':c['execution_path'],'guard':c['guard'],'favorability':d['favorability'],'gain_score':d['gain_score'],'risk_score':d['risk_score'],'is_optimal':![],'payoff_note':d['payoff'],'risk':d['risk']};});return b['sort']((c,d)=>d['favorability']-c['favorability']),b['length']>0x0&&(b[0x0]['is_optimal']=!![]),{'current_node':a['current_node'],'perspective':a['perspective'],'actions':b,'cooperation':evaluateCooperation(a),'value_at_stake':a['order_amount'],'risk_exposure':a['compensation_fund'],'summary':buildSummary(a,b)};}function evaluateCooperation(a){if(!a['threshold']||a['threshold']<=0x1)return undefined;const b=a['operable']['reduce']((g,h)=>g+(h['weight']??0x1),0x0),c=a['threshold']-b,d=c>0x0?a['waiting_on']['map'](f=>f['role']):[],e=a['allocation'];return{'threshold':a['threshold'],'my_weight':b,'needed_from_others':Math['max'](0x0,c),'collaborators':d,'allocation':e,'allocation_note':e?describeAllocation(e):undefined};}function describeAllocation(b){const c=['settlement\x20splits\x20across\x20'+b['recipient_slots']+'\x20recipient\x20slot(s)'];if(b['direct_to_me_slots']>0x0)c['push'](b['direct_to_me_slots']+'\x20pay\x20directly\x20to\x20you');if(b['guard_gated_slots']>0x0)c['push'](b['guard_gated_slots']+'\x20are\x20guard-resolved\x20(may\x20pay\x20a\x20cooperating\x20party)');if(b['to_payer_slots']>0x0)c['push'](b['to_payer_slots']+'\x20route\x20back\x20to\x20the\x20payer\x20(refund-oriented)');return c['join'](';\x20')+'.';}function scoreForward(a,b,c,d){const e=classifyOutcome(a['consequence']),g=evaluateOutcome(e,b,c);return{'favorability':g['net_score'],'gain_score':g['gain_score'],'risk_score':g['risk_score'],'payoff':payoffNote(e,b,d),'risk':riskOf(e,b)};}function amountSuffix(a){return a!=null?'\x20('+a+'\x20raw\x20units)':'';}function payoffNote(a,b,c){if(b==='customer'||b==='prospect')switch(a){case'refund':return'funds\x20return\x20to\x20you'+amountSuffix(c)+'\x20(refund/cancel\x20path)';case'completion':return'releases\x20escrowed\x20funds'+amountSuffix(c)+'\x20to\x20the\x20merchant\x20—\x20only\x20confirm\x20if\x20the\x20deliverable\x20matches\x20the\x20agreement';case'advance':return'advances\x20the\x20order\x20to\x20the\x20next\x20node\x20(funds'+amountSuffix(c)+'\x20stay\x20escrowed)';}if(b==='merchant'||b==='collaborator'||b==='supplier')switch(a){case'completion':return'settlement'+amountSuffix(c)+'\x20released\x20to\x20you\x20+\x20shorter\x20fund-settlement\x20cycle';case'refund':return'refund'+amountSuffix(c)+'\x20—\x20downside,\x20recorded\x20on-chain\x20(arb-loss/stall\x20stats)';case'advance':return'advance\x20the\x20workflow\x20to\x20shorten\x20settlement'+amountSuffix(c);}return'neutral\x20for\x20'+b;}function riskOf(a,b){if(b==='customer'||b==='prospect'){if(a==='completion')return'high';if(a==='refund')return'low';return'medium';}if(b==='merchant'||b==='collaborator'||b==='supplier'){if(a==='refund')return'high';return'low';}return'medium';}function buildSummary(a,b){if(b['length']===0x0)return a['waiting_on']['length']>0x0?'Waiting\x20on\x20'+a['waiting_on']['map'](e=>e['role'])['join'](',\x20'):'No\x20operable\x20actions\x20at\x20node\x20\x27'+(a['current_node']||'(entry)')+'\x27';const c=b[0x0];let d='Optimal\x20for\x20'+a['perspective']+':\x20\x27'+c['forward']+'\x27\x20→\x20\x27'+c['to_node']+'\x27\x20('+c['payoff_note']+')';return b['length']>0x1&&(d+='\x20—\x20choosing\x20this\x20closes\x20the\x20other\x20'+(b['length']-0x1)+'\x20option(s)\x20(opportunity\x20competition:\x20your\x20gain\x20may\x20be\x20another\x20role\x27s\x20lost\x20chance).'),d;}

package/dist/evaluation/path-reasoning.d.ts

@@ -0,0 +1,35 @@
+import type { CommercialRole } from "../role/types.js";
+import type { RadarMachineNode, NodeAnnotations } from "../participation/radar-core.js";
+import { type RiskAppetite } from "./game-strategy.js";
+export interface WorkflowPath {
+    id: string;
+    nodes: string[];
+    forwards: string[];
+    terminal: "completed" | "refunded" | "open";
+    guard_gates: number;
+    length: number;
+    terminal_value: number;
+    gain_score: number;
+    risk_score: number;
+    score: number;
+    rationale: string;
+}
+export interface PathReasoningInput {
+    current_node: string;
+    perspective: CommercialRole;
+    machine_nodes: RadarMachineNode[];
+    node_annotations?: NodeAnnotations;
+    appetite?: RiskAppetite;
+    requirements?: string[];
+    order_amount?: string;
+    max_depth?: number;
+}
+export interface PathReasoningAdvice {
+    current_node: string;
+    perspective: CommercialRole;
+    ranked_paths: WorkflowPath[];
+    optimal_path?: WorkflowPath;
+    foregone_terminals: string[];
+    summary: string;
+}
+export declare function evaluatePathReasoning(input: PathReasoningInput): PathReasoningAdvice;

package/dist/evaluation/path-reasoning.js

@@ -0,0 +1 @@
+import{evaluateOutcome}from'./game-strategy.js';const DEFAULT_COMPLETED=['completed','done','finished','received','finalized','active','accepted'],DEFAULT_REFUNDED=['refunded','refund','cancelled','canceled','disputed','expired'];function terminalNames(a){return{'completed':a?.['completed']?.['length']?a['completed']:DEFAULT_COMPLETED,'refunded':a?.['refunded']?.['length']?a['refunded']:DEFAULT_REFUNDED};}function isTerminal(a,b,c){const d=a['toLowerCase']();if(b['some'](e=>d===e['toLowerCase']()||d['includes'](e['toLowerCase']())))return'completed';if(c['some'](e=>d===e['toLowerCase']()||d['includes'](e['toLowerCase']())))return'refunded';return null;}function buildAdjacency(a){const b=new Map();for(const c of a){for(const d of c['pairs']??[]){const e=d['prev_node']||'';if(!b['has'](e))b['set'](e,[]);b['get'](e)['push']({'to_node':c['name'],'threshold':d['threshold'],'forwards':(d['forwards']??[])['map'](g=>({'name':g['name'],'guard':g['guard'],'weight':g['weight']}))});}}return b;}function enumeratePaths(a,b,c,d,e){const f=[],g=(h,i,j)=>{if(i['length']>0x0){const l=isTerminal(h,c,d);if(l){f['push']({'nodes':i['map'](m=>m['node']),'forwards':i['map'](m=>m['forward']),'terminal':l,'guard_gates':i['filter'](m=>m['guard'])['length']});return;}}if(i['length']>=e){f['push']({'nodes':i['map'](m=>m['node']),'forwards':i['map'](m=>m['forward']),'terminal':'open','guard_gates':i['filter'](m=>m['guard'])['length']});return;}const k=a['get'](h)??[];if(k['length']===0x0&&i['length']>0x0){f['push']({'nodes':i['map'](m=>m['node']),'forwards':i['map'](m=>m['forward']),'terminal':'open','guard_gates':i['filter'](m=>m['guard'])['length']});return;}for(const m of k){if(j['has'](m['to_node']))continue;for(const n of m['forwards']){const o=new Set(j);o['add'](m['to_node']),g(m['to_node'],[...i,{'node':m['to_node'],'forward':n['name'],'guard':!!n['guard']}],o);}}};return g(b,[],new Set([b])),f;}function terminalScore(a,b,c){const d=a==='refunded'?'refund':a==='completed'?'completion':'advance',e=evaluateOutcome(d,b,c);return{'net':e['net_score'],'gain':e['gain_score'],'risk':e['risk_score']};}const LENGTH_COST=0x4,GATE_COST=0x5;export function evaluatePathReasoning(a){const {current_node:b,perspective:c,machine_nodes:d,node_annotations:e,appetite:f,requirements:g}=a,h=a['max_depth']??0xc,{completed:i,refunded:j}=terminalNames(e),k=buildAdjacency(d),l=f||g?.['length']?{'risk_appetite':f,'requirements':g}:undefined,m=enumeratePaths(k,b,i,j,h),n=m['map'](u=>{const v=terminalScore(u['terminal'],c,l),w=u['forwards']['length'],x=w*LENGTH_COST,y=u['guard_gates']*GATE_COST,z=Math['max'](0x0,Math['min'](0x64,v['net']-x-y));return{'id':[b,...u['nodes']]['join']('→'),'nodes':u['nodes'],'forwards':u['forwards'],'terminal':u['terminal'],'guard_gates':u['guard_gates'],'length':w,'terminal_value':v['net'],'gain_score':v['gain'],'risk_score':v['risk'],'score':z,'rationale':'terminal='+u['terminal']+'\x20value='+v['net']+'/100;\x20'+w+'\x20step(s),\x20'+u['guard_gates']+'\x20guard\x20gate(s)\x20(−'+(x+y)+')'};});n['sort']((t,u)=>{const v=t['terminal']==='open'?0x1:0x0,w=u['terminal']==='open'?0x1:0x0;if(v!==w)return v-w;return u['score']-t['score'];});const o=n['length']>0x0&&n[0x0]['terminal']!=='open'?n[0x0]:undefined,p=o?.['terminal'],q=new Set(n['filter'](t=>t['terminal']!=='open')['map'](t=>t['terminal']));q['delete'](p);const r=o?Array['from'](q):[];let s;return!o?s='No\x20terminal\x20path\x20reachable\x20from\x20\x27'+(b||'(entry)')+'\x27\x20—\x20workflow\x20may\x20be\x20stuck\x20or\x20unannotated.':(s='Optimal\x20path\x20for\x20'+c+':\x20'+o['id']+'\x20→\x20'+o['terminal']+'\x20(score\x20'+o['score']+'/100,\x20'+o['length']+'\x20step(s),\x20'+o['guard_gates']+'\x20guard\x20gate(s))',r['length']>0x0&&(s+='\x20—\x20choosing\x20it\x20foregoes\x20'+r['join']('/')+'\x20(opportunity\x20competition:\x20your\x20gain\x20may\x20close\x20another\x20outcome).')),{'current_node':b,'perspective':c,'ranked_paths':n,'optimal_path':o,'foregone_terminals':r,'summary':s};}

package/dist/evaluation/region.d.ts

@@ -7,4 +7,10 @@ export interface Region {
 }
 export type RegionRelation = "exact" | "contains" | "overlap" | "compatible" | "mismatch";
 export declare function parseRegion(raw: string): Region;
+export interface RegionValidation {
+    region: Region;
+    valid: boolean;
+    reminder?: string;
+}
+export declare function validateRegionInput(raw: string): RegionValidation;
 export declare function relateRegion(a: Region, b: Region): RegionRelation;

package/dist/evaluation/region.js

@@ -1,36 +1 @@
-const REMOTE_KEYWORDS = ["remote", "online", "anywhere"];
-export function parseRegion(raw) {
-    const trimmed = raw?.trim() ?? "";
-    const lower = trimmed.toLowerCase();
-    const isRemote = REMOTE_KEYWORDS.some((k) => lower.includes(k));
-    if (isRemote) {
-        return { mode: "remote", raw: trimmed };
-    }
-    return { mode: "physical", raw: trimmed };
-}
-export function relateRegion(a, b) {
-    if (a.mode === "remote" || b.mode === "remote") {
-        return "compatible";
-    }
-    const na = normalizePhysical(a.raw);
-    const nb = normalizePhysical(b.raw);
-    if (!na || !nb) {
-        return "mismatch";
-    }
-    if (na === nb) {
-        return "exact";
-    }
-    if (na.includes(nb) || nb.includes(na)) {
-        return "contains";
-    }
-    if (a.province && b.province && a.province === b.province) {
-        return "overlap";
-    }
-    return "mismatch";
-}
-function normalizePhysical(raw) {
-    return raw
-        .trim()
-        .toLowerCase()
-        .replace(/\s+/g, "");
-}
+const REMOTE_KEYWORDS=['remote','online','anywhere'];export function parseRegion(a){const b=a?.['trim']()??'',c=b['toLowerCase'](),d=REMOTE_KEYWORDS['some'](e=>c['includes'](e));if(d)return{'mode':'remote','raw':b};return{'mode':'physical','raw':b};}export function validateRegionInput(a){const b=parseRegion(a),c=a?.['trim']()??'';if(!c)return{'region':b,'valid':![],'reminder':'Location\x20is\x20empty\x20—\x20provide\x20a\x20city/region\x20or\x20\x27remote\x27.'};if(b['mode']==='physical'&&!b['country']&&!b['city'])return{'region':b,'valid':!![],'reminder':'Physical\x20location\x20not\x20yet\x20resolved\x20to\x20country/city\x20—\x20AI\x20enrichment\x20will\x20resolve\x20it;\x20confirm\x20or\x20add\x20a\x20city.'};return{'region':b,'valid':!![]};}export function relateRegion(c,d){if(c['mode']==='remote'||d['mode']==='remote')return'compatible';const e=normalizePhysical(c['raw']),f=normalizePhysical(d['raw']);if(!e||!f)return'mismatch';if(e===f)return'exact';if(e['includes'](f)||f['includes'](e))return'contains';if(c['province']&&d['province']&&c['province']===d['province'])return'overlap';return'mismatch';}function normalizePhysical(a){return a['trim']()['toLowerCase']()['replace'](/\s+/g,'');}

package/dist/evaluation/types.d.ts

@@ -2,6 +2,7 @@ export interface DataSource {
     id: string;
     description: string;
     evaluation_ids?: string[];
+    priority?: number;
     isEnabled?: (ctx: EvaluationContext) => boolean;
     extract(ctx: EvaluationContext): Promise<Record<string, unknown>> | Record<string, unknown>;
 }
@@ -64,6 +65,18 @@ export interface EvaluationTraceEntry {
     id: string;
     detail: string;
 }
+export interface CriterionScore {
+    name: string;
+    score: number;
+    weight: number;
+    rationale: string;
+}
+export interface EvaluationFinding {
+    criterion: string;
+    severity: "critical" | "warning" | "info";
+    message: string;
+    deduction: number;
+}
 export interface EvaluationResult {
     evaluation_id: string;
     total: number;
@@ -73,4 +86,9 @@ export interface EvaluationResult {
     blocked: boolean;
     trace: EvaluationTraceEntry[];
     summary: string;
+    criterionScores?: CriterionScore[];
+    findings?: EvaluationFinding[];
+    strengths?: string[];
+    needsLlm?: boolean;
+    llmPrompt?: string;
 }

package/dist/evaluation/types.js

@@ -1 +1 @@
-export {};
+export{};

package/dist/evaluation/user-injection.js

@@ -1,27 +1 @@
-export const REQUIREMENT_PASS_THRESHOLD = 60;
-export function normalizeInjection(injection) {
-    return {
-        intent: injection?.intent,
-        preferences: injection?.preferences,
-        requirements: injection?.requirements ?? [],
-        overrides: injection?.overrides ?? {},
-    };
-}
-export function isRuleEnabled(ruleId, injection) {
-    const override = injection?.overrides?.rules?.[ruleId];
-    if (override && override.enabled !== undefined)
-        return override.enabled;
-    return true;
-}
-export function isDataSourceEnabled(dataSourceId, injection) {
-    const override = injection?.overrides?.data_sources?.[dataSourceId];
-    if (override && override.enabled !== undefined)
-        return override.enabled;
-    return true;
-}
-export function effectiveWeight(rule, injection) {
-    const override = injection?.overrides?.rules?.[rule.id];
-    if (override && override.weight !== undefined)
-        return override.weight;
-    return rule.weight;
-}
+export const REQUIREMENT_PASS_THRESHOLD=0x3c;export function normalizeInjection(a){return{'intent':a?.['intent'],'preferences':a?.['preferences'],'requirements':a?.['requirements']??[],'overrides':a?.['overrides']??{}};}export function isRuleEnabled(a,b){const c=b?.['overrides']?.['rules']?.[a];if(c&&c['enabled']!==undefined)return c['enabled'];return!![];}export function isDataSourceEnabled(a,b){const c=b?.['overrides']?.['data_sources']?.[a];if(c&&c['enabled']!==undefined)return c['enabled'];return!![];}export function effectiveWeight(a,b){const c=b?.['overrides']?.['rules']?.[a['id']];if(c&&c['weight']!==undefined)return c['weight'];return a['weight'];}

package/dist/experience/experience-reuse.js

@@ -1,103 +1 @@
-import { extractSignals } from "./intent-distill.js";
-const MAX_HISTORY = 200;
-const history = [];
-export function recordSignature(sig) {
-    try {
-        history.push(sig);
-        if (history.length > MAX_HISTORY) {
-            history.shift();
-        }
-    }
-    catch {
-    }
-}
-export function findMatches(intent, operation_type, data, limit = 3) {
-    try {
-        const currentSignals = extractSignals(operation_type, data);
-        const now = Date.now();
-        const scored = history
-            .map((sig) => {
-            const relevance = computeRelevance(sig, intent, currentSignals, now);
-            return { signature: sig, relevance };
-        })
-            .filter((s) => s.relevance > 0.3)
-            .sort((a, b) => b.relevance - a.relevance)
-            .slice(0, limit);
-        return scored.map((s) => formatMatch(s.signature, s.relevance));
-    }
-    catch {
-        return [];
-    }
-}
-function computeRelevance(sig, currentIntent, currentSignals, now) {
-    let score = 0;
-    if (sig.intent === currentIntent) {
-        score += 0.5;
-    }
-    else if (sig.intent.startsWith(currentIntent.split("_")[0])) {
-        score += 0.2;
-    }
-    const sigKeys = Object.keys(sig.signals);
-    if (sigKeys.length > 0) {
-        const overlap = sigKeys.filter((k) => {
-            const sigVal = JSON.stringify(sig.signals[k]);
-            const curVal = JSON.stringify(currentSignals[k]);
-            return sigVal === curVal;
-        }).length;
-        score += (overlap / sigKeys.length) * 0.3;
-    }
-    const ageDays = (now - sig.timestamp) / (1000 * 60 * 60 * 24);
-    const decay = Math.exp(-ageDays / 30);
-    score *= decay;
-    return Math.min(1, score);
-}
-function formatMatch(sig, relevance) {
-    const advice = buildAdvice(sig);
-    const avoid = buildAvoid(sig);
-    return {
-        signature: sig,
-        relevance,
-        advice,
-        avoid,
-    };
-}
-function buildAdvice(sig) {
-    if (sig.outcome === "success") {
-        if (sig.recovery_path && sig.recovery_path.length > 0) {
-            return `Last ${sig.intent} succeeded (after ${sig.recovery_path.length} recovery steps), you can follow the same path.`;
-        }
-        return `Last ${sig.intent} succeeded, parameter configuration is valid.`;
-    }
-    if (sig.outcome === "failed" && sig.error_code) {
-        return `Last ${sig.intent} failed (${sig.error_code}), please check the relevant parameters.`;
-    }
-    return `Last ${sig.intent} partially succeeded, check result completeness.`;
-}
-function buildAvoid(sig) {
-    const avoid = [];
-    if (sig.outcome !== "success" && sig.error_code) {
-        avoid.push(`Avoid triggering ${sig.error_code} error`);
-    }
-    if (sig.recovery_path && sig.recovery_path.length > 0) {
-        avoid.push(`Note: last time required ${sig.recovery_path.length} recovery steps to succeed`);
-    }
-    return avoid;
-}
-export function getHistory(intent) {
-    if (intent) {
-        return history.filter((h) => h.intent === intent);
-    }
-    return [...history];
-}
-export function clearHistory() {
-    history.length = 0;
-}
-export function getHistoryStats() {
-    const byOutcome = {};
-    const byIntent = {};
-    for (const h of history) {
-        byOutcome[h.outcome] = (byOutcome[h.outcome] ?? 0) + 1;
-        byIntent[h.intent] = (byIntent[h.intent] ?? 0) + 1;
-    }
-    return { total: history.length, by_outcome: byOutcome, by_intent: byIntent };
-}
+import{extractSignals}from'./intent-distill.js';const MAX_HISTORY=0xc8,history=[];export function recordSignature(a){try{history['push'](a),history['length']>MAX_HISTORY&&history['shift']();}catch{}}export function findMatches(a,b,c,d=0x3){try{const e=extractSignals(b,c),f=Date['now'](),g=history['map'](h=>{const i=computeRelevance(h,a,e,f);return{'signature':h,'relevance':i};})['filter'](h=>h['relevance']>0.3)['sort']((h,i)=>i['relevance']-h['relevance'])['slice'](0x0,d);return g['map'](h=>formatMatch(h['signature'],h['relevance']));}catch{return[];}}function computeRelevance(a,b,c,d){let e=0x0;if(a['intent']===b)e+=0.5;else a['intent']['startsWith'](b['split']('_')[0x0])&&(e+=0.2);const f=Object['keys'](a['signals']);if(f['length']>0x0){const i=f['filter'](j=>{const l=JSON['stringify'](a['signals'][j]),m=JSON['stringify'](c[j]);return l===m;})['length'];e+=i/f['length']*0.3;}const g=(d-a['timestamp'])/(0x3e8*0x3c*0x3c*0x18),h=Math['exp'](-g/0x1e);return e*=h,Math['min'](0x1,e);}function formatMatch(a,b){const c=buildAdvice(a),d=buildAvoid(a);return{'signature':a,'relevance':b,'advice':c,'avoid':d};}function buildAdvice(a){if(a['outcome']==='success'){if(a['recovery_path']&&a['recovery_path']['length']>0x0)return'Last\x20'+a['intent']+'\x20succeeded\x20(after\x20'+a['recovery_path']['length']+'\x20recovery\x20steps),\x20you\x20can\x20follow\x20the\x20same\x20path.';return'Last\x20'+a['intent']+'\x20succeeded,\x20parameter\x20configuration\x20is\x20valid.';}if(a['outcome']==='failed'&&a['error_code'])return'Last\x20'+a['intent']+'\x20failed\x20('+a['error_code']+'),\x20please\x20check\x20the\x20relevant\x20parameters.';return'Last\x20'+a['intent']+'\x20partially\x20succeeded,\x20check\x20result\x20completeness.';}function buildAvoid(a){const b=[];return a['outcome']!=='success'&&a['error_code']&&b['push']('Avoid\x20triggering\x20'+a['error_code']+'\x20error'),a['recovery_path']&&a['recovery_path']['length']>0x0&&b['push']('Note:\x20last\x20time\x20required\x20'+a['recovery_path']['length']+'\x20recovery\x20steps\x20to\x20succeed'),b;}export function getHistory(a){if(a)return history['filter'](b=>b['intent']===a);return[...history];}export function clearHistory(){history['length']=0x0;}export function getHistoryStats(){const a={},b={};for(const c of history){a[c['outcome']]=(a[c['outcome']]??0x0)+0x1,b[c['intent']]=(b[c['intent']]??0x0)+0x1;}return{'total':history['length'],'by_outcome':a,'by_intent':b};}