@wowok/agent-mcp 2.7.7 → 2.7.10

package/dist/knowledge/trust-metrics.d.ts

@@ -18,6 +18,7 @@ export interface ServiceTrustMetrics {
     hasPublishedEvents?: boolean;
     hasMachineBound?: boolean;
     hasBuyGuard?: boolean;
+    hasReward?: boolean;
 }
 export interface TrustDimension {
     name: string;
@@ -25,6 +26,13 @@ export interface TrustDimension {
     maxScore: number;
     description: string;
     humanReadable: string;
+    weight?: number;
+}
+export interface TrustFinding {
+    kind: string;
+    severity: "critical" | "warning" | "info";
+    message: string;
+    deduction: number;
 }
 export interface ServiceTrustScore {
     score: number;
@@ -32,9 +40,26 @@ export interface ServiceTrustScore {
     breakdown: TrustDimension[];
     summary: string;
     warnings: string[];
+    findings: TrustFinding[];
+}
+export declare const TRUST_METRICS_VERSION = 2;
+export declare const TRUST_DIMENSION_WEIGHTS: {
+    readonly trust_arbitration: 20;
+    readonly trust_reviews: 35;
+    readonly trust_fulfillment: 20;
+    readonly trust_fund_safety: 15;
+    readonly trust_transparency: 10;
+};
+export type TrustDimensionId = keyof typeof TRUST_DIMENSION_WEIGHTS;
+export interface TrustInjection {
+    overrides?: {
+        rules?: Record<string, {
+            enabled?: boolean;
+            weight?: number;
+        }>;
+    };
 }
-export declare const TRUST_METRICS_VERSION = 1;
-export declare function computeServiceTrustScore(metrics: ServiceTrustMetrics): ServiceTrustScore;
+export declare function computeServiceTrustScore(metrics: ServiceTrustMetrics, injection?: TrustInjection): ServiceTrustScore;
 export declare function quickTrustCheck(metrics: ServiceTrustMetrics): {
     pass: boolean;
     reason: string;

package/dist/knowledge/trust-metrics.js

@@ -1 +1 @@
-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']+')'};}
+export const TRUST_METRICS_VERSION=0x2;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 const TRUST_DIMENSION_WEIGHTS={'trust_arbitration':0x14,'trust_reviews':0x23,'trust_fulfillment':0x14,'trust_fund_safety':0xf,'trust_transparency':0xa};function trustWeight(a,b){const c=b?.['overrides']?.['rules']?.[a];if(c?.['enabled']===![])return 0x0;if(c?.['weight']!==undefined)return Math['max'](0x0,c['weight']);return TRUST_DIMENSION_WEIGHTS[a];}export function computeServiceTrustScore(a,b){const c=[{'id':'trust_arbitration','dim':computeArbitrationDimension(a)},{'id':'trust_reviews','dim':computeReviewDimension(a)},{'id':'trust_fulfillment','dim':computeFulfillmentDimension(a)},{'id':'trust_fund_safety','dim':computeFundDimension(a)},{'id':'trust_transparency','dim':computeTransparencyDimension(a)}],d=[],e=[];let f=0x0,g=0x0;for(const {id:m,dim:n}of c){const o=trustWeight(m,b),p=n['maxScore']>0x0?n['score']/n['maxScore']*0x64:0x0;f+=p*o,g+=o,e['push']({...n,'weight':o}),o>0x0&&p<0x1e&&d['push'](n['name']+':\x20low\x20score\x20('+Math['round'](p)+'/100)');}const h=[];(a['compensationFundBalance']===undefined||a['compensationFundBalance']===0x0n)&&h['push']({'kind':'fund_safety_missing','severity':'warning','message':'No\x20compensation\x20fund;\x20insufficient\x20protection\x20of\x20customer\x20rights','deduction':0x5});const i=g>0x0?Math['round'](f/g):0x0,j=TRUST_LEVELS['find'](q=>i>=q['min'])?.['level']??'high_risk',k=TRUST_LEVELS['find'](q=>i>=q['min'])?.['label']??'High\x20risk',l=buildSummary(i,k,a,e);return{'score':i,'level':j,'breakdown':e,'summary':l,'warnings':d,'findings':h};}function computeArbitrationDimension(a){const b=0x14;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*0x8);c+=e,d['push']('score\x20'+a['arbitrationScore']+'/100');}else c+=0x2;a['arbitrationVotingGuardCount']!==undefined&&a['arbitrationVotingGuardCount']>0x0&&(c+=0x3,d['push'](a['arbitrationVotingGuardCount']+'\x20voting_guard(s)'));a['arbitrationFeeBalance']!==undefined&&a['arbitrationFeeBalance']>0x0n&&(c+=0x3,d['push']('fee\x20funded'));if(a['arbitrationPaused']===![])c+=0x3,d['push']('active');else a['arbitrationPaused']===!![]&&d['push']('paused');return a['arbitrationCases']!==undefined&&a['arbitrationCases']>0x0&&(c+=0x3,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=0x23;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*0x14+h),j=a['hasReward']?0xa:0x0;return{'name':'reviews','score':Math['min'](b,i+j),'maxScore':b,'description':'Like\x20rate\x20'+Math['round'](g*0x64)+'%\x20('+f+'\x20reviews,\x20'+e+'\x20verified)\x20+\x20reward\x20mechanism\x20'+(a['hasReward']?'✓':'✗'),'humanReadable':'Like\x20rate\x20'+Math['round'](g*0x64)+'%\x20('+f+'\x20reviews)'+(a['hasReward']?',\x20reward\x20✓':'')};}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/workflow-guidance.d.ts

@@ -16,6 +16,9 @@ export interface ParsedMachineNode {
 }
 export type NameResolver = (addr: string | undefined | null) => string | undefined;
 export declare function resolvePermissionRole(index: number | undefined | null, permissionDescription?: string): string;
