@wowok/agent-mcp 2.7.0 → 2.7.2

package/dist/evaluation/composer.d.ts

@@ -0,0 +1,13 @@
+import type { CapabilityVector, WorkflowCapabilities } from "./capability.js";
+export interface CompositePlan {
+    demand: string;
+    services: Array<{
+        id: string;
+        covered: Array<keyof WorkflowCapabilities>;
+    }>;
+    coverage_score: number;
+    remaining_missing: Array<keyof WorkflowCapabilities>;
+    feasibility: "ready" | "needs_supply_chain" | "infeasible";
+    summary: string;
+}
+export declare function composeServicesForDemand(demand: CapabilityVector, services: CapabilityVector[]): CompositePlan;

package/dist/evaluation/composer.js

@@ -0,0 +1 @@
+import{requiredCapabilities}from'./capability.js';import{relateRegion}from'./region.js';export function composeServicesForDemand(a,b){const c=requiredCapabilities(a['capabilities']),d=new Set(c),e=[],f=b['filter'](i=>relateRegion(a['region'],i['region'])!=='mismatch');while(d['size']>0x0){let i=null;for(const j of f){if(e['some'](m=>m['id']===j['id']))continue;const l=c['filter'](m=>d['has'](m)&&j['capabilities'][m]);(!i||l['length']>i['covered']['length'])&&(i={'id':j['id'],'covered':l});}if(!i||i['covered']['length']===0x0)break;e['push'](i);for(const m of i['covered'])d['delete'](m);}const g=c['length']===0x0?0x64:Math['round']((c['length']-d['size'])/c['length']*0x64),h=d['size']===0x0?'ready':e['length']>0x0?'needs_supply_chain':'infeasible';return{'demand':a['id'],'services':e,'coverage_score':g,'remaining_missing':[...d],'feasibility':h,'summary':d['size']===0x0?'Composite\x20of\x20'+e['length']+'\x20service(s)\x20covers\x20all\x20'+c['length']+'\x20requirements':'Composite\x20of\x20'+e['length']+'\x20service(s)\x20covers\x20'+g+'/100;\x20missing:\x20'+([...d]['join'](',\x20')||'none')};}

package/dist/evaluation/engine.d.ts

@@ -0,0 +1,18 @@
+import type { DataSource, EvaluationLevel, EvaluationResult, EvaluationRule, UserInjection } from "./types.js";
+export declare function levelFromScore(score: number): EvaluationLevel;
+export declare class EvaluationEngine {
+    private static instance;
+    private dataSources;
+    private rules;
+    static Instance(): EvaluationEngine;
+    registerDataSource(ds: DataSource): boolean;
+    unregisterDataSource(id: string): boolean;
+    registerRule(rule: EvaluationRule): boolean;
+    unregisterRule(id: string): boolean;
+    getRule(id: string): EvaluationRule | undefined;
+    listRules(): EvaluationRule[];
+    getDataSource(id: string): DataSource | undefined;
+    listDataSources(): DataSource[];
+    evaluate(evaluationId: string, entities: Record<string, unknown>, injection?: UserInjection): Promise<EvaluationResult>;
+}
+export declare function getEvaluationEngine(): EvaluationEngine;

package/dist/evaluation/engine.js

