@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/schemas/onchain_operations_reward.schema.json

@@ -2,30 +2,13 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://wowok.net/schemas/onchain_operations_reward.json",
   "title": "Reward Operation",
-  "description": "On-chain reward operation schema",
+  "description": "🎁 Reward Object: Create reward pools and set claim conditions by Guard verification.",
   "type": "object",
   "properties": {
     "operation_type": {
+      "type": "string",
       "const": "reward"
     },
-    "data": {
-      "$ref": "#/definitions/data",
-      "$schema": "http://json-schema.org/draft-07/schema#"
-    },
-    "env": {
-      "$ref": "#/definitions/env",
-      "$schema": "http://json-schema.org/draft-07/schema#"
-    },
-    "submission": {
-      "$ref": "#/definitions/submission",
-      "$schema": "http://json-schema.org/draft-07/schema#"
-    }
-  },
-  "required": [
-    "operation_type",
-    "data"
-  ],
-  "definitions": {
     "data": {
       "type": "object",
       "properties": {
@@ -39,48 +22,55 @@
               "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"
                 },
                 "permission": {
                   "anyOf": [
                     {
-                      "$ref": "#/definitions/data/properties/object/anyOf/0",
+                      "type": "string",
                       "description": "String format: Reference an EXISTING object by its name (local mark) or on-chain object ID. Example: 'my-object' or '0x1234...'"
                     },
                     {
                       "type": "object",
                       "properties": {
                         "name": {
-                          "$ref": "#/definitions/data/properties/object/anyOf/1/properties/name"
+                          "description": "The name of the object",
+                          "type": "string"
                         },
                         "tags": {
-                          "$ref": "#/definitions/data/properties/object/anyOf/1/properties/tags"
+                          "description": "The tags of the object",
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
                         },
                         "onChain": {
-                          "$ref": "#/definitions/data/properties/object/anyOf/1/properties/onChain"
+                          "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": {
-                          "$ref": "#/definitions/data/properties/object/anyOf/1/properties/replaceExistName"
+                          "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"
                         },
                         "description": {
-                          "type": "string",
-                          "description": "The description of the object"
+                          "description": "The description of the object",
+                          "type": "string"
                         }
                       },
                       "additionalProperties": false,
@@ -90,11 +80,14 @@
                   "description": "Two ways to specify an object: (1) STRING - Reference an EXISTING object by name or ID; (2) OBJECT - CREATE a NEW object with full configuration including optional name, tags, description, and visibility settings (local private by default, or public on-chain with onChain:true)."
                 },
                 "type_parameter": {
-                  "type": "string",
+                  "default": "0x2::wow::WOW",
                   "description": "Payment token type for this object (format: {address}::{module}::{struct}). e.g. '0x2::wow::WOW' (WOW, the default), '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). Defines which token this object accepts for payments. To discover all available tokens and their type tags, call wowok_buildin_info with info 'mainnet bridge tokens' and use the returned `wowTypeTag` value here.",
-                  "default": "0x2::wow::WOW"
+                  "type": "string"
                 }
               },
+              "required": [
+                "type_parameter"
+              ],
               "additionalProperties": false,
               "description": "Object format: CREATE a NEW object with COMPLETE configuration including: optional name, tags, description, token type for payments (e.g., '0x2::wow::WOW'), AND Permission-based access control. Use this for creating sophisticated objects with both payment token specification and permission management."
             }
@@ -102,22 +95,27 @@
           "description": "Two ways to specify an object: (1) STRING - Reference an EXISTING object by name or ID; (2) OBJECT - CREATE a NEW object with full configuration including name, tags, description, token type for payments, and Permission-based access control. The object format is used when you need both token specification AND permission management."
         },
         "claim": {
-          "$ref": "#/definitions/data/properties/object/anyOf/0",
-          "description": "Guard object ID. Used to verify Guard and start the reward distribution process corresponding to this Guard."
+          "description": "Guard object ID. Used to verify Guard and start the reward distribution process corresponding to this Guard.",
+          "type": "string"
         },
         "description": {
           "type": "string",
           "description": "Description string (max 4000 bcs characters)"
         },
         "coin_add": {
+          "description": "Add amount to Reward object.",
           "anyOf": [
             {
               "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."
                 }
@@ -141,16 +139,24 @@
               ],
               "additionalProperties": false
             }
-          ],
-          "description": "Add amount to Reward object."
+          ]
         },
         "receive": {
+          "description": "Unwrap CoinWrapper objects received by Reward object and store them in pending balance.\n\nACCEPTED FORMATS (F-06 unified receive operation block):\n• 'recently' (string literal) — auto-query and receive ALL recently received balance.\n  Use this for the common case: \"deposit all recently received coins into pending balance.\"\n  Example: receive: 'recently'\n• ReceivedBalance ({token_type, balance, received: [{id, balance, payment}]}) —\n  receive a specific balance record from a Payment/payer.\n  Use this when targeting a specific received balance (advanced).\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": "object",
               "properties": {
                 "balance": {
-                  "$ref": "#/definitions/data/properties/coin_add/anyOf/0/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."
                 },
                 "token_type": {
                   "type": "string",
@@ -166,7 +172,15 @@
                         "description": "Received CoinWrapper object ID"
                       },
                       "balance": {
-                        "$ref": "#/definitions/data/properties/coin_add/anyOf/0/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",
@@ -196,16 +210,16 @@
               "type": "string",
               "const": "recently"
             }
-          ],
-          "description": "Unwrap CoinWrapper objects received by Reward object and store them in pending balance.\n\nACCEPTED FORMATS (F-06 unified receive operation block):\n• 'recently' (string literal) — auto-query and receive ALL recently received balance.\n  Use this for the common case: \"deposit all recently received coins into pending balance.\"\n  Example: receive: 'recently'\n• ReceivedBalance ({token_type, balance, received: [{id, balance, payment}]}) —\n  receive a specific balance record from a Payment/payer.\n  Use this when targeting a specific received balance (advanced).\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."
+          ]
         },
         "guard_add": {
+          "description": "Add Guard to Reward object.",
           "type": "array",
           "items": {
             "type": "object",
             "properties": {
               "guard": {
-                "$ref": "#/definitions/data/properties/object/anyOf/0",
+                "type": "string",
                 "description": "Guard object ID or name."
               },
               "recipient": {
@@ -233,12 +247,12 @@
                         "type": "object",
                         "properties": {
                           "name_or_address": {
-                            "$ref": "#/definitions/data/properties/claim",
+                            "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,
@@ -269,7 +283,7 @@
                 "description": "Recipient ID. Three forms:\n  - {GuardIdentifier: u8}  — DYNAMIC address resolved from Passport at alloc() time\n  - {Entity: {name_or_address: 'mark_name'}}  — FIXED static address via LocalMark (recommended)\n  - {Signer: 'signer'}  — transaction sender at alloc() time (e.g. self-refund; customer must call alloc_by_guard themselves)"
               },
               "amount": {
-                "anyOf": [
+                "oneOf": [
                   {
                     "type": "object",
                     "properties": {
@@ -278,7 +292,10 @@
                         "const": "GuardU64Identifier"
                       },
                       "value": {
-                        "$ref": "#/definitions/data/properties/guard_add/items/properties/recipient/anyOf/0/properties/GuardIdentifier"
+                        "type": "integer",
+                        "minimum": 0,
+                        "maximum": 255,
+                        "description": "Identifier (0-255) for data lookup in Guard table."
                       }
                     },
                     "required": [
@@ -296,7 +313,15 @@
                         "const": "Fixed"
                       },
                       "value": {
-                        "$ref": "#/definitions/data/properties/coin_add/anyOf/0/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."
                       }
                     },
                     "required": [
@@ -310,19 +335,22 @@
                 "description": "Reward amount"
               },
               "expiration_time": {
-                "type": "number",
-                "description": "Reward Guard expiration time. If set, the reward cannot be claimed by this guard after the expiration time. If not specified, Reward Guard is permanently valid."
+                "description": "Reward Guard expiration time. If set, the reward cannot be claimed by this guard after the expiration time. If not specified, Reward Guard is permanently valid.",
+                "type": "number"
               },
               "store_from_id": {
+                "description": "Guard table data index for record storage. The value at this index (address or number, including submitted values) will be stored in the record for Guard verification purposes, such as controlling operation frequency.",
                 "anyOf": [
                   {
-                    "$ref": "#/definitions/data/properties/guard_add/items/properties/recipient/anyOf/0/properties/GuardIdentifier"
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 255,
+                    "description": "Identifier (0-255) for data lookup in Guard table."
                   },
                   {
                     "type": "null"
                   }
-                ],
-                "description": "Guard table data index for record storage. The value at this index (address or number, including submitted values) will be stored in the record for Guard verification purposes, such as controlling operation frequency."
+                ]
               }
             },
             "required": [
@@ -332,26 +360,27 @@
             ],
             "additionalProperties": false,
             "description": "Reward Guard type"
-          },
-          "description": "Add Guard to Reward object."
+          }
         },
         "guard_remove_expired": {
-          "type": "boolean",
-          "description": "Whether to remove expired Guard."
+          "description": "Whether to remove expired Guard.",
+          "type": "boolean"
         },
         "guard_expiration_time": {
+          "description": "Add expiration time(ms). Before this time expires, new Guard and fund allocation rules cannot be added.",
           "anyOf": [
             {
               "type": "integer",
-              "minimum": 1
+              "minimum": 1,
+              "maximum": 9007199254740991
             },
             {
               "type": "null"
             }
-          ],
-          "description": "Add expiration time(ms). Before this time expires, new Guard and fund allocation rules cannot be added."
+          ]
         },
         "owner_receive": {
+          "description": "Unwrap CoinWrapper objects and other objects received by this Reward object and send them to the owner of its Permission object.\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",
@@ -381,25 +410,84 @@
               }
             },
             {
-              "$ref": "#/definitions/data/properties/receive/anyOf/0"
+              "type": "object",
+              "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."
+                },
+                "token_type": {
+                  "type": "string",
+                  "description": "Asset type of Coin objects. Supports CoinWrapper<...> format for order receive operations."
+                },
+                "received": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "description": "Received CoinWrapper object ID"
+                      },
+                      "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",
+                        "description": "Payment object ID"
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "balance",
+                      "payment"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Received CoinWrapper object record"
+                  },
+                  "description": "Received records of Coin objects"
+                }
+              },
+              "required": [
+                "balance",
+                "token_type",
+                "received"
+              ],
+              "additionalProperties": false,
+              "description": "Received record of Coin objects"
             },
             {
               "type": "string",
               "const": "recently"
             }
