@wowok/agent-mcp 2.4.3 → 2.5.0

package/dist/schemas/onchain_operations_guard.schema.json

@@ -13,8 +13,87 @@
       "description": "On-chain Guard creation. IMPORTANT: All defined data (include all submitted data) must be defined in the 'table' field. USAGE: Set 'namedNew' field with {name, tags?, onChain?} to name the new Guard. The Guard is immutable once created. Define the validation logic in 'root' field. When root.type='file', the file can contain all Guard fields, and any fields defined in the schema will OVERRIDE the file content.",
       "properties": {
         "namedNew": {
+          "$ref": "#/definitions/guard_namedNew",
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "description": {
+          "$ref": "#/definitions/guard_description",
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "table": {
+          "$ref": "#/definitions/guard_table",
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "root": {
+          "description": "Root definition: either a direct GuardNode computation tree (no type wrapper) or a file reference (type='file'). When type='file', the file can define all Guard fields (namedNew, description, table, root, rely), and schema fields override file content. For the node structure, see guard-node-schema.json for complete GuardNode definitions. IMPORTANT: The root node MUST be a logical operation returning Bool (e.g., logic_and, logic_or, logic_equal, query_reward_record_exists, etc.)",
+          "oneOf": [
+            {
+              "$ref": "guard-node-schema.json",
+              "description": "Direct GuardNode computation tree - the node MUST be a logical operation returning Bool (e.g., logic_and, logic_or, logic_equal, query_reward_record_exists, etc.). No 'type: node' wrapper needed."
+            },
+            {
+              "type": "object",
+              "description": "File reference",
+              "properties": {
+                "type": {
+                  "const": "file"
+                },
+                "file_path": {
+                  "type": "string",
+                  "description": "Path to JSON or Markdown file containing Guard definition"
+                },
+                "format": {
+                  "type": "string",
+                  "enum": [
+                    "json",
+                    "markdown"
+                  ],
+                  "default": "json",
+                  "description": "File format: 'json' or 'markdown'"
+                }
+              },
+              "required": [
+                "type",
+                "file_path"
+              ]
+            }
+          ]
+        },
+        "rely": {
+          "$ref": "#/definitions/guard_rely",
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "binding_hint": {
+          "$ref": "#/definitions/guard_binding_hint",
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        }
+      },
+      "required": [
+        "root"
+      ],
+      "additionalProperties": false
+    },
+    "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": {
+    "guard_namedNew": {
+      "anyOf": [
+        {
+          "not": {}
+        },
+        {
           "type": "object",
-          "description": "Name and optional tags for the new Guard object. Set 'onChain: true' to create a public on-chain identity. When using root.type='file', this field OVERRIDES namedNew in the file.",
           "properties": {
             "name": {
               "type": "string",
@@ -29,22 +108,38 @@
             },
             "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."
+              "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."
             },
             "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."
+              "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)."
             }
           },
-          "additionalProperties": false
+          "additionalProperties": false,
+          "description": "Assign a name and optional tags to a new object. By default, names are stored LOCALLY (private) on your device. Set 'onChain: true' to create a PUBLIC on-chain identity visible to everyone. IMPORTANT: If the requested name is already taken, the operation will FAIL by default. Only set 'replaceExistName: true' when the user EXPLICITLY demands to forcefully claim the name."
+        }
+      ],
+      "description": "Name and optional tags for the new Guard object. Set 'onChain: true' to create a public on-chain identity. When using root.type='file', this field OVERRIDES namedNew in the file."
+    },
+    "guard_description": {
+      "anyOf": [
+        {
+          "not": {}
         },
-        "description": {
+        {
           "type": "string",
-          "description": "Guard description. When using root.type='file', this field OVERRIDES description in the file."
+          "description": "Description string (max 4000 bcs characters)"
+        }
+      ],
+      "description": "Guard description. When using root.type='file', this field OVERRIDES description in the file."
+    },
+    "guard_table": {
+      "anyOf": [
+        {
+          "not": {}
         },
-        "table": {
+        {
           "type": "array",
-          "description": "Data table of the Guard object. When using root.type='file', this field OVERRIDES table in the file.",
           "items": {
             "type": "object",
             "properties": {
@@ -52,21 +147,398 @@
                 "type": "integer",
                 "minimum": 0,
                 "maximum": 255,
-                "description": "Identifier index (0-255) for referencing this value in Guard nodes"
+                "description": "Identifier (0-255) for data lookup in Guard table."
               },
               "b_submission": {
                 "type": "boolean",
                 "description": "Whether user submission is required for this data"
               },
               "value_type": {
-                "type": "string",
-                "description": "Value type: Bool, Address, String, U8, U16, U32, U64, U128, U256, VecBool, VecAddress, VecString, VecU8, VecU16, VecU32, VecU64, VecU128, VecU256, VecVecU8"
+                "anyOf": [
+                  {
+                    "type": "number",
+                    "const": 0,
+                    "description": "Bool (0)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 1,
+                    "description": "Address (1)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 2,
+                    "description": "String (2)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 3,
+                    "description": "U8 (3)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 4,
+                    "description": "U16 (4)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 5,
+                    "description": "U32 (5)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 6,
+                    "description": "U64 (6)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 7,
+                    "description": "U128 (7)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 8,
+                    "description": "U256 (8)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 9,
+                    "description": "VecBool (9)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 10,
+                    "description": "VecAddress (10)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 11,
+                    "description": "VecString (11)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 12,
+                    "description": "VecU8 (12)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 13,
+                    "description": "VecU16 (13)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 14,
+                    "description": "VecU32 (14)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 15,
+                    "description": "VecU64 (15)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 16,
+                    "description": "VecU128 (16)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 17,
+                    "description": "VecU256 (17)"
+                  },
+                  {
+                    "type": "number",
+                    "const": 18,
+                    "description": "VecVecU8 (18)"
+                  },
+                  {
+                    "type": "string",
+                    "const": "Bool",
+                    "description": "Bool"
+                  },
+                  {
+                    "type": "string",
+                    "const": "Address",
+                    "description": "Address"
+                  },
+                  {
+                    "type": "string",
+                    "const": "String",
+                    "description": "String"
+                  },
+                  {
+                    "type": "string",
+                    "const": "U8",
+                    "description": "U8"
+                  },
+                  {
+                    "type": "string",
+                    "const": "U16",
+                    "description": "U16"
+                  },
+                  {
+                    "type": "string",
+                    "const": "U32",
+                    "description": "U32"
+                  },
+                  {
+                    "type": "string",
+                    "const": "U64",
+                    "description": "U64"
+                  },
+                  {
+                    "type": "string",
+                    "const": "U128",
+                    "description": "U128"
+                  },
+                  {
+                    "type": "string",
+                    "const": "U256",
+                    "description": "U256"
+                  },
+                  {
+                    "type": "string",
+                    "const": "VecBool",
+                    "description": "VecBool"
+                  },
+                  {
+                    "type": "string",
+                    "const": "VecAddress",
+                    "description": "VecAddress"
+                  },
+                  {
+                    "type": "string",
+                    "const": "VecString",
+                    "description": "VecString"
+                  },
+                  {
+                    "type": "string",
+                    "const": "VecU8",
+                    "description": "VecU8"
+                  },
+                  {
+                    "type": "string",
+                    "const": "VecU16",
+                    "description": "VecU16"
+                  },
+                  {
+                    "type": "string",
+                    "const": "VecU32",
+                    "description": "VecU32"
+                  },
+                  {
+                    "type": "string",
+                    "const": "VecU64",
+                    "description": "VecU64"
+                  },
+                  {
+                    "type": "string",
+                    "const": "VecU128",
+                    "description": "VecU128"
+                  },
+                  {
+                    "type": "string",
+                    "const": "VecU256",
+                    "description": "VecU256"
+                  },
+                  {
+                    "type": "string",
+                    "const": "VecVecU8",
+                    "description": "VecVecU8"
+                  },
+                  {
+                    "type": "string",
+                    "const": "bool",
+                    "description": "bool"
+                  },
+                  {
+                    "type": "string",
+                    "const": "address",
+                    "description": "address"
+                  },
+                  {
+                    "type": "string",
+                    "const": "string",
+                    "description": "string"
+                  },
+                  {
+                    "type": "string",
+                    "const": "u8",
+                    "description": "u8"
+                  },
+                  {
+                    "type": "string",
+                    "const": "u16",
+                    "description": "u16"
+                  },
+                  {
+                    "type": "string",
+                    "const": "u32",
+                    "description": "u32"
+                  },
+                  {
+                    "type": "string",
+                    "const": "u64",
+                    "description": "u64"
+                  },
+                  {
+                    "type": "string",
+                    "const": "u128",
+                    "description": "u128"
+                  },
+                  {
+                    "type": "string",
+                    "const": "u256",
+                    "description": "u256"
+                  },
+                  {
+                    "type": "string",
+                    "const": "vecbool",
+                    "description": "vecbool"
+                  },
+                  {
+                    "type": "string",
+                    "const": "vecaddress",
+                    "description": "vecaddress"
+                  },
+                  {
+                    "type": "string",
+                    "const": "vecstring",
+                    "description": "vecstring"
+                  },
+                  {
+                    "type": "string",
+                    "const": "vecu8",
+                    "description": "vecu8"
+                  },
+                  {
+                    "type": "string",
+                    "const": "vecu16",
+                    "description": "vecu16"
+                  },
+                  {
+                    "type": "string",
+                    "const": "vecu32",
+                    "description": "vecu32"
+                  },
+                  {
+                    "type": "string",
+                    "const": "vecu64",
+                    "description": "vecu64"
+                  },
+                  {
+                    "type": "string",
+                    "const": "vecu128",
+                    "description": "vecu128"
+                  },
+                  {
+                    "type": "string",
+                    "const": "vecu256",
+                    "description": "vecu256"
+                  },
+                  {
+                    "type": "string",
+                    "const": "vecvecu8",
+                    "description": "vecvecu8"
+                  }
+                ],
+                "description": "Type of the value"
               },
               "value": {
-                "description": "The actual value (omit if b_submission is true)"
+                "anyOf": [
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "anyOf": [
+                      {
+                        "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": {
+                            "type": "boolean",
+                            "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks"
+                          }
+                        },
+                        "additionalProperties": false,
+                        "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                      },
+                      {
+                        "type": "string"
+                      }
+                    ]
+                  },
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "array",
+                    "items": {
+                      "type": "boolean"
+                    }
+                  },
+                  {
+                    "anyOf": [
+                      {
+                        "type": "object",
+                        "properties": {
+                          "entities": {
+                            "type": "array",
+                            "items": {
+                              "$ref": "#/definitions/guard_table/anyOf/1/items/properties/value/anyOf/1/anyOf/0"
+                            }
+                          },
+                          "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"
+                          }
+                        },
+                        "required": [
+                          "entities"
+                        ],
+                        "additionalProperties": false,
+                        "description": "Used to batch find account or object IDs by name"
+                      },
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    ]
+                  },
+                  {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  {
+                    "type": "array",
+                    "items": {
+                      "type": "number"
+                    }
+                  },
+                  {
+                    "type": "array",
+                    "items": {
+                      "type": "array",
+                      "items": {
+                        "type": "number"
+                      }
+                    }
+                  }
+                ],
+                "description": "The actual value data"
               },
               "name": {
                 "type": "string",
+                "default": "",
                 "description": "Name or description of this data"
               }
             },
@@ -74,52 +546,27 @@
               "identifier",
               "b_submission",
               "value_type"
-            ]
+            ],
+            "additionalProperties": false,
+            "description": "Guard table item"
           }
+        }
+      ],
+      "description": "Data table of the Guard object. When using root.type='file', this field OVERRIDES table in the file."
+    },
+    "guard_rely": {
+      "anyOf": [
+        {
+          "not": {}
         },
-        "root": {
-          "description": "Root definition: either a direct GuardNode computation tree (no type wrapper) or a file reference (type='file'). When type='file', the file can define all Guard fields (namedNew, description, table, root, rely), and schema fields override file content. For the node structure, see guard-node-schema.json for complete GuardNode definitions. IMPORTANT: The root node MUST be a logical operation returning Bool (e.g., logic_and, logic_or, logic_equal, query_reward_record_exists, etc.)",
-          "oneOf": [
-            {
-              "$ref": "guard-node-schema.json",
-              "description": "Direct GuardNode computation tree - the node MUST be a logical operation returning Bool (e.g., logic_and, logic_or, logic_equal, query_reward_record_exists, etc.). No 'type: node' wrapper needed."
-            },
-            {
-              "type": "object",
-              "description": "File reference",
-              "properties": {
-                "type": {
-                  "const": "file"
-                },
-                "file_path": {
-                  "type": "string",
-                  "description": "Path to JSON or Markdown file containing Guard definition"
-                },
-                "format": {
-                  "type": "string",
-                  "enum": [
-                    "json",
-                    "markdown"
-                  ],
-                  "default": "json",
-                  "description": "File format: 'json' or 'markdown'"
-                }
-              },
-              "required": [
-                "type",
-                "file_path"
-              ]
-            }
-          ]
-        },
-        "rely": {
+        {
           "type": "object",
-          "description": "All Guard objects that the new Guard object depends on.",
           "properties": {
             "guards": {
               "type": "array",
               "items": {
-                "type": "string"
+                "type": "string",
+                "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
               },
               "description": "List of dependent Guard object IDs or names."
             },
@@ -130,27 +577,93 @@
           },
           "required": [
             "guards"
-          ]
+          ],
+          "additionalProperties": false
         }
-      },
-      "required": [
-        "root"
-      ]
+      ],
+      "description": "All Guard objects that the new Guard object depends on. If logic_or is true, the execution result of the new Guard object is the logical OR of the execution results of all dependent Guard objects; otherwise, it is logical AND. When using root.type='file', this field OVERRIDES rely in the file."
     },