@@ -0,0 +1 @@
+import{REQUIREMENT_PASS_THRESHOLD,effectiveWeight,isDataSourceEnabled,isRuleEnabled,normalizeInjection}from'./user-injection.js';const LEVELS=[{'min':0x55,'level':'low'},{'min':0x46,'level':'medium_low'},{'min':0x32,'level':'medium_high'},{'min':0x0,'level':'high'}];export function levelFromScore(a){for(const b of LEVELS){if(a>=b['min'])return b['level'];}return'high';}function appliesTo(a,b){if(!a||a['length']===0x0)return!![];return a['includes'](b);}export class EvaluationEngine{static ['instance']=null;['dataSources']=new Map();['rules']=new Map();static['Instance'](){return!EvaluationEngine['instance']&&(EvaluationEngine['instance']=new EvaluationEngine()),EvaluationEngine['instance'];}['registerDataSource'](a){if(!a['id']||this['dataSources']['has'](a['id']))return![];return this['dataSources']['set'](a['id'],a),!![];}['unregisterDataSource'](a){return this['dataSources']['delete'](a);}['registerRule'](a){if(!a['id']||this['rules']['has'](a['id']))return![];return this['rules']['set'](a['id'],a),!![];}['unregisterRule'](a){return this['rules']['delete'](a);}['getRule'](a){return this['rules']['get'](a);}['listRules'](){return Array['from'](this['rules']['values']());}['getDataSource'](a){return this['dataSources']['get'](a);}['listDataSources'](){return Array['from'](this['dataSources']['values']());}async['evaluate'](a,b,c){const d=normalizeInjection(c),e={'evaluation_id':a,'entities':b,'facts':{},'injection':d,'now':Date['now']()},f=[],g=Array['from'](this['dataSources']['values']())['filter'](m=>appliesTo(m['evaluation_ids'],a))['sort']((m,n)=>(m['priority']??0x0)-(n['priority']??0x0));for(const m of g){if(!isDataSourceEnabled(m['id'],d)){f['push']({'kind':'override','id':m['id'],'detail':'data\x20source\x20disabled\x20by\x20user\x20override'});continue;}if(m['isEnabled']&&!m['isEnabled'](e))continue;const n=await m['extract'](e);Object['assign'](e['facts'],n),f['push']({'kind':'data_source','id':m['id'],'detail':'extracted\x20'+Object['keys'](n)['length']+'\x20fact(s)'});}const h=[],i=[];for(const o of this['rules']['values']()){if(!appliesTo(o['evaluation_ids'],a))continue;if(!isRuleEnabled(o['id'],d)){f['push']({'kind':'override','id':o['id'],'detail':'rule\x20disabled\x20by\x20user\x20override'});continue;}if(o['isEnabled']&&!o['isEnabled'](e))continue;const p=o['evaluate'](e);if(!p)continue;const q=effectiveWeight(o,d);h['push']({'rule_id':o['id'],'dimension':o['dimension'],'score':p['score'],'weight':q,'reason':p['reason'],'matched':p['matched'],'mismatched':p['mismatched'],'red_flag':p['red_flag']}),p['red_flag']&&i['push'](p['reason']??o['id']+'\x20triggered\x20a\x20hard\x20block'),f['push']({'kind':'rule','id':o['id'],'detail':'score='+p['score']+'\x20weight='+q});}const j=aggregateScore(h);let k=i['length']>0x0;for(const r of d['requirements']??[]){const s=h['find'](t=>t['rule_id']===r['rule_id']);if(r['condition']==='require')(!s||s['score']<REQUIREMENT_PASS_THRESHOLD||s['red_flag'])&&(k=!![],i['push'](r['note']??'Requirement\x20requires\x20rule\x20\x27'+r['rule_id']+'\x27\x20to\x20pass'));else r['condition']==='forbid'&&(s&&s['red_flag']&&(k=!![],i['push'](r['note']??'Requirement\x20forbids\x20rule\x20\x27'+r['rule_id']+'\x27\x20from\x20triggering')));}const l=buildSummary(a,j,h,i,k);return{'evaluation_id':a,'total':j,'level':levelFromScore(j),'breakdown':h,'red_flags':i,'blocked':k,'trace':f,'summary':l};}}function aggregateScore(a){if(a['length']===0x0)return 0x0;let c=0x0,d=0x0;for(const e of a){c+=e['score']*e['weight'],d+=e['weight'];}if(d<=0x0)return 0x0;return clamp(Math['round'](c/d),0x0,0x64);}function clamp(a,b,c){return Math['max'](b,Math['min'](c,a));}function buildSummary(a,b,c,d,e){const f=['Evaluation\x20\x27'+a+'\x27:\x20score\x20'+b+'/100'];return e?f['push']('BLOCKED\x20('+d['length']+'\x20red\x20flag(s))'):f['push'](c['length']+'\x20rule(s)\x20evaluated'),f['join']('\x20—\x20');}export function getEvaluationEngine(){return EvaluationEngine['Instance']();}

