@wowok/agent-mcp 3.2.0 → 3.2.1

package/dist/tools/handlers/onchain-name-registration.d.ts

@@ -0,0 +1,37 @@
+import { ObjectType } from "@wowok/wowok";
+export interface CreatedObjectRef {
+    type?: ObjectType | string;
+    object?: string;
+    change?: string;
+}
+export interface NamedObjectRequest {
+    name: string;
+    field: string;
+    tags?: string[];
+    onChain?: boolean;
+    replaceExistName?: boolean;
+}
+export interface LocalMarkWrite {
+    name: {
+        value: string;
+        replaceExistName?: boolean;
+    };
+    address: string;
+    tags?: string[];
+}
+export interface LocalMarkAccess {
+    getAddress(nameOrAddress: string | undefined | null): Promise<string | undefined>;
+    put(marks: LocalMarkWrite[]): Promise<unknown>;
+}
+export declare function operationPrimaryType(operationType: string | undefined): ObjectType | undefined;
+export declare function collectOnChainNamedObjectRequests(data: unknown, maxDepth?: number): NamedObjectRequest[];
+export declare function planLocalMarkRegistrations(requests: NamedObjectRequest[], created: CreatedObjectRef[], operationType: string | undefined): LocalMarkWrite[];
+export interface NameRegistrationReport {
+    resolved: string[];
+    written: string[];
+    failed: Array<{
+        name: string;
+        error: string;
+    }>;
+}
+export declare function registerLocalMarksForCreatedObjects(requests: NamedObjectRequest[], created: CreatedObjectRef[], operationType: string | undefined, access: LocalMarkAccess): Promise<NameRegistrationReport>;

package/dist/tools/handlers/onchain-name-registration.js

@@ -0,0 +1 @@
+import{ObjectType}from'@wowok/wowok';const OPERATION_PRIMARY_TYPE={'service':ObjectType['Service'],'machine':ObjectType['Machine'],'guard':ObjectType['Guard'],'progress':ObjectType['Progress'],'repository':ObjectType['Repository'],'arbitration':ObjectType['Arbitration'],'contact':ObjectType['Contact'],'treasury':ObjectType['Treasury'],'reward':ObjectType['Reward'],'allocation':ObjectType['Allocation'],'demand':ObjectType['Demand'],'order':ObjectType['Order'],'proof':ObjectType['Proof'],'permission':ObjectType['Permission']},NAMED_FIELD_TYPES={'namedNewOrder':ObjectType['Order'],'namedNewAllocation':ObjectType['Allocation'],'namedNewProgress':ObjectType['Progress'],'namedNewPayment':ObjectType['Payment'],'namedArb':ObjectType['Arb']};export function operationPrimaryType(a){return a?OPERATION_PRIMARY_TYPE[a]:undefined;}function expectedTypeForField(a,b){return NAMED_FIELD_TYPES[a]??operationPrimaryType(b);}export function collectOnChainNamedObjectRequests(a,b=0x8){const c=[],d=new WeakSet(),e=(f,g,h)=>{if(f==null||h>b)return;if(Array['isArray'](f)){for(const j of f)e(j,g,h+0x1);return;}if(typeof f!=='object')return;if(d['has'](f))return;d['add'](f);const i=f;if(i['onChain']===!![]&&typeof i['name']==='string'&&i['name']['trim']()['length']>0x0){const k={'name':i['name']['trim'](),'field':g,'onChain':!![]};if(Array['isArray'](i['tags'])){const l=i['tags']['filter'](m=>typeof m==='string'&&m['length']>0x0);if(l['length']>0x0)k['tags']=l;}if(i['replaceExistName']===!![])k['replaceExistName']=!![];c['push'](k);}for(const [m,n]of Object['entries'](i)){e(n,m,h+0x1);}};return e(a,'object',0x0),c;}export function planLocalMarkRegistrations(a,b,c){const d=new Map();for(const f of b??[]){if(f?.['change']!=='created')continue;if(typeof f['object']!=='string'||f['object']['length']===0x0)continue;if(f['type']==null)continue;const g=String(f['type']);if(!d['has'](g))d['set'](g,f['object']);}const e=[];for(const h of a??[]){const i=expectedTypeForField(h['field'],c);if(!i)continue;const j=d['get'](String(i));if(!j)continue;e['push']({'name':{'value':h['name'],'replaceExistName':h['replaceExistName']},'address':j,'tags':h['tags']});}return e;}export async function registerLocalMarksForCreatedObjects(a,b,c,d){const e={'resolved':[],'written':[],'failed':[]},f=planLocalMarkRegistrations(a,b,c);for(const g of f){try{const h=await d['getAddress'](g['name']['value']);if(h?.['toLowerCase']()===g['address']['toLowerCase']()){e['resolved']['push'](g['name']['value']);continue;}await d['put']([g]),e['written']['push'](g['name']['value']),e['resolved']['push'](g['name']['value']);}catch(i){e['failed']['push']({'name':g['name']['value'],'error':i instanceof Error?i['message']:String(i)});}}return e;}

