@wowok/agent-mcp 2.7.0 → 2.7.2

package/dist/tools/handlers/query.js

@@ -1,434 +1 @@
-import { strictParse, WatchQueryOperationsSchema, OnchainTableDataSchema, OnchainEventsInputSchema, ProtocolInfoQuerySchema, } from "../../schema/index.js";
-import { query_local_mark_list, query_account_list, query_local_info_list, query_local_token_list, query_account, GetLocalNamesByAddresses, query_personal, query_objects, query_table, query_tableItem, queryTableItem_RepositoryData, queryTableItem_PermissionPerm, queryTableItem_RewardRecord, queryTableItem_DemandPresenter, queryTableItem_TreasuryHistory, queryTableItem_MachineNode, queryTableItem_ProgressHistory, queryTableItem_AddressMark, queryTableItem_EntityRegistrar, queryTableItem_EntityLinker, query_received, queryProtocolInfo, query_events, query_transaction, query_object_history, query_address_activity, generateNodeComments, } from "@wowok/wowok";
-import { buildDataSemantic, } from "../../schema/call/semantic.js";
-import { formatChainValue, annotateObjectMonetaryFields, annotateTableItemMonetaryFields, annotateEventsMonetaryFields, annotateBalanceChanges, resolveParentObjectTokenType, convertTokenValue, } from "../../knowledge/fund-layer.js";
-import { normalizeAccountOrMark } from "./messenger.js";
-async function annotateAccountBalance(result, network) {
-    if (!result || typeof result !== "object")
-        return;
-    const displays = {};
-    const convert = (raw, coinType) => {
-        if (raw === null || raw === undefined)
-            return undefined;
-        if (typeof raw !== "string" && typeof raw !== "number" && typeof raw !== "bigint")
-            return undefined;
-        if (typeof coinType !== "string" || !coinType)
-            return undefined;
-        return formatChainValue(raw, coinType, network);
-    };
-    const balance = result.balance;
-    if (balance && typeof balance === "object") {
-        const coinType = balance.coinType;
-        const total = await convert(balance.totalBalance, coinType);
-        if (total)
-            displays["balance.totalBalance"] = total;
-        if (balance.lockedBalance !== undefined) {
-            const locked = await convert(balance.lockedBalance, coinType);
-            if (locked)
-                displays["balance.lockedBalance"] = locked;
-        }
-    }
-    const coinData = result.coin?.data;
-    if (Array.isArray(coinData)) {
-        for (let i = 0; i < coinData.length; i++) {
-            const c = coinData[i];
-            const d = await convert(c?.balance, c?.coinType);
-            if (d)
-                displays[`coin.data[${i}].balance`] = d;
-        }
-    }
-    if (Object.keys(displays).length > 0) {
-        result._money_display = displays;
-    }
-}
-export async function handleWatchQueryOperations(args) {
-    const validated = strictParse(WatchQueryOperationsSchema, args, "watch_and_query input");
-    let result;
-    switch (validated.query_type) {
-        case "local_mark_list": {
-            const queryResult = await query_local_mark_list(validated.filter || {});
-            result = { query_type: "local_mark_list", result: queryResult };
-            break;
-        }
-        case "account_list": {
-            const queryResult = await query_account_list(validated.filter);
-            result = { query_type: "account_list", result: queryResult };
-            break;
-        }
-        case "local_info_list": {
-            const queryResult = await query_local_info_list(validated.filter);
-            result = { query_type: "local_info_list", result: queryResult };
-            break;
-        }
-        case "token_list": {
-            const queryResult = await query_local_token_list(validated.filter || {});
-            result = { query_type: "token_list", result: queryResult };
-            break;
-        }
-        case "account_balance": {
-            const queryResult = await query_account({
-                name_or_address: validated.name_or_address,
-                token_type: validated.token_type,
-                balance: validated.balance,
-                coin: validated.coin,
-                network: validated.network,
-            });
-            await annotateAccountBalance(queryResult, validated.network);
-            result = { query_type: "account_balance", result: queryResult };
-            break;
-        }
-        case "local_names": {
-            const queryResult = await GetLocalNamesByAddresses(validated.addresses);
-            result = { query_type: "local_names", result: queryResult };
-            break;
-        }
-        case "onchain_personal_profile": {
-            const queryResult = await query_personal({
-                account: validated.account,
-                no_cache: validated.no_cache,
-                network: validated.network,
-            });
-            result = { query_type: "onchain_personal_profile", result: queryResult };
-            break;
-        }
-        case "onchain_objects": {
-            const queryResult = await query_objects({
-                objects: validated.objects,
-                no_cache: validated.no_cache,
-                network: validated.network,
-            });
-            if (queryResult && queryResult.objects && Array.isArray(queryResult.objects)) {
-                queryResult.objects = queryResult.objects.map((obj) => {
-                    if (obj && obj.data && obj.data.type === "Guard" && obj.data.root) {
-                        try {
-                            const nodeComments = generateNodeComments(obj.data.root);
-                            return {
-                                ...obj,
-                                _guard_node_comments: nodeComments,
-                            };
-                        }
-                        catch (e) {
-                            return obj;
-                        }
-                    }
-                    return obj;
-                });
-                queryResult.objects = queryResult.objects.map((obj) => {
-                    if (obj && obj.data && obj.data.type === "Progress" && obj.data.current === "") {
-                        const machineId = obj.data.machine;
-                        const taskId = obj.data.task;
-                        return {
-                            ...obj,
-                            _diagnostic: {
-                                issue: "Progress.current is empty — order workflow is stuck at the initial state",
-                                cause: "The Machine's entry node (prev_node='') likely has no forwards defined. " +
-                                    "When Progress starts, it looks up the entry node's forwards to determine " +
-                                    "the next node. Without forwards, Progress cannot advance and the order " +
-                                    "is permanently stuck.",
-                                machine_object_id: machineId ?? null,
-                                bound_order_id: taskId ?? null,
-                                fix: [
-                                    "1. Query the Machine object (use query_toolkit with query_type='onchain_objects' and objects=[" + JSON.stringify(machineId) + "]).",
-                                    "2. Inspect node.pairs for the entry node (prev_node='').",
-                                    "3. If forwards is empty: this is the root cause. The Machine must be republished with at least one forward on the entry node.",
-                                    "4. To republish: clone the Machine nodes, add a forward to the entry node's pairs, then create a new Machine (Machine nodes are immutable after publish — see P0-2 schema validation that now blocks this).",
-                                    "5. Rebind the new Machine to the Service (service.machine field) and create a new Order to test.",
-                                ],
-                                reference: "P0-2 schema refinement in MachineNodePairSchema ensures new Machines cannot be published with empty entry-node forwards. This diagnostic catches legacy Machines that predate the fix.",
-                            },
-                        };
-                    }
-                    return obj;
-                });
-                for (const obj of queryResult.objects) {
-                    try {
-                        await annotateObjectMonetaryFields(obj, validated.network);
-                    }
-                    catch {
-                    }
-                }
-            }
-            result = { query_type: "onchain_objects", result: queryResult };
-            break;
-        }
-        case "onchain_received": {
-            const queryResult = await query_received({
-                name_or_address: normalizeAccountOrMark(validated.name_or_address),
-                type: validated.type,
-                cursor: validated.cursor,
-                limit: validated.limit,
-                no_cache: validated.no_cache,
-                network: validated.network,
-            });
-            const qr = queryResult;
-            if (qr && typeof qr === "object" && typeof qr.balance === "bigint") {
-                const tokenType = qr.token_type;
-                qr.balance = qr.balance.toString();
-                if (Array.isArray(qr.received)) {
-                    for (const item of qr.received) {
-                        if (item && typeof item.balance === "bigint") {
-                            item.balance = item.balance.toString();
-                        }
-                    }
-                }
-                if (tokenType) {
-                    try {
-                        const displays = {
-                            balance: await formatChainValue(qr.balance, tokenType, validated.network),
-                        };
-                        if (Array.isArray(qr.received)) {
-                            for (let i = 0; i < qr.received.length; i++) {
-                                const b = qr.received[i]?.balance;
-                                if (b !== undefined && b !== null) {
-                                    displays[`received[${i}].balance`] = await formatChainValue(b, tokenType, validated.network);
-                                }
-                            }
-                        }
-                        qr._money_display = displays;
-                    }
-                    catch {
-                    }
-                }
-            }
-            result = { query_type: "onchain_received", result: qr };
-            break;
-        }
-        case "onchain_transaction": {
-            const queryResult = await query_transaction({
-                digest: validated.digest,
-                no_cache: validated.no_cache,
-                network: validated.network,
-            });
-            try {
-                await annotateBalanceChanges(queryResult?.balance_changes, validated.network);
-            }
-            catch {
-            }
-            result = { query_type: "onchain_transaction", result: queryResult };
-            break;
-        }
-        case "onchain_object_history": {
-            const queryResult = await query_object_history({
-                object: validated.object,
-                cursor: validated.cursor,
-                limit: validated.limit,
-                order: validated.order,
-                no_cache: validated.no_cache,
-                network: validated.network,
-            });
-            result = { query_type: "onchain_object_history", result: queryResult };
-            break;
-        }
-        case "onchain_address_activity": {
-            const addrInput = typeof validated.name_or_address === 'string'
-                ? validated.name_or_address
-                : validated.name_or_address.name_or_address;
-            const queryResult = await query_address_activity({
-                name_or_address: addrInput,
-                cursor: validated.cursor,
-                limit: validated.limit,
-                order: validated.order,
-                no_cache: validated.no_cache,
-                network: validated.network,
-            });
-            result = { query_type: "onchain_address_activity", result: queryResult };
-            break;
-        }
-        case "token_value_convert": {
-            const hasRaw = validated.raw !== undefined;
-            const hasUnit = validated.unit !== undefined;
-            if (hasRaw === hasUnit) {
-                throw new Error(`token_value_convert: provide EXACTLY ONE of 'raw' (u64 smallest units → unit value) ` +
-                    `or 'unit' (unit value → u64 raw). Received raw=${JSON.stringify(validated.raw)}, ` +
-                    `unit=${JSON.stringify(validated.unit)}.`);
-            }
-            const conversion = await convertTokenValue(validated.token_type, hasRaw ? { raw: validated.raw } : { unit: validated.unit }, validated.network);
-            result = { query_type: "token_value_convert", result: conversion };
-            break;
-        }
-        default:
-            throw new Error(`Unknown query type. Valid query_types are: "local_mark_list", "account_list", "local_info_list", "token_list", "account_balance", "local_names", "onchain_personal_profile", "onchain_objects", "onchain_received", "onchain_transaction", "onchain_object_history", "onchain_address_activity", "token_value_convert". For table queries, use the "onchain_table_data" tool.`);
-    }
-    return {
-        content: [{ type: "text", text: JSON.stringify({ result }) }],
-        structuredContent: {
-            result,
-            semantic: buildDataSemantic(result, {
-                operation_type: "query_toolkit",
-                data: validated,
-            }),
-        },
-    };
-}
-export async function handleOnchainTableData(args) {
-    const validated = strictParse(OnchainTableDataSchema, args, "onchain_table_data input");
-    let result;
-    switch (validated.query_type) {
-        case "onchain_table": {
-            const queryResult = await query_table({
-                parent: validated.parent,
-                cursor: validated.cursor,
-                limit: validated.limit,
-                no_cache: validated.no_cache,
-                network: validated.network,
-            });
-            result = { query_type: "onchain_table", result: queryResult };
-            break;
-        }
-        case "onchain_table_item_repository_data": {
-            const queryResult = await queryTableItem_RepositoryData({
-                parent: validated.parent, name: validated.name, entity: validated.entity,
-                no_cache: validated.no_cache, network: validated.network,
-            });
-            result = { query_type: "onchain_table_item_repository_data", result: queryResult };
-            break;
-        }
-        case "onchain_table_item_permission_perm": {
-            const queryResult = await queryTableItem_PermissionPerm({
-                parent: validated.parent, address: validated.address,
-                no_cache: validated.no_cache, network: validated.network,
-            });
-            result = { query_type: "onchain_table_item_permission_perm", result: queryResult };
-            break;
-        }
-        case "onchain_table_item_reward_record": {
-            const queryResult = await queryTableItem_RewardRecord({
-                parent: validated.parent, address: validated.address,
-                no_cache: validated.no_cache, network: validated.network,
-            });
-            if (queryResult) {
-                try {
-                    const parentToken = await resolveParentObjectTokenType(validated.parent, validated.network);
-                    await annotateTableItemMonetaryFields(queryResult, parentToken, validated.network);
-                }
-                catch {
-                }
-            }
-            result = { query_type: "onchain_table_item_reward_record", result: queryResult };
-            break;
-        }
-        case "onchain_table_item_demand_presenter": {
-            const queryResult = await queryTableItem_DemandPresenter({
-                parent: validated.parent, address: validated.address,
-                no_cache: validated.no_cache, network: validated.network,
-            });
-            result = { query_type: "onchain_table_item_demand_presenter", result: queryResult };
-            break;
-        }
-        case "onchain_table_item_treasury_history": {
-            const queryResult = await queryTableItem_TreasuryHistory({
-                parent: validated.parent, address: validated.address,
-                no_cache: validated.no_cache, network: validated.network,
-            });
-            if (queryResult) {
-                try {
-                    const parentToken = await resolveParentObjectTokenType(validated.parent, validated.network);
-                    await annotateTableItemMonetaryFields(queryResult, parentToken, validated.network);
-                }
-                catch {
-                }
-            }
-            result = { query_type: "onchain_table_item_treasury_history", result: queryResult };
-            break;
-        }
-        case "onchain_table_item_machine_node": {
-            const queryResult = await queryTableItem_MachineNode({
-                parent: validated.parent, key: validated.key,
-                no_cache: validated.no_cache, network: validated.network,
-            });
-            result = { query_type: "onchain_table_item_machine_node", result: queryResult };
-            break;
-        }
-        case "onchain_table_item_progress_history": {
-            const queryResult = await queryTableItem_ProgressHistory({
-                parent: validated.parent, u64: validated.u64,
-                no_cache: validated.no_cache, network: validated.network,
-            });
-            result = { query_type: "onchain_table_item_progress_history", result: queryResult };
-            break;
-        }
-        case "onchain_table_item_address_mark": {
-            const queryResult = await queryTableItem_AddressMark({
-                parent: validated.parent, address: validated.address,
-                no_cache: validated.no_cache, network: validated.network,
-            });
-            result = { query_type: "onchain_table_item_address_mark", result: queryResult };
-            break;
-        }
-        case "onchain_table_item_entity_registrar": {
-            const queryResult = await queryTableItem_EntityRegistrar({
-                address: validated.address,
-                no_cache: validated.no_cache, network: validated.network,
-            });
-            result = { query_type: "onchain_table_item_entity_registrar", result: queryResult };
-            break;
-        }
-        case "onchain_table_item_entity_linker": {
-            const queryResult = await queryTableItem_EntityLinker({
-                address: validated.address,
-                no_cache: validated.no_cache, network: validated.network,
-            });
-            result = { query_type: "onchain_table_item_entity_linker", result: queryResult };
-            break;
-        }
-        case "onchain_table_item_generic": {
-            const queryResult = await query_tableItem({
-                parent: validated.parent,
-                key: { type: validated.key_type, value: validated.key_value },
-                no_cache: validated.no_cache,
-                network: validated.network,
-            });
-            result = { query_type: "onchain_table_item_generic", result: queryResult };
-            break;
-        }
-        default:
-            throw new Error(`Unknown table query type. Valid query_types are: "onchain_table", "onchain_table_item_repository_data", "onchain_table_item_permission_perm", "onchain_table_item_reward_record", "onchain_table_item_demand_presenter", "onchain_table_item_treasury_history", "onchain_table_item_machine_node", "onchain_table_item_progress_history", "onchain_table_item_address_mark", "onchain_table_item_entity_registrar", "onchain_table_item_entity_linker", "onchain_table_item_generic"`);
-    }
-    return {
-        content: [{ type: "text", text: JSON.stringify({ result }) }],
-        structuredContent: {
-            result,
-            semantic: buildDataSemantic(result, {
-                operation_type: "onchain_table_data",
-                data: validated,
-            }),
-        },
-    };
-}
-export async function handleOnchainEvents(args) {
-    const validated = strictParse(OnchainEventsInputSchema, args, "onchain_events input");
-    const queryResult = await query_events({
-        type: validated.type,
-        cursor: validated.cursor ? {
-            eventSeq: String(validated.cursor.eventSeq),
-            txDigest: validated.cursor.txDigest,
-        } : null,
-        limit: validated.limit ?? null,
-        order: validated.order ?? null,
-        no_cache: validated.no_cache,
-        network: validated.network,
-    });
-    try {
-        await annotateEventsMonetaryFields(queryResult?.data, validated.network);
-    }
-    catch {
-    }
-    return {
-        content: [{ type: "text", text: JSON.stringify({ result: queryResult }) }],
-        structuredContent: {
-            result: queryResult,
-            semantic: buildDataSemantic(queryResult, {
-                operation_type: "onchain_events",
-                data: validated,
-            }),
-        },
-    };
-}
-export async function handleWowokInfo(args) {
-    const validated = strictParse(ProtocolInfoQuerySchema, args, "wowok_buildin_info input");
-    const queryResult = await queryProtocolInfo(validated);
-    return {
-        content: [{ type: "text", text: JSON.stringify({ result: queryResult }) }],
-        structuredContent: { result: queryResult },
-    };
-}
+import{strictParse,WatchQueryOperationsSchema,OnchainTableDataSchema,OnchainEventsInputSchema,ProtocolInfoQuerySchema}from'../../schema/index.js';import{checkUpgrade}from'../upgrade-check.js';import{query_local_mark_list,query_account_list,query_local_info_list,query_local_token_list,query_account,GetLocalNamesByAddresses,query_personal,query_objects,query_table,query_tableItem,queryTableItem_RepositoryData,queryTableItem_PermissionPerm,queryTableItem_RewardRecord,queryTableItem_DemandPresenter,queryTableItem_TreasuryHistory,queryTableItem_MachineNode,queryTableItem_ProgressHistory,queryTableItem_AddressMark,queryTableItem_EntityRegistrar,queryTableItem_EntityLinker,query_received,queryProtocolInfo,query_events,query_transaction,query_object_history,query_address_activity,generateNodeComments}from'@wowok/wowok';import{buildDataSemantic}from'../../schema/call/semantic.js';import{formatChainValue,annotateObjectMonetaryFields,annotateTableItemMonetaryFields,annotateEventsMonetaryFields,annotateBalanceChanges,resolveParentObjectTokenType,convertTokenValue}from'../../knowledge/fund-layer.js';import{normalizeAccountOrMark}from'./messenger.js';async function annotateAccountBalance(a,b){if(!a||typeof a!=='object')return;const e={},f=(j,k)=>{if(j===null||j===undefined)return undefined;if(typeof j!=='string'&&typeof j!=='number'&&typeof j!=='bigint')return undefined;if(typeof k!=='string'||!k)return undefined;return formatChainValue(j,k,b);},g=a['balance'];if(g&&typeof g==='object'){const j=g['coinType'],k=await f(g['totalBalance'],j);if(k)e['balance.totalBalance']=k;if(g['lockedBalance']!==undefined){const l=await f(g['lockedBalance'],j);if(l)e['balance.lockedBalance']=l;}}const h=a['coin']?.['data'];if(Array['isArray'](h))for(let m=0x0;m<h['length'];m++){const n=h[m],o=await f(n?.['balance'],n?.['coinType']);if(o)e['coin.data['+m+'].balance']=o;}Object['keys'](e)['length']>0x0&&(a['_money_display']=e);}export async function handleWatchQueryOperations(a){const c=strictParse(WatchQueryOperationsSchema,a,'watch_and_query\x20input');let d;switch(c['query_type']){case'local_mark_list':{const e=await query_local_mark_list(c['filter']||{});d={'query_type':'local_mark_list','result':e};break;}case'account_list':{const f=await query_account_list(c['filter']);d={'query_type':'account_list','result':f};break;}case'local_info_list':{const g=await query_local_info_list(c['filter']);d={'query_type':'local_info_list','result':g};break;}case'token_list':{const h=await query_local_token_list(c['filter']||{});d={'query_type':'token_list','result':h};break;}case'account_balance':{const j=await query_account({'name_or_address':c['name_or_address'],'token_type':c['token_type'],'balance':c['balance'],'coin':c['coin'],'network':c['network']});await annotateAccountBalance(j,c['network']),d={'query_type':'account_balance','result':j};break;}case'local_names':{const k=await GetLocalNamesByAddresses(c['addresses']);d={'query_type':'local_names','result':k};break;}case'onchain_personal_profile':{const l=await query_personal({'account':c['account'],'no_cache':c['no_cache'],'network':c['network']});d={'query_type':'onchain_personal_profile','result':l};break;}case'onchain_objects':{const m=await query_objects({'objects':c['objects'],'no_cache':c['no_cache'],'network':c['network']});if(m&&m['objects']&&Array['isArray'](m['objects'])){m['objects']=m['objects']['map'](n=>{if(n&&n['data']&&n['data']['type']==='Guard'&&n['data']['root'])try{const o=generateNodeComments(n['data']['root']);return{...n,'_guard_node_comments':o};}catch(p){return n;}return n;}),m['objects']=m['objects']['map'](n=>{if(n&&n['data']&&n['data']['type']==='Progress'&&n['data']['current']===''){const o=n['data']['machine'],p=n['data']['task'];return{...n,'_diagnostic':{'issue':'Progress.current\x20is\x20empty\x20—\x20order\x20workflow\x20is\x20stuck\x20at\x20the\x20initial\x20state','cause':'The\x20Machine\x27s\x20entry\x20node\x20(prev_node=\x27\x27)\x20likely\x20has\x20no\x20forwards\x20defined.\x20'+'When\x20Progress\x20starts,\x20it\x20looks\x20up\x20the\x20entry\x20node\x27s\x20forwards\x20to\x20determine\x20'+'the\x20next\x20node.\x20Without\x20forwards,\x20Progress\x20cannot\x20advance\x20and\x20the\x20order\x20'+'is\x20permanently\x20stuck.','machine_object_id':o??null,'bound_order_id':p??null,'fix':['1.\x20Query\x20the\x20Machine\x20object\x20(use\x20query_toolkit\x20with\x20query_type=\x27onchain_objects\x27\x20and\x20objects=['+JSON['stringify'](o)+']).','2.\x20Inspect\x20node.pairs\x20for\x20the\x20entry\x20node\x20(prev_node=\x27\x27).','3.\x20If\x20forwards\x20is\x20empty:\x20this\x20is\x20the\x20root\x20cause.\x20The\x20Machine\x20must\x20be\x20republished\x20with\x20at\x20least\x20one\x20forward\x20on\x20the\x20entry\x20node.','4.\x20To\x20republish:\x20clone\x20the\x20Machine\x20nodes,\x20add\x20a\x20forward\x20to\x20the\x20entry\x20node\x27s\x20pairs,\x20then\x20create\x20a\x20new\x20Machine\x20(Machine\x20nodes\x20are\x20immutable\x20after\x20publish\x20—\x20see\x20P0-2\x20schema\x20validation\x20that\x20now\x20blocks\x20this).','5.\x20Rebind\x20the\x20new\x20Machine\x20to\x20the\x20Service\x20(service.machine\x20field)\x20and\x20create\x20a\x20new\x20Order\x20to\x20test.'],'reference':'P0-2\x20schema\x20refinement\x20in\x20MachineNodePairSchema\x20ensures\x20new\x20Machines\x20cannot\x20be\x20published\x20with\x20empty\x20entry-node\x20forwards.\x20This\x20diagnostic\x20catches\x20legacy\x20Machines\x20that\x20predate\x20the\x20fix.'}};}return n;});for(const n of m['objects']){try{await annotateObjectMonetaryFields(n,c['network']);}catch{}}}d={'query_type':'onchain_objects','result':m};break;}case'onchain_received':{const o=await query_received({'name_or_address':normalizeAccountOrMark(c['name_or_address']),'type':c['type'],'cursor':c['cursor'],'limit':c['limit'],'no_cache':c['no_cache'],'network':c['network']}),p=o;if(p&&typeof p==='object'&&typeof p['balance']==='bigint'){const q=p['token_type'];p['balance']=p['balance']['toString']();if(Array['isArray'](p['received']))for(const r of p['received']){r&&typeof r['balance']==='bigint'&&(r['balance']=r['balance']['toString']());}if(q)try{const s={'balance':await formatChainValue(p['balance'],q,c['network'])};if(Array['isArray'](p['received']))for(let t=0x0;t<p['received']['length'];t++){const u=p['received'][t]?.['balance'];u!==undefined&&u!==null&&(s['received['+t+'].balance']=await formatChainValue(u,q,c['network']));}p['_money_display']=s;}catch{}}d={'query_type':'onchain_received','result':p};break;}case'onchain_transaction':{const v=await query_transaction({'digest':c['digest'],'no_cache':c['no_cache'],'network':c['network']});try{await annotateBalanceChanges(v?.['balance_changes'],c['network']);}catch{}d={'query_type':'onchain_transaction','result':v};break;}case'onchain_object_history':{const w=await query_object_history({'object':c['object'],'cursor':c['cursor'],'limit':c['limit'],'order':c['order'],'no_cache':c['no_cache'],'network':c['network']});d={'query_type':'onchain_object_history','result':w};break;}case'onchain_address_activity':{const x=typeof c['name_or_address']==='string'?c['name_or_address']:c['name_or_address']['name_or_address'],y=await query_address_activity({'name_or_address':x,'cursor':c['cursor'],'limit':c['limit'],'order':c['order'],'no_cache':c['no_cache'],'network':c['network']});d={'query_type':'onchain_address_activity','result':y};break;}case'token_value_convert':{const z=c['raw']!==undefined,A=c['unit']!==undefined;if(z===A)throw new Error('token_value_convert:\x20provide\x20EXACTLY\x20ONE\x20of\x20\x27raw\x27\x20(u64\x20smallest\x20units\x20→\x20unit\x20value)\x20'+('or\x20\x27unit\x27\x20(unit\x20value\x20→\x20u64\x20raw).\x20Received\x20raw='+JSON['stringify'](c['raw'])+',\x20')+('unit='+JSON['stringify'](c['unit'])+'.'));const B=await convertTokenValue(c['token_type'],z?{'raw':c['raw']}:{'unit':c['unit']},c['network']);d={'query_type':'token_value_convert','result':B};break;}default:throw new Error('Unknown\x20query\x20type.\x20Valid\x20query_types\x20are:\x20\x22local_mark_list\x22,\x20\x22account_list\x22,\x20\x22local_info_list\x22,\x20\x22token_list\x22,\x20\x22account_balance\x22,\x20\x22local_names\x22,\x20\x22onchain_personal_profile\x22,\x20\x22onchain_objects\x22,\x20\x22onchain_received\x22,\x20\x22onchain_transaction\x22,\x20\x22onchain_object_history\x22,\x20\x22onchain_address_activity\x22,\x20\x22token_value_convert\x22.\x20For\x20table\x20queries,\x20use\x20the\x20\x22onchain_table_data\x22\x20tool.');}return{'content':[{'type':'text','text':JSON['stringify']({'result':d})}],'structuredContent':{'result':d,'semantic':buildDataSemantic(d,{'operation_type':'query_toolkit','data':c})}};}export async function handleOnchainTableData(a){const b=strictParse(OnchainTableDataSchema,a,'onchain_table_data\x20input');let c;switch(b['query_type']){case'onchain_table':{const d=await query_table({'parent':b['parent'],'cursor':b['cursor'],'limit':b['limit'],'no_cache':b['no_cache'],'network':b['network']});c={'query_type':'onchain_table','result':d};break;}case'onchain_table_item_repository_data':{const e=await queryTableItem_RepositoryData({'parent':b['parent'],'name':b['name'],'entity':b['entity'],'no_cache':b['no_cache'],'network':b['network']});c={'query_type':'onchain_table_item_repository_data','result':e};break;}case'onchain_table_item_permission_perm':{const f=await queryTableItem_PermissionPerm({'parent':b['parent'],'address':b['address'],'no_cache':b['no_cache'],'network':b['network']});c={'query_type':'onchain_table_item_permission_perm','result':f};break;}case'onchain_table_item_reward_record':{const g=await queryTableItem_RewardRecord({'parent':b['parent'],'address':b['address'],'no_cache':b['no_cache'],'network':b['network']});if(g)try{const h=await resolveParentObjectTokenType(b['parent'],b['network']);await annotateTableItemMonetaryFields(g,h,b['network']);}catch{}c={'query_type':'onchain_table_item_reward_record','result':g};break;}case'onchain_table_item_demand_presenter':{const i=await queryTableItem_DemandPresenter({'parent':b['parent'],'address':b['address'],'no_cache':b['no_cache'],'network':b['network']});c={'query_type':'onchain_table_item_demand_presenter','result':i};break;}case'onchain_table_item_treasury_history':{const j=await queryTableItem_TreasuryHistory({'parent':b['parent'],'address':b['address'],'no_cache':b['no_cache'],'network':b['network']});if(j)try{const k=await resolveParentObjectTokenType(b['parent'],b['network']);await annotateTableItemMonetaryFields(j,k,b['network']);}catch{}c={'query_type':'onchain_table_item_treasury_history','result':j};break;}case'onchain_table_item_machine_node':{const l=await queryTableItem_MachineNode({'parent':b['parent'],'key':b['key'],'no_cache':b['no_cache'],'network':b['network']});c={'query_type':'onchain_table_item_machine_node','result':l};break;}case'onchain_table_item_progress_history':{const m=await queryTableItem_ProgressHistory({'parent':b['parent'],'u64':b['u64'],'no_cache':b['no_cache'],'network':b['network']});c={'query_type':'onchain_table_item_progress_history','result':m};break;}case'onchain_table_item_address_mark':{const n=await queryTableItem_AddressMark({'parent':b['parent'],'address':b['address'],'no_cache':b['no_cache'],'network':b['network']});c={'query_type':'onchain_table_item_address_mark','result':n};break;}case'onchain_table_item_entity_registrar':{const o=await queryTableItem_EntityRegistrar({'address':b['address'],'no_cache':b['no_cache'],'network':b['network']});c={'query_type':'onchain_table_item_entity_registrar','result':o};break;}case'onchain_table_item_entity_linker':{const p=await queryTableItem_EntityLinker({'address':b['address'],'no_cache':b['no_cache'],'network':b['network']});c={'query_type':'onchain_table_item_entity_linker','result':p};break;}case'onchain_table_item_generic':{const q=await query_tableItem({'parent':b['parent'],'key':{'type':b['key_type'],'value':b['key_value']},'no_cache':b['no_cache'],'network':b['network']});c={'query_type':'onchain_table_item_generic','result':q};break;}default:throw new Error('Unknown\x20table\x20query\x20type.\x20Valid\x20query_types\x20are:\x20\x22onchain_table\x22,\x20\x22onchain_table_item_repository_data\x22,\x20\x22onchain_table_item_permission_perm\x22,\x20\x22onchain_table_item_reward_record\x22,\x20\x22onchain_table_item_demand_presenter\x22,\x20\x22onchain_table_item_treasury_history\x22,\x20\x22onchain_table_item_machine_node\x22,\x20\x22onchain_table_item_progress_history\x22,\x20\x22onchain_table_item_address_mark\x22,\x20\x22onchain_table_item_entity_registrar\x22,\x20\x22onchain_table_item_entity_linker\x22,\x20\x22onchain_table_item_generic\x22');}return{'content':[{'type':'text','text':JSON['stringify']({'result':c})}],'structuredContent':{'result':c,'semantic':buildDataSemantic(c,{'operation_type':'onchain_table_data','data':b})}};}export async function handleOnchainEvents(a){const b=strictParse(OnchainEventsInputSchema,a,'onchain_events\x20input'),c=await query_events({'type':b['type'],'cursor':b['cursor']?{'eventSeq':String(b['cursor']['eventSeq']),'txDigest':b['cursor']['txDigest']}:null,'limit':b['limit']??null,'order':b['order']??null,'no_cache':b['no_cache'],'network':b['network']});try{await annotateEventsMonetaryFields(c?.['data'],b['network']);}catch{}return{'content':[{'type':'text','text':JSON['stringify']({'result':c})}],'structuredContent':{'result':c,'semantic':buildDataSemantic(c,{'operation_type':'onchain_events','data':b})}};}export async function handleWowokInfo(a){const b=strictParse(ProtocolInfoQuerySchema,a,'wowok_buildin_info\x20input');if(b['info']==='upgrade_check'){const d=await checkUpgrade(),e={'info':'upgrade_check','result':d};return{'content':[{'type':'text','text':JSON['stringify']({'result':e})}],'structuredContent':{'result':e}};}const c=await queryProtocolInfo(b);return{'content':[{'type':'text','text':JSON['stringify']({'result':c})}],'structuredContent':{'result':c}};}

