@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/schemas/onchain_operations_permission.schema.json

@@ -2,26 +2,13 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://wowok.net/schemas/onchain_operations_permission.json",
   "title": "Permission Operation",
-  "description": "On-chain permission operation schema",
+  "description": "🔐 Permission Object: Define who can perform which operations on WoWok objects. Important Note: If needed, you should first query 'guard instructions' through the 'wowok_buildin_info' tool.",
   "type": "object",
   "properties": {
     "operation_type": {
+      "type": "string",
       "const": "permission"
     },
-    "data": {
-      "$ref": "#/definitions/data",
-      "$schema": "http://json-schema.org/draft-07/schema#"
-    },
-    "env": {
-      "$ref": "#/definitions/env",
-      "$schema": "http://json-schema.org/draft-07/schema#"
-    }
-  },
-  "required": [
-    "operation_type",
-    "data"
-  ],
-  "definitions": {
     "data": {
       "type": "object",
       "properties": {
@@ -35,23 +22,23 @@
               "type": "object",
               "properties": {
                 "name": {
-                  "type": "string",
-                  "description": "The name of the object"
+                  "description": "The name of the object",
+                  "type": "string"
                 },
                 "tags": {
+                  "description": "The tags of the object",
                   "type": "array",
                   "items": {
                     "type": "string"
-                  },
-                  "description": "The tags of the object"
+                  }
                 },
                 "onChain": {
-                  "type": "boolean",
-                  "description": "CRITICAL: Whether to sync the name to the blockchain. DEFAULT (undefined/false): The name is stored LOCALLY ONLY on your device (PRIVATE). If set to true: The name is published ON-CHAIN and becomes PUBLICLY VISIBLE to everyone. Only set to true for displaying the relationships you are willing to make public on the chain."
+                  "description": "CRITICAL: Whether to sync the name to the blockchain. DEFAULT (undefined/false): The name is stored LOCALLY ONLY on your device (PRIVATE). If set to true: The name is published ON-CHAIN and becomes PUBLICLY VISIBLE to everyone. Only set to true for displaying the relationships you are willing to make public on the chain.",
+                  "type": "boolean"
                 },
                 "replaceExistName": {
-                  "type": "boolean",
-                  "description": "FORCE CLAIM: Set to true ONLY when the user explicitly expresses a STRONG INTENTION to forcefully take over an existing name (e.g., 'I must use this name', 'force rename', 'replace the existing one'). WARNING: This will UNBIND the name from its original object and rebind it to the new one, potentially breaking existing references. If not specified or false: the operation will FAIL with an error when the name is already in use (safe default behavior)."
+                  "description": "FORCE CLAIM: Set to true ONLY when the user explicitly expresses a STRONG INTENTION to forcefully take over an existing name (e.g., 'I must use this name', 'force rename', 'replace the existing one'). WARNING: This will UNBIND the name from its original object and rebind it to the new one, potentially breaking existing references. If not specified or false: the operation will FAIL with an error when the name is already in use (safe default behavior).",
+                  "type": "boolean"
                 }
               },
               "additionalProperties": false,
@@ -65,7 +52,7 @@
           "description": "Description string (max 4000 bcs characters)"
         },
         "remark": {
-          "anyOf": [
+          "oneOf": [
             {
               "type": "object",
               "properties": {
@@ -75,6 +62,8 @@
                 },
                 "index": {
                   "type": "integer",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991,
                   "description": "Permission index type"
                 },
                 "remark": {
@@ -98,7 +87,10 @@
                   "const": "remove"
                 },
                 "index": {
-                  "$ref": "#/definitions/data/properties/remark/anyOf/0/properties/index"
+                  "type": "integer",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991,
+                  "description": "Permission index type"
                 }
               },
               "required": [
@@ -126,7 +118,8 @@
           "description": "Set remarks for permissions."
         },
         "table": {
-          "anyOf": [
+          "description": "Manage permission assignments using two approaches: (1) By Permission Index - add/set/remove entity IDs for a specific permission; (2) By Entity - add/set/remove permission indexes for a specific entity. Requires admin permission.",
+          "oneOf": [
             {
               "type": "object",
               "properties": {
@@ -135,7 +128,10 @@
                   "const": "add perm by index"
                 },
                 "index": {
-                  "$ref": "#/definitions/data/properties/remark/anyOf/0/properties/index"
+                  "type": "integer",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991,
+                  "description": "Permission index type"
                 },
                 "entity": {
                   "type": "object",
@@ -146,12 +142,12 @@
                         "type": "object",
                         "properties": {
                           "name_or_address": {
-                            "$ref": "#/definitions/data/properties/object/anyOf/0",
+                            "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": {
-                            "type": "boolean",
-                            "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks"
+                            "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                            "type": "boolean"
                           }
                         },
                         "additionalProperties": false,
@@ -159,8 +155,8 @@
                       }
                     },
                     "check_all_founded": {
-                      "type": "boolean",
-                      "description": "Whether to check all entities are found, if true, all entities must be found (abort and throw exception if any ID not found); if false, only return found IDs"
+                      "description": "Whether to check all entities are found, if true, all entities must be found (abort and throw exception if any ID not found); if false, only return found IDs",
+                      "type": "boolean"
                     }
                   },
                   "required": [
@@ -186,10 +182,42 @@
                   "const": "set perm by index"
                 },
                 "index": {
-                  "$ref": "#/definitions/data/properties/remark/anyOf/0/properties/index"
+                  "type": "integer",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991,
+                  "description": "Permission index type"
                 },
                 "entity": {
-                  "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity"
+                  "type": "object",
+                  "properties": {
+                    "entities": {
+                      "type": "array",
+                      "items": {
+                        "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."
+                      }
+                    },
+                    "check_all_founded": {
+                      "description": "Whether to check all entities are found, if true, all entities must be found (abort and throw exception if any ID not found); if false, only return found IDs",
+                      "type": "boolean"
+                    }
+                  },
+                  "required": [
+                    "entities"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Used to batch find account or object IDs by name"
                 }
               },
               "required": [
@@ -208,10 +236,42 @@
                   "const": "remove perm by index"
                 },
                 "index": {
-                  "$ref": "#/definitions/data/properties/remark/anyOf/0/properties/index"
+                  "type": "integer",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991,
+                  "description": "Permission index type"
                 },
                 "entity": {
-                  "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity"
+                  "type": "object",
+                  "properties": {
+                    "entities": {
+                      "type": "array",
+                      "items": {
+                        "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."
+                      }
+                    },
+                    "check_all_founded": {
+                      "description": "Whether to check all entities are found, if true, all entities must be found (abort and throw exception if any ID not found); if false, only return found IDs",
+                      "type": "boolean"
+                    }
+                  },
+                  "required": [
+                    "entities"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Used to batch find account or object IDs by name"
                 }
               },
               "required": [
@@ -230,12 +290,27 @@
                   "const": "add perm by entity"
                 },
                 "entity": {
-                  "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity/properties/entities/items"
+                  "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."
                 },
                 "index": {
                   "type": "array",
                   "items": {
-                    "$ref": "#/definitions/data/properties/remark/anyOf/0/properties/index"
+                    "type": "integer",
+                    "minimum": -9007199254740991,
+                    "maximum": 9007199254740991,
+                    "description": "Permission index type"
                   }
                 }
               },
@@ -255,12 +330,27 @@
                   "const": "set perm by entity"
                 },
                 "entity": {
-                  "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity/properties/entities/items"
+                  "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."
                 },
                 "index": {
                   "type": "array",
                   "items": {
-                    "$ref": "#/definitions/data/properties/remark/anyOf/0/properties/index"
+                    "type": "integer",
+                    "minimum": -9007199254740991,
+                    "maximum": 9007199254740991,
+                    "description": "Permission index type"
                   }
                 }
               },
@@ -280,12 +370,27 @@
                   "const": "remove perm by entity"
                 },
                 "entity": {
-                  "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity/properties/entities/items"
+                  "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."
                 },
                 "index": {
                   "type": "array",
                   "items": {
-                    "$ref": "#/definitions/data/properties/remark/anyOf/0/properties/index"
+                    "type": "integer",
+                    "minimum": -9007199254740991,
+                    "maximum": 9007199254740991,
+                    "description": "Permission index type"
                   }
                 }
               },
@@ -297,11 +402,11 @@
               "additionalProperties": false,
               "description": "Revoke multiple permissions from a single entity. USE WHEN: You need to remove MANY permissions from ONE user/Guard at once. Example: Remove all Machine-related permissions from Alice."
             }
-          ],
-          "description": "Manage permission assignments using two approaches: (1) By Permission Index - add/set/remove entity IDs for a specific permission; (2) By Entity - add/set/remove permission indexes for a specific entity. Requires admin permission."
+          ]
         },
         "entity": {
-          "anyOf": [
+          "description": "Advanced entity permission operations: swap permissions between two entities, replace one entity's permissions with another's, copy permissions from one entity to another, or delete all permissions of an entity. Entity can be a user ID or Guard object ID. Requires admin permission.",
+          "oneOf": [
             {
               "type": "object",
               "properties": {
@@ -310,10 +415,34 @@
                   "const": "swap"
                 },
                 "entity1": {
-                  "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity/properties/entities/items"
+                  "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."
                 },
                 "entity2": {
-                  "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity/properties/entities/items"
+                  "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."
                 }
               },
               "required": [
@@ -332,10 +461,34 @@
                   "const": "replace"
                 },
                 "entity1": {
-                  "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity/properties/entities/items"
+                  "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."
                 },
                 "entity2": {
-                  "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity/properties/entities/items"
+                  "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."
                 }
               },
               "required": [
@@ -354,10 +507,34 @@
                   "const": "copy"
                 },
                 "entity1": {
-                  "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity/properties/entities/items"
+                  "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."
                 },
                 "entity2": {
-                  "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity/properties/entities/items"
+                  "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."
                 }
               },
               "required": [
@@ -376,7 +553,19 @@
                   "const": "del"
                 },
                 "entity": {
-                  "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity/properties/entities/items"
+                  "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."
                 }
               },
               "required": [
@@ -386,10 +575,10 @@
               "additionalProperties": false,
               "description": "Delete all permission indexes from an entity."
             }