-          ],
-          "description": "Unwrap CoinWrapper objects and other objects received by this Reward object and send them to the owner of its Permission object.\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/claim"
+              "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."
+          ]
         }
       },
       "required": [
@@ -412,20 +500,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",
@@ -437,38 +525,42 @@
           "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."
     },
@@ -481,6 +573,7 @@
           "description": "Discriminator for this result variant. Constraint: always 'submission'. Example: 'submission'"
         },
         "guard": {
+          "maxItems": 20,
           "type": "array",
           "items": {
             "type": "object",
@@ -500,7 +593,6 @@
             ],
             "additionalProperties": false
           },
-          "maxItems": 20,
           "description": "Array of Guard objects to verify. Constraint: at most 20 entries (MAX_GUARD_COUNT_PASSPORT). Relation: each entry corresponds to a Guard bound to the operation."
         },
         "submission": {
@@ -509,7 +601,7 @@
             "type": "object",
             "properties": {
               "guard": {
-                "$ref": "#/definitions/submission/properties/guard/items/properties/object",
+                "type": "string",
                 "description": "Guard object name or ID that requires submission data. Example: 'my-delivery-guard'"
               },
               "submission": {
@@ -818,6 +910,7 @@
                       "description": "Type of the value stored in `value`. One of: Bool(0), Address(1), String(2), U8(3), U16(4), U32(5), U64(6), U128(7), U256(8), VecBool(9), VecAddress(10), VecString(11), VecU8(12), VecU16(13), VecU32(14), VecU64(15), VecU128(16), VecU256(17), VecVecU8(18). When value_type=Address (1), the `value` field accepts a hex address string, a LocalMark name, or an AccountOrMark_Address object — see `value` field description for details."
                     },
                     "value": {
+                      "description": "The actual value data. Format depends on `value_type`:\n• Bool: true/false (boolean)\n• Address (CRITICAL — string 'Address' is NOT a placeholder): a hex address (e.g. '0x1234...'), a LocalMark name (e.g. 'my-service' — resolved to address at evaluation time), an AccountOrMark_Address object (e.g. {name_or_address:'my-service'}), or system shorthand ('0xaaa' = EntityLinker, '0xaab' = EntityRegistrar). The literal string 'Address' itself is INVALID — it would be treated as a non-existent LocalMark name and fail. Example: value='0x2::wow::WOW<address>' or value='my-permission'.\n• String: any string\n• U8/U16/U32/U64/U128/U256: number or numeric string (e.g. 42 or '42')\n• Vec* types: arrays of the corresponding element type\nREQUIRED when b_submission=false. OPTIONAL when b_submission=true (value is supplied at evaluation time by user submission).",
                       "anyOf": [
                         {
                           "type": "boolean"
@@ -828,12 +921,12 @@
                               "type": "object",
                               "properties": {
                                 "name_or_address": {
-                                  "$ref": "#/definitions/submission/properties/guard/items/properties/object",
+                                  "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,
@@ -864,12 +957,24 @@
                                 "entities": {
                                   "type": "array",
                                   "items": {
-                                    "$ref": "#/definitions/submission/properties/submission/items/properties/submission/items/properties/value/anyOf/1/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)."
+                                      },
+                                      "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": {
-                                  "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": [
@@ -907,15 +1012,15 @@
                             }
                           }
                         }
-                      ],
-                      "description": "The actual value data. Format depends on `value_type`:\n• Bool: true/false (boolean)\n• Address (CRITICAL — string 'Address' is NOT a placeholder): a hex address (e.g. '0x1234...'), a LocalMark name (e.g. 'my-service' — resolved to address at evaluation time), an AccountOrMark_Address object (e.g. {name_or_address:'my-service'}), or system shorthand ('0xaaa' = EntityLinker, '0xaab' = EntityRegistrar). The literal string 'Address' itself is INVALID — it would be treated as a non-existent LocalMark name and fail. Example: value='0x2::wow::WOW<address>' or value='my-permission'.\n• String: any string\n• U8/U16/U32/U64/U128/U256: number or numeric string (e.g. 42 or '42')\n• Vec* types: arrays of the corresponding element type\nREQUIRED when b_submission=false. OPTIONAL when b_submission=true (value is supplied at evaluation time by user submission)."
+                      ]
                     },
                     "name": {
-                      "type": "string",
                       "default": "",
-                      "description": "Data name identifier. MAX 64 BCS characters (Chinese chars count as 3-4 BCS bytes each). Use short identifiers like 'order_id', 'delivery_node'. Put longer descriptions in the Guard's 'description' field, NOT here."
+                      "description": "Data name identifier. MAX 64 BCS characters (Chinese chars count as 3-4 BCS bytes each). Use short identifiers like 'order_id', 'delivery_node'. Put longer descriptions in the Guard's 'description' field, NOT here.",
+                      "type": "string"
                     },
                     "object_type": {
+                      "description": "OUTPUT-ONLY (query side): Object type when value_type is Address and represents a specific object. Auto-derived by the system — DO NOT set this field at Guard creation.",
                       "type": "string",
                       "enum": [
                         "Permission",
@@ -950,14 +1055,14 @@
                         "TableItem_EntityLinker",
                         "TableItem_AddressMark",
                         "TableItem_EntityRegistrar"
-                      ],
-                      "description": "OUTPUT-ONLY (query side): Object type when value_type is Address and represents a specific object. Auto-derived by the system — DO NOT set this field at Guard creation."
+                      ]
                     }
                   },
                   "required": [
                     "identifier",
                     "b_submission",
-                    "value_type"
+                    "value_type",
+                    "name"
                   ],
                   "additionalProperties": false,
                   "description": "Guard table item (QUERY/OUTPUT form — includes auto-derived object_type field)"
@@ -983,5 +1088,10 @@
       "additionalProperties": false,
       "description": "Guard verification required. The operation was blocked because one or more Guards require user-submitted data. Fill the submission array and resubmit. Semantic status is 'pending_input'."
     }
-  }
+  },
+  "required": [
+    "operation_type",
+    "data"
+  ],
+  "additionalProperties": false
 }