-    "env": {
-      "$ref": "#/definitions/env",
-      "$schema": "http://json-schema.org/draft-07/schema#"
+    "guard_binding_hint": {
+      "anyOf": [
+        {
+          "not": {}
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "enum": [
+                "buy",
+                "forward",
+                "allocate",
+                "claim_reward",
+                "vote",
+                "dispute",
+                "write_repository",
+                "submit_progress",
+                "gen_passport",
+                "custom"
+              ],
+              "description": "Protected action type. Example: 'buy' for Service buy_guard, 'forward' for Machine Forward.guard."
+            },
+            "host_object": {
+              "type": "string",
+              "enum": [
+                "Service",
+                "Machine",
+                "Arbitration",
+                "Reward",
+                "Repository",
+                "Progress",
+                "Demand",
+                "Standalone"
+              ],
+              "description": "Host object type. Example: 'Service', 'Machine'."
+            },
+            "binding_field": {
+              "type": "string",
+              "enum": [
+                "buy_guard",
+                "order_allocators",
+                "Forward.guard",
+                "submission",
+                "guard",
+                "write_guard",
+                "usage_guard",
+                "voting_guard",
+                "ServiceGuard",
+                "none"
+              ],
+              "description": "Binding field. Example: 'buy_guard', 'Forward.guard'."
+            },
+            "rule_sentence": {
+              "type": "string",
+              "description": "One-sentence description of the validation rule (human-readable). Example: 'Only the author can purchase this service'."
+            },
+            "failure_conditions": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "List of conditions under which the Guard should FAIL. Example: ['Signer is not in allowlist','Order is already completed']."
+            },
+            "circular_reference": {
+              "type": "boolean",
+              "description": "Whether the Guard references the Host Object itself (circular reference pattern). true=Guard queries the Host Object it binds to."
+            }
+          },
+          "required": [
+            "action",
+            "host_object",
+            "binding_field"
+          ],
+          "additionalProperties": false,
+          "description": "Optional semantic hint for Guard capability system. Provides intent + binding context so the MCP server can derive GuardPuzzle, run risk assessment, and generate confirmation text. Strongly recommended: fill this field to enable puzzle_status, matched_scene, suggested_patterns, confirmation_text, and pending_questions in the response guard_advice."
+        }
+      ],
+      "description": "Phase 5 Guard capability hint. Provides semantic context (action + host_object + binding_field + optional rule/failure_conditions) for puzzle derivation. When provided, the response will include complete guard_advice (puzzle_status, matched_scene, suggested_patterns, confirmation_text, pending_questions). When absent, puzzle_status intent/binding dimensions are marked incomplete."
     },
-    "submission": {
-      "$ref": "#/definitions/submission",
-      "$schema": "http://json-schema.org/draft-07/schema#"
-    }
-  },
-  "required": [
-    "operation_type",
-    "data"
-  ],
-  "definitions": {
     "env": {
       "type": "object",
       "properties": {
@@ -238,7 +751,8 @@
             ],
             "additionalProperties": false
           },
-          "description": "Array of Guard objects to verify. Relation: each entry corresponds to a Guard bound to the operation."
+          "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": {
           "type": "array",