package/dist/evaluation/extract.d.ts

@@ -0,0 +1,30 @@
+import type { CapabilityVector } from "./capability.js";
+export interface ServiceExtractInput {
+    object: string;
+    description: string;
+    location: string;
+    sales?: Array<{
+        name?: string;
+        price: number | bigint | string;
+        wip_hash?: string;
+    }>;
+    arbitrations?: string[];
+    compensation_fund?: number | bigint | string;
+    buy_guard?: string | null;
+    machine?: string | null;
+    um?: string | null;
+    bPublished?: boolean;
+    bPaused?: boolean;
+    order_allocators?: unknown;
+    owner?: string;
+}
+export interface DemandExtractInput {
+    object: string;
+    description: string;
+    location: string;
+    rewards?: string[];
+    um?: string | null;
+    owner?: string;
+}
+export declare function extractServiceCapability(input: ServiceExtractInput, overrides?: Partial<CapabilityVector>): CapabilityVector;
+export declare function extractDemandCapability(input: DemandExtractInput, overrides?: Partial<CapabilityVector>): CapabilityVector;

package/dist/evaluation/extract.js

@@ -0,0 +1 @@
+import{parseRegion}from'./region.js';import{findSimilarIndustries,inferTraitsFromDescription}from'../knowledge/industry-generalizer.js';const BUILTIN_SCENARIOS=['freelance','rental','education','travel','subscription','retail'];function enrichFromDescription(a){const b=a?.['trim']();if(!b)return{'industry':'general','industry_confidence':0x0,'tags':[],'keywords':[]};const {traits:c,confidence:d,matched_keywords:e}=inferTraitsFromDescription(b),f=findSimilarIndustries(c,0x3),g=f[0x0],h=g&&BUILTIN_SCENARIOS['includes'](g['industry'])?g['industry']:'general',i=e['length']>0x0||(g?.['similarity']??0x0)>0.2;return{'industry':i?h:'general','industry_confidence':i?Math['max'](d,g?.['similarity']??0x0):0x0,'tags':i?f['slice'](0x0,0x3)['map'](j=>j['industry']):[],'keywords':e};}export function extractServiceCapability(a,b){const c=a['sales']??[],d=c['map'](j=>toBigInt(j['price']))['filter'](j=>j!==undefined),e=a['arbitrations']??[],f=toBigInt(a['compensation_fund'])??0x0n,g=enrichFromDescription(a['description']),h={'has_arbitration':e['length']>0x0,'has_refund_path':e['length']>0x0&&f>0x0n,'has_milestone_nodes':![],'has_compensation_fund':f>0x0n,'has_wip_verification':c['some'](j=>!!j['wip_hash']),'has_messenger':a['um']!=null,'has_buy_guard':a['buy_guard']!=null,'has_dynamic_pricing':![],'is_published':a['bPublished']===!![],'is_paused':a['bPaused']===!![]},i={'id':a['object'],'kind':'service','owner':a['owner']??'','industry':g['industry'],'industry_confidence':g['industry_confidence'],'region':parseRegion(a['location']),'price_min':d['length']>0x0?minBigInt(d):undefined,'price_max':d['length']>0x0?maxBigInt(d):undefined,'token_type':'','ticket_size':'medium','trust_score':0x32,'reputation_like_ratio':0x1,'arbitration_independent':![],'merchant_history_count':0x0,'capabilities':h,'tags':g['tags'],'keywords':g['keywords']};return{...i,...b};}export function extractDemandCapability(a,b){const c=enrichFromDescription(a['description']),d={'id':a['object'],'kind':'demand','owner':a['owner']??'','industry':c['industry'],'industry_confidence':c['industry_confidence'],'region':parseRegion(a['location']),'price_min':undefined,'price_max':undefined,'token_type':'','ticket_size':'medium','trust_score':0x32,'reputation_like_ratio':0x1,'arbitration_independent':![],'merchant_history_count':0x0,'capabilities':{'has_arbitration':![],'has_refund_path':![],'has_milestone_nodes':![],'has_compensation_fund':![],'has_wip_verification':![],'has_messenger':a['um']!=null,'has_buy_guard':![],'has_dynamic_pricing':![],'is_published':!![],'is_paused':![]},'tags':c['tags'],'keywords':c['keywords']};return{...d,...b};}function toBigInt(a){if(a===undefined||a===null)return undefined;try{return BigInt(a);}catch{return undefined;}}function minBigInt(a){return a['reduce']((c,d)=>c<d?c:d);}function maxBigInt(a){return a['reduce']((c,d)=>c>d?c:d);}

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.d.ts

