@wowok/agent-mcp 2.6.1 → 2.6.4

package/dist/schema/operations.js

@@ -61,6 +61,29 @@ 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;
+            }
+            if (Array.isArray(guardData.table)) {
+                for (const item of guardData.table) {
+                    if (item && typeof item === 'object' && !Array.isArray(item)
+                        && 'object_type' in item) {
+                        delete item.object_type;
+                    }
+                }
+            }
+        }
+        if (obj.data && typeof obj.data === 'object' && !Array.isArray(obj.data)) {
+            const d = obj.data;
+            if (d.submission !== undefined && obj.submission === undefined) {
+                obj.submission = d.submission;
+                delete d.submission;
+            }
+        }
         return obj;
     }
     return input;
@@ -128,7 +151,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 +275,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 +371,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 +411,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"),
@@ -431,6 +482,24 @@ export const WatchQueryOperationsSchema = z.preprocess((input) => {
         no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
         network: EntrypointSchema.optional(),
     }).strict().describe("FORENSICS TOOL — query all transactions sent by an address. WARNING: like onchain_object_history, this can lead to non-convergent queries. For AI context building, use assemble_context (extracts embedded history) or query_events (real-time transitions) instead. This tool is for auditing/user-activity profiling only. Returns: TransactionHistoryAnswer | undefined"),
+    z.object({
+        query_type: z.literal("token_value_convert"),
+        token_type: TokenTypeSchema.describe("Full token type in Move format: 0x<package>::<module>::<struct>. " +
+            "Examples: \"0x2::wow::WOW\" (9 decimals). The token's decimals drive the conversion — " +
+            "resolved from official registry → local cache → on-chain coin metadata."),
+        raw: z.union([z.string(), z.number()]).optional().describe("Raw smallest-unit value (u64, e.g. \"2200000000\") to convert TO a human unit value. " +
+            "Provide EXACTLY ONE of raw / unit."),
+        unit: z.union([z.string(), z.number()]).optional().describe("Human unit value (e.g. \"2.2\") to convert TO raw smallest units (u64). " +
+            "Provide EXACTLY ONE of raw / unit. Conversion is REFUSED when the token's " +
+            "decimals cannot be resolved (guessing would forge wrong on-chain values)."),
+        network: EntrypointSchema.optional(),
+    }).strict()
+        .describe("Convert between raw on-chain smallest units (u64) and human unit values, in EITHER direction. " +
+        "Provide EXACTLY ONE of raw / unit (handler-validated). " +
+        "raw → unit: \"2200000000\" → \"2.2\" (pass-through when precision unknown). " +
+        "unit → raw: \"2.2\" → \"2200000000\" (REFUSED when precision unknown — never guesses decimals). " +
+        "Use this before displaying chain values to users, and before entering amounts for on-chain operations. " +
+        "Returns: { token_type, symbol?, decimals?, precision_known, direction, input, output, error?, text }"),
 ]));
 export const OnchainTableDataResultSchema = z.object({
     result: z.union([