wowok_agent 2.2.3 → 2.2.5

package/dist/index.js

@@ -5,7 +5,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { readFileSync } from "fs";
 import { resolve } from "path";
 const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
-import { CallService_DataSchema, CallMachine_DataSchema, MachineNode2File_InputSchema, MachineNode2File_OutputWrappedSchema, CallProgress_DataSchema, CallPermission_DataSchema, CallGuard_DataSchema, Guard2File_InputSchema, Guard2File_OutputWrappedSchema, CallArbitration_DataSchema, CallRepository_DataSchema, CallContact_DataSchema, CallTreasury_DataSchema, CallReward_DataSchema, CallAllocation_DataSchema, CallPersonal_DataSchema, CallPayment_DataSchema, CallDemand_DataSchema, CallOrder_DataSchema, CallEnvSchema, SubmissionCallSchema, strictParse, CallOutputSchema, handleCallResult, createServerConfig, createCapabilitiesConfig, createToolMeta, transformSubmission, getEnvConfig, WipGenerationOptionsSchema, WipToHtmlOptionsSchema, TokenDataFilterSchema, LocalInfoFilterSchema, LocalMarkFilterSchema, AccountFilterSchema, TokenTypeSchema, OnchainEventsInputSchema, OnchainEventsResultSchema, ProtocolInfoQuerySchema, ProtocolInfoResultSchema, WatchQueryOperationsResultSchema, NameOrAddressSchema, AccountOrMark_AddressSchema, ObjectTypeSchema, AccountOperationOutputWrappedSchema, LocalMarkOperationOutputWrappedSchema, LocalInfoOperationOutputWrappedSchema, WipOperationOutputSchema, MessengerOperationOutputSchema, AccountOperationSchema, LocalMarkOperationSchema, LocalInfoOperationSchema, parseMachineNodesFromText, formatNodeErrors as formatMachineNodeErrors, MessengerOperationInputSchema, } from "./schema/index.js";
+import { CallService_DataSchema, CallMachine_DataSchema, MachineNode2File_InputSchema, MachineNode2File_OutputWrappedSchema, CallProgress_DataSchema, CallPermission_DataSchema, CallGuard_DataSchema, Guard2File_InputSchema, Guard2File_OutputWrappedSchema, CallArbitration_DataSchema, CallRepository_DataSchema, CallContact_DataSchema, CallTreasury_DataSchema, CallReward_DataSchema, CallAllocation_DataSchema, CallPersonal_DataSchema, CallPayment_DataSchema, CallDemand_DataSchema, CallOrder_DataSchema, CallEnvSchema, SubmissionCallSchema, strictParse, CallOutputSchema, handleCallResult, createServerConfig, createCapabilitiesConfig, createToolMeta, transformSubmission, getEnvConfig, WipGenerationOptionsSchema, WipToHtmlOptionsSchema, TokenDataFilterSchema, LocalInfoFilterSchema, LocalMarkFilterSchema, AccountFilterSchema, TokenTypeSchema, OnchainEventsInputSchema, OnchainEventsResultSchema, ProtocolInfoQuerySchema, ProtocolInfoResultSchema, TableAnswerSchema, TableItem_RepositoryDataSchema, TableItem_PermissionPermSchema, TableItem_EntityRegistrarSchema, TableItem_EntityLinkerSchema, TableItem_RewardRecordSchema, TableItem_DemandPresenterSchema, TableItem_TreasuryHistorySchema, TableItem_MachineNodeSchema, TableItem_ProgressHistorySchema, TableItem_AddressMarkSchema, NameOrAddressSchema, AccountOrMark_AddressSchema, EntrypointSchema, AccountOperationOutputWrappedSchema, LocalMarkOperationOutputWrappedSchema, LocalInfoOperationOutputWrappedSchema, WipOperationOutputSchema, MessengerOperationOutputSchema, AccountOperationSchema, LocalMarkOperationSchema, LocalInfoOperationSchema, parseMachineNodesFromText, formatNodeErrors as formatMachineNodeErrors, MessengerOperationInputSchema, } from "./schema/index.js";
 import { CallService, CallMachine, CallProgress, CallPermission, CallGuard, CallArbitration, CallRepository, CallContact, CallTreasury, CallReward, CallAllocation, CallPersonal, CallPayment, CallDemand, CallOrder, gen_passport, guard2file, parseGuardFile, formatGuardParseErrors, machineNode2file, generateNodeComments, generate_wip, verify_wip, sign_wip, wip2html, account_operation, local_mark_operation, local_info_operation, watch_conversations, send_message, send_file, watch_messages, extract_zip_messages, generate_wts, verify_wts, sign_wts, wts2html, proof_message, mark_messages_as_viewed, mark_conversation_as_viewed, query_local_mark_list, query_account_list, query_local_info_list, query_local_token_list, query_account, query_personal, query_objects, query_table, queryProtocolInfo, query_received, queryTableItem_RepositoryData, queryTableItem_PermissionPerm, queryTableItem_RewardRecord, queryTableItem_DemandPresenter, queryTableItem_TreasuryHistory, queryTableItem_MachineNode, queryTableItem_ProgressHistory, queryTableItem_AddressMark, queryTableItem_EntityRegistrar, queryTableItem_EntityLinker, query_events, blacklist, friendslist, guardlist, settings, AmountType, } from "wowok";
 const SERVER_DESCRIPTION = `WoWok MCP Server - Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.
 
@@ -146,6 +146,15 @@ function transformRewardData(data) {
 const OnchainOperationsSchema = z.preprocess((input) => {
     if (typeof input === 'object' && input !== null) {
         const obj = { ...input };
+        if (typeof obj.description === 'string' && !obj.operation_type) {
+            try {
+                const parsed = JSON.parse(obj.description);
+                if (parsed && typeof parsed === 'object' && parsed.operation_type) {
+                    return parsed;
+                }
+            }
+            catch { }
+        }
         if (typeof obj.data === 'string') {
             try {
                 obj.data = JSON.parse(obj.data);
@@ -237,7 +246,7 @@ const OnchainOperationsSchema = z.preprocess((input) => {
         operation_type: z.literal("guard"),
         data: CallGuard_DataSchema,
         env: CallEnvSchema.optional(),
-    }).describe("🛡️ Guard Object: Create immutable programmable validation rules that return boolean results. Set 'namedNew' to name the new Guard. Use root.type='node' for direct node tree or root.type='file' to load from file. Use 'wowok_buildin_info' tool with query='guard instructions' for all available operations."),
+    }).describe("🛡️ Guard Object: Create immutable programmable validation rules that return boolean results. Set 'namedNew' to name the new Guard. Use root.type='node' for direct node tree or root.type='file' to load from file. Use 'wowok_buildin_info' tool with query='guard instructions' for all available operations. NOTE for EntityLinker/EntityRegistrar queries: Add system addresses to the Guard table - ENTITY_LINKER_ADDRESS (0xaaa) for EntityLinker, ENTITY_REGISTRAR_ADDRESS (0xaab) for EntityRegistrar."),
     z.object({
         operation_type: z.literal("personal"),
         data: CallPersonal_DataSchema,
@@ -270,6 +279,15 @@ const OnchainOperationsSchema = z.preprocess((input) => {
 const WipOperationsSchema = z.preprocess((input) => {
     if (typeof input === 'object' && input !== null) {
         const obj = { ...input };
+        if (typeof obj.description === 'string' && !obj.type) {
+            try {
+                const parsed = JSON.parse(obj.description);
+                if (parsed && typeof parsed === 'object' && parsed.type) {
+                    return parsed;
+                }
+            }
+            catch { }
+        }
         if (typeof obj.options === 'string') {
             try {
                 obj.options = JSON.parse(obj.options);
@@ -303,9 +321,202 @@ const WipOperationsSchema = z.preprocess((input) => {
         options: WipToHtmlOptionsSchema.optional().describe("Conversion options"),
     }).describe("Convert WIP file to HTML format"),
 ]));
+const OnchainTableDataSchema = z.preprocess((input) => {
+    if (typeof input === 'object' && input !== null && !Array.isArray(input)) {
+        const obj = { ...input };
+        if (typeof obj.description === 'string' && !obj.query_type) {
+            try {
+                const parsed = JSON.parse(obj.description);
+                if (parsed && typeof parsed === 'object' && parsed.query_type) {
+                    return parsed;
+                }
+            }
+            catch { }
+        }
+        if (obj.cursor === '')
+            obj.cursor = null;
+        if (obj.limit === '')
+            obj.limit = null;
+        return obj;
+    }
+    return input;
+}, z.union([
+    z.discriminatedUnion("query_type", [
+        z.object({
+            query_type: z.literal("onchain_table"),
+            parent: NameOrAddressSchema.describe("Parent object ID whose dynamic fields table to query"),
+            cursor: z.union([z.string(), z.null()]).optional().describe("Pagination cursor from previous page's nextCursor"),
+            limit: z.union([z.number(), z.null()]).optional().describe("Max items per page"),
+            no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
+            network: EntrypointSchema.optional(),
+        }).describe("Paginated query of an on-chain object's dynamic fields table — returns items with keys, types, and object IDs. Use to explore all entries (e.g., all orders in a Service, all records in a Repository). Returns: TableAnswer | undefined (items[], nextCursor, hasNextPage)"),
+        z.object({
+            query_type: z.literal("onchain_table_item_repository_data"),
+            parent: NameOrAddressSchema.describe("Parent Repository object ID"),
+            name: z.string().describe("Name/key of the record to retrieve from the repository"),
+            entity: z.union([AccountOrMark_AddressSchema, z.number()]).describe("Entity ID or address that owns/identifies the record"),
+            no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
+            network: EntrypointSchema.optional(),
+        }).describe("Query a specific record from a Repository's on-chain key-value database by name and entity. Use to read stored data records. Returns: TableItem_RepositoryData | undefined"),
+        z.object({
+            query_type: z.literal("onchain_table_item_permission_perm"),
+            parent: NameOrAddressSchema.describe("Parent Permission object ID"),
+            address: z.union([AccountOrMark_AddressSchema, z.string()]).describe("User address or Guard ID whose permissions to check"),
+            no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
+            network: EntrypointSchema.optional(),
+        }).describe("Query a permission entry from a Permission object's perm table — checks what operations a user/guard is allowed to perform. Use to verify access rights. Returns: TableItem_PermissionPerm | undefined"),
+        z.object({
+            query_type: z.literal("onchain_table_item_entity_registrar"),
+            address: z.union([AccountOrMark_AddressSchema, z.string()]).describe("User address to look up in the global EntityRegistrar"),
+            no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
+            network: EntrypointSchema.optional(),
+        }).describe("Query an entity's registration record from the global EntityRegistrar — verifies if an address is registered on the blockchain. Use to check registration status and details. Returns: TableItem_EntityRegistrar | undefined"),
+        z.object({
+            query_type: z.literal("onchain_table_item_entity_linker"),
+            address: z.union([AccountOrMark_AddressSchema, z.string()]).describe("Entity address whose community votes/endorsements to query"),
+            no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
+            network: EntrypointSchema.optional(),
+        }).describe("Query community votes/endorsements for an entity from the global EntityLinker — shows how others have voted on this entity. Use to check reputation and community trust. Returns: TableItem_EntityLinker | undefined"),
+        z.object({
+            query_type: z.literal("onchain_table_item_reward_record"),
+            parent: NameOrAddressSchema.describe("Parent Reward object ID"),
+            address: AccountOrMark_AddressSchema.describe("User address that claimed the reward"),
+            no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
+            network: EntrypointSchema.optional(),
+        }).describe("Query a reward claim record from a Reward object's table — checks if a user has claimed a specific incentive. Use to verify reward distribution status. Returns: TableItem_RewardRecord | undefined"),
+    ]),
+    z.discriminatedUnion("query_type", [
+        z.object({
+            query_type: z.literal("onchain_table_item_demand_presenter"),
+            parent: NameOrAddressSchema.describe("Parent Demand object ID"),
+            address: AccountOrMark_AddressSchema.describe("Presenter address that submitted the demand"),
+            no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
+            network: EntrypointSchema.optional(),
+        }).describe("Query a demand submission from a Demand object's table — Demands are service requests submitted by users. Use to check a specific demand's details. Returns: TableItem_DemandPresenter | undefined"),
+        z.object({
+            query_type: z.literal("onchain_table_item_treasury_history"),
+            parent: NameOrAddressSchema.describe("Parent Treasury object ID"),
+            address: AccountOrMark_AddressSchema.describe("Payment ID whose treasury record to look up"),
+            no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
+            network: EntrypointSchema.optional(),
+        }).describe("Query a payment record from a Treasury's history table by payment ID — Treasury manages funds and payment tracking. Use to look up payment details and status. Returns: TableItem_TreasuryHistory | undefined"),
+        z.object({
+            query_type: z.literal("onchain_table_item_machine_node"),
+            parent: NameOrAddressSchema.describe("Parent Machine object ID"),
+            key: z.string().describe("Node name (string key) to query in the Machine's workflow definition"),
+            no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
+            network: EntrypointSchema.optional(),
+        }).describe("Query a workflow node definition from a Machine object's table by node name — Machines define workflow templates. Use to inspect a specific node's configuration and logic. Returns: TableItem_MachineNode | undefined"),
+        z.object({
+            query_type: z.literal("onchain_table_item_progress_history"),
+            parent: NameOrAddressSchema.describe("Parent Progress object ID"),
+            u64: z.union([z.number(), z.string()]).describe("Sequence number (u64) of the progress step to query"),
+            no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
+            network: EntrypointSchema.optional(),
+        }).describe("Query a progress step record from a Progress object's table by sequence number — Progress tracks order/workflow execution. Use to check the status of a specific execution step. Returns: TableItem_ProgressHistory | undefined"),
+        z.object({
+            query_type: z.literal("onchain_table_item_address_mark"),
+            parent: NameOrAddressSchema.describe("Parent AddressMark object ID"),
+            address: AccountOrMark_AddressSchema.describe("Address whose PUBLIC on-chain name/tags to look up"),
+            no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
+            network: EntrypointSchema.optional(),
+        }).describe("Query a PUBLIC on-chain name/tag mark for an address — unlike local marks, these are published on-chain. Use to look up public labels attached to any address. Returns: TableItem_AddressMark | undefined"),
+    ]),
+]));
+const OnchainTableDataResultSchema = z.object({
+    result: z.union([
+        z.object({ query_type: z.literal("onchain_table"), result: z.union([TableAnswerSchema, z.undefined()]) }),
+        z.object({ query_type: z.literal("onchain_table_item_repository_data"), result: z.union([TableItem_RepositoryDataSchema, z.undefined()]) }),
+        z.object({ query_type: z.literal("onchain_table_item_permission_perm"), result: z.union([TableItem_PermissionPermSchema, z.undefined()]) }),
+        z.object({ query_type: z.literal("onchain_table_item_entity_registrar"), result: z.union([TableItem_EntityRegistrarSchema, z.undefined()]) }),
+        z.object({ query_type: z.literal("onchain_table_item_entity_linker"), result: z.union([TableItem_EntityLinkerSchema, z.undefined()]) }),
+        z.object({ query_type: z.literal("onchain_table_item_reward_record"), result: z.union([TableItem_RewardRecordSchema, z.undefined()]) }),
+        z.object({ query_type: z.literal("onchain_table_item_demand_presenter"), result: z.union([TableItem_DemandPresenterSchema, z.undefined()]) }),
+        z.object({ query_type: z.literal("onchain_table_item_treasury_history"), result: z.union([TableItem_TreasuryHistorySchema, z.undefined()]) }),
+        z.object({ query_type: z.literal("onchain_table_item_machine_node"), result: z.union([TableItem_MachineNodeSchema, z.undefined()]) }),
+        z.object({ query_type: z.literal("onchain_table_item_progress_history"), result: z.union([TableItem_ProgressHistorySchema, z.undefined()]) }),
+        z.object({ query_type: z.literal("onchain_table_item_address_mark"), result: z.union([TableItem_AddressMarkSchema, z.undefined()]) }),
+    ])
+});
+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 });
+            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 });
+            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;
+        }
+        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"`);
+    }
+    return {
+        content: [{ type: "text", text: JSON.stringify({ result }) }],
+        structuredContent: { result },
+    };
+}
 const WatchQueryOperationsSchema = z.preprocess((input) => {
     if (typeof input === 'object' && input !== null) {
         const obj = { ...input };
+        if (typeof obj.description === 'string' && !obj.query_type) {
+            try {
+                const parsed = JSON.parse(obj.description);
+                if (parsed && typeof parsed === 'object' && parsed.query_type) {
+                    return parsed;
+                }
+            }
+            catch { }
+        }
         for (const key of ['filter', 'objects', 'env', 'token_type']) {
             if (typeof obj[key] === 'string') {
                 try {
@@ -317,98 +528,71 @@ const WatchQueryOperationsSchema = z.preprocess((input) => {
         return obj;
     }
     return input;
-}, z.discriminatedUnion("query_type", [
-    z.object({
-        query_type: z.literal("local_mark_list"),
-        filter: LocalMarkFilterSchema.optional().describe("Local mark filter"),
-    }).describe("Query local ID/USER address book with optional filter"),
-    z.object({
-        query_type: z.literal("account_list"),
-        filter: AccountFilterSchema.optional().describe("Account filter"),
-    }).describe("Query account list with optional filter"),
-    z.object({
-        query_type: z.literal("local_info_list"),
-        filter: LocalInfoFilterSchema.optional().describe("Local info filter"),
-    }).describe("Query local info list with optional filter"),
-    z.object({
-        query_type: z.literal("token_list"),
-        filter: TokenDataFilterSchema.optional(),
-    }).describe("Query token list with optional filter"),
-    z.object({
-        query_type: z.literal("account_balance"),
-        name_or_address: NameOrAddressSchema.optional().describe("Account name or address. Use empty string '' for the default account. Defaults to '' if omitted."),
-        token_type: TokenTypeSchema.optional().describe("Token type; default token type is 0x2::wow::WOW"),
-    }).describe("Query account balance or coin objects by the token type"),
-    z.object({
-        query_type: z.literal("onchain_personal_profile"),
-        account: NameOrAddressSchema.optional().describe("Account name or ID to query. Use empty string '' for the default account."),
-    }).describe("Query PUBLIC on-chain personal profile for any account address"),
-    z.object({
-        query_type: z.literal("onchain_objects"),
-        objects: z.array(NameOrAddressSchema).describe("List of object IDs to query"),
-    }).describe("Query on-chain objects"),
-    z.object({
-        query_type: z.literal("onchain_table"),
-        parent: NameOrAddressSchema,
-        object_type: ObjectTypeSchema,
-    }).describe("Query on-chain table data of the specified object"),
-    z.object({
-        query_type: z.literal("onchain_table_item_repository_data"),
-        parent: NameOrAddressSchema.describe("Parent object ID of the data table to query"),
-        name: z.string().describe("Name of the record to query"),
-        entity: z.union([AccountOrMark_AddressSchema, z.number()]).describe("ID or address of the entity; or address that number is casted to"),
-    }).describe("Query repository data table item"),
-    z.object({
-        query_type: z.literal("onchain_table_item_permission_perm"),
-        parent: NameOrAddressSchema.describe("Parent object ID of the data table to query"),
-        address: z.union([AccountOrMark_AddressSchema, z.string()]).describe("User ID or address, or Guard ID in the permission perm table"),
-    }).describe("Query permission perm table item"),
-    z.object({
-        query_type: z.literal("onchain_table_item_entity_registrar"),
-        address: z.union([AccountOrMark_AddressSchema, z.string()]).describe("User ID or address of the entity"),
-    }).describe("Query entity registrar table item"),
-    z.object({
-        query_type: z.literal("onchain_table_item_entity_linker"),
-        address: z.union([AccountOrMark_AddressSchema, z.string()]).describe("ID or address that the registrar votes are attached to"),
-    }).describe("Query entity linker table item"),
-    z.object({
-        query_type: z.literal("onchain_table_item_reward_record"),
-        parent: NameOrAddressSchema.describe("Parent object ID of the data table to query"),
-        address: AccountOrMark_AddressSchema.describe("User ID or address that claims the reward"),
-    }).describe("Query reward record table item"),
-    z.object({
-        query_type: z.literal("onchain_table_item_demand_presenter"),
-        parent: NameOrAddressSchema.describe("Parent object ID of the data table to query"),
-        address: AccountOrMark_AddressSchema.describe("User ID or address of the Demand presenter"),
-    }).describe("Query demand presenter table item"),
-    z.object({
-        query_type: z.literal("onchain_table_item_treasury_history"),
-        parent: NameOrAddressSchema.describe("Parent object ID of the data table to query"),
-        address: AccountOrMark_AddressSchema.describe("ID of the payment that the treasury record is attached to"),
-    }).describe("Query treasury record table item"),
-    z.object({
-        query_type: z.literal("onchain_table_item_machine_node"),
-        parent: NameOrAddressSchema.describe("Parent object ID of the data table to query"),
-        key: z.string().describe("String key of the node name to query"),
-    }).describe("Query machine node table item"),
-    z.object({
-        query_type: z.literal("onchain_table_item_progress_history"),
-        parent: NameOrAddressSchema.describe("Parent object ID of the data table to query"),
-        u64: z.union([z.number(), z.string()]).describe("U64 value of the record to query"),
-    }).describe("Query progress history table item"),
-    z.object({
-        query_type: z.literal("onchain_table_item_address_mark"),
-        parent: NameOrAddressSchema.describe("Parent object ID of the data table to query"),
-        address: AccountOrMark_AddressSchema.describe("ID or address that the mark name and tags are attached to"),
-    }).describe("Query address mark table item"),
-    z.object({
-        query_type: z.literal("onchain_received"),
-        object: z.string().describe("Object ID to query"),
-        all_type: z.boolean().optional().describe("Whether to query all types of received objects"),
-    }).describe("Query on-chain received balance, payments, and NFTs"),
+}, z.union([
+    z.discriminatedUnion("query_type", [
+        z.object({
+            query_type: z.literal("local_mark_list"),
+            filter: LocalMarkFilterSchema.optional().describe("Local mark filter"),
+        }).describe("Query your LOCAL address book — maps human-readable names to blockchain addresses with optional tags. Use to resolve names→addresses or find addresses by tag. Returns: MarkData[] (name, address, tags, timestamps)"),
+        z.object({
+            query_type: z.literal("account_list"),
+            filter: AccountFilterSchema.optional().describe("Account filter"),
+        }).describe("Query your LOCAL accounts — view all accounts stored on this device (addresses, public keys, messenger status, suspension state). Use to discover available accounts before operations. Returns: AccountData[] (name, address, pubkey, suspended, messenger, timestamps)"),
+        z.object({
+            query_type: z.literal("local_info_list"),
+            filter: LocalInfoFilterSchema.optional().describe("Local info filter"),
+        }).describe("Query your LOCAL private info — sensitive data like delivery addresses, phone numbers, contacts stored ONLY on this device. Use to retrieve saved contact/delivery details. Returns: InfoData[] (name, default value, contents, timestamps)"),
+        z.object({
+            query_type: z.literal("token_list"),
+            filter: TokenDataFilterSchema.optional(),
+        }).describe("Query cached token metadata — symbol, decimals, icon URL, description for tokens previously fetched from chain. Use to look up token info without an on-chain query. Returns: TokenTypeInfo[] (type, alias, name, symbol, decimals, iconUrl)"),
+        z.object({
+            query_type: z.literal("account_balance"),
+            name_or_address: NameOrAddressSchema.optional().describe("Account name or address. Use empty string '' for the default account. Defaults to '' if omitted."),
+            balance: z.boolean().optional().describe("Set to true to query total balance amount for the token type"),
+            coin: z.object({
+                cursor: z.union([z.string(), z.null()]).optional().describe("Pagination cursor for listing coin objects"),
+                limit: z.union([z.number(), z.null()]).optional().describe("Max coin objects per page"),
+            }).optional().describe("Set to query paginated coin objects instead of balance. Use cursor/limit for pagination."),
+            token_type: TokenTypeSchema.optional().describe("Token type to query; defaults to 0x2::wow::WOW (platform token)"),
+            network: EntrypointSchema.optional(),
+        }).describe("Query an account's coin balance OR paginated coin objects. Use balance=true for total amount, or coin={cursor,limit} to list individual coin objects. Returns: { address, balance? | coin? }"),
+    ]),
+    z.discriminatedUnion("query_type", [
+        z.object({
+            query_type: z.literal("onchain_personal_profile"),
+            account: NameOrAddressSchema.optional().describe("Account name or ID to query. Use empty string '' for the default account."),
+            no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
+            network: EntrypointSchema.optional(),
+        }).describe("Query any user's PUBLIC on-chain profile — social links, reputation (likes/dislikes), personal info records, voting history, referrer. Use to look up a user's public identity and reputation. Returns: ObjectPersonal | undefined"),
+        z.object({
+            query_type: z.literal("onchain_objects"),
+            objects: z.array(NameOrAddressSchema).describe("List of object IDs (names or addresses) to query in batch"),
+            no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
+            network: EntrypointSchema.optional(),
+        }).describe("Batch query on-chain WOWOK objects by ID or name — supports Service, Machine, Order, Treasury, Reward, Arb, Personal, Contact, and more. Use to inspect one or more objects in a single call. Returns: { objects: ObjectBase[] }"),
+        z.object({
+            query_type: z.literal("onchain_received"),
+            object: z.string().describe("Name or address of the object that received payments/items"),
+            all_type: z.boolean().optional().describe("Set to true to query all token types received; defaults to the object's Token type '0x2::payment::CoinWrapper<TOKEN>' (Coins wrapper sent via Payment object). If the object has no Token type, the call will fail."),
+            cursor: z.union([z.string(), z.null()]).optional().describe("Pagination cursor from previous page"),
+            limit: z.union([z.number(), z.null()]).optional().describe("Max records per page"),
+            no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
+            network: EntrypointSchema.optional(),
+        }).describe("Query objects (Payments, Tokens, NFTs) received by a specific object. Use to track incoming payments or items sent to an on-chain object. Supports pagination and all_type filter. Returns: ReceivedBalance | ReceivedNormal[]"),
+    ]),
 ]));
 async function handleOnchainOperations(args) {
     try {
+        if (typeof args === 'object' && args !== null && args.description && !args.operation_type) {
+            const hasWrappedParams = typeof args.description === 'string' &&
+                (args.description.includes('operation_type') || args.description.includes('data'));
+            if (hasWrappedParams) {
+                throw new Error("Invalid parameter structure. Parameters should NOT be wrapped in 'description' field.\n" +
+                    "Correct format: { operation_type: '...', data: {...} }\n" +
+                    "Incorrect format: { description: '{ operation_type: ... }' }");
+            }
+        }
         const validated = strictParse(OnchainOperationsSchema, args, "onchain_operations input");
         const env = getEnvConfig(validated.env);
         switch (validated.operation_type) {
@@ -793,17 +977,17 @@ async function handleWatchQueryOperations(args) {
             break;
         }
         case "account_balance": {
-            const queryResult = await query_account({ name_or_address: validated.name_or_address, token_type: validated.token_type, balance: true });
+            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 });
             result = { query_type: "account_balance", result: queryResult };
             break;
         }
         case "onchain_personal_profile": {
-            const queryResult = await query_personal({ account: validated.account });
+            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 });
+            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) {
@@ -824,68 +1008,13 @@ async function handleWatchQueryOperations(args) {
             result = { query_type: "onchain_objects", result: queryResult };
             break;
         }
-        case "onchain_table": {
-            const queryResult = await query_table({ parent: validated.parent, object_type: validated.object_type });
-            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 });
-            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 });
-            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 });
-            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 });
-            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 });
-            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 });
-            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 });
-            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 });
-            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 });
-            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 });
-            result = { query_type: "onchain_table_item_entity_linker", result: queryResult };
-            break;
-        }
         case "onchain_received": {
-            const queryResult = await query_received({ object: validated.object, all_type: validated.all_type });
+            const queryResult = await query_received({ object: validated.object, all_type: validated.all_type, cursor: validated.cursor, limit: validated.limit, no_cache: validated.no_cache, network: validated.network });
             result = { query_type: "onchain_received", result: queryResult };
             break;
         }
         default:
-            throw new Error(`Unknown watch query type. Valid query_types are: "local_mark_list", "account_list", "local_info_list", "token_list", "account_balance", "onchain_personal_profile", "onchain_objects", "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_received"`);
+            throw new Error(`Unknown query type. Valid query_types are: "local_mark_list", "account_list", "local_info_list", "token_list", "account_balance", "onchain_personal_profile", "onchain_objects", "onchain_received". For table queries, use the "onchain_table_data" tool.`);
     }
     return {
         content: [{ type: "text", text: JSON.stringify({ result }) }],
@@ -1209,19 +1338,51 @@ async function main() {
     }, handleMachineNode2File);
     server.registerTool("query_toolkit", {
         title: "🔍 Data Query Toolkit",
-        description: "WOWOK data query toolkit: Query local naming info (accounts, names, Object IDs), and query on-chain WOWOK objects, table items, events, received tokens, user profile, etc.",
+        description: "WOWOK data query toolkit — 8 query types covering local device data and on-chain blockchain data:\n\n"
+            + "LOCAL (device-only, never on-chain):\n"
+            + "1. local_mark_list — Query your LOCAL address book: maps human-readable names to blockchain addresses with optional tags. Use to resolve names→addresses or find addresses by tag.\n"
+            + "2. account_list — Query your LOCAL accounts: view all accounts stored on this device (addresses, public keys, messenger status, suspension state). Use to discover available accounts before operations.\n"
+            + "3. local_info_list — Query your LOCAL private info: sensitive data like delivery addresses, phone numbers, contacts stored ONLY on this device.\n"
+            + "4. token_list — Query cached token metadata: symbol, decimals, icon URL, description for tokens previously fetched from chain. Use to look up token precision/decimals before performing token operations. Returns: TokenTypeInfo[] (type, alias, name, symbol, decimals, iconUrl).\n"
+            + "5. account_balance — Query an account's coin balance OR paginated coin objects. Use balance=true for total amount, or coin={cursor,limit} to list individual coin objects. Supports multi-token via token_type parameter.\n\n"
+            + "ONCHAIN (blockchain):\n"
+            + "6. onchain_personal_profile — Query any user's PUBLIC on-chain profile: social links, reputation (likes/dislikes), personal info records, voting history, referrer.\n"
+            + "7. onchain_objects — Batch query on-chain WOWOK objects by ID or name: supports Service, Machine, Order, Treasury, Reward, Arb, Personal, Contact, and more.\n"
+            + "8. onchain_received — Query objects (Payments, Tokens, NFTs) received by a specific object. Supports pagination and all_type filter.\n\n"
+            + "For dynamic table data queries (pagination, table items), use the 'onchain_table_data' tool.",
         inputSchema: WatchQueryOperationsSchema,
-        outputSchema: WatchQueryOperationsResultSchema,
+        outputSchema: z.object({
+            result: z.any().describe("Query result — type depends on query_type. Local queries return arrays (MarkData[], AccountData[], InfoData[], TokenTypeInfo[]). account_balance returns { address, balance? | coin? }. Onchain queries return typed objects or undefined. onchain_received returns ReceivedBalance | ReceivedNormal[].")
+        }),
         annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
-        _meta: createToolMeta("query", ["watch", "query", "on-chain", "local", "events", "objects", "tables", "tokens", "balance", "profile"]),
+        _meta: createToolMeta("query", ["watch", "query", "on-chain", "local", "events", "objects", "tokens", "balance", "profile"]),
     }, handleWatchQueryOperations);