-          ],
-          "description": "Advanced entity permission operations: swap permissions between two entities, replace one entity's permissions with another's, copy permissions from one entity to another, or delete all permissions of an entity. Entity can be a user ID or Guard object ID. Requires admin permission."
+          ]
         },
         "admin": {
+          "description": "Manage Permission object admins: add new admins, remove existing admins, or set the complete admin list. Only the Permission object owner (builder) can perform this operation. The creator automatically becomes an admin with full permissions.",
           "type": "object",
           "properties": {
             "op": {
@@ -405,10 +594,26 @@
               "type": "object",
               "properties": {
                 "entities": {
-                  "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity/properties/entities"
+                  "type": "array",
+                  "items": {
+                    "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."
+                  }
                 },
                 "check_all_founded": {
-                  "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity/properties/check_all_founded"
+                  "description": "Whether to check all entities are found, if true, all entities must be found (abort and throw exception if any ID not found); if false, only return found IDs",
+                  "type": "boolean"
                 }
               },
               "required": [
@@ -422,21 +627,33 @@
             "op",
             "addresses"
           ],
-          "additionalProperties": false,
-          "description": "Manage Permission object admins: add new admins, remove existing admins, or set the complete admin list. Only the Permission object owner (builder) can perform this operation. The creator automatically becomes an admin with full permissions."
+          "additionalProperties": false
         },
         "apply": {
+          "description": "Array of object IDs or names to operate on, apply the Permission object to these objects' permission control. Note: The signer must be the owner of the existing Permission objects for these objects",
           "type": "array",
           "items": {
-            "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity/properties/entities/items/properties/name_or_address"
-          },
-          "description": "Array of object IDs or names to operate on, apply the Permission object to these objects' permission control. Note: The signer must be the owner of the existing Permission objects for these objects"
+            "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)."
+          }
         },
         "builder": {
-          "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity/properties/entities/items",
-          "description": "Set or transfer ownership of the Permission object to the specified user ID. The creator automatically becomes the builder; only the builder can transfer ownership to other users."
+          "description": "Set or transfer ownership of the Permission object to the specified user ID. The creator automatically becomes the builder; only the builder can transfer ownership to other users.",
+          "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
         },
         "owner_receive": {
+          "description": "Unwrap CoinWrapper objects and other objects received by this Permission object and send them to the builder(owner).\n\nACCEPTED FORMATS (F-06 unified receive operation block):\n• 'recently' (string literal) — auto-query and receive ALL recently received objects.\n  Use this for the common case: \"withdraw everything the object has received.\"\n  Example: receive: 'recently'\n• ReceivedNormal[] (array) — explicit list of received objects to unwrap.\n  Use this when you want to receive specific objects only (not all).\n  Example: receive: [{id: '0xobj1', type: '0x2::coin::Coin<0x2::sui::SUI>'}]\n• ReceivedBalance ({token_type, balance, received: [{id, balance, payment}]}) —\n  receive a balance record from a specific Payment/payer.\n  Use this for precise balance targeting (advanced — usually after querying\n  the object's received history via query_received).\n  Example: receive: {token_type: '0x2::sui::SUI', balance: 1000000, received: [{id: '0xrec1', balance: 1000000, payment: '0xpay1'}]}\nANTI-PATTERN: do NOT wrap in {result: ...} — pass the value directly.",
           "anyOf": [
             {
               "type": "array",
@@ -469,9 +686,13 @@
               "type": "object",
               "properties": {
                 "balance": {
-                  "type": [
-                    "number",
-                    "string"
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "string"
+                    }
                   ],
                   "description": "A coin/balance amount. Accepts three formats: (1) DISPLAY FORMAT with token symbol: \"2.5WOW\", \"10USDC\", \"0.05SUI\" — auto-converted to smallest units via the Fund Processing Layer (token precision resolved from official registry → cache → on-chain). The symbol MUST match the token's type_parameter. (2) SMALLEST UNIT (numeric string): \"10000000000\" — used as-is, no conversion. (3) SMALLEST UNIT (number): 10000000000 — used as-is (loses precision above 2^53). PRECISION RULE: for values exceeding 2^53, ALWAYS use format (1) or (2) — JS numbers lose precision. Default token: WOW (9 decimals, 1 WOW = 10^9 MIST). For custom tokens: use display format with the token's symbol, or pass smallest units directly. MONEY CONFIRMATION: all monetary fields trigger user confirmation via the Fund Processing Layer. If multiple tokens share a symbol (ambiguity), specify the full type string in type_parameter. Examples: \"2.5WOW\" (display → 2500000000), 10000000000 (number, smallest unit), \"50000000000\" (string, smallest unit). Used for: Service.sale.price, Service.compensation_fund_add balance, Treasury.deposit, Arbitration.fee, Reward.amount, stock quantities."
                 },
@@ -489,7 +710,15 @@
                         "description": "Received CoinWrapper object ID"
                       },
                       "balance": {
-                        "$ref": "#/definitions/data/properties/owner_receive/anyOf/1/properties/balance"
+                        "anyOf": [
+                          {
+                            "type": "number"
+                          },
+                          {
+                            "type": "string"
+                          }
+                        ],
+                        "description": "A coin/balance amount. Accepts three formats: (1) DISPLAY FORMAT with token symbol: \"2.5WOW\", \"10USDC\", \"0.05SUI\" — auto-converted to smallest units via the Fund Processing Layer (token precision resolved from official registry → cache → on-chain). The symbol MUST match the token's type_parameter. (2) SMALLEST UNIT (numeric string): \"10000000000\" — used as-is, no conversion. (3) SMALLEST UNIT (number): 10000000000 — used as-is (loses precision above 2^53). PRECISION RULE: for values exceeding 2^53, ALWAYS use format (1) or (2) — JS numbers lose precision. Default token: WOW (9 decimals, 1 WOW = 10^9 MIST). For custom tokens: use display format with the token's symbol, or pass smallest units directly. MONEY CONFIRMATION: all monetary fields trigger user confirmation via the Fund Processing Layer. If multiple tokens share a symbol (ambiguity), specify the full type string in type_parameter. Examples: \"2.5WOW\" (display → 2500000000), 10000000000 (number, smallest unit), \"50000000000\" (string, smallest unit). Used for: Service.sale.price, Service.compensation_fund_add balance, Treasury.deposit, Arbitration.fee, Reward.amount, stock quantities."
                       },
                       "payment": {
                         "type": "string",
@@ -519,19 +748,19 @@
               "type": "string",
               "const": "recently"
             }
-          ],
-          "description": "Unwrap CoinWrapper objects and other objects received by this Permission object and send them to the builder(owner).\n\nACCEPTED FORMATS (F-06 unified receive operation block):\n• 'recently' (string literal) — auto-query and receive ALL recently received objects.\n  Use this for the common case: \"withdraw everything the object has received.\"\n  Example: receive: 'recently'\n• ReceivedNormal[] (array) — explicit list of received objects to unwrap.\n  Use this when you want to receive specific objects only (not all).\n  Example: receive: [{id: '0xobj1', type: '0x2::coin::Coin<0x2::sui::SUI>'}]\n• ReceivedBalance ({token_type, balance, received: [{id, balance, payment}]}) —\n  receive a balance record from a specific Payment/payer.\n  Use this for precise balance targeting (advanced — usually after querying\n  the object's received history via query_received).\n  Example: receive: {token_type: '0x2::sui::SUI', balance: 1000000, received: [{id: '0xrec1', balance: 1000000, payment: '0xpay1'}]}\nANTI-PATTERN: do NOT wrap in {result: ...} — pass the value directly."
+          ]
         },
         "um": {
+          "description": "Contact object ID or name.",
           "anyOf": [
             {
-              "$ref": "#/definitions/data/properties/table/anyOf/0/properties/entity/properties/entities/items/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)."
             },
             {
               "type": "null"
             }
-          ],
-          "description": "Contact object ID or name."
+          ]
         }
       },
       "additionalProperties": false,