package/dist/tools/handlers/onchain-name-registration.spec.d.ts

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

package/dist/tools/handlers/onchain-name-registration.spec.js

@@ -0,0 +1 @@
+import{describe,expect,it}from'vitest';import{ObjectType}from'@wowok/wowok';import{collectOnChainNamedObjectRequests,planLocalMarkRegistrations,registerLocalMarksForCreatedObjects}from'./onchain-name-registration.js';function fakeMarkStore(a={}){const b=new Map(Object['entries'](a)),c=[];return{'writes':c,async 'getAddress'(d){return b['get'](String(d)['toLowerCase']());},async 'put'(d){for(const e of d){c['push'](e),b['set'](e['name']['value']['toLowerCase'](),e['address']);}return d;}};}const GUARD_ADDR='0x1111111111111111111111111111111111111111111111111111111111111111';describe('collectOnChainNamedObjectRequests',()=>{it('finds\x20a\x20Guard\x20named\x20with\x20onChain:true\x20under\x20`namedNew`',()=>{const a=collectOnChainNamedObjectRequests({'namedNew':{'name':'bkg_g_holder','onChain':!![]}});expect(a)['toEqual']([{'name':'bkg_g_holder','field':'namedNew','onChain':!![]}]);}),it('finds\x20a\x20Guard\x20named\x20with\x20onChain:true\x20under\x20the\x20`object`\x20alias',()=>{const a=collectOnChainNamedObjectRequests({'object':{'name':'bkg_g_holder','onChain':!![]}});expect(a)['toHaveLength'](0x1),expect(a[0x0])['toMatchObject']({'name':'bkg_g_holder','field':'object'});}),it('ignores\x20a\x20local-only\x20(onChain\x20falsy)\x20name\x20—\x20that\x20path\x20already\x20writes\x20a\x20mark',()=>{expect(collectOnChainNamedObjectRequests({'object':{'name':'private_shop'}}))['toEqual']([]),expect(collectOnChainNamedObjectRequests({'object':{'name':'x','onChain':![]}}))['toEqual']([]);}),it('ignores\x20Guard\x20table\x20entries,\x20which\x20carry\x20a\x20`name`\x20but\x20never\x20request\x20onChain',()=>{const a=collectOnChainNamedObjectRequests({'namedNew':{'name':'g','onChain':!![]},'table':[{'identifier':0x1,'name':'order_id','b_submission':!![]}]});expect(a['map'](b=>b['name']))['toEqual'](['g']);}),it('carries\x20tags\x20and\x20replaceExistName\x20through',()=>{const a=collectOnChainNamedObjectRequests({'object':{'name':'g','onChain':!![],'tags':['a','b'],'replaceExistName':!![]}});expect(a[0x0])['toEqual']({'name':'g','field':'object','onChain':!![],'tags':['a','b'],'replaceExistName':!![]});}),it('finds\x20a\x20nested\x20named\x20object\x20(order_new.namedNewOrder)',()=>{const a=collectOnChainNamedObjectRequests({'object':{'name':'svc'},'order_new':{'namedNewOrder':{'name':'ord_1','onChain':!![]}}});expect(a)['toEqual']([{'name':'ord_1','field':'namedNewOrder','onChain':!![]}]);});}),describe('planLocalMarkRegistrations',()=>{it('pairs\x20the\x20Guard\x20request\x20with\x20the\x20Guard\x20the\x20transaction\x20created',()=>{const a=planLocalMarkRegistrations([{'name':'bkg_g_holder','field':'namedNew','onChain':!![]}],[{'type':ObjectType['Guard'],'object':GUARD_ADDR,'change':'created'}],'guard');expect(a)['toEqual']([{'name':{'value':'bkg_g_holder','replaceExistName':undefined},'address':GUARD_ADDR,'tags':undefined}]);}),it('pairs\x20by\x20FIELD\x20hint\x20when\x20several\x20objects\x20are\x20created\x20in\x20one\x20call',()=>{const a='0x2222222222222222222222222222222222222222222222222222222222222222',b='0x3333333333333333333333333333333333333333333333333333333333333333',c=planLocalMarkRegistrations([{'name':'svc','field':'object','onChain':!![]},{'name':'ord','field':'namedNewOrder','onChain':!![]}],[{'type':ObjectType['Order'],'object':b,'change':'created'},{'type':ObjectType['Service'],'object':a,'change':'created'}],'service');expect(c)['toEqual']([{'name':{'value':'svc','replaceExistName':undefined},'address':a,'tags':undefined},{'name':{'value':'ord','replaceExistName':undefined},'address':b,'tags':undefined}]);}),it('drops\x20the\x20request\x20when\x20nothing\x20of\x20that\x20type\x20was\x20created\x20(never\x20guess)',()=>{const a=planLocalMarkRegistrations([{'name':'g','field':'namedNew','onChain':!![]}],[{'type':ObjectType['Payment'],'object':GUARD_ADDR,'change':'created'}],'guard');expect(a)['toEqual']([]);}),it('ignores\x20mutated\x20(not\x20created)\x20objects',()=>{const a=planLocalMarkRegistrations([{'name':'g','field':'namedNew','onChain':!![]}],[{'type':ObjectType['Guard'],'object':GUARD_ADDR,'change':'mutated'}],'guard');expect(a)['toEqual']([]);});}),describe('registerLocalMarksForCreatedObjects\x20—\x20the\x20created\x20name\x20resolves\x20locally',()=>{it('writes\x20a\x20LocalMark\x20so\x20the\x20name\x20resolves\x20for\x20a\x20subsequent\x20reference',async()=>{const a=fakeMarkStore(),b=await registerLocalMarksForCreatedObjects([{'name':'bkg_g_holder','field':'namedNew','onChain':!![]}],[{'type':ObjectType['Guard'],'object':GUARD_ADDR,'change':'created'}],'guard',a);expect(await a['getAddress']('bkg_g_holder'))['toBe'](GUARD_ADDR),expect(b['written'])['toEqual'](['bkg_g_holder']),expect(b['failed'])['toEqual']([]);}),it('is\x20idempotent\x20—\x20a\x20name\x20already\x20bound\x20to\x20the\x20same\x20address\x20is\x20not\x20rewritten',async()=>{const a=fakeMarkStore({'bkg_g_holder':GUARD_ADDR}),b=await registerLocalMarksForCreatedObjects([{'name':'bkg_g_holder','field':'namedNew','onChain':!![]}],[{'type':ObjectType['Guard'],'object':GUARD_ADDR,'change':'created'}],'guard',a);expect(a['writes'])['toEqual']([]),expect(b['written'])['toEqual']([]),expect(b['resolved'])['toEqual'](['bkg_g_holder']);}),it('rebinds\x20a\x20stale\x20address\x20(SDK\x20left\x20the\x20name\x20pointing\x20at\x20an\x20older\x20object)',async()=>{const a='0x9999999999999999999999999999999999999999999999999999999999999999',b=fakeMarkStore({'g':a});await registerLocalMarksForCreatedObjects([{'name':'g','field':'namedNew','onChain':!![]}],[{'type':ObjectType['Guard'],'object':GUARD_ADDR,'change':'created'}],'guard',b),expect(await b['getAddress']('g'))['toBe'](GUARD_ADDR);}),it('reports\x20a\x20failed\x20write\x20instead\x20of\x20throwing\x20(chain\x20effect\x20already\x20succeeded)',async()=>{const a=fakeMarkStore();a['put']=async()=>{throw new Error('LocalMarkNameExist');};const b=await registerLocalMarksForCreatedObjects([{'name':'g','field':'namedNew','onChain':!![]}],[{'type':ObjectType['Guard'],'object':GUARD_ADDR,'change':'created'}],'guard',a);expect(b['failed'])['toEqual']([{'name':'g','error':'LocalMarkNameExist'}]),expect(b['resolved'])['toEqual']([]);}),it('does\x20nothing\x20when\x20the\x20request\x20list\x20is\x20empty',async()=>{const a=fakeMarkStore(),b=await registerLocalMarksForCreatedObjects([],[{'type':ObjectType['Guard'],'object':GUARD_ADDR,'change':'created'}],'guard',a);expect(a['writes'])['toEqual']([]),expect(b)['toEqual']({'resolved':[],'written':[],'failed':[]});}),it('propagates\x20replaceExistName\x20so\x20a\x20forced\x20claim\x20still\x20works',async()=>{const a=fakeMarkStore();await registerLocalMarksForCreatedObjects([{'name':'g','field':'namedNew','onChain':!![],'replaceExistName':!![]}],[{'type':ObjectType['Guard'],'object':GUARD_ADDR,'change':'created'}],'guard',a),expect(a['writes'][0x0]['name'])['toEqual']({'value':'g','replaceExistName':!![]});});});

package/dist/tools/handlers/onchain.d.ts

@@ -1,2 +1,3 @@
 import type { ToolDispatchResult } from "../types.js";
+export declare function invalidateResolvedNameCache(): void;
 export declare function handleOnchainOperations(args: unknown): Promise<ToolDispatchResult>;