+export declare const QUERY_OBJECTS_BATCH = 50;
+export declare function fetchAllFieldObjectIds(parent: string, network?: string, noCache?: boolean): Promise<string[]>;
+export declare function batchQueryObjectsByIds(ids: string[], network?: string, noCache?: boolean): Promise<any[]>;
 export declare function fetchMachineNodes(machine: string, network?: string, noCache?: boolean): Promise<ParsedMachineNode[]>;
 export interface GuidanceInput {
     current: string;
@@ -159,6 +162,25 @@ export interface EntityContactContext {
     byContact: Map<string, number>;
 }
 export declare function fetchEntityContact(entityAddr: string, network?: string, noCache?: boolean): Promise<EntityContactContext | undefined>;
+export declare const ENTITY_ORDER_OBJECT_ID = "0xaa8";
+export declare const ENTITY_ORDER_ROLES: {
+    readonly OWNER: 1;
+    readonly AGENT: 2;
+};
+export interface EntityOrderItem {
+    role: number;
+    order: string;
+    time: number;
+}
+export interface EntityOrderContext {
+    items: EntityOrderItem[];
+    byOrder: Map<string, number>;
+}
+export declare function fetchOrdersOfUser(entityAddr: string, network?: string, noCache?: boolean): Promise<any[] | undefined>;
+export interface ResolvedLocalNames {
+    byAddress: Map<string, string>;
+}
+export declare function resolveLocalNamesFor(addresses: string[]): Promise<ResolvedLocalNames>;
 export declare const OBJECT_LINKER_CORE_OBJECT_ID = "0xaae";
 export declare const OBJECT_LINKER_TX_OBJECT_ID = "0xaaf";
 export interface ObjectLinkerItem {

package/dist/knowledge/workflow-guidance.js

@@ -1 +1 @@
-import{query_objects,query_table,query_account_list,LocalMark,GetLocalNamesByAddresses,bcs,deriveDynamicFieldID}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['callerAddress']??a['caller'],a['orderHolderAddresses']);let n=![];a['callerAddress']&&(n=accountCanExecuteForward(k,a['callerAddress'],a['progressNamedOperator']??[],a['orderContext'],a['permissionContext']));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']((u,v)=>v['consistency']-u['consistency']);const c=b[0x0];b[0x0]={...c,'recommended':!![]};const d=[];for(const u of b){u!==c&&u['consistency']>0x0&&u['forward']!==c['forward']&&d['push']('Choosing\x20\x22'+u['forward']+'\x20→\x20'+u['next_node']+'\x22\x20forfeits\x20the\x20faster/more\x20aligned\x20path\x20\x22'+c['forward']+'\x20→\x20'+c['next_node']+'\x22');}const e=[],g=b['filter'](v=>v['operator']['kind']==='order_holder'&&v['forward']!==c['forward']&&c['forward']!==v['forward']),h=b['filter'](v=>v['operator']['account_name']&&v['operator']['account_name']!==a['caller']);return h['length']>0x0&&!b['some'](v=>v['recommended']&&v['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'](u=>u?.['name']==='')?.['operators']:undefined)??[];if(!g)return undefined;const j=await fetchMachineNodes(g,a['network'],a['noCache']);let k,l;try{const u=await query_objects({'objects':[g],'no_cache':a['noCache'],'network':a['network']}),v=u?.['objects']?.[0x0],w=v?.['data']??v,x=w?.['permission'];if(x){const y=await query_objects({'objects':[x],'no_cache':a['noCache'],'network':a['network']}),z=y?.['objects']?.[0x0];k=(z?.['data']??z)?.['description']??undefined,l=await fetchPermissionContext(x,a['network'],a['noCache']);}}catch{}const m=(Array['isArray'](e['namedOperator'])?e['namedOperator']:[])['map'](A=>({'name':String(A?.['name']??''),'operators':(A?.['operators']??[])['map'](B=>String(B))}));let n;e['task']&&(n=await fetchOrderContext(e['task'],a['network'],a['noCache']));let o;try{o=await LocalMark['Instance']()['get_address'](a['accountName'])??undefined;}catch{o=undefined;}const p=await makeNameResolver([a['accountName'],...i]),q={'current':f,'nodes':j,'caller':a['accountName'],'callerAddress':o,'orderHolderAddresses':i,'progressNamedOperator':m,'permissionContext':l,'orderContext':n,'permissionDescription':k,'nameResolver':p},r=buildWorkflowGuidance(q);let s;a['operate']?.['forward']&&a['operate']?.['next_node_name']&&(s=buildWorkflowReceipt({...q,'callerName':a['accountName']??b,'forward':a['operate']['forward'],'targetNode':a['operate']['next_node_name'],'op':a['operate']['op'],'session':h}));const t=[s?renderReceiptText(s):undefined,r['options']['length']?renderGuidanceText(r):undefined]['filter'](A=>!!A)['join']('\x0a\x0a');return{'guidance':r,'receipt':s,'text':t};}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;}export const ENTITY_PERMISSION_OBJECT_ID='0xaad';export const ENTITY_PERMISSION_ROLES={'OWNER':0x1,'ADMIN':0x2,'ENTITY':0x4};export async function fetchEntityPermission(a,b,c){try{const e=bcs['Address']['serialize'](a)['toBytes'](),f=deriveDynamicFieldID(ENTITY_PERMISSION_OBJECT_ID,'address',e),g=await query_objects({'objects':[f],'no_cache':c,'network':b}),h=g?.['objects']?.[0x0],i=h?.['data']??h,j=[],k=new Map(),l=Array['isArray'](i?.['items'])?i['items']:[];for(const m of l){const n=Number(m?.['role']??0x0),o=String(m?.['permission']??'')['toLowerCase'](),p=Number(m?.['time']??0x0);o&&(j['push']({'role':n,'permission':o,'time':p}),k['set'](o,(k['get'](o)??0x0)|n));}return{'items':j,'byPermission':k};}catch{return undefined;}}export const ENTITY_CONTACT_OBJECT_ID='0xaa9';export async function fetchEntityContact(a,b,c){try{const e=bcs['Address']['serialize'](a)['toBytes'](),f=deriveDynamicFieldID(ENTITY_CONTACT_OBJECT_ID,'address',e),g=await query_objects({'objects':[f],'no_cache':c,'network':b}),h=g?.['objects']?.[0x0],i=h?.['data']??h,j=[],k=new Map(),l=Array['isArray'](i?.['items'])?i['items']:[];for(const m of l){const n=String(m?.['contact']??'')['toLowerCase'](),o=Number(m?.['time']??0x0);n&&(j['push']({'contact':n,'time':o}),k['set'](n,o));}return{'items':j,'byContact':k};}catch{return undefined;}}export const OBJECT_LINKER_CORE_OBJECT_ID='0xaae';export const OBJECT_LINKER_TX_OBJECT_ID='0xaaf';async function fetchObjectLinker(a,b,c,e){try{const f=bcs['Address']['serialize'](b)['toBytes'](),g=deriveDynamicFieldID(a,'address',f),h=await query_objects({'objects':[g],'no_cache':e,'network':c}),i=h?.['objects']?.[0x0],j=i?.['data']??i,k=[],l=new Map(),m=Array['isArray'](j?.['items'])?j['items']:[];for(const n of m){const o=String(n?.['who']??'')['toLowerCase'](),p=Number(n?.['time']??0x0);o&&(k['push']({'who':o,'time':p}),l['set'](o,p));}return{'items':k,'byWho':l};}catch{return undefined;}}export async function fetchObjectLinkerCore(a,b,c){return fetchObjectLinker(OBJECT_LINKER_CORE_OBJECT_ID,a,b,c);}export async function fetchObjectLinkerTx(a,b,c){return fetchObjectLinker(OBJECT_LINKER_TX_OBJECT_ID,a,b,c);}export async function fetchPermissionContext(a,b,c){try{const e=await query_objects({'objects':[a],'no_cache':c,'network':b}),f=e?.['objects']?.[0x0],g=f?.['data']??f,h=new Set((g?.['admin']??[])['map'](l=>String(l)['toLowerCase']())),i=new Map(),j=await query_table({'parent':a,'no_cache':c,'network':b}),k=(j?.['items']??[])['map'](l=>l?.['object'])['filter'](l=>typeof l==='string');if(k['length']>0x0){const l=await query_objects({'objects':k,'no_cache':c,'network':b});for(const m of l?.['objects']??[]){const n=m?.['data']??m,p=n?.['address'],q=n?.['perm'];p!=null&&Array['isArray'](q)&&i['set'](String(p)['toLowerCase'](),new Set(q['map'](r=>Number(r))));}}return{'admin':h,'table':i};}catch{return undefined;}}export async function fetchOrderContext(a,b,c){try{const e=await query_objects({'objects':[a],'no_cache':c,'network':b}),f=e?.['objects']?.[0x0];if((f?.['type']??f?.['data']?.['type'])!=='Order')return undefined;const g=f?.['data']??f;return{'builder':String(g?.['builder']??''),'agent':new Set((g?.['agent']??[])['map'](h=>String(h)['toLowerCase']()))};}catch{return undefined;}}export async function listLocalAccounts(){try{const a=await query_account_list({'suspended':![]});return(a??[])['filter'](b=>b?.['address'])['map'](b=>({'address':String(b['address']),'name':b['name']??undefined}));}catch{return[];}}export function accountCanExecuteForward(a,b,c,d,e){const g=b['toLowerCase']();if(a['namedOperator']!==undefined&&a['namedOperator']!==null){if(a['namedOperator']===''){if(d&&(g===d['builder']['toLowerCase']()||d['agent']['has'](g)))return!![];}else{if(a['namedOperator']['length']>0x0){const h=c['find'](i=>i?.['name']===a['namedOperator']);if(h?.['operators']?.['some'](i=>String(i)['toLowerCase']()===g))return!![];}}}if(a['permissionIndex']!==undefined&&a['permissionIndex']!==null&&e){if(e['admin']['has'](g))return!![];const i=e['table']['get'](g);if(i?.['has'](a['permissionIndex']))return!![];}return![];}
+import{query_objects,query_table,query_account_list,LocalMark,GetLocalNamesByAddresses,bcs,deriveDynamicFieldID,queryOrdersByUser}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';import{formatShortAddress}from'../persona/address-format.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 const QUERY_OBJECTS_BATCH=0x32;export async function fetchAllFieldObjectIds(a,b,c){const d=[];let e=undefined;for(;;){const f=await query_table({'parent':a,'cursor':e??undefined,'no_cache':c,'network':b});if(!f?.['items']||f['items']['length']===0x0)break;for(const g of f['items']){const h=g?.['object'];if(typeof h==='string')d['push'](h);}if(!f['hasNextPage']||!f['nextCursor'])break;e=f['nextCursor'];}return d;}export async function batchQueryObjectsByIds(a,b,c){const d=[];for(let e=0x0;e<a['length'];e+=QUERY_OBJECTS_BATCH){const f=a['slice'](e,e+QUERY_OBJECTS_BATCH),g=await query_objects({'objects':f,'no_cache':c,'network':b});d['push'](...g?.['objects']??[]);}return d;}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 fetchAllFieldObjectIds(f,b,c);if(g['length']===0x0)return[];const h=await batchQueryObjectsByIds(g,b,c);return(h??[])['filter'](i=>i?.['type']==='TableItem_MachineNode')['map'](i=>{const j=i?.['data']??i,k=typeof j?.['name']==='string'?j['name']:'',l=Array['isArray'](j?.['value'])?j['value']:Array['isArray'](j?.['pairs'])?j['pairs']:[];if(!k)return null;return{'name':k,'pairs':l['map'](m=>({'prev_node':String(m?.['prev_node']??''),'threshold':Number(m?.['threshold']??0x0),'forwards':Array['isArray'](m?.['forwards'])?m['forwards']['map'](n=>{const q=typeof n?.['guard']==='object'&&n?.['guard']!==null?n['guard']['guard']??undefined:typeof n?.['guard']==='string'?n['guard']:undefined;return{'name':String(n?.['name']??''),'weight':Number(n?.['weight']??0x0),'namedOperator':n?.['namedOperator']!==undefined&&n?.['namedOperator']!==null?String(n['namedOperator']):undefined,'permissionIndex':n?.['permissionIndex']!==undefined&&n?.['permissionIndex']!==null?Number(n['permissionIndex']):undefined,'guard':q};}):[]}))};})['filter'](i=>i!==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;return formatShortAddress(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['callerAddress']??a['caller'],a['orderHolderAddresses']);let n=![];a['callerAddress']&&(n=accountCanExecuteForward(k,a['callerAddress'],a['progressNamedOperator']??[],a['orderContext'],a['permissionContext']));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']((u,v)=>v['consistency']-u['consistency']);const c=b[0x0];b[0x0]={...c,'recommended':!![]};const d=[];for(const u of b){u!==c&&u['consistency']>0x0&&u['forward']!==c['forward']&&d['push']('Choosing\x20\x22'+u['forward']+'\x20→\x20'+u['next_node']+'\x22\x20forfeits\x20the\x20faster/more\x20aligned\x20path\x20\x22'+c['forward']+'\x20→\x20'+c['next_node']+'\x22');}const e=[],g=b['filter'](v=>v['operator']['kind']==='order_holder'&&v['forward']!==c['forward']&&c['forward']!==v['forward']),h=b['filter'](v=>v['operator']['account_name']&&v['operator']['account_name']!==a['caller']);return h['length']>0x0&&!b['some'](v=>v['recommended']&&v['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'](v=>v?.['name']==='')?.['operators']:undefined)??[];if(!g)return undefined;const j=await fetchMachineNodes(g,a['network'],![]);let k,l;try{const v=await query_objects({'objects':[g],'no_cache':a['noCache'],'network':a['network']}),w=v?.['objects']?.[0x0],x=w?.['data']??w,y=x?.['permission'];if(y){const z=await query_objects({'objects':[y],'no_cache':a['noCache'],'network':a['network']}),A=z?.['objects']?.[0x0];k=(A?.['data']??A)?.['description']??undefined,l=await fetchPermissionContext(y,a['network'],a['noCache']);}}catch{}const m=(Array['isArray'](e['namedOperator'])?e['namedOperator']:[])['map'](B=>({'name':String(B?.['name']??''),'operators':(B?.['operators']??[])['map'](C=>String(C))}));let n;e['task']&&(n=await fetchOrderContext(e['task'],a['network'],a['noCache']));const o=n?Array['from'](new Set([n['builder'],...n['agent']])['values']()):i;let p;try{p=await LocalMark['Instance']()['get_address'](a['accountName'])??undefined;}catch{p=undefined;}const q=await makeNameResolver([a['accountName'],...o]),r={'current':f,'nodes':j,'caller':a['accountName'],'callerAddress':p,'orderHolderAddresses':o,'progressNamedOperator':m,'permissionContext':l,'orderContext':n,'permissionDescription':k,'nameResolver':q},s=buildWorkflowGuidance(r);let t;a['operate']?.['forward']&&a['operate']?.['next_node_name']&&(t=buildWorkflowReceipt({...r,'callerName':a['accountName']??b,'forward':a['operate']['forward'],'targetNode':a['operate']['next_node_name'],'op':a['operate']['op'],'session':h}));const u=[t?renderReceiptText(t):undefined,s['options']['length']?renderGuidanceText(s):undefined]['filter'](B=>!!B)['join']('\x0a\x0a');return{'guidance':s,'receipt':t,'text':u};}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;}export const ENTITY_PERMISSION_OBJECT_ID='0xaad';export const ENTITY_PERMISSION_ROLES={'OWNER':0x1,'ADMIN':0x2,'ENTITY':0x4};export async function fetchEntityPermission(a,b,c){try{const e=bcs['Address']['serialize'](a)['toBytes'](),f=deriveDynamicFieldID(ENTITY_PERMISSION_OBJECT_ID,'address',e),g=await query_objects({'objects':[f],'no_cache':c,'network':b}),h=g?.['objects']?.[0x0],i=h?.['data']??h,j=[],k=new Map(),l=Array['isArray'](i?.['items'])?i['items']:[];for(const m of l){const n=Number(m?.['role']??0x0),o=String(m?.['permission']??'')['toLowerCase'](),p=Number(m?.['time']??0x0);o&&(j['push']({'role':n,'permission':o,'time':p}),k['set'](o,(k['get'](o)??0x0)|n));}return{'items':j,'byPermission':k};}catch{return undefined;}}export const ENTITY_CONTACT_OBJECT_ID='0xaa9';export async function fetchEntityContact(a,b,c){try{const e=bcs['Address']['serialize'](a)['toBytes'](),f=deriveDynamicFieldID(ENTITY_CONTACT_OBJECT_ID,'address',e),g=await query_objects({'objects':[f],'no_cache':c,'network':b}),h=g?.['objects']?.[0x0],i=h?.['data']??h,j=[],k=new Map(),l=Array['isArray'](i?.['items'])?i['items']:[];for(const m of l){const n=String(m?.['contact']??'')['toLowerCase'](),o=Number(m?.['time']??0x0);n&&(j['push']({'contact':n,'time':o}),k['set'](n,(k['get'](n)??o)||o));}return{'items':j,'byContact':k};}catch{return undefined;}}export const ENTITY_ORDER_OBJECT_ID='0xaa8';export const ENTITY_ORDER_ROLES={'OWNER':0x1,'AGENT':0x2};export async function fetchOrdersOfUser(a,b,c){try{return await queryOrdersByUser({'address':a,'no_cache':c,'network':b});}catch{return undefined;}}export async function resolveLocalNamesFor(a){const b=new Map();try{const c=[...new Set((a??[])['filter'](e=>typeof e==='string'&&e['startsWith']('0x')))];if(c['length']===0x0)return{'byAddress':b};const d=await GetLocalNamesByAddresses(c);for(const e of d??[]){const f=e?.['account']||e?.['local_mark'];if(f)b['set'](String(e['address'])['toLowerCase'](),f);}}catch{}return{'byAddress':b};}export const OBJECT_LINKER_CORE_OBJECT_ID='0xaae';export const OBJECT_LINKER_TX_OBJECT_ID='0xaaf';async function fetchObjectLinker(a,b,c,e){try{const f=bcs['Address']['serialize'](b)['toBytes'](),g=deriveDynamicFieldID(a,'address',f),h=await query_objects({'objects':[g],'no_cache':e,'network':c}),i=h?.['objects']?.[0x0],j=i?.['data']??i,k=[],l=new Map(),m=Array['isArray'](j?.['items'])?j['items']:[];for(const n of m){const o=String(n?.['who']??'')['toLowerCase'](),p=Number(n?.['time']??0x0);o&&(k['push']({'who':o,'time':p}),l['set'](o,p));}return{'items':k,'byWho':l};}catch{return undefined;}}export async function fetchObjectLinkerCore(a,b,c){return fetchObjectLinker(OBJECT_LINKER_CORE_OBJECT_ID,a,b,c);}export async function fetchObjectLinkerTx(a,b,c){return fetchObjectLinker(OBJECT_LINKER_TX_OBJECT_ID,a,b,c);}export async function fetchPermissionContext(a,b,c){try{const e=await query_objects({'objects':[a],'no_cache':c,'network':b}),f=e?.['objects']?.[0x0],g=f?.['data']??f,h=new Set((g?.['admin']??[])['map'](k=>String(k)['toLowerCase']())),i=new Map(),j=await fetchAllFieldObjectIds(a,b,c);if(j['length']>0x0){const k=await batchQueryObjectsByIds(j,b,c);for(const l of k??[]){const m=l?.['data']??l,n=m?.['address'],p=m?.['perm'];n!=null&&Array['isArray'](p)&&i['set'](String(n)['toLowerCase'](),new Set(p['map'](q=>Number(q))));}}return{'admin':h,'table':i};}catch{return undefined;}}export async function fetchOrderContext(a,b,c){try{const e=await query_objects({'objects':[a],'no_cache':c,'network':b}),f=e?.['objects']?.[0x0];if((f?.['type']??f?.['data']?.['type'])!=='Order')return undefined;const g=f?.['data']??f;return{'builder':String(g?.['builder']??g?.['owner']??''),'agent':new Set((g?.['agent']??[])['map'](h=>String(h)['toLowerCase']()))};}catch{return undefined;}}export async function listLocalAccounts(){try{const a=await query_account_list({'suspended':![]});return(a??[])['filter'](b=>b?.['address'])['map'](b=>({'address':String(b['address']),'name':b['name']??undefined}));}catch{return[];}}export function accountCanExecuteForward(a,b,c,d,e){const g=b['toLowerCase']();if(a['namedOperator']!==undefined&&a['namedOperator']!==null){if(a['namedOperator']===''){if(d&&(g===d['builder']['toLowerCase']()||d['agent']['has'](g)))return!![];}else{if(a['namedOperator']['length']>0x0){const h=a['namedOperator'],i=c['find'](j=>String(j?.['name']??'')===h);if(i?.['operators']?.['some'](j=>String(j)['toLowerCase']()===g))return!![];}}}if(a['permissionIndex']!==undefined&&a['permissionIndex']!==null&&e){if(e['admin']['has'](g))return!![];const j=e['table']['get'](g);if(j?.['has'](a['permissionIndex']))return!![];}return![];}

package/dist/knowledge/workspace-lists.d.ts

@@ -0,0 +1,56 @@
+export interface WorkspaceListItem {
+    object: string;
+    object_type: string | null;
+    name?: string;
+    time?: number;
+    description?: string;
+    tags?: string[];
+    location?: string;
+    members_total?: number;
+    members_mine?: number;
+    related_objects?: number;
+    records_total?: number;
+    policies_total?: number;
+    rewards_total?: number;
+    token?: string;
+    balance_total?: string;
+    type_raw?: string;
+    guards_total?: number;
+    claimers?: number;
+    inflow?: string;
+    outflow?: string;
+    status?: "LIVE" | "PAUSED" | "UNPUBLISHED";
+    nodes?: number;
+    edges?: number;
+    progresses?: number;
+    rep?: {
+        like: number;
+        dislike: number;
+        favor: number;
+        votes?: {
+            who: string | null;
+            like: boolean;
+            dislike: boolean;
+            favor: boolean;
+        }[];
+    };
+}
+export interface WorkspaceListsResult {
+    action: "workspace_lists";
+    network?: string;
+    updated_at_ms: number;
+    cached: boolean;
+    treasuries: WorkspaceListItem[];
+    repositories: WorkspaceListItem[];
+    contacts: WorkspaceListItem[];
+    machines: WorkspaceListItem[];
+    rewards: WorkspaceListItem[];
+    others: WorkspaceListItem[];
+    counts: Record<string, number>;
+    note?: string;
+}
+export declare function buildWorkspaceLists(opts: {
+    network?: string;
+    no_cache?: boolean;
+    account?: string;
+}): Promise<WorkspaceListsResult>;

package/dist/knowledge/workspace-lists.js

@@ -0,0 +1 @@
+import{objectTypeFromAddress,query_affiliations,query_objects,query_local_mark_list,query_table,queryTableItem_EntityRegistrar,queryTableItem_EntityLinker}from'@wowok/wowok';import{ObjectType}from'@wowok/wowok';import{fetchEntityPermission,fetchEntityContact,fetchObjectLinkerCore,fetchObjectLinkerTx,listLocalAccounts,resolveLocalNamesFor}from'./workflow-guidance.js';import{fetchMachineNodes}from'../playbooks/service-build/machine-nodes.js';const AGG_TTL_MS=0x1d4c0,AGG_CACHE_MAX=0x8,aggCache=new Map(),aggInflight=new Map(),CLASSIFIED_TYPES=new Set([ObjectType['Permission'],ObjectType['Service'],ObjectType['Machine'],ObjectType['Treasury'],ObjectType['Repository'],ObjectType['Reward'],ObjectType['Demand'],ObjectType['Arbitration'],ObjectType['Arb'],ObjectType['Contact'],ObjectType['Order'],ObjectType['Progress']]);function sortItems(a){return a['sort']((c,d)=>(d['time']??0x0)-(c['time']??0x0)||c['object']['localeCompare'](d['object']));}export async function buildWorkspaceLists(a){const b=a['network'],c=a['account']?.['trim']()['toLowerCase']()||undefined,d=a['no_cache']===!![],e=(b??'')+'|'+(c??'');if(!d){const g=aggCache['get'](e);if(g&&Date['now']()-g['at']<AGG_TTL_MS)return{...g['value'],'cached':!![]};const h=aggInflight['get'](e);if(h)return h;}const f=((async()=>{const i=c?[{'address':c,'name':undefined}]:await listLocalAccounts(),j={'action':'workspace_lists','network':b,'updated_at_ms':Date['now'](),'cached':![],'treasuries':[],'repositories':[],'contacts':[],'machines':[],'rewards':[],'others':[],'counts':{'treasuries':0x0,'repositories':0x0,'contacts':0x0,'machines':0x0,'rewards':0x0,'others':0x0},'note':i['length']===0x0?'No\x20local\x20accounts\x20found\x20—\x20create\x20or\x20import\x20an\x20account\x20first.':undefined};if(i['length']===0x0)return aggCache['set'](e,{'at':Date['now'](),'value':j}),j;const [k,l,n]=await Promise['all']([Promise['all'](i['map'](R=>fetchEntityPermission(R['address'],b,d))),Promise['all'](i['map'](R=>fetchEntityContact(R['address'],b,d))),Promise['all'](i['map'](R=>fetchObjectLinkerTx(R['address'],b,d)))]),p=[],q=new Set();for(const R of k){for(const S of R?.['items']??[]){!q['has'](S['permission'])&&(q['add'](S['permission']),p['push'](S['permission']));}}const s=await Promise['all'](p['map'](T=>fetchObjectLinkerCore(T,b,d))),v={'treasuries':new Map(),'repositories':new Map(),'contacts':new Map(),'machines':new Map(),'rewards':new Map()},w=(T,U,V)=>{const W=U['toLowerCase'](),X=T['get'](W);if(X===undefined||(V??0x0)>X)T['set'](W,V??0x0);};s['forEach'](T=>{for(const U of T?.['items']??[]){const V=objectTypeFromAddress(U['who']);if(V===ObjectType['Treasury'])w(v['treasuries'],U['who'],U['time']);else{if(V===ObjectType['Repository'])w(v['repositories'],U['who'],U['time']);else{if(V===ObjectType['Machine'])w(v['machines'],U['who'],U['time']);else{if(V===ObjectType['Reward'])w(v['rewards'],U['who'],U['time']);else{if(V===ObjectType['Contact'])w(v['contacts'],U['who'],U['time']);}}}}}});for(const T of l){for(const U of T?.['items']??[])w(v['contacts'],U['contact'],U['time']);}const x=new Map();for(const V of n){for(const W of V?.['items']??[]){const X=objectTypeFromAddress(W['who']);if(X&&CLASSIFIED_TYPES['has'](X))continue;w(x,W['who'],W['time']);}}const y=[...v['treasuries']['keys'](),...v['repositories']['keys'](),...v['contacts']['keys'](),...v['machines']['keys'](),...v['rewards']['keys'](),...x['keys']()],z=Y=>Y['startsWith']('0x00'),A=[],B=[];for(const Y of y){if(z(Y))B['push'](Y);else A['push'](Y);}const C=await resolveLocalNamesFor(y),D=new Map(),E=new Map(),F=new Map(),G=new Map(),H=new Map(),I=new Map(),J=new Map();try{const [Z,a0,a1,a2]=await Promise['all']([A['length']>0x0?query_objects({'objects':A,'no_cache':!![],'network':b}):Promise['resolve']({'objects':[]}),Promise['all'](B['map'](a8=>queryTableItem_EntityRegistrar({'address':a8,'no_cache':d,'network':b})['then'](a9=>({'addr':a8,'row':a9}))['catch'](()=>null))),query_local_mark_list(undefined),listLocalAccounts()]),a3=new Set((a2??[])['map'](a8=>String(a8?.['address']??'')['toLowerCase']())),a4=new Set((Z?.['objects']??[])['map'](a8=>String(a8?.['object']??a8?.['address']??'')['toLowerCase']())['filter'](Boolean));for(const a8 of a0){if(!a8)continue;a4['add'](a8['addr']['toLowerCase']());const a9=a8['row']?.['description']??a8['row']?.['info']?.['description'];if(typeof a9==='string'&&a9['trim']())D['set'](a8['addr']['toLowerCase'](),a9['trim']());}if(a4['size']>0x0){const aa=ab=>{for(const ac of[...ab['keys']()])if(!a4['has'](ac))ab['delete'](ac);};aa(v['treasuries']),aa(v['repositories']),aa(v['contacts']),aa(v['machines']),aa(v['rewards']),aa(x);}const a5=new Set([...v['treasuries']['keys'](),...v['repositories']['keys'](),...v['contacts']['keys'](),...v['machines']['keys'](),...v['rewards']['keys'](),...x['keys']()]);await Promise['all']([...a5]['map'](async ab=>{try{const ac=await queryTableItem_EntityLinker({'address':ab,'no_cache':d,'network':b}),ad=Array['isArray'](ac?.['votes'])?ac['votes']:[];ad['length']>0x0&&J['set'](ab,{'like':ad['filter'](ae=>ae&&ae['like'])['length'],'dislike':ad['filter'](ae=>ae&&ae['dislike'])['length'],'favor':ad['filter'](ae=>ae&&ae['favor'])['length'],'votes':ad['map'](ae=>({'who':ae?.['who']??null,'like':!!ae?.['like'],'dislike':!!ae?.['dislike'],'favor':!!ae?.['favor']}))});}catch{}}));for(const ab of Z?.['objects']??[]){const ac=String(ab?.['object']??ab?.['address']??'')['toLowerCase'](),ad=ab?.['description']??ab?.['data']?.['description'];ac&&typeof ad==='string'&&ad['trim']()&&D['set'](ac,ad['trim']());if(ac&&v['contacts']['has'](ac)){const ae=Array['isArray'](ab?.['ims'])?ab['ims']:[],af=typeof ab?.['location']==='string'?ab['location']['trim']():'';F['set'](ac,{...af?{'location':af}:{},'members_total':ae['length'],'members_mine':ae['filter'](ag=>a3['has'](String(ag?.['at']??'')['toLowerCase']()))['length']});}if(ac&&v['rewards']['has'](ac)){const ag=/<([0-9a-zA-Z_:]+)>\s*$/['exec'](String(ab?.['type_raw']??'')),ah=Array['isArray'](ab?.['guards'])?ab['guards']:[],ai=Number(ab?.['record_count']);I['set'](ac,{...ag?{'token':ag[0x1]['split']('::')['pop']()}:{},'guards_total':ah['length'],...Number['isFinite'](ai)?{'claimers':ai}:{},...ab?.['balance']!=null?{'balance_total':String(ab['balance'])}:{},...ab?.['type_raw']!=null?{'type_raw':String(ab['type_raw'])}:{}});}if(ac&&v['treasuries']['has'](ac)){const aj=/<([0-9a-zA-Z_:]+)>\s*$/['exec'](String(ab?.['type_raw']??'')),ak=al=>al===null||al===undefined||al===''?undefined:String(al);I['set'](ac,{...aj?{'token':aj[0x1]['split']('::')['pop']()}:{},...ab?.['balance']!=null?{'balance_total':String(ab['balance'])}:{},...ab?.['type_raw']!=null?{'type_raw':String(ab['type_raw'])}:{},...ab?.['inflow']!=null?{'inflow':ak(ab['inflow'])}:{},...ab?.['outflow']!=null?{'outflow':ak(ab['outflow'])}:{}});}if(ac&&v['repositories']['has'](ac)){const al=Number(ab?.['data_count']),am=Array['isArray'](ab?.['policies'])?ab['policies']:[],an=Array['isArray'](ab?.['rewards'])?ab['rewards']:[];G['set'](ac,{...Number['isFinite'](al)?{'records_total':al}:{},'policies_total':am['length'],'rewards_total':an['length']});}ac&&v['machines']['has'](ac)&&(ab?.['bPublished']!=null||ab?.['bPaused']!=null||ab?.['node_count']!=null)&&H['set'](ac,{'status':ab['bPublished']===!![]?ab['bPaused']===!![]?'PAUSED':'LIVE':'UNPUBLISHED',...Number['isFinite'](Number(ab?.['node_count']))?{'nodes':Number(ab['node_count'])}:{}});}for(const ao of a1??[]){const ap=String(ao?.['address']??'')['toLowerCase']();ap&&Array['isArray'](ao?.['tags'])&&ao['tags']['length']>0x0&&E['set'](ap,ao['tags']['map'](String));}await Promise['all']([...F['keys'](),...G['keys'](),...[...I['keys']()]['filter'](aq=>v['treasuries']['has'](aq)||v['rewards']['has'](aq))]['map'](async aq=>{try{const ar=await query_affiliations({'address':aq,'no_cache':d,'network':b}),as=new Set();let at=0x0;for(const av of ar?.['entries']??[]){const aw=String(av?.['who']??'')['toLowerCase']();if(!aw||aw==='0x0')continue;if(objectTypeFromAddress(aw)===undefined)continue;const ax=(av?.['table']??'')+':'+aw;if(as['has'](ax))continue;as['add'](ax),at++;}const au=F['get'](aq)??G['get'](aq)??(v['treasuries']['has'](aq)||v['rewards']['has'](aq)?I['get'](aq):undefined);if(au)au['related_objects']=at;}catch{}})),await Promise['all']([...v['machines']['keys']()]['map'](async aq=>{try{const [ar,as]=await Promise['all']([fetchMachineNodes(aq,b)['catch'](()=>undefined),fetchObjectLinkerTx(aq,b,d)]);if(!H['has'](aq))H['set'](aq,{});const at=H['get'](aq);if(ar){at['nodes']=ar['length'];let au=0x0;for(const av of ar){for(const aw of Array['isArray'](av?.['value'])?av['value']:[]){if(aw&&typeof aw==='object'&&aw['prev_node'])au++;}}at['edges']=au;}if(as){const ax=new Set();let ay=0x0,az=0x0;for(const aA of as['items']??[]){const aB=String(aA?.['who']??'')['toLowerCase']();if(!aB||aB==='0x0'||ax['has'](aB))continue;ax['add'](aB);if(objectTypeFromAddress(aB)===undefined)continue;ay++;if(objectTypeFromAddress(aB)===ObjectType['Progress'])az++;}at['related_objects']=ay,at['progresses']=az;}}catch{}}));const a6=0x12c,a7=0xc8;await Promise['all']([...G['keys']()]['map'](async aq=>{try{let ar=undefined,as=0x0;for(;;){const au=await query_table({'parent':aq,'cursor':ar,'limit':a7,'no_cache':d,'network':b});as+=Array['isArray'](au?.['items'])?au['items']['length']:0x0;if(!au?.['hasNextPage']||!au?.['nextCursor']||as>=a6)break;ar=String(au['nextCursor']);}const at=G['get'](aq);if(at)at['records_total']=Math['min'](as,a6);}catch(av){if(/query\.parent/i['test'](String(av?.['message']??av))){const aw=G['get'](aq);if(aw)aw['records_total']=0x0;}}}));}catch{}const K=aq=>sortItems([...aq['entries']()]['map'](([ar,as])=>({'object':ar,'object_type':objectTypeFromAddress(ar)??null,'name':C['byAddress']['get'](ar),'time':as||undefined,'description':D['get'](ar),'tags':E['get'](ar)}))),L=aq=>sortItems([...aq['entries']()]['map'](([ar,as])=>({'object':ar,'object_type':objectTypeFromAddress(ar)??null,'name':C['byAddress']['get'](ar),'time':as||undefined,'description':D['get'](ar),'tags':E['get'](ar),...F['get'](ar)??{}}))),M=aq=>sortItems([...aq['entries']()]['map'](([ar,as])=>({'object':ar,'object_type':objectTypeFromAddress(ar)??null,'name':C['byAddress']['get'](ar),'time':as||undefined,'description':D['get'](ar),'tags':E['get'](ar),...I['get'](ar)??{}}))),N=aq=>sortItems([...aq['entries']()]['map'](([ar,as])=>({'object':ar,'object_type':objectTypeFromAddress(ar)??null,'name':C['byAddress']['get'](ar),'time':as||undefined,'description':D['get'](ar),'tags':E['get'](ar),...I['get'](ar)??{}}))),O=aq=>sortItems([...aq['entries']()]['map'](([ar,as])=>({'object':ar,'object_type':objectTypeFromAddress(ar)??null,'name':C['byAddress']['get'](ar),'time':as||undefined,'description':D['get'](ar),'tags':E['get'](ar),...G['get'](ar)??{}}))),P=aq=>sortItems([...aq['entries']()]['map'](([ar,as])=>({'object':ar,'object_type':objectTypeFromAddress(ar)??null,'name':C['byAddress']['get'](ar),'time':as||undefined,'description':D['get'](ar),'tags':E['get'](ar),...H['get'](ar)??{}}))),Q={'action':'workspace_lists','network':b,'updated_at_ms':Date['now'](),'cached':![],'treasuries':N(v['treasuries']),'repositories':O(v['repositories']),'contacts':L(v['contacts']),'machines':P(v['machines']),'rewards':M(v['rewards']),'others':K(x),'counts':{'treasuries':v['treasuries']['size'],'repositories':v['repositories']['size'],'contacts':v['contacts']['size'],'machines':v['machines']['size'],'rewards':v['rewards']['size'],'others':x['size']}};for(const aq of[Q['treasuries'],Q['repositories'],Q['contacts'],Q['machines'],Q['rewards'],Q['others']]){for(const ar of aq){const as=J['get'](ar['object']);if(as)ar['rep']=as;}}aggCache['set'](e,{'at':Date['now'](),'value':Q});if(aggCache['size']>AGG_CACHE_MAX){const at=aggCache['keys']()['next']()['value'];if(at!==undefined)aggCache['delete'](at);}return Q;})());if(!d)aggInflight['set'](e,f);try{return await f;}finally{if(!d)aggInflight['delete'](e);}}

package/dist/loop-engineering/context-collect.d.ts

@@ -1,4 +1,4 @@
-import type { AssembleContextResult } from "../project/context-assembly.js";
+import type { AssembleContextResult } from "../playbooks/service-build/context-assembly.js";
 export interface ContextCollectionResult {
     signature_recorded: boolean;
     proposal_created: boolean;

package/dist/monitor/EventRouter.d.ts

@@ -0,0 +1,10 @@
+import { type MonitorEventStore } from "./EventStore.js";
+import { type EventFilter, type RelevanceAnnotation, type ScopeSnapshot, type SubscriptionConfig } from "./types.js";
+export declare function evaluateFilter(filter: EventFilter, event: unknown): boolean;
+export declare function annotateEvent(event: Record<string, any>, snapshot: ScopeSnapshot, config: SubscriptionConfig): RelevanceAnnotation;
+export declare function annotateBatch(events: Record<string, any>[], snapshot: ScopeSnapshot, config: SubscriptionConfig): RelevanceAnnotation[];
+export declare function shouldDeliver(annotation: RelevanceAnnotation, config: SubscriptionConfig): boolean;
+export declare function backfillAnnotations(network: string, store: MonitorEventStore, snapshot: ScopeSnapshot, windowDays: number, config?: SubscriptionConfig): Promise<{
+    rescanned: number;
+    updated: number;
+}>;

package/dist/monitor/EventRouter.js

@@ -0,0 +1 @@
+import{monitorEventId}from'./EventStore.js';import{EVENT_ADDRESS_FIELDS}from'./normalize.js';import{defaultSubscriptionConfig,normalizeAddr}from'./types.js';function resolveFieldValues(a,b){let c=[a];for(const d of b['split']('.')){const e=d['endsWith']('[]'),f=e?d['slice'](0x0,-0x2):d;if(!f)return[];const g=[];for(const h of c){if(h===null||h===undefined||typeof h!=='object')continue;const i=h[f];if(e){if(Array['isArray'](i))g['push'](...i);}else g['push'](i);}c=g;}return c;}function bothIntegers(c,d){return/^-?\d+$/['test'](c)&&/^-?\d+$/['test'](d);}function applyOp(c,d,e){if(c===null||c===undefined)return![];switch(d){case'eq':return String(c)===String(e);case'neq':return String(c)!==String(e);case'contains':if(typeof c==='string')return c['includes'](String(e));if(Array['isArray'](c))return c['some'](f=>String(f)===String(e));return![];case'gte':case'lte':{const f=String(c),g=String(e);let h;if(bothIntegers(f,g)){const i=BigInt(f),j=BigInt(g);h=i<j?-0x1:i>j?0x1:0x0;}else{const k=Number(f),l=Number(g);if(Number['isNaN'](k)||Number['isNaN'](l))return![];h=k<l?-0x1:k>l?0x1:0x0;}return d==='gte'?h>=0x0:h<=0x0;}case'in':return Array['isArray'](e)&&e['some'](m=>String(m)===String(c));default:return![];}}export function evaluateFilter(a,b){if(!a||typeof a['field']!=='string'||!a['field'])return![];const c=resolveFieldValues(b,a['field']);return c['some'](d=>applyOp(d,a['op'],a['value']));}function eventAddresses(a){const b=[];for(const c of EVENT_ADDRESS_FIELDS){const d=a?.[c];if(typeof d==='string'&&d)b['push'](d);else{if(Array['isArray'](d)){for(const e of d)if(typeof e==='string'&&e)b['push'](e);}}}if(typeof a?.['sender']==='string'&&a['sender'])b['push'](a['sender']);return b;}export function annotateEvent(a,b,c){const d=String(a?.['type']??''),e=[],f=new Set();for(const h of eventAddresses(a)){const i=b['index']?.[normalizeAddr(h)];if(!i)continue;for(const j of i){const k=j['rule']+':'+normalizeAddr(j['object']);if(f['has'](k))continue;f['add'](k),e['push'](j);}}const g=[];for(const l of c['filters']??[]){if(!l?.['enabled'])continue;if(l['event']&&l['event']!==d)continue;try{if(evaluateFilter(l,a))g['push'](l['id']);}catch{}}return{'event_id':monitorEventId(a?.['id']),'event_type':d,'rules':e,'focus_hit':e['some'](m=>m['rule']==='focus'),'matched_filters':g,'scope_version':b['version'],'annotated_at':Date['now']()};}export function annotateBatch(a,b,c){const d=[];for(const e of a??[]){if(!monitorEventId(e?.['id']))continue;d['push'](annotateEvent(e,b,c));}return d;}export function shouldDeliver(a,b){const c=a['rules']['length']>0x0||a['focus_hit']||a['matched_filters']['length']>0x0;if(!c)return![];return b['events']?.[a['event_type']]===!![]||a['focus_hit'];}export async function backfillAnnotations(a,b,c,d,e=defaultSubscriptionConfig()){const f=Date['now']()-Math['max'](0x0,d)*0x5265c00;let g=0x0,h=0x0,i=0x0;const j=0xc8;for(;;){const k=await b['list'](a,{'since':f,'offset':i,'limit':j});if(k['events']['length']===0x0)break;const l=await b['getAnnotations'](a,k['events']['map'](o=>o['id'])),m=[],n=[];for(const o of k['events']){g++;const p=l['get'](o['id']);if(p&&p['scope_version']>=c['version'])continue;const q=o['event'];if(!q||typeof q!=='object')continue;const r=annotateEvent(q,c,e);if(!r['event_id'])continue;const s=r['rules']['length']>0x0||r['focus_hit']||r['matched_filters']['length']>0x0;if(s)m['push'](r),h++;else p&&(n['push'](o['id']),h++);}await b['saveAnnotations'](a,m);if(n['length']>0x0)await b['deleteAnnotations'](a,n);i+=k['events']['length'];if(i>=k['total'])break;}return{'rescanned':g,'updated':h};}

package/dist/monitor/EventStore.d.ts

@@ -0,0 +1,98 @@
+import { SQLiteStorage } from "@wowok/wowok/w/local";
+import { type MonitorEventModule, type RelevanceAnnotation } from "./types.js";
+export { MONITOR_EVENT_MODULES } from "./types.js";
+export type { MonitorEventModule } from "./types.js";
+export interface MonitorEventRecord {
+    module: MonitorEventModule;
+    type: string;
+    time: number;
+    event: unknown;
+}
+export interface MonitorEventWithSeen extends MonitorEventRecord {
+    id: string;
+    seen: boolean;
+    relevance?: RelevanceAnnotation;
+}
+export interface MonitorListOptions {
+    module?: MonitorEventModule;
+    eventType?: string;
+    since?: number;
+    until?: number;
+    offset?: number;
+    limit?: number;
+    relevantOnly?: boolean;
+    withReason?: boolean;
+}
+export interface MonitorListResult {
+    events: MonitorEventWithSeen[];
+    total: number;
+    moduleCounts: Record<string, number>;
+    unreadByModule: Record<string, number>;
+    totalUnread: number;
+}
+interface CursorRow {
+    cursors: Record<string, {
+        eventSeq: string;
+        txDigest: string;
+    }>;
+    lastPollAt: number;
+}
+export interface LegacyMonitorState {
+    cursors?: Record<string, {
+        eventSeq: string;
+        txDigest: string;
+    }>;
+    modules?: Record<string, any[]>;
+    seenIds?: string[];
+    lastPollAt?: number;
+}
+export declare function monitorEventId(id: {
+    eventSeq?: string | number;
+    txDigest?: string;
+} | null | undefined): string;
+export declare class MonitorEventStore {
+    private storage;
+    private locks;
+    constructor(storage?: SQLiteStorage);
+    private withLock;
+    private evKey;
+    private idxKey;
+    private unreadKey;
+    private cursorKey;
+    private metaKey;
+    private relKey;
+    private relIdxKey;
+    private getJson;
+    private putJson;
+    ensureMigrated(network: string, legacy?: LegacyMonitorState | null, legacyCursors?: Record<string, {
+        eventSeq: string;
+        txDigest: string;
+    }>, legacyLastPollAt?: number): Promise<void>;
+    insert(network: string, module: MonitorEventModule, events: any[]): Promise<number>;
+    private unreadSets;
+    private pool;
+    list(network: string, opts?: MonitorListOptions): Promise<MonitorListResult>;
+    saveAnnotations(network: string, annotations: RelevanceAnnotation[]): Promise<void>;
+    getAnnotations(network: string, ids: string[]): Promise<Map<string, RelevanceAnnotation>>;
+    deleteAnnotations(network: string, ids: string[]): Promise<void>;
+    listRelevantIds(network: string, offset?: number, limit?: number): Promise<{
+        entries: {
+            id: string;
+            t: number;
+        }[];
+        total: number;
+    }>;
+    unreadCount(network: string, module?: MonitorEventModule): Promise<number>;
+    markRead(network: string, ids: string[]): Promise<{
+        marked: number;
+    }>;
+    markAllRead(network: string, module?: MonitorEventModule): Promise<{
+        marked: number;
+    }>;
+    getCursors(network: string): Promise<CursorRow>;
+    saveCursors(network: string, cursors: Record<string, {
+        eventSeq: string;
+        txDigest: string;
+    }>, lastPollAt: number): Promise<void>;
+}
+export declare const monitorEventStore: MonitorEventStore;

package/dist/monitor/EventStore.js

@@ -0,0 +1 @@
+import{SQLiteStorage}from'@wowok/wowok/w/local';import{MONITOR_EVENT_MODULES}from'./types.js';export{MONITOR_EVENT_MODULES}from'./types.js';const KEY_PREFIX='mon_ev:v3:',IDX_PREFIX='mon_idx:v3:',UNREAD_PREFIX='mon_unread:v3:',CURSOR_PREFIX='mon_cur:v3:',META_PREFIX='mon_meta:v3:',REL_PREFIX='mon_rel:v4:',REL_IDX_PREFIX='mon_rel_idx:v4:';function netKey(a){return(a||'default')['replace'](/[^a-zA-Z0-9_-]/g,'_');}export function monitorEventId(a){if(!a||!a['txDigest']||a['eventSeq']===undefined||a['eventSeq']===null)return'';return a['eventSeq']+':'+a['txDigest'];}export class MonitorEventStore{['storage'];['locks']=new Map();constructor(a){this['storage']=a??new SQLiteStorage();}['withLock'](a,b){const c=netKey(a),d=this['locks']['get'](c)??Promise['resolve'](),e=d['then'](b,b);return this['locks']['set'](c,e['catch'](()=>undefined)),e;}['evKey'](a,b){return''+KEY_PREFIX+netKey(a)+':'+b;}['idxKey'](a,b){return''+IDX_PREFIX+netKey(a)+':'+b;}['unreadKey'](a,b){return''+UNREAD_PREFIX+netKey(a)+':'+b;}['cursorKey'](a){return''+CURSOR_PREFIX+netKey(a);}['metaKey'](a){return''+META_PREFIX+netKey(a);}['relKey'](a,b){return''+REL_PREFIX+netKey(a)+':'+b;}['relIdxKey'](a){return''+REL_IDX_PREFIX+netKey(a);}async['getJson'](a){const b=await this['storage']['get'](a);if(!b)return undefined;try{return JSON['parse'](b);}catch{return undefined;}}async['putJson'](a,b){await this['storage']['put'](a,JSON['stringify'](b));}async['ensureMigrated'](a,b,c,d){await this['withLock'](a,async()=>{const e=await this['getJson'](this['metaKey'](a));if(e?.['migrated'])return;if(b?.['modules']&&typeof b['modules']==='object'){const f=new Set(Array['isArray'](b['seenIds'])?b['seenIds']:[]);for(const g of Object['keys'](b['modules'])){if(!MONITOR_EVENT_MODULES['includes'](g))continue;const h=Array['isArray'](b['modules'][g])?b['modules'][g]:[],j=[],k=[],l=[];for(const m of h){const n=monitorEventId(m?.['id']);if(!n)continue;const o=Number(m?.['time']??0x0)||0x0;l['push']({'key':this['evKey'](a,n),'value':JSON['stringify']({'module':g,'type':m?.['type']??'','time':o,'event':m})}),j['push']({'id':n,'t':o});if(!f['has'](n))k['push'](n);}j['sort']((q,r)=>r['t']-q['t']),await this['storage']['putMany'](l),await this['putJson'](this['idxKey'](a,g),{'entries':j}),await this['putJson'](this['unreadKey'](a,g),{'ids':k});}}c&&Object['keys'](c)['length']>0x0&&await this['putJson'](this['cursorKey'](a),{'cursors':c,'lastPollAt':d??0x0}),await this['putJson'](this['metaKey'](a),{'migrated':!![]});});}async['insert'](a,b,c){const d=c['filter'](e=>monitorEventId(e?.['id'])!=='');if(d['length']===0x0)return 0x0;return this['withLock'](a,async()=>{const e=d['map'](n=>monitorEventId(n['id'])),f=await this['storage']['getMany'](e['map'](n=>this['evKey'](a,n))),g=[];d['forEach']((n,o)=>{if(f[o]===undefined||f[o]===null)g['push']({'id':e[o],'ev':n});});if(g['length']===0x0)return 0x0;await this['storage']['putMany'](g['map'](({id:n,ev:o})=>({'key':this['evKey'](a,n),'value':JSON['stringify']({'module':b,'type':o?.['type']??'','time':Number(o?.['time']??0x0)||0x0,'event':o})})));const h=await this['getJson'](this['idxKey'](a,b))??{'entries':[]},j=new Set(h['entries']['map'](n=>n['id'])),k=[];for(const {id:n,ev:o}of g){if(j['has'](n))continue;j['add'](n),k['push']({'id':n,'t':Number(o?.['time']??0x0)||0x0});}k['sort']((q,r)=>r['t']-q['t']),h['entries']=[...k,...h['entries']],await this['putJson'](this['idxKey'](a,b),h);const l=await this['getJson'](this['unreadKey'](a,b))??{'ids':[]},m=new Set(l['ids']);for(const {id:q}of g)m['add'](q);return await this['putJson'](this['unreadKey'](a,b),{'ids':[...m]}),g['length'];});}async['unreadSets'](a){const b=new Map();for(const c of MONITOR_EVENT_MODULES){const d=await this['getJson'](this['unreadKey'](a,c));b['set'](c,new Set(d?.['ids']??[]));}return b;}async['pool'](a,b){if(b){const f=await this['getJson'](this['idxKey'](a,b));return f?.['entries']??[];}const c=[];for(const g of MONITOR_EVENT_MODULES){const h=await this['getJson'](this['idxKey'](a,g));if(h?.['entries']?.['length'])c['push'](h['entries']);}const d=[],e=c['map'](j=>({'p':j,'i':0x0}));for(;;){let j=-0x1;for(let l=0x0;l<e['length'];l++){const {p:n,i:o}=e[l];if(o<n['length']&&(j<0x0||n[o]['t']>e[j]['p'][e[j]['i']]['t']))j=l;}if(j<0x0)break;d['push'](e[j]['p'][e[j]['i']]),e[j]['i']++;}return d;}async['list'](a,b={}){let c;if(b['relevantOnly']){const x=await this['getJson'](this['relIdxKey'](a));c=x?.['entries']??[];}else c=await this['pool'](a,b['module']);const d=Number(b['since']);if(Number['isFinite'](d)&&d>0x0)c=c['filter'](y=>y['t']>=d);const e=Number(b['until']);if(Number['isFinite'](e)&&e>0x0)c=c['filter'](y=>y['t']<=e);const f=b['relevantOnly']?b['module']:undefined;let g;if(b['eventType']||f){g=new Map();const y=await this['storage']['getMany'](c['map'](A=>this['evKey'](a,A['id']))),z=[];c['forEach']((A,B)=>{let C;try{C=y[B]?JSON['parse'](y[B]):undefined;}catch{C=undefined;}if(!C)return;if(f&&C['module']!==f)return;if(b['eventType']&&C['type']!==b['eventType'])return;z['push'](A),g['set'](A['id'],C);}),c=z;}const h={};for(const A of MONITOR_EVENT_MODULES){const B=await this['getJson'](this['idxKey'](a,A));h[A]=B?.['entries']?.['length']??0x0;}const j=await this['unreadSets'](a),k={};let l=0x0;for(const C of MONITOR_EVENT_MODULES){const D=j['get'](C)?.['size']??0x0;k[C]=D,l+=D;}const o=c['length'],q=Math['max'](0x0,Number(b['offset'])||0x0),r=Math['max'](0x1,Number(b['limit'])||0x32),s=c['slice'](q,q+r),t=s['filter'](E=>!g?.['has'](E['id'])),u=t['length']?await this['storage']['getMany'](t['map'](E=>this['evKey'](a,E['id']))):[],v=new Map();t['forEach']((E,F)=>{try{const G=u[F]?JSON['parse'](u[F]):undefined;if(G)v['set'](E['id'],G);}catch{}});const w=[];for(const E of s){const F=g?.['get'](E['id'])??v['get'](E['id']);if(!F||!MONITOR_EVENT_MODULES['includes'](F['module']))continue;w['push']({'id':E['id'],'module':F['module'],'type':F['type']??'','time':F['time']??E['t'],'event':F['event']??null,'seen':!(j['get'](F['module'])?.['has'](E['id'])??![])});}if(b['withReason']&&w['length']>0x0){const G=await this['getAnnotations'](a,w['map'](H=>H['id']));for(const H of w){const I=G['get'](H['id']);if(I)H['relevance']=I;}}return{'events':w,'total':o,'moduleCounts':h,'unreadByModule':k,'totalUnread':l};}async['saveAnnotations'](a,b){const c=(b??[])['filter'](d=>d&&typeof d['event_id']==='string'&&d['event_id']);if(c['length']===0x0)return;return this['withLock'](a,async()=>{const d=await this['storage']['getMany'](c['map'](k=>this['evKey'](a,k['event_id']))),f=new Map();c['forEach']((k,l)=>{let m=Number(k['annotated_at'])||0x0;try{const n=d[l]?JSON['parse'](d[l]):undefined;if(n&&Number['isFinite'](Number(n['time'])))m=Number(n['time']);}catch{}f['set'](k['event_id'],m);}),await this['storage']['putMany'](c['map'](k=>({'key':this['relKey'](a,k['event_id']),'value':JSON['stringify'](k)})));const g=await this['getJson'](this['relIdxKey'](a))??{'entries':[]},h=new Map();for(const k of g['entries'])h['set'](k['id'],k);for(const l of c)h['set'](l['event_id'],{'id':l['event_id'],'t':f['get'](l['event_id'])??0x0});const j=[...h['values']()]['sort']((m,n)=>n['t']-m['t']);await this['putJson'](this['relIdxKey'](a),{'entries':j});});}async['getAnnotations'](a,b){const c=new Map(),d=(b??[])['filter'](f=>typeof f==='string'&&f['length']>0x0);if(d['length']===0x0)return c;const e=await this['storage']['getMany'](d['map'](f=>this['relKey'](a,f)));return d['forEach']((f,g)=>{try{const h=e[g]?JSON['parse'](e[g]):undefined;if(h&&typeof h['event_id']==='string')c['set'](f,h);}catch{}}),c;}async['deleteAnnotations'](a,b){const c=(b??[])['filter'](d=>typeof d==='string'&&d['length']>0x0);if(c['length']===0x0)return;return this['withLock'](a,async()=>{for(const e of c)await this['storage']['del'](this['relKey'](a,e));const d=await this['getJson'](this['relIdxKey'](a));if(d?.['entries']?.['length']){const f=new Set(c);await this['putJson'](this['relIdxKey'](a),{'entries':d['entries']['filter'](g=>!f['has'](g['id']))});}});}async['listRelevantIds'](a,b,c){const d=await this['getJson'](this['relIdxKey'](a)),e=d?.['entries']??[],f=Math['max'](0x0,Number(b)||0x0),g=Math['max'](0x1,Number(c)||0x32);return{'entries':e['slice'](f,f+g),'total':e['length']};}async['unreadCount'](a,b){const c=await this['unreadSets'](a);if(b)return c['get'](b)?.['size']??0x0;let d=0x0;for(const e of MONITOR_EVENT_MODULES)d+=c['get'](e)?.['size']??0x0;return d;}async['markRead'](a,b){const c=(b??[])['filter'](d=>typeof d==='string'&&d['length']>0x0);if(c['length']===0x0)return{'marked':0x0};return this['withLock'](a,async()=>{const d=await this['storage']['getMany'](c['map'](g=>this['evKey'](a,g))),e=new Map();let f=0x0;c['forEach']((g,h)=>{if(!d[h])return;let j;try{j=JSON['parse'](d[h]);}catch{return;}if(!j?.['module']||!MONITOR_EVENT_MODULES['includes'](j['module']))return;if(!e['has'](j['module']))e['set'](j['module'],new Set());e['get'](j['module'])['add'](g);});for(const [g,h]of e){const j=await this['getJson'](this['unreadKey'](a,g))??{'ids':[]},k=j['ids']['length'],l=j['ids']['filter'](m=>!h['has'](m));f+=k-l['length'],l['length']!==k&&await this['putJson'](this['unreadKey'](a,g),{'ids':l});}return{'marked':f};});}async['markAllRead'](a,b){return this['withLock'](a,async()=>{const c=b?[b]:[...MONITOR_EVENT_MODULES];let d=0x0;for(const e of c){const f=await this['getJson'](this['unreadKey'](a,e))??{'ids':[]};d+=f['ids']['length'],f['ids']['length']>0x0&&await this['putJson'](this['unreadKey'](a,e),{'ids':[]});}return{'marked':d};});}async['getCursors'](a){const b=await this['getJson'](this['cursorKey'](a));return b??{'cursors':{},'lastPollAt':0x0};}async['saveCursors'](a,b,c){await this['putJson'](this['cursorKey'](a),{'cursors':b,'lastPollAt':c});}}export const monitorEventStore=new MonitorEventStore();

package/dist/monitor/MonitorLoop.d.ts

@@ -0,0 +1,79 @@
+import { SQLiteStorage } from "@wowok/wowok/w/local";
+import { MonitorEventStore } from "./EventStore.js";
+import { SubscriptionStore } from "./SubscriptionStore.js";
+import { type ResolveScopeResult } from "./ScopeResolver.js";
+import { annotateBatch } from "./EventRouter.js";
+import { type ProblemBridgeInput } from "./ProblemBridge.js";
+import { type ScopeSnapshot, type SubscriptionConfig } from "./types.js";
+export interface MonitorLoopStatus {
+    running: boolean;
+    lease_holder: string | null;
+    last_tick_at: number;
+    last_new_count: number;
+    scope_version: number;
+    backoff_ms: number;
+}
+export interface MonitorTickSummary {
+    captured: number;
+    annotated: number;
+    duration_ms: number;
+}
+export interface MonitorLoopQuery {
+    type: string;
+    cursor: {
+        eventSeq: string;
+        txDigest: string;
+    } | null;
+    limit: number;
+    order: "ascending" | "descending";
+    network?: string;
+}
+export interface MonitorLoopQueryResult {
+    data?: any[];
+    hasNextPage?: boolean;
+    nextCursor?: {
+        eventSeq: string;
+        txDigest: string;
+    } | null;
+}
+export interface MonitorLoopDeps {
+    store: MonitorEventStore;
+    configStore: Pick<SubscriptionStore, "getConfig">;
+    storage: Pick<SQLiteStorage, "get" | "put" | "del">;
+    resolveScope(network: string, config: SubscriptionConfig): Promise<ResolveScopeResult>;
+    loadScope(network: string): Promise<ScopeSnapshot | undefined>;
+    router: {
+        annotateBatch: typeof annotateBatch;
+        backfillAnnotations: (network: string, store: MonitorEventStore, snapshot: ScopeSnapshot, windowDays: number, config: SubscriptionConfig) => Promise<{
+            rescanned: number;
+            updated: number;
+        }>;
+    };
+    queryEvents(query: MonitorLoopQuery): Promise<MonitorLoopQueryResult | undefined>;
+    defaultNetwork(): Promise<string>;
+    now(): number;
+    pid: number;
+    bootId: string;
+    logger(message: string): void;
+    openProblems?(input: ProblemBridgeInput): Promise<number>;
+    setTimer(cb: () => void, ms: number): unknown;
+    clearTimer(handle: unknown): void;
+}
+export declare class MonitorLoop {
+    private deps;
+    private runtimes;
+    constructor(deps?: Partial<MonitorLoopDeps>);
+    start(networks?: string[]): Promise<string[]>;
+    stop(network?: string): Promise<void>;
+    status(network?: string): MonitorLoopStatus & {
+        last_tick?: MonitorTickSummary;
+    };
+    kick(network: string): void;
+    invalidateScope(network: string): void;
+    tick(network: string): Promise<MonitorTickSummary | undefined>;
+    private schedule;
+    private acquireLease;
+    private getScope;
+    private capture;
+}
+export declare const monitorLoop: MonitorLoop;