@@ -541,20 +770,20 @@
       "type": "object",
       "properties": {
         "account": {
+          "default": "",
           "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).",
-          "default": ""
+          "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)."
         },
         "permission_guard": {
+          "description": "List of permission guard IDs. Used to extend additional operation permissions (requires verification and configuration in the Permission object).",
           "type": "array",
           "items": {
             "type": "string"
-          },
-          "description": "List of permission guard IDs. Used to extend additional operation permissions (requires verification and configuration in the Permission object)."
+          }
         },
         "no_cache": {
-          "type": "boolean",
-          "description": "Whether to disable caching."
+          "description": "Whether to disable caching.",
+          "type": "boolean"
         },
         "network": {
           "type": "string",
@@ -566,40 +795,49 @@
           "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."
         },
         "referrer": {
-          "$ref": "#/definitions/env/properties/account",
-          "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded."
+          "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded.",
+          "type": "string"
         },
         "confirmed": {
-          "type": "boolean",
-          "description": "Phase 2 ConfirmGate: set to true to proceed after a 'pending_confirmation' result. The operation is NOT executed until you re-call with confirmed=true after user consent."
+          "description": "Phase 2 ConfirmGate: set to true to proceed after a 'pending_confirmation' result. The operation is NOT executed until you re-call with confirmed=true after user consent.",
+          "type": "boolean"
         },
         "user_intent_phrases": {
+          "description": "Phase 2 ConfirmGate: explicit user intent phrases collected from conversation context (e.g. 'use default account', 'force publish'). Used to bypass confirmation rules whose bypass_on_explicit_intent matches.",
           "type": "array",
           "items": {
             "type": "string"
-          },
-          "description": "Phase 2 ConfirmGate: explicit user intent phrases collected from conversation context (e.g. 'use default account', 'force publish'). Used to bypass confirmation rules whose bypass_on_explicit_intent matches."
+          }
         },
         "project": {
-          "type": "string",
-          "description": "Project prefix to assign this object to (e.g. 'myshop'). When set: 1) the object is tagged with 'project:<prefix>' on-chain automatically via ProjectService, 2) the newly created object is auto-associated to the SQLite project for local management, evaluation, and graph tracking. The project MUST exist (create via project_operation action='create_project' first). Use project_operation to manage projects."
+          "description": "Project prefix to assign this object to (e.g. 'myshop'). When set: 1) the object is tagged with 'project:<prefix>' on-chain automatically via ProjectService, 2) the newly created object is auto-associated to the SQLite project for local management, evaluation, and graph tracking. The project MUST exist (create via project_operation action='create_project' first). Use project_operation to manage projects.",
+          "type": "string"
         },
         "client_schema_version": {
-          "type": "string",
-          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched.",
+          "type": "string"
         },
         "schema_strict_mode": {
-          "type": "boolean",
           "default": false,
-          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode).",
+          "type": "boolean"
         },
         "dry_run": {
-          "type": "boolean",
-          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
+          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
+          "type": "boolean"
         }
       },
+      "required": [
+        "account",
+        "schema_strict_mode"
+      ],
       "additionalProperties": false,
       "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
     }
-  }
+  },
+  "required": [
+    "operation_type",
+    "data"
+  ],
+  "additionalProperties": false
 }