@wowok/agent-mcp 2.6.1 → 2.6.3

package/dist/schema/operations.js

@@ -61,6 +61,14 @@ export const OnchainOperationsSchema = z.preprocess((input) => {
                 catch { }
             }
         }
+        if (obj.operation_type === 'guard' && obj.data && typeof obj.data === 'object'
+            && !Array.isArray(obj.data)) {
+            const guardData = obj.data;
+            if (guardData.object && !guardData.namedNew) {
+                guardData.namedNew = guardData.object;
+                delete guardData.object;
+            }
+        }
         return obj;
     }
     return input;
@@ -128,7 +136,7 @@ export const OnchainOperationsSchema = z.preprocess((input) => {
         operation_type: z.literal("guard"),
         data: CallGuard_DataSchema,
         env: CallEnvSchema.optional(),
-    }).strict().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."),
+    }).strict().describe("🛡️ Guard Object: Create immutable programmable validation rules that return boolean results. Set 'namedNew' to name the new Guard (you may also use 'object' as an alias — both work). 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,
@@ -252,19 +260,19 @@ export const OnchainTableDataSchema = z.preprocess((input) => {
         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"),
+            address: AccountOrMark_AddressAISchema.describe("User address or Guard ID whose permissions to check. Supports string (name/address) or object form. LocalMark names are resolved automatically."),
             no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
             network: EntrypointSchema.optional(),
         }).strict().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"),
+            address: AccountOrMark_AddressAISchema.describe("User address to look up in the global EntityRegistrar. Supports string (name/address) or object form. LocalMark names are resolved automatically."),
             no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
             network: EntrypointSchema.optional(),
         }).strict().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"),
+            address: AccountOrMark_AddressAISchema.describe("Entity address whose community votes/endorsements to query. Supports string (name/address) or object form. LocalMark names are resolved automatically."),
             no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
             network: EntrypointSchema.optional(),
         }).strict().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"),
@@ -348,6 +356,24 @@ export const WatchQueryOperationsSchema = z.preprocess((input) => {
                 catch { }
             }
         }
+        if (obj.query_type === 'account_balance' && obj.filter && typeof obj.filter === 'object') {
+            const f = obj.filter;
+            if (!obj.name_or_address) {
+                if (typeof f.name_or_address === 'string') {
+                    obj.name_or_address = f.name_or_address;
+                }
+                else if (typeof f.name === 'string') {
+                    obj.name_or_address = f.name;
+                }
+                else if (typeof f.address === 'string') {
+                    obj.name_or_address = f.address;
+                }
+            }
+            if (!obj.token_type && typeof f.token_type === 'string') {
+                obj.token_type = f.token_type;
+            }
+            delete obj.filter;
+        }
         return obj;
     }
     return input;
@@ -370,15 +396,25 @@ export const WatchQueryOperationsSchema = z.preprocess((input) => {
     }).strict().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."),
+        name_or_address: NameOrAddressSchema.optional().describe("Account name or address to query. " +
+            "Examples: \"my_account\", \"0xabc123...\", or \"\" for the default account. " +
+            "NOTE: This field is NOT named 'filter' — use 'name_or_address' directly. " +
+            "Defaults to '' (default account) 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"),
         }).strict().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)"),
+        token_type: TokenTypeSchema.optional().describe("Token type in Move format: 0x<package>::<module>::<struct>. " +
+            "Examples: \"0x2::wow::WOW\" (default, 9 decimals), \"0x2::sui::SUI\" (9 decimals). " +
+            "For custom tokens, use the full type string from the token's coin metadata. " +
+            "The Fund Processing Layer resolves precision from the official registry → cache → on-chain."),
         network: EntrypointSchema.optional(),
-    }).strict().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? }"),
+    }).strict().describe("Query an account's coin balance OR paginated coin objects. " +
+        "PARAMETERS: Use 'name_or_address' to specify the account (NOT 'filter'). " +
+        "Use balance=true for total amount, or coin={cursor,limit} to list individual coin objects. " +
+        "Use token_type to query non-default tokens (format: 0x<package>::<module>::<struct>). " +
+        "Returns: { address, balance? | coin? }"),
     z.object({
         query_type: z.literal("local_names"),
         addresses: z.array(z.string()).describe("Array of addresses to look up local names for"),