@wowok/agent-mcp 2.3.16 → 2.3.18

package/dist/schemas/query_toolkit.schema.json

@@ -8,462 +8,454 @@
     "query_toolkit": {
       "anyOf": [
         {
-          "anyOf": [
-            {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "local_mark_list"
+            },
+            "filter": {
               "type": "object",
               "properties": {
-                "query_type": {
+                "name": {
                   "type": "string",
-                  "const": "local_mark_list"
+                  "description": "Filter by mark name (supports fuzzy match)"
+                },
+                "tags": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Filter by tags - returns marks that contain ANY of the specified tags"
                 },
-                "filter": {
+                "address": {
+                  "type": "string",
+                  "description": "Filter by address (exact match, format: 0x + 64 hex characters)"
+                },
+                "createdAt": {
                   "type": "object",
                   "properties": {
-                    "name": {
-                      "type": "string",
-                      "description": "Filter by mark name (supports fuzzy match)"
-                    },
-                    "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"
+                    "gte": {
+                      "type": "number",
+                      "description": "Filter marks created on or after this timestamp (ms)"
                     },
-                    "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": {
+                      "type": "number",
+                      "description": "Filter marks created on or before this timestamp (ms)"
                     }
                   },
                   "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"
+                  "description": "Filter by creation time range"
                 },
-                "filter": {
+                "updatedAt": {
                   "type": "object",
                   "properties": {
-                    "name": {
-                      "$ref": "#/definitions/query_toolkit/anyOf/0/anyOf/0/properties/filter/properties/name",
-                      "description": "Filter by account name (supports fuzzy match)"
-                    },
-                    "address": {
-                      "$ref": "#/definitions/query_toolkit/anyOf/0/anyOf/0/properties/filter/properties/address",
-                      "description": "Filter by account address (supports partial match, format: 0x + hex characters)"
-                    },
-                    "suspended": {
-                      "type": "boolean",
-                      "description": "Filter by suspension status. Omit to return all accounts regardless of status"
+                    "gte": {
+                      "type": "number",
+                      "description": "Filter marks updated on or after this timestamp (ms)"
                     },
-                    "hasMessenger": {
-                      "type": "boolean",
-                      "description": "Filter accounts with messenger enabled"
-                    },
-                    "m": {
-                      "$ref": "#/definitions/query_toolkit/anyOf/0/anyOf/0/properties/filter/properties/name",
-                      "description": "Filter by messenger name (supports fuzzy match)"
-                    },
-                    "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": {
+                      "type": "number",
+                      "description": "Filter marks updated on or before this timestamp (ms)"
                     }
                   },
                   "additionalProperties": false,
-                  "description": "Account filter"
+                  "description": "Filter by update time range"
                 }
               },
-              "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)"
+              "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"
             },
-            {
+            "filter": {
               "type": "object",
               "properties": {
-                "query_type": {
-                  "type": "string",
-                  "const": "local_info_list"
+                "name": {
+                  "$ref": "#/definitions/query_toolkit/anyOf/0/properties/filter/properties/name",
+                  "description": "Filter by account name (supports fuzzy match)"
                 },
-                "filter": {
+                "address": {
+                  "$ref": "#/definitions/query_toolkit/anyOf/0/properties/filter/properties/address",
+                  "description": "Filter by account address (supports partial match, format: 0x + hex characters)"
+                },
+                "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"
+                },
+                "m": {
+                  "$ref": "#/definitions/query_toolkit/anyOf/0/properties/filter/properties/name",
+                  "description": "Filter by messenger name (supports fuzzy match)"
+                },
+                "createdAt": {
                   "type": "object",
                   "properties": {
-                    "name": {
-                      "$ref": "#/definitions/query_toolkit/anyOf/0/anyOf/0/properties/filter/properties/name",
-                      "description": "Filter by info name (supports fuzzy match)"
+                    "gte": {
+                      "type": "number",
+                      "description": "Filter accounts created on or after this timestamp (ms)"
                     },
-                    "default": {
-                      "type": "string",
-                      "description": "Filter by default value (supports fuzzy match)"
-                    },
-                    "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": {
+                      "type": "number",
+                      "description": "Filter accounts created on or before this timestamp (ms)"
                     }
                   },
                   "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"
+                  "description": "Filter by creation time range"
                 },
-                "filter": {
+                "updatedAt": {
                   "type": "object",
                   "properties": {
-                    "alias_or_name": {
-                      "$ref": "#/definitions/query_toolkit/anyOf/0/anyOf/0/properties/filter/properties/name",
-                      "description": "Alias or name filter"
+                    "gte": {
+                      "type": "number",
+                      "description": "Filter accounts updated on or after this timestamp (ms)"
                     },
-                    "symbol": {
-                      "type": "string",
-                      "description": "Token symbol"
-                    },
-                    "type": {
-                      "type": "string",
-                      "description": "Token type"
+                    "lte": {
+                      "type": "number",
+                      "description": "Filter accounts updated on or before this timestamp (ms)"
                     }
                   },
                   "additionalProperties": false,
-                  "description": "Token data filter"
+                  "description": "Filter by update time range"
+                },
+                "includePubkey": {
+                  "type": "boolean",
+                  "description": "Include pubkey in results (default: false). Pubkey is large (~900 bytes), omit unless needed"
                 }
               },
-              "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)"
+              "description": "Account filter"
+            }
+          },
+          "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": {
               "type": "object",
               "properties": {
-                "query_type": {
-                  "type": "string",
-                  "const": "account_balance"
+                "name": {
+                  "$ref": "#/definitions/query_toolkit/anyOf/0/properties/filter/properties/name",
+                  "description": "Filter by info name (supports fuzzy match)"
                 },
-                "name_or_address": {
+                "default": {
                   "type": "string",
-                  "description": "Account name or address. Use empty string '' for the default account. Defaults to '' if omitted."
+                  "description": "Filter by default value (supports fuzzy match)"
                 },
-                "balance": {
-                  "type": "boolean",
-                  "description": "Set to true to query total balance amount for the token type"
+                "contents": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Filter by contents - returns info that contains ANY of the specified content items"
                 },
-                "coin": {
+                "createdAt": {
                   "type": "object",
                   "properties": {
-                    "cursor": {
-                      "type": [
-                        "string",
-                        "null"
-                      ],
-                      "description": "Pagination cursor for listing coin objects"
+                    "gte": {
+                      "type": "number",
+                      "description": "Filter info created on or after this timestamp (ms)"
                     },
-                    "limit": {
-                      "type": [
-                        "number",
-                        "null"
-                      ],
-                      "description": "Max coin objects per page"
+                    "lte": {
+                      "type": "number",
+                      "description": "Filter info created on or before this timestamp (ms)"
                     }
                   },
                   "additionalProperties": false,
-                  "description": "Set to query paginated coin objects instead of balance. Use cursor/limit for pagination."
+                  "description": "Filter by creation time range"
                 },
-                "token_type": {
-                  "type": "string",
-                  "description": "Token type to query; defaults to 0x2::wow::WOW (platform token)"
-                },
-                "network": {
-                  "type": "string",
-                  "enum": [
-                    "localnet",
-                    "testnet",
-                    "mainnet"
-                  ],
-                  "description": "Network entrypoint: Specifies which network the operation occurs on"
-                }
-              },
-              "required": [
-                "query_type"
-              ],
-              "additionalProperties": false,
-              "description": "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? }"
-            },
-            {
-              "type": "object",
-              "properties": {
-                "query_type": {
-                  "type": "string",
-                  "const": "local_names"
-                },
-                "addresses": {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
+                "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)"
+                    }
                   },
-                  "description": "Array of addresses to look up local names for"
+                  "additionalProperties": false,
+                  "description": "Filter by update time range"
                 }
               },
-              "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 }"
+              "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)"
         },
         {
-          "anyOf": [
-            {
-              "type": "object",
-              "properties": {
-                "query_type": {
-                  "type": "string",
-                  "const": "onchain_personal_profile"
-                },
-                "account": {
-                  "$ref": "#/definitions/query_toolkit/anyOf/0/anyOf/4/properties/name_or_address",
-                  "description": "Account name or ID to query. Use empty string '' for the default account."
-                },
-                "no_cache": {
-                  "type": "boolean",
-                  "description": "Set to true to bypass cache and fetch fresh on-chain data"
-                },
-                "network": {
-                  "$ref": "#/definitions/query_toolkit/anyOf/0/anyOf/4/properties/network",
-                  "description": "Network entrypoint: Specifies which network the operation occurs on"
-                }
-              },
-              "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": "token_list"
             },
-            {
+            "filter": {
               "type": "object",
               "properties": {
-                "query_type": {
-                  "type": "string",
-                  "const": "onchain_objects"
-                },
-                "objects": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/definitions/query_toolkit/anyOf/0/anyOf/4/properties/name_or_address"
-                  },
-                  "description": "List of object IDs (names or addresses) to query in batch"
+                "alias_or_name": {
+                  "$ref": "#/definitions/query_toolkit/anyOf/0/properties/filter/properties/name",
+                  "description": "Alias or name filter"
                 },
-                "no_cache": {
-                  "type": "boolean",
-                  "description": "Set to true to bypass cache and fetch fresh on-chain data"
+                "symbol": {
+                  "type": "string",
+                  "description": "Token symbol"
                 },
-                "network": {
-                  "$ref": "#/definitions/query_toolkit/anyOf/0/anyOf/4/properties/network",
-                  "description": "Network entrypoint: Specifies which network the operation occurs on"
+                "type": {
+                  "type": "string",
+                  "description": "Token type"
                 }
               },
-              "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[] }"
+              "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"
             },
-            {
+            "name_or_address": {
+              "type": "string",
+              "description": "Account name or address. Use empty string '' for the default account. Defaults to '' if omitted."
+            },
+            "balance": {
+              "type": "boolean",
+              "description": "Set to true to query total balance amount for the token type"
+            },
+            "coin": {
               "type": "object",
               "properties": {
-                "query_type": {
-                  "type": "string",
-                  "const": "onchain_received"
-                },
-                "name_or_address": {
-                  "anyOf": [
-                    {
-                      "type": "string",
-                      "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: '0x1234...' - uses address directly"
-                    },
-                    {
-                      "type": "object",
-                      "properties": {
-                        "name_or_address": {
-                          "$ref": "#/definitions/query_toolkit/anyOf/0/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."
-                    }
-                  ],
-                  "description": "Name or address of the object that received payments/items - can be a string (name/address) or full object"
-                },
-                "type": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "string",
-                      "const": "CoinWrapper"
-                    },
-                    {
-                      "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"
+                  "description": "Pagination cursor for listing coin objects"
                 },
                 "limit": {
                   "type": [
                     "number",
                     "null"
                   ],
-                  "description": "Max records per page"
+                  "description": "Max coin objects per page"
+                }
+              },
+              "additionalProperties": false,
+              "description": "Set to query paginated coin objects instead of balance. Use cursor/limit for pagination."
+            },
+            "token_type": {
+              "type": "string",
+              "description": "Token type to query; defaults to 0x2::wow::WOW (platform token)"
+            },
+            "network": {
+              "type": "string",
+              "enum": [
+                "localnet",
+                "testnet",
+                "mainnet"
+              ],
+              "description": "Network entrypoint: Specifies which network the operation occurs on"
+            }
+          },
+          "required": [
+            "query_type"
+          ],
+          "additionalProperties": false,
+          "description": "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? }"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "local_names"
+            },
+            "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": {
+              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/name_or_address",
+              "description": "Account name or ID to query. Use empty string '' for the default account."
+            },
+            "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"
+            }
+          },
+          "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": {
+                "$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"
+            }
+          },
+          "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": [
+                {
+                  "type": "string",
+                  "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: '0x1234...' - uses address directly"
                 },
-                "no_cache": {
-                  "type": "boolean",
-                  "description": "Set to true to bypass cache and fetch fresh on-chain data"
+                {
+                  "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."
+                }
+              ],
+              "description": "Name or address of the object that received payments/items - can be a string (name/address) or full object"
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "type": "string"
                 },
-                "network": {
-                  "$ref": "#/definitions/query_toolkit/anyOf/0/anyOf/4/properties/network",
-                  "description": "Network entrypoint: Specifies which network the operation occurs on"
+                {
+                  "type": "string",
+                  "const": "CoinWrapper"
+                },
+                {
+                  "type": "null"
                 }
-              },
-              "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[]"
+              "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"
             }
-          ]
+          },
+          "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[]"
         }
       ]
     }