+    server.registerTool("onchain_table_data", {
+        title: "📊 Watch WoWok On-chain Table Data Query",
+        description: "Query dynamic table data of on-chain objects — supports paginated table queries and specific table item lookups. Each table item belongs to a parent object type and has a specific meaning:\n\n"
+            + "1. onchain_table — Paginated query of ANY object's dynamic fields table (Parent: any object). Returns all entries with keys, types, and object IDs. Use to explore all sub-items of an object.\n"
+            + "2. onchain_table_item_repository_data — Query a record from a Repository's on-chain key-value database (Parent: Repository). Key: name + entity (address or number). Returns the stored data record with typed value.\n"
+            + "3. onchain_table_item_permission_perm — Query a permission entry from a Permission object's access control table (Parent: Permission). Key: user address or Guard ID. Returns the permission list (perm[]) granted to that user/guard.\n"
+            + "4. onchain_table_item_entity_registrar — Query an entity's registration record from the GLOBAL EntityRegistrar (Parent: system EntityRegistrar). Key: user address. Returns registration info: description, referrer, records, mark_object.\n"
+            + "5. onchain_table_item_entity_linker — Query community votes/endorsements for an entity from the GLOBAL EntityLinker (Parent: system EntityLinker). Key: entity address. Returns vote records (likes/dislikes) showing community trust.\n"
+            + "6. onchain_table_item_reward_record — Query a reward claim record from a Reward object's distribution table (Parent: Reward). Key: recipient address. Returns claim history: guard used, total claimed, per-claim details.\n"
+            + "7. onchain_table_item_demand_presenter — Query a demand submission from a Demand object's presenter table (Parent: Demand). Key: presenter address. Returns submission details: recommendation, service, feedback, acceptance score.\n"
+            + "8. onchain_table_item_treasury_history — Query a payment record from a Treasury's history table (Parent: Treasury). Key: payment ID (address). Returns payment details: operation type, signer, amount, external guard.\n"
+            + "9. onchain_table_item_machine_node — Query a workflow node definition from a Machine object's node table (Parent: Machine). Key: node name (string). Returns node configuration: pairs, forwards, guards, thresholds.\n"
+            + "10. onchain_table_item_progress_history — Query a progress step record from a Progress object's history table (Parent: Progress). Key: sequence number (u64). Returns step details: node, next_node, session state, time.\n"
+            + "11. onchain_table_item_address_mark — Query a PUBLIC on-chain name/tag mark from an AddressMark object's table (Parent: AddressMark). Key: address. Returns public labels: entity, name, tags[]. Unlike local marks, these are published on-chain.",
+        inputSchema: OnchainTableDataSchema,
+        outputSchema: OnchainTableDataResultSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+        _meta: createToolMeta("table query", ["on-chain", "table", "dynamic fields", "pagination", "repository", "permission", "reward", "demand", "treasury", "machine", "progress"]),
+    }, handleOnchainTableData);
     server.registerTool("onchain_events", {
-        title: "📅 Watch On-chain Events",
-        description: "Watch on-chain WOWOK events by type. Supports arbitration events, new order events, progress events, demand presentation events, demand feedback events, and new entity registration events. Use pagination cursor for fetching large result sets.",
+        title: "📅 Watch WoWok On-chain Events",
+        description: "Watch on-chain WoWok events by type. Supports arbitration events, new order events, progress events, demand presentation events, demand feedback events, and new entity registration events. Use pagination cursor for fetching large result sets.",
         inputSchema: OnchainEventsInputSchema,
         outputSchema: OnchainEventsResultSchema,
         annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
-        _meta: createToolMeta("watch events", ["events", "on-chain", "arbitration", "order", "progress", "demand", "entity"]),
+        _meta: createToolMeta("watch wowook events", ["events", "on-chain", "arbitration", "order", "progress", "demand", "entity"]),
     }, handleOnchainEvents);
     server.registerTool("wowok_buildin_info", {
         title: "ℹ️ WoWok Build-in Information",