@@ -0,0 +1,2 @@
+import type { CapabilityGapReport, CapabilityVector } from "./capability.js";
+export declare function summarizeCapabilityGaps(demand: CapabilityVector, service: CapabilityVector): CapabilityGapReport;

package/dist/evaluation/gap.js

@@ -0,0 +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'},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

@@ -0,0 +1,12 @@
+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 "./builtins/index.js";
+export { EvaluationEngine, getEvaluationEngine, levelFromScore } from "./engine.js";

package/dist/evaluation/index.js

@@ -0,0 +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'./game-strategy.js';export*from'./node-game.js';export*from'./arbitration-game.js';export*from'./builtins/index.js';export{EvaluationEngine,getEvaluationEngine,levelFromScore}from'./engine.js';

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

@@ -0,0 +1,62 @@
+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: CommercialRole;
+    appetite?: RiskAppetite;
+    threshold?: number;
+    allocation?: AllocationSummary;
+    requirements?: string[];
+    order_amount?: string;
+    compensation_fund?: string;
+    operable: NodeForwardInput[];
+    waiting_on: Array<{
+        role: string;
+        forwards: string[];
+    }>;
+}
+export interface NodeGameAction {
+    forward: string;
+    to_node: string;
+    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: 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

@@ -0,0 +1 @@
+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/region.d.ts

@@ -0,0 +1,10 @@
+export interface Region {
+    mode: "remote" | "physical";
+    country?: string;
+    province?: string;
+    city?: string;
+    raw: string;
+}
+export type RegionRelation = "exact" | "contains" | "overlap" | "compatible" | "mismatch";
+export declare function parseRegion(raw: string): Region;
+export declare function relateRegion(a: Region, b: Region): RegionRelation;

package/dist/evaluation/region.js

@@ -0,0 +1 @@
+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 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

@@ -0,0 +1,77 @@
+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>;
+}
+export interface EvaluationRule {
+    id: string;
+    description: string;
+    dimension: string;
+    weight: number;
+    evaluation_ids?: string[];
+    isEnabled?: (ctx: EvaluationContext) => boolean;
+    evaluate(ctx: EvaluationContext): RuleContribution | null;
+}
+export interface RuleContribution {
+    score: number;
+    weight: number;
+    reason?: string;
+    matched?: string[];
+    mismatched?: string[];
+    red_flag?: boolean;
+}
+export interface UserRequirement {
+    rule_id: string;
+    condition: "require" | "forbid";
+    note?: string;
+}
+export interface UserInjection {
+    intent?: string;
+    preferences?: Record<string, unknown>;
+    requirements?: UserRequirement[];
+    overrides?: {
+        rules?: Record<string, {
+            enabled?: boolean;
+            weight?: number;
+        }>;
+        data_sources?: Record<string, {
+            enabled?: boolean;
+        }>;
+    };
+}
+export interface EvaluationContext {
+    evaluation_id: string;
+    entities: Record<string, unknown>;
+    facts: Record<string, unknown>;
+    injection?: UserInjection;
+    now?: number;
+}
+export type EvaluationLevel = "low" | "medium_low" | "medium_high" | "high";
+export interface EvaluationBreakdown {
+    rule_id: string;
+    dimension: string;
+    score: number;
+    weight: number;
+    reason?: string;
+    matched?: string[];
+    mismatched?: string[];
+    red_flag?: boolean;
+}
+export interface EvaluationTraceEntry {
+    kind: "data_source" | "rule" | "override";
+    id: string;
+    detail: string;
+}
+export interface EvaluationResult {
+    evaluation_id: string;
+    total: number;
+    level: EvaluationLevel;
+    breakdown: EvaluationBreakdown[];
+    red_flags: string[];
+    blocked: boolean;
+    trace: EvaluationTraceEntry[];
+    summary: string;
+}