package/dist/tools/handlers/schema-query.js

@@ -1,176 +1 @@
-import { processSchemaQuery, EXAMPLES_DIR, } from "../../schema-query/index.js";
-import { strictParse } from "../../schema/index.js";
-import { SchemaQueryInputSchema } from "../../schema/schema-query/index.js";
-export async function handleSchemaQuery(args) {
-    const validated = strictParse(SchemaQueryInputSchema, args, "schema_query input");
-    const request = {
-        action: validated.action,
-        name: validated.name,
-        query: validated.query,
-        field_path: validated.field_path,
-        template: validated.template,
-        object_type: validated.object_type,
-        params: validated.params,
-        output_file: validated.output_file,
-    };
-    const response = processSchemaQuery(request);
-    let textContent = response.message;
-    if (response.output_file_path) {
-        textContent += `\n\n📄 Full data written to: ${response.output_file_path}`;
-        textContent += `\n   Use the Read tool to access the file content.`;
-    }
-    const data = response.data;
-    if (response.success && data) {
-        switch (request.action) {
-            case "list":
-                if (Array.isArray(data) && data.length > 0) {
-                    textContent += "\n\nAll available schemas:\n";
-                    for (const item of data) {
-                        textContent += `\n  • ${item.name ?? ""}`;
-                        if (item.title) {
-                            textContent += ` - ${item.title}`;
-                        }
-                        if (item.description) {
-                            textContent += `\n    ${item.description.slice(0, 100)}...`;
-                        }
-                        textContent += "\n";
-                    }
-                }
-                break;
-            case "list_operations":
-                if (Array.isArray(data) && data.length > 0) {
-                    textContent += "\n\nOn-chain operation schemas:\n";
-                    for (const item of data) {
-                        textContent += `\n  • ${item.name ?? ""}`;
-                        if (item.title) {
-                            textContent += ` - ${item.title}`;
-                        }
-                        if (item.description) {
-                            textContent += `\n    ${item.description.slice(0, 100)}...`;
-                        }
-                        textContent += "\n";
-                    }
-                }
-                break;
-            case "get":
-                textContent += "\n\n## JSON Schema\n\n";
-                textContent += "```json\n";
-                textContent += JSON.stringify(data, null, 2);
-                textContent += "\n```\n";
-                break;
-            case "get_output":
-                textContent += "\n\n## Output JSON Schema\n\n";
-                textContent += "```json\n";
-                textContent += JSON.stringify(data, null, 2);
-                textContent += "\n```\n";
-                break;
-            case "get_guard_templates":
-                textContent += "\n\n## Guard Templates\n\n";
-                textContent += "```json\n";
-                textContent += JSON.stringify(data, null, 2);
-                textContent += "\n```\n";
-                break;
-            case "get_field":
-                textContent += "\n\n## Field Schema\n\n";
-                textContent += "```json\n";
-                textContent += JSON.stringify(data, null, 2);
-                textContent += "\n```\n";
-                break;
-            case "search":
-                if (Array.isArray(data) && data.length > 0) {
-                    textContent += `\n\nFound ${data.length} schemas matching '${request.query ?? ""}':\n`;
-                    for (const item of data) {
-                        textContent += `\n  • ${item.name ?? ""}`;
-                        if (item.title) {
-                            textContent += ` - ${item.title}`;
-                        }
-                        if (item.description) {
-                            textContent += `\n    ${item.description.slice(0, 100)}...`;
-                        }
-                        textContent += "\n";
-                    }
-                }
-                else {
-                    textContent += "\n\nNo schemas found. Try 'list' to browse all available schemas, or use a broader search term.";
-                }
-                break;
-            case "search_examples": {
-                const items = (Array.isArray(data) ? data : []);
-                if (items.length > 0) {
-                    textContent += `\n\nFound ${items.length} example(s) matching '${request.query ?? ""}':\n`;
-                    for (const item of items) {
-                        textContent += `\n  • [score: ${item.score}] ${item.file}`;
-                        textContent += `\n    Title: ${item.title}`;
-                        textContent += `\n    Industry: ${item.industry} | Operation: ${item.operation_type} | Verified: ${item.verified ? "yes" : "no"}`;
-                        textContent += `\n    Tags: ${item.tags.join(", ")}`;
-                        textContent += `\n    Matched fields: ${item.matched_fields.join(", ")}`;
-                        const descPreview = item.description.length > 120
-                            ? `${item.description.slice(0, 120)}...`
-                            : item.description;
-                        textContent += `\n    Description: ${descPreview}`;
-                        textContent += "\n";
-                    }
-                    textContent += `\n  To view the full example JSON, read files from: ${EXAMPLES_DIR}`;
-                }
-                else {
-                    textContent += "\n\nNo examples found. Try broader terms like 'service', 'machine', 'guard', 'permission', or an industry name like 'rental' or 'retail'.";
-                }
-                break;
-            }
-            case "get_tool_reference": {
-                textContent += "\n\n## MCP Tool Reference\n\n";
-                textContent += "```json\n";
-                textContent += JSON.stringify(data, null, 2);
-                textContent += "\n```\n";
-                break;
-            }
-            case "get_guard_design_patterns": {
-                textContent += "\n\n## Guard Design Patterns\n\n";
-                textContent += "```json\n";
-                textContent += JSON.stringify(data, null, 2);
-                textContent += "\n```\n";
-                break;
-            }
-            case "get_safety_rules": {
-                textContent += "\n\n## Safety Rules (sunk from wowok-safety skill)\n\n";
-                textContent += "```json\n";
-                textContent += JSON.stringify(data, null, 2);
-                textContent += "\n```\n";
-                break;
-            }
-            case "get_templates": {
-                textContent += "\n\n## Unified Template Registry (92-review D.2)\n\n";
-                const listData = data;
-                if (Array.isArray(listData.templates) && !request.template) {
-                    textContent += `\n${listData.total ?? listData.templates.length} template(s). `;
-                    textContent += "Call with 'template'=<id> for detail; add 'params' (JSON string) to instantiate.\n";
-                    for (const t of listData.templates) {
-                        textContent += `\n  • ${t.id} [${t.object_type}${t.instantiable ? "" : ", guidance-only"}] — ${t.name} (${t.parameters?.length ?? 0} params)`;
-                    }
-                    textContent += "\n";
-                }
-                else {
-                    textContent += "```json\n";
-                    textContent += JSON.stringify(data, null, 2);
-                    textContent += "\n```\n";
-                }
-                break;
-            }
-            default:
-                throw new Error(`Unknown schema_query action: ${String(request.action)}`);
-        }
-    }
-    if (response.suggestions && response.suggestions.length > 0) {
-        textContent += "\n\n💡 Suggestions:\n";
-        for (const suggestion of response.suggestions) {
-            textContent += `  • ${suggestion}\n`;
-        }
-    }
-    return {
-        content: [{
-                type: "text",
-                text: textContent,
-            }],
-        structuredContent: response,
-    };
-}
+import{processSchemaQuery,EXAMPLES_DIR}from'../../schema-query/index.js';import{strictParse}from'../../schema/index.js';import{SchemaQueryInputSchema}from'../../schema/schema-query/index.js';export async function handleSchemaQuery(a){const b=strictParse(SchemaQueryInputSchema,a,'schema_query\x20input'),c={'action':b['action'],'name':b['name'],'query':b['query'],'field_path':b['field_path'],'template':b['template'],'object_type':b['object_type'],'params':b['params'],'output_file':b['output_file']},d=processSchemaQuery(c);let e=d['message'];d['output_file_path']&&(e+='\x0a\x0a📄\x20Full\x20data\x20written\x20to:\x20'+d['output_file_path'],e+='\x0a\x20\x20\x20Use\x20the\x20Read\x20tool\x20to\x20access\x20the\x20file\x20content.');const f=d['data'];if(d['success']&&f)switch(c['action']){case'list':if(Array['isArray'](f)&&f['length']>0x0){e+='\x0a\x0aAll\x20available\x20schemas:\x0a';for(const g of f){e+='\x0a\x20\x20•\x20'+(g['name']??''),g['title']&&(e+='\x20-\x20'+g['title']),g['description']&&(e+='\x0a\x20\x20\x20\x20'+g['description']['slice'](0x0,0x64)+'...'),e+='\x0a';}}break;case'list_operations':if(Array['isArray'](f)&&f['length']>0x0){e+='\x0a\x0aOn-chain\x20operation\x20schemas:\x0a';for(const h of f){e+='\x0a\x20\x20•\x20'+(h['name']??''),h['title']&&(e+='\x20-\x20'+h['title']),h['description']&&(e+='\x0a\x20\x20\x20\x20'+h['description']['slice'](0x0,0x64)+'...'),e+='\x0a';}}break;case'get':e+='\x0a\x0a##\x20JSON\x20Schema\x0a\x0a',e+='```json\x0a',e+=JSON['stringify'](f,null,0x2),e+='\x0a```\x0a';break;case'get_output':e+='\x0a\x0a##\x20Output\x20JSON\x20Schema\x0a\x0a',e+='```json\x0a',e+=JSON['stringify'](f,null,0x2),e+='\x0a```\x0a';break;case'get_guard_templates':e+='\x0a\x0a##\x20Guard\x20Templates\x0a\x0a',e+='```json\x0a',e+=JSON['stringify'](f,null,0x2),e+='\x0a```\x0a';break;case'get_field':e+='\x0a\x0a##\x20Field\x20Schema\x0a\x0a',e+='```json\x0a',e+=JSON['stringify'](f,null,0x2),e+='\x0a```\x0a';break;case'search':if(Array['isArray'](f)&&f['length']>0x0){e+='\x0a\x0aFound\x20'+f['length']+'\x20schemas\x20matching\x20\x27'+(c['query']??'')+'\x27:\x0a';for(const i of f){e+='\x0a\x20\x20•\x20'+(i['name']??''),i['title']&&(e+='\x20-\x20'+i['title']),i['description']&&(e+='\x0a\x20\x20\x20\x20'+i['description']['slice'](0x0,0x64)+'...'),e+='\x0a';}}else e+='\x0a\x0aNo\x20schemas\x20found.\x20Try\x20\x27list\x27\x20to\x20browse\x20all\x20available\x20schemas,\x20or\x20use\x20a\x20broader\x20search\x20term.';break;case'search_examples':{const j=Array['isArray'](f)?f:[];if(j['length']>0x0){e+='\x0a\x0aFound\x20'+j['length']+'\x20example(s)\x20matching\x20\x27'+(c['query']??'')+'\x27:\x0a';for(const k of j){e+='\x0a\x20\x20•\x20[score:\x20'+k['score']+']\x20'+k['file'],e+='\x0a\x20\x20\x20\x20Title:\x20'+k['title'],e+='\x0a\x20\x20\x20\x20Industry:\x20'+k['industry']+'\x20|\x20Operation:\x20'+k['operation_type']+'\x20|\x20Verified:\x20'+(k['verified']?'yes':'no'),e+='\x0a\x20\x20\x20\x20Tags:\x20'+k['tags']['join'](',\x20'),e+='\x0a\x20\x20\x20\x20Matched\x20fields:\x20'+k['matched_fields']['join'](',\x20');const l=k['description']['length']>0x78?k['description']['slice'](0x0,0x78)+'...':k['description'];e+='\x0a\x20\x20\x20\x20Description:\x20'+l,e+='\x0a';}e+='\x0a\x20\x20To\x20view\x20the\x20full\x20example\x20JSON,\x20read\x20files\x20from:\x20'+EXAMPLES_DIR;}else e+='\x0a\x0aNo\x20examples\x20found.\x20Try\x20broader\x20terms\x20like\x20\x27service\x27,\x20\x27machine\x27,\x20\x27guard\x27,\x20\x27permission\x27,\x20or\x20an\x20industry\x20name\x20like\x20\x27rental\x27\x20or\x20\x27retail\x27.';break;}case'get_tool_reference':{e+='\x0a\x0a##\x20MCP\x20Tool\x20Reference\x0a\x0a',e+='```json\x0a',e+=JSON['stringify'](f,null,0x2),e+='\x0a```\x0a';break;}case'get_guard_design_patterns':{e+='\x0a\x0a##\x20Guard\x20Design\x20Patterns\x0a\x0a',e+='```json\x0a',e+=JSON['stringify'](f,null,0x2),e+='\x0a```\x0a';break;}case'get_safety_rules':{e+='\x0a\x0a##\x20Safety\x20Rules\x20(sunk\x20from\x20wowok-safety\x20skill)\x0a\x0a',e+='```json\x0a',e+=JSON['stringify'](f,null,0x2),e+='\x0a```\x0a';break;}case'get_templates':{e+='\x0a\x0a##\x20Unified\x20Template\x20Registry\x20(92-review\x20D.2)\x0a\x0a';const m=f;if(Array['isArray'](m['templates'])&&!c['template']){e+='\x0a'+(m['total']??m['templates']['length'])+'\x20template(s).\x20',e+='Call\x20with\x20\x27template\x27=<id>\x20for\x20detail;\x20add\x20\x27params\x27\x20(JSON\x20string)\x20to\x20instantiate.\x0a';for(const n of m['templates']){e+='\x0a\x20\x20•\x20'+n['id']+'\x20['+n['object_type']+(n['instantiable']?'':',\x20guidance-only')+']\x20—\x20'+n['name']+'\x20('+(n['parameters']?.['length']??0x0)+'\x20params)';}e+='\x0a';}else e+='```json\x0a',e+=JSON['stringify'](f,null,0x2),e+='\x0a```\x0a';break;}default:throw new Error('Unknown\x20schema_query\x20action:\x20'+String(c['action']));}if(d['suggestions']&&d['suggestions']['length']>0x0){e+='\x0a\x0a💡\x20Suggestions:\x0a';for(const o of d['suggestions']){e+='\x20\x20•\x20'+o+'\x0a';}}return{'content':[{'type':'text','text':e}],'structuredContent':d};}