@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/schemas/query_toolkit.schema.json

@@ -3,626 +3,718 @@
   "$id": "https://wowok.net/schemas/query_toolkit.json",
   "title": "Data Query Toolkit",
   "description": "Query local and on-chain data",
-  "$ref": "#/definitions/query_toolkit",
-  "definitions": {
-    "query_toolkit": {
-      "anyOf": [
-        {
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "query_type": {
+          "type": "string",
+          "const": "local_mark_list"
+        },
+        "filter": {
+          "description": "Local mark filter",
           "type": "object",
           "properties": {
-            "query_type": {
-              "type": "string",
-              "const": "local_mark_list"
+            "name": {
+              "description": "Filter by mark name (supports fuzzy match)",
+              "type": "string"
+            },
+            "tags": {
+              "description": "Filter by tags - returns marks that contain ANY of the specified tags",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
             },
-            "filter": {
+            "address": {
+              "description": "Filter by address (exact match, format: 0x + 64 hex characters)",
+              "type": "string"
+            },
+            "createdAt": {
+              "description": "Filter by creation time range",
               "type": "object",
               "properties": {
-                "name": {
-                  "type": "string",
-                  "description": "Filter by mark name (supports fuzzy match)"
+                "gte": {
+                  "description": "Filter marks created on or after this timestamp (ms)",
+                  "type": "number"
                 },
-                "tags": {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  },
-                  "description": "Filter by tags - returns marks that contain ANY of the specified tags"
-                },
-                "address": {
-                  "type": "string",
-                  "description": "Filter by address (exact match, format: 0x + 64 hex characters)"
-                },
-                "createdAt": {
-                  "type": "object",
-                  "properties": {
-                    "gte": {
-                      "type": "number",
-                      "description": "Filter marks created on or after this timestamp (ms)"
-                    },
-                    "lte": {
-                      "type": "number",
-                      "description": "Filter marks created on or before this timestamp (ms)"
-                    }
-                  },
-                  "additionalProperties": false,
-                  "description": "Filter by creation time range"
-                },
-                "updatedAt": {
-                  "type": "object",
-                  "properties": {
-                    "gte": {
-                      "type": "number",
-                      "description": "Filter marks updated on or after this timestamp (ms)"
-                    },
-                    "lte": {
-                      "type": "number",
-                      "description": "Filter marks updated on or before this timestamp (ms)"
-                    }
-                  },
-                  "additionalProperties": false,
-                  "description": "Filter by update time range"
+                "lte": {
+                  "description": "Filter marks created on or before this timestamp (ms)",
+                  "type": "number"
                 }
               },
-              "additionalProperties": false,
-              "description": "Local mark filter"
-            }
-          },
-          "required": [
-            "query_type"
-          ],
-          "additionalProperties": false,
-          "description": "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)"
-        },
-        {
-          "type": "object",
-          "properties": {
-            "query_type": {
-              "type": "string",
-              "const": "account_list"
+              "additionalProperties": false
             },
-            "filter": {
+            "updatedAt": {
+              "description": "Filter by update time range",
               "type": "object",
               "properties": {
-                "name": {
-                  "$ref": "#/definitions/query_toolkit/anyOf/0/properties/filter/properties/name",
-                  "description": "Filter by account name (supports fuzzy match)"
-                },
-                "address": {
-                  "$ref": "#/definitions/query_toolkit/anyOf/0/properties/filter/properties/address",
-                  "description": "Filter by account address (supports partial match, format: 0x + hex characters)"
+                "gte": {
+                  "description": "Filter marks updated on or after this timestamp (ms)",
+                  "type": "number"
                 },
-                "suspended": {
-                  "type": "boolean",
-                  "description": "Filter by suspension status. Omit to return all accounts regardless of status"
-                },
-                "hasMessenger": {
-                  "type": "boolean",
-                  "description": "Filter accounts with messenger enabled"
-                },
-                "createdAt": {
-                  "type": "object",
-                  "properties": {
-                    "gte": {
-                      "type": "number",
-                      "description": "Filter accounts created on or after this timestamp (ms)"
-                    },
-                    "lte": {
-                      "type": "number",
-                      "description": "Filter accounts created on or before this timestamp (ms)"
-                    }
-                  },
-                  "additionalProperties": false,
-                  "description": "Filter by creation time range"
-                },
-                "updatedAt": {
-                  "type": "object",
-                  "properties": {
-                    "gte": {
-                      "type": "number",
-                      "description": "Filter accounts updated on or after this timestamp (ms)"
-                    },
-                    "lte": {
-                      "type": "number",
-                      "description": "Filter accounts updated on or before this timestamp (ms)"
-                    }
-                  },
-                  "additionalProperties": false,
-                  "description": "Filter by update time range"
-                },
-                "includePubkey": {
-                  "type": "boolean",
-                  "description": "Include pubkey in results (default: false). Pubkey is large (~900 bytes), omit unless needed"
+                "lte": {
+                  "description": "Filter marks updated on or before this timestamp (ms)",
+                  "type": "number"
                 }
               },
-              "additionalProperties": false,
-              "description": "Account filter"
+              "additionalProperties": false
             }
           },
-          "required": [
-            "query_type"
-          ],
-          "additionalProperties": false,
-          "description": "Query your LOCAL accounts — view all accounts stored on this device (addresses, messenger status, suspension state). Use filter.includePubkey=true to also include public keys (~900 bytes each, omitted by default). Returns: AccountData[] (name, address, pubkey?, suspended, messenger, timestamps)"
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "query_type"
+      ],
+      "additionalProperties": false,
+      "description": "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)"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "query_type": {
+          "type": "string",
+          "const": "account_list"
         },
-        {
+        "filter": {
+          "description": "Account filter",
           "type": "object",
           "properties": {
-            "query_type": {
-              "type": "string",
-              "const": "local_info_list"
+            "name": {
+              "description": "Filter by account name (supports fuzzy match)",
+              "type": "string"
+            },
+            "address": {
+              "description": "Filter by account address (supports partial match, format: 0x + hex characters)",
+              "type": "string"
+            },
+            "suspended": {
+              "description": "Filter by suspension status. Omit to return all accounts regardless of status",
+              "type": "boolean"
             },
-            "filter": {
+            "hasMessenger": {
+              "description": "Filter accounts with messenger enabled",
+              "type": "boolean"
+            },
+            "createdAt": {
+              "description": "Filter by creation time range",
               "type": "object",
               "properties": {
-                "name": {
-                  "$ref": "#/definitions/query_toolkit/anyOf/0/properties/filter/properties/name",
-                  "description": "Filter by info name (supports fuzzy match)"
-                },
-                "default": {
-                  "type": "string",
-                  "description": "Filter by default value (supports fuzzy match)"
+                "gte": {
+                  "description": "Filter accounts created on or after this timestamp (ms)",
+                  "type": "number"
                 },
-                "contents": {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  },
-                  "description": "Filter by contents - returns info that contains ANY of the specified content items"
-                },
-                "createdAt": {
-                  "type": "object",
-                  "properties": {
-                    "gte": {
-                      "type": "number",
-                      "description": "Filter info created on or after this timestamp (ms)"
-                    },
-                    "lte": {
-                      "type": "number",
-                      "description": "Filter info created on or before this timestamp (ms)"
-                    }
-                  },
-                  "additionalProperties": false,
-                  "description": "Filter by creation time range"
-                },
-                "updatedAt": {
-                  "type": "object",
-                  "properties": {
-                    "gte": {
-                      "type": "number",
-                      "description": "Filter info updated on or after this timestamp (ms)"
-                    },
-                    "lte": {
-                      "type": "number",
-                      "description": "Filter info updated on or before this timestamp (ms)"
-                    }
-                  },
-                  "additionalProperties": false,
-                  "description": "Filter by update time range"
+                "lte": {
+                  "description": "Filter accounts created on or before this timestamp (ms)",
+                  "type": "number"
                 }
               },
-              "additionalProperties": false,
-              "description": "Local info filter"
-            }
-          },
-          "required": [
-            "query_type"
-          ],
-          "additionalProperties": false,
-          "description": "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)"
-        },
-        {
-          "type": "object",
-          "properties": {
-            "query_type": {
-              "type": "string",
-              "const": "token_list"
+              "additionalProperties": false
             },
-            "filter": {
+            "updatedAt": {
+              "description": "Filter by update time range",
               "type": "object",
               "properties": {
-                "alias_or_name": {
-                  "$ref": "#/definitions/query_toolkit/anyOf/0/properties/filter/properties/name",
-                  "description": "Alias or name filter"
+                "gte": {
+                  "description": "Filter accounts updated on or after this timestamp (ms)",
+                  "type": "number"
                 },
-                "symbol": {
-                  "type": "string",
-                  "description": "Token symbol"
-                },
-                "type": {
-                  "type": "string",
-                  "description": "Token type"
+                "lte": {
+                  "description": "Filter accounts updated on or before this timestamp (ms)",
+                  "type": "number"
                 }
               },
-              "additionalProperties": false,
-              "description": "Token data filter"
+              "additionalProperties": false
+            },
+            "includePubkey": {
+              "description": "Include pubkey in results (default: false). Pubkey is large (~900 bytes), omit unless needed",
+              "type": "boolean"
             }
           },
-          "required": [
-            "query_type"
-          ],
-          "additionalProperties": false,
-          "description": "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)"
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "query_type"
+      ],
+      "additionalProperties": false,
+      "description": "Query your LOCAL accounts — view all accounts stored on this device (addresses, messenger status, suspension state). Use filter.includePubkey=true to also include public keys (~900 bytes each, omitted by default). Returns: AccountData[] (name, address, pubkey?, suspended, messenger, timestamps)"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "query_type": {
+          "type": "string",
+          "const": "local_info_list"
         },
-        {
+        "filter": {
+          "description": "Local info filter",
           "type": "object",
           "properties": {
-            "query_type": {
-              "type": "string",
-              "const": "account_balance"
+            "name": {
+              "description": "Filter by info name (supports fuzzy match)",
+              "type": "string"
             },
-            "name_or_address": {
-              "type": "string",
-              "description": "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."
+            "default": {
+              "description": "Filter by default value (supports fuzzy match)",
+              "type": "string"
             },
-            "balance": {
-              "type": "boolean",
-              "description": "Set to true to query total balance amount for the token type"
+            "contents": {
+              "description": "Filter by contents - returns info that contains ANY of the specified content items",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
             },
-            "coin": {
+            "createdAt": {
+              "description": "Filter by creation time range",
               "type": "object",
               "properties": {
-                "cursor": {
-                  "type": [
-                    "string",
-                    "null"
-                  ],
-                  "description": "Pagination cursor for listing coin objects"
+                "gte": {
+                  "description": "Filter info created on or after this timestamp (ms)",
+                  "type": "number"
                 },
-                "limit": {
-                  "type": [
-                    "number",
-                    "null"
-                  ],
-                  "description": "Max coin objects per page"
+                "lte": {
+                  "description": "Filter info created on or before this timestamp (ms)",
+                  "type": "number"
                 }
               },
-              "additionalProperties": false,
-              "description": "Set to query paginated coin objects instead of balance. Use cursor/limit for pagination."
+              "additionalProperties": false
             },
-            "token_type": {
-              "type": "string",
-              "description": "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": {
-              "type": "string",
-              "enum": [
-                "localnet",
-                "testnet",
-                "mainnet"
-              ],
-              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
-            }
-          },
-          "required": [
-            "query_type"
-          ],
-          "additionalProperties": false,
-          "description": "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? }"
-        },
-        {
-          "type": "object",
-          "properties": {
-            "query_type": {
-              "type": "string",
-              "const": "local_names"
-            },
-            "addresses": {
-              "type": "array",
-              "items": {
-                "type": "string"
+            "updatedAt": {
+              "description": "Filter by update time range",
+              "type": "object",
+              "properties": {
+                "gte": {
+                  "description": "Filter info updated on or after this timestamp (ms)",
+                  "type": "number"
+                },
+                "lte": {
+                  "description": "Filter info updated on or before this timestamp (ms)",
+                  "type": "number"
+                }
               },
-              "description": "Array of addresses to look up local names for"
+              "additionalProperties": false
             }
           },
-          "required": [
-            "query_type",
-            "addresses"
-          ],
-          "additionalProperties": false,
-          "description": "Query local names (account name and local mark name) for a list of addresses. Returns array of: { account?: string, local_mark?: string, address: string }"
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "query_type"
+      ],
+      "additionalProperties": false,
+      "description": "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)"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "query_type": {
+          "type": "string",
+          "const": "token_list"
         },
-        {
+        "filter": {
           "type": "object",
           "properties": {
-            "query_type": {
-              "type": "string",
-              "const": "onchain_personal_profile"
-            },
-            "account": {
-              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/name_or_address",
-              "description": "Account name or ID to query. Use empty string '' for the default account."
+            "alias_or_name": {
+              "description": "Alias or name filter",
+              "type": "string"
             },
-            "no_cache": {
-              "type": "boolean",
-              "description": "Set to true to bypass cache and fetch fresh on-chain data"
+            "symbol": {
+              "description": "Token symbol",
+              "type": "string"
             },
-            "network": {
-              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/network",
-              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+            "type": {
+              "description": "Token type",
+              "type": "string"
             }
           },
-          "required": [
-            "query_type"
-          ],
           "additionalProperties": false,
-          "description": "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"
+          "description": "Token data filter"
+        }
+      },
+      "required": [
+        "query_type"
+      ],
+      "additionalProperties": false,
+      "description": "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)"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "query_type": {
+          "type": "string",
+          "const": "account_balance"
         },
-        {
-          "type": "object",
-          "properties": {
-            "query_type": {
-              "type": "string",
-              "const": "onchain_objects"
-            },
-            "objects": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/query_toolkit/anyOf/4/properties/name_or_address"
-              },
-              "description": "List of object IDs (names or addresses) to query in batch"
-            },
-            "no_cache": {
-              "type": "boolean",
-              "description": "Set to true to bypass cache and fetch fresh on-chain data"
-            },
-            "network": {
-              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/network",
-              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
-            }
-          },
-          "required": [
-            "query_type",
-            "objects"
-          ],
-          "additionalProperties": false,
-          "description": "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[] }"
+        "name_or_address": {
+          "description": "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.",
+          "type": "string"
+        },
+        "balance": {
+          "description": "Set to true to query total balance amount for the token type",
+          "type": "boolean"
         },
-        {
+        "coin": {
+          "description": "Set to query paginated coin objects instead of balance. Use cursor/limit for pagination.",
           "type": "object",
           "properties": {
-            "query_type": {
-              "type": "string",
-              "const": "onchain_received"
-            },
-            "name_or_address": {
+            "cursor": {
+              "description": "Pagination cursor for listing coin objects",
               "anyOf": [
                 {
-                  "$ref": "#/definitions/query_toolkit/anyOf/4/properties/name_or_address",
-                  "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
+                  "type": "string"
                 },
                 {
-                  "type": "object",
-                  "properties": {
-                    "name_or_address": {
-                      "$ref": "#/definitions/query_toolkit/anyOf/4/properties/name_or_address",
-                      "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
-                    },
-                    "local_mark_first": {
-                      "type": "boolean",
-                      "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks"
-                    }
-                  },
-                  "additionalProperties": false,
-                  "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                  "type": "null"
                 }
-              ],
-              "description": "Name or address of the object that received payments/items - can be a string (name/address) or full object"
+              ]
             },
-            "type": {
+            "limit": {
+              "description": "Max coin objects per page",
               "anyOf": [
                 {
-                  "type": "string"
-                },
-                {
-                  "type": "string",
-                  "const": "CoinWrapper"
+                  "type": "number"
                 },
                 {
                   "type": "null"
                 }
-              ],
-              "description": "Type filter for querying received objects. - If undefined or null: query all types (equivalent to the old all_type=true). - If 'CoinWrapper': query CoinWrapper type for the object's token (equivalent to the old all_type=false). - If string: query specific StructType (e.g., '0x2::payment::CoinWrapper<0x2::wow::WOW>')."
-            },
-            "cursor": {
-              "type": [
-                "string",
-                "null"
-              ],
-              "description": "Pagination cursor from previous page"
-            },
-            "limit": {
-              "type": [
-                "number",
-                "null"
-              ],
-              "description": "Max records per page"
-            },
-            "no_cache": {
-              "type": "boolean",
-              "description": "Set to true to bypass cache and fetch fresh on-chain data"
-            },
-            "network": {
-              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/network",
-              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+              ]
             }
           },
-          "required": [
-            "query_type",
-            "name_or_address"
+          "additionalProperties": false
+        },
+        "token_type": {
+          "description": "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.",
+          "type": "string"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
           ],
-          "additionalProperties": false,
-          "description": "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 type filter. Returns: ReceivedBalance | ReceivedNormal[]"
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+        }
+      },
+      "required": [
+        "query_type"
+      ],
+      "additionalProperties": false,
+      "description": "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? }"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "query_type": {
+          "type": "string",
+          "const": "local_names"
         },
-        {
-          "type": "object",
-          "properties": {
-            "query_type": {
-              "type": "string",
-              "const": "onchain_transaction"
+        "addresses": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Array of addresses to look up local names for"
+        }
+      },
+      "required": [
+        "query_type",
+        "addresses"
+      ],
+      "additionalProperties": false,
+      "description": "Query local names (account name and local mark name) for a list of addresses. Returns array of: { account?: string, local_mark?: string, address: string }"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "query_type": {
+          "type": "string",
+          "const": "onchain_personal_profile"
+        },
+        "account": {
+          "description": "Account name or ID to query. Use empty string '' for the default account.",
+          "type": "string"
+        },
+        "no_cache": {
+          "description": "Set to true to bypass cache and fetch fresh on-chain data",
+          "type": "boolean"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+        }
+      },
+      "required": [
+        "query_type"
+      ],
+      "additionalProperties": false,
+      "description": "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"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "query_type": {
+          "type": "string",
+          "const": "onchain_objects"
+        },
+        "objects": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+          },
+          "description": "List of object IDs (names or addresses) to query in batch"
+        },
+        "no_cache": {
+          "description": "Set to true to bypass cache and fetch fresh on-chain data",
+          "type": "boolean"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+        }
+      },
+      "required": [
+        "query_type",
+        "objects"
+      ],
+      "additionalProperties": false,
+      "description": "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[] }"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "query_type": {
+          "type": "string",
+          "const": "onchain_received"
+        },
+        "name_or_address": {
+          "anyOf": [
+            {
+              "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
             },
-            "digest": {
-              "type": "string",
-              "description": "Transaction digest (0x...) to verify. Use after any on-chain operation to confirm what actually happened on-chain — object changes, balance changes, gas used, success/failure status. This is the 'OperationProof' primitive for the Verify step."
+            {
+              "type": "object",
+              "properties": {
+                "name_or_address": {
+                  "type": "string",
+                  "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+                },
+                "local_mark_first": {
+                  "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                  "type": "boolean"
+                }
+              },
+              "additionalProperties": false,
+              "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+            }
+          ],
+          "description": "Name or address of the object that received payments/items - can be a string (name/address) or full object"
+        },
+        "type": {
+          "description": "Type filter for querying received objects. - If undefined or null: query all types (equivalent to the old all_type=true). - If 'CoinWrapper': query CoinWrapper type for the object's token (equivalent to the old all_type=false). - If string: query specific StructType (e.g., '0x2::payment::CoinWrapper<0x2::wow::WOW>').",
+          "anyOf": [
+            {
+              "type": "string"
             },
-            "no_cache": {
-              "type": "boolean",
-              "description": "Set to true to bypass cache and fetch fresh on-chain data"
+            {
+              "type": "string",
+              "const": "CoinWrapper"
             },
-            "network": {
-              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/network",
-              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+            {
+              "type": "null"
             }
-          },
-          "required": [
-            "query_type",
-            "digest"
+          ]
+        },
+        "cursor": {
+          "description": "Pagination cursor from previous page",
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "limit": {
+          "description": "Max records per page",
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "no_cache": {
+          "description": "Set to true to bypass cache and fetch fresh on-chain data",
+          "type": "boolean"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
           ],
-          "additionalProperties": false,
-          "description": "Verify what a specific transaction did on-chain — the 'OperationProof' primitive. After executing any operation, call this with the returned digest to confirm: status (success/failed), object changes (created/mutated/deleted), balance changes, gas used, and events. Essential for the 5-step loop's Verify step. Returns: TransactionDetail | undefined"
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+        }
+      },
+      "required": [
+        "query_type",
+        "name_or_address"
+      ],
+      "additionalProperties": false,
+      "description": "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 type filter. Returns: ReceivedBalance | ReceivedNormal[]"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "query_type": {
+          "type": "string",
+          "const": "onchain_transaction"
         },
-        {
-          "type": "object",
-          "properties": {
-            "query_type": {
+        "digest": {
+          "type": "string",
+          "description": "Transaction digest (0x...) to verify. Use after any on-chain operation to confirm what actually happened on-chain — object changes, balance changes, gas used, success/failure status. This is the 'OperationProof' primitive for the Verify step."
+        },
+        "no_cache": {
+          "description": "Set to true to bypass cache and fetch fresh on-chain data",
+          "type": "boolean"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+        }
+      },
+      "required": [
+        "query_type",
+        "digest"
+      ],
+      "additionalProperties": false,
+      "description": "Verify what a specific transaction did on-chain — the 'OperationProof' primitive. After executing any operation, call this with the returned digest to confirm: status (success/failed), object changes (created/mutated/deleted), balance changes, gas used, and events. Essential for the 5-step loop's Verify step. Returns: TransactionDetail | undefined"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "query_type": {
+          "type": "string",
+          "const": "onchain_object_history"
+        },
+        "object": {
+          "type": "string",
+          "description": "Object ID (0x...) or LocalMark name. Query the provenance chain — every transaction that created, mutated, or deleted this object. Use to trace how an object reached its current state."
+        },
+        "cursor": {
+          "description": "Pagination cursor from previous page's next_cursor",
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "limit": {
+          "description": "Max results per page (default 20, max 50)",
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "order": {
+          "description": "Sort order: ascending=oldest first, descending=newest first (default)",
+          "anyOf": [
+            {
               "type": "string",
-              "const": "onchain_object_history"
-            },
-            "object": {
-              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/name_or_address",
-              "description": "Object ID (0x...) or LocalMark name. Query the provenance chain — every transaction that created, mutated, or deleted this object. Use to trace how an object reached its current state."
-            },
-            "cursor": {
-              "type": [
-                "string",
-                "null"
-              ],
-              "description": "Pagination cursor from previous page's next_cursor"
-            },
-            "limit": {
-              "type": [
-                "number",
-                "null"
-              ],
-              "description": "Max results per page (default 20, max 50)"
+              "const": "ascending"
             },
-            "order": {
+            {
               "type": "string",
-              "enum": [
-                "ascending",
-                "descending"
-              ],
-              "description": "Sort order: ascending=oldest first, descending=newest first (default)"
-            },
-            "no_cache": {
-              "type": "boolean",
-              "description": "Set to true to bypass cache and fetch fresh on-chain data"
-            },
-            "network": {
-              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/network",
-              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+              "const": "descending"
             }
-          },
-          "required": [
-            "query_type",
-            "object"
+          ]
+        },
+        "no_cache": {
+          "description": "Set to true to bypass cache and fetch fresh on-chain data",
+          "type": "boolean"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
           ],
-          "additionalProperties": false,
-          "description": "FORENSICS TOOL — query all transactions that touched an object. WARNING: this can lead to non-convergent queries (each tx touches more objects with their own history). For AI context building, use assemble_context instead — it extracts embedded history from object states (ProgressSession.forwards, etc.) without infinite recursion. This tool is for auditing/forensics only. Returns: TransactionHistoryAnswer | undefined"
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+        }
+      },
+      "required": [
+        "query_type",
+        "object"
+      ],
+      "additionalProperties": false,
+      "description": "FORENSICS TOOL — query all transactions that touched an object. WARNING: this can lead to non-convergent queries (each tx touches more objects with their own history). For AI context building, use assemble_context instead — it extracts embedded history from object states (ProgressSession.forwards, etc.) without infinite recursion. This tool is for auditing/forensics only. Returns: TransactionHistoryAnswer | undefined"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "query_type": {
+          "type": "string",
+          "const": "onchain_address_activity"
         },
-        {
-          "type": "object",
-          "properties": {
-            "query_type": {
-              "type": "string",
-              "const": "onchain_address_activity"
+        "name_or_address": {
+          "anyOf": [
+            {
+              "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
             },
-            "name_or_address": {
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/query_toolkit/anyOf/8/properties/name_or_address/anyOf/0"
+            {
+              "type": "object",
+              "properties": {
+                "name_or_address": {
+                  "type": "string",
+                  "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
                 },
-                {
-                  "$ref": "#/definitions/query_toolkit/anyOf/8/properties/name_or_address/anyOf/1"
+                "local_mark_first": {
+                  "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                  "type": "boolean"
                 }
-              ],
-              "description": "Address (0x...) or account name. Query all on-chain activity by this actor — every transaction they sent. Use to build a user's on-chain activity profile or verify an actor's history."
-            },
-            "cursor": {
-              "type": [
-                "string",
-                "null"
-              ],
-              "description": "Pagination cursor from previous page's next_cursor"
-            },
-            "limit": {
-              "type": [
-                "number",
-                "null"
-              ],
-              "description": "Max results per page (default 20, max 50)"
-            },
-            "order": {
-              "type": "string",
-              "enum": [
-                "ascending",
-                "descending"
-              ],
-              "description": "Sort order: ascending=oldest first, descending=newest first (default)"
-            },
-            "no_cache": {
-              "type": "boolean",
-              "description": "Set to true to bypass cache and fetch fresh on-chain data"
-            },
-            "network": {
-              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/network",
-              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+              },
+              "additionalProperties": false,
+              "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
             }
-          },
-          "required": [
-            "query_type",
-            "name_or_address"
           ],
-          "additionalProperties": false,
-          "description": "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"
+          "description": "Address (0x...) or account name. Query all on-chain activity by this actor — every transaction they sent. Use to build a user's on-chain activity profile or verify an actor's history."
         },
-        {
-          "type": "object",
-          "properties": {
-            "query_type": {
+        "cursor": {
+          "description": "Pagination cursor from previous page's next_cursor",
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "limit": {
+          "description": "Max results per page (default 20, max 50)",
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "order": {
+          "description": "Sort order: ascending=oldest first, descending=newest first (default)",
+          "anyOf": [
+            {
               "type": "string",
-              "const": "token_value_convert"
-            },
-            "token_type": {
-              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/token_type",
-              "description": "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": {
-              "type": [
-                "string",
-                "number"
-              ],
-              "description": "Raw smallest-unit value (u64, e.g. \"2200000000\") to convert TO a human unit value. Provide EXACTLY ONE of raw / unit."
+              "const": "ascending"
             },
-            "unit": {
-              "type": [
-                "string",
-                "number"
-              ],
-              "description": "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": {
-              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/network",
-              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+            {
+              "type": "string",
+              "const": "descending"
             }
-          },
-          "required": [
-            "query_type",
-            "token_type"
+          ]
+        },
+        "no_cache": {
+          "description": "Set to true to bypass cache and fetch fresh on-chain data",
+          "type": "boolean"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
           ],
-          "additionalProperties": false,
-          "description": "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 }"
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+        }
+      },
+      "required": [
+        "query_type",
+        "name_or_address"
+      ],
+      "additionalProperties": false,
+      "description": "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"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "query_type": {
+          "type": "string",
+          "const": "token_value_convert"
+        },
+        "token_type": {
+          "type": "string",
+          "description": "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": {
+          "description": "Raw smallest-unit value (u64, e.g. \"2200000000\") to convert TO a human unit value. Provide EXACTLY ONE of raw / unit.",
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            }
+          ]
+        },
+        "unit": {
+          "description": "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).",
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            }
+          ]
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
         }
-      ]
+      },
+      "required": [
+        "query_type",
+        "token_type"
+      ],
+      "additionalProperties": false,
+      "description": "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 }"
     }
-  }
+  ]
 }