package/dist/evaluation/types.js

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

package/dist/evaluation/user-injection.d.ts

@@ -0,0 +1,6 @@
+import type { EvaluationRule, UserInjection } from "./types.js";
+export declare const REQUIREMENT_PASS_THRESHOLD = 60;
+export declare function normalizeInjection(injection?: UserInjection): UserInjection;
+export declare function isRuleEnabled(ruleId: string, injection?: UserInjection): boolean;
+export declare function isDataSourceEnabled(dataSourceId: string, injection?: UserInjection): boolean;
+export declare function effectiveWeight(rule: EvaluationRule, injection?: UserInjection): number;

package/dist/evaluation/user-injection.js

@@ -0,0 +1 @@
+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/examples/education-contact-create.json

@@ -0,0 +1,40 @@
+{
+  "title": "Create Education Contact Object",
+  "description": "Create a named Contact object for an education provider, with a Permission reference and an IM entry pointing at the support account",
+  "tags": ["contact", "messenger", "ims", "education"],
+  "industry": "education",
+  "operation_type": "contact",
+  "source": "Template-generated from K2 industry defaults (not chain-verified)",
+  "verified": false,
+  "network": "testnet",
+  "call": {
+    "tool": "onchain_operations",
+    "operation_type": "contact",
+    "data": {
+      "object": {
+        "name": "education_contact",
+        "permission": "education_permission",
+        "replaceExistName": true
+      },
+      "description": "Education provider contact — course info, attendance, and refund policy",
+      "ims": {
+        "op": "add",
+        "im": [
+          {
+            "at": "education_support",
+            "description": "Primary support account"
+          }
+        ]
+      }
+    },
+    "env": {
+      "network": "testnet",
+      "no_cache": true,
+      "confirmed": true
+    }
+  },
+  "notes": [
+    "Bind this Contact to the education Service via the service call's 'um' field.",
+    "Tuition should be escrowed and released per lesson (1/N) to prevent run-away disputes."
+  ]
+}

package/dist/examples/freelance-contact-create.json

@@ -0,0 +1,40 @@
+{
+  "title": "Create Freelance Contact Object",
+  "description": "Create a named Contact object for a freelance service provider, with a Permission reference and an IM entry pointing at the provider account",
+  "tags": ["contact", "messenger", "ims", "freelance"],
+  "industry": "freelance",
+  "operation_type": "contact",
+  "source": "Template-generated from K2 industry defaults (not chain-verified)",
+  "verified": false,
+  "network": "testnet",
+  "call": {
+    "tool": "onchain_operations",
+    "operation_type": "contact",
+    "data": {
+      "object": {
+        "name": "freelancer_contact",
+        "permission": "freelancer_permission",
+        "replaceExistName": true
+      },
+      "description": "Freelance provider contact — reach me for project requirements and delivery milestones",
+      "ims": {
+        "op": "add",
+        "im": [
+          {
+            "at": "freelancer",
+            "description": "Primary provider account"
+          }
+        ]
+      }
+    },
+    "env": {
+      "network": "testnet",
+      "no_cache": true,
+      "confirmed": true
+    }
+  },
+  "notes": [
+    "Bind this Contact to the freelance Service via the service call's 'um' field.",
+    "ims.im[].at accepts an account name or a full 0x address."
+  ]
+}

package/dist/examples/insurance-machine-create.json

@@ -4,7 +4,7 @@
   "tags": ["machine", "insurance", "claim", "workflow", "draft", "12-step"],
   "industry": "insurance",
   "operation_type": "machine",
-  "source": "docs/examples/Insurance — adapted to the 12-step plan (DRAFT only, schema-validated)",
+  "source": "docs/examples/Insurance — adapted to the 12-step plan (DRAFT only, schema-validated, not chain-verified)",
   "verified": false,
   "network": "testnet",
   "call": {

package/dist/examples/insurance-service-allocators.json

@@ -4,7 +4,7 @@
   "tags": ["service", "insurance", "order_allocators", "entity-sharing", "12-step"],
   "industry": "insurance",
   "operation_type": "service",
-  "source": "docs/examples/Insurance — adapted to the 12-step plan (allocators only, schema-validated)",
+  "source": "docs/examples/Insurance — adapted to the 12-step plan (allocators only, schema-validated, not chain-verified)",
   "verified": false,
   "network": "testnet",
   "call": {

package/dist/examples/machine-publish.json

@@ -4,7 +4,7 @@
   "tags": ["machine", "publish", "freeze", "immutable", "12-step"],
   "industry": "general",
   "operation_type": "machine",
-  "source": "12-step deploy plan (Step 6 Machine publish) — schema-validated",
+  "source": "12-step deploy plan (Step 6 Machine publish) — schema-validated, not chain-verified",
   "verified": false,
   "network": "testnet",
   "call": {

package/dist/examples/rental-ziroom-service-create.json

@@ -4,7 +4,7 @@
   "tags": ["service", "rental", "draft", "create", "12-step"],
   "industry": "rental",
   "operation_type": "service",
-  "source": "ziroom testnet deployment 2026-07-29 — adapted to the 12-step plan (DRAFT only, schema-validated)",
+  "source": "ziroom testnet deployment 2026-07-29 — adapted to the 12-step plan (DRAFT only, schema-validated, not chain-verified)",
   "verified": false,
   "network": "testnet",
   "call": {

package/dist/examples/retail-adv-guard-messenger-proof-create.json

@@ -54,7 +54,7 @@
     }
   },
   "notes": [
-    "Strict-mode alternative to the broad 'Merkle Root length == 66' Guard (machine_merkle_root_v2). Broad mode trusts submitter honesty; strict mode enforces WHO submitted (谁得利谁举证 — whoever benefits bears the burden of proof) without verifying message content on-chain.",
+    "Strict-mode alternative to the broad 'Merkle Root length == 66' Guard (machine_merkle_root_v2). Broad mode trusts submitter honesty; strict mode enforces WHO submitted (whoever benefits bears the burden of proof) without verifying message content on-chain.",
     "Schema-verified: CallGuard_DataSchema (guard.ts) — namedNew creation form; table items carry no object_type (output-only); root logic_and returns Bool (allowed root type). logic_as_u256_greater compares first node > all subsequent nodes, so proof.time is listed before order.time.",
     "Query names verified against knowledge/guard-templates.ts (tpl that uses proof.signer/proof.time/order.time): proof.signer (Proof object, Address), proof.time (U64, clock-derived, always > 0), order.time (U64), order.service (Address). context enum is exactly 'Signer' | 'Clock' | 'Guard'.",
     "Proof generation (provider side, off-chain SDK): messenger submitChainProof(env, peerAddress, description) — about_address = the customer, order id embedded in description; returns proofAddress which is later submitted as identifier 0.",

package/dist/examples/retail-myshop-service-create.json

@@ -4,7 +4,7 @@
   "tags": ["service", "retail", "ecommerce", "draft", "create", "12-step"],
   "industry": "retail",
   "operation_type": "service",
-  "source": "myshop deployment walkthrough (docs/examples/MyShop) — adapted to the 12-step plan + testnet (DRAFT only, schema-validated)",
+  "source": "myshop deployment walkthrough (docs/examples/MyShop) — adapted to the 12-step plan + testnet (DRAFT only, schema-validated, not chain-verified)",
   "verified": false,
   "network": "testnet",
   "call": {

package/dist/examples/retail-myshop-service-customer-required.json

@@ -4,7 +4,7 @@
   "tags": ["service", "customer_required", "um", "contact", "messenger", "retail", "hard-linkage", "12-step"],
   "industry": "retail",
   "operation_type": "service",
-  "source": "adapted to the 12-step plan + SDK customer_required⟶um hard linkage (schema-validated)",
+  "source": "adapted to the 12-step plan + SDK customer_required⟶um hard linkage (schema-validated, not chain-verified)",
   "verified": false,
   "network": "testnet",
   "call": {

package/dist/examples/subscription-contact-create.json

@@ -0,0 +1,40 @@
+{
+  "title": "Create Subscription Contact Object",
+  "description": "Create a named Contact object for a subscription service, with a Permission reference and an IM entry pointing at the support account",
+  "tags": ["contact", "messenger", "ims", "subscription"],
+  "industry": "subscription",
+  "operation_type": "contact",
+  "source": "Template-generated from K2 industry defaults (not chain-verified)",
+  "verified": false,
+  "network": "testnet",
+  "call": {
+    "tool": "onchain_operations",
+    "operation_type": "contact",
+    "data": {
+      "object": {
+        "name": "subscription_contact",
+        "permission": "subscription_permission",
+        "replaceExistName": true
+      },
+      "description": "Subscription support contact — manage your plan, pause, or cancel anytime",
+      "ims": {
+        "op": "add",
+        "im": [
+          {
+            "at": "subscription_support",
+            "description": "Primary support account"
+          }
+        ]
+      }
+    },
+    "env": {
+      "network": "testnet",
+      "no_cache": true,
+      "confirmed": true
+    }
+  },
+  "notes": [
+    "Bind this Contact to the subscription Service via the service call's 'um' field.",
+    "Subscription billing should use charge_guard_signer (explicit user signature per period)."
+  ]
+}

package/dist/examples/threebody-machine-create.json

@@ -4,7 +4,7 @@
   "tags": ["machine", "multisig", "signature", "approval-gate", "permissionIndex", "draft", "12-step"],
   "industry": "general",
   "operation_type": "machine",
-  "source": "docs/examples/ThreeBody_Signature — adapted to the 12-step plan (DRAFT only, schema-validated)",
+  "source": "docs/examples/ThreeBody_Signature — adapted to the 12-step plan (DRAFT only, schema-validated, not chain-verified)",
   "verified": false,
   "network": "testnet",
   "call": {

package/dist/examples/travel-machine-create.json

@@ -4,7 +4,7 @@
   "tags": ["machine", "travel", "workflow", "forward-guard", "multi-node", "draft", "12-step"],
   "industry": "travel",
   "operation_type": "machine",
-  "source": "docs/examples/Travel — adapted to the 12-step plan (DRAFT only, schema-validated)",
+  "source": "docs/examples/Travel — adapted to the 12-step plan (DRAFT only, schema-validated, not chain-verified)",
   "verified": false,
   "network": "testnet",
   "call": {

package/dist/examples/travel-service-create.json

@@ -4,7 +4,7 @@
   "tags": ["service", "travel", "draft", "create", "12-step"],
   "industry": "travel",
   "operation_type": "service",
-  "source": "docs/examples/Travel — adapted to the 12-step plan (DRAFT only, schema-validated)",
+  "source": "docs/examples/Travel — adapted to the 12-step plan (DRAFT only, schema-validated, not chain-verified)",
   "verified": false,
   "network": "testnet",
   "call": {