@wowok/agent-mcp 2.2.13 → 2.2.15

package/dist/schemas/onchain_operations_contact.schema.json

@@ -0,0 +1,853 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/onchain_operations_contact.json",
+  "title": "Contact Operation",
+  "description": "On-chain contact operation schema",
+  "type": "object",
+  "properties": {
+    "operation_type": {
+      "const": "contact"
+    },
+    "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": {
+        "object": {
+          "anyOf": [
+            {
+              "type": "string",
+              "description": "String format: Reference an EXISTING object by its name (local mark) or on-chain object ID. Use when the Permission object already exists."
+            },
+            {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "description": "The name of the object"
+                },
+                "tags": {
+                  "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."
+                },
+                "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)."
+                },
+                "permission": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/data/properties/object/anyOf/0",
+                      "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"
+                        },
+                        "tags": {
+                          "$ref": "#/definitions/data/properties/object/anyOf/1/properties/tags"
+                        },
+                        "onChain": {
+                          "$ref": "#/definitions/data/properties/object/anyOf/1/properties/onChain"
+                        },
+                        "replaceExistName": {
+                          "$ref": "#/definitions/data/properties/object/anyOf/1/properties/replaceExistName"
+                        },
+                        "description": {
+                          "type": "string",
+                          "description": "The description of the object"
+                        }
+                      },
+                      "additionalProperties": false,
+                      "description": "Object format: CREATE a NEW object with name, optional description, and visibility settings. Extends NamedObjectSchema with an additional 'description' field for detailed object information."
+                    }
+                  ],
+                  "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)."
+                }
+              },
+              "additionalProperties": false,
+              "description": "Object format: CREATE a NEW object with Permission-based access control. Includes optional name, tags, visibility settings, AND a Permission object (which itself can be referenced by string or created as a new object). Use this to create objects with managed access permissions."
+            }
+          ],
+          "description": "Two ways to specify a Permission-managed object: (1) STRING - Reference an EXISTING Permission object by name or ID; (2) OBJECT - CREATE a NEW object with Permission access control, where the Permission can also be either referenced (string) or newly created (object). This is used when you need permission management but don't need to specify a token type."
+        },
+        "my_status": {
+          "$ref": "#/definitions/data/properties/object/anyOf/1/properties/name",
+          "description": "Set your status message in this contact list. Only valid if your account is already in the IM list"
+        },
+        "description": {
+          "type": "string",
+          "description": "Contact object description or public information"
+        },
+        "location": {
+          "type": "string",
+          "description": "Physical or virtual location information for this contact"
+        },
+        "ims": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "add",
+                  "description": "Add new IM contacts to the list"
+                },
+                "im": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "at": {
+                        "$ref": "#/definitions/data/properties/object/anyOf/0",
+                        "description": "Contact's account address or name for instant messaging"
+                      },
+                      "description": {
+                        "$ref": "#/definitions/data/properties/location",
+                        "description": "Optional description or note about this contact"
+                      }
+                    },
+                    "required": [
+                      "at"
+                    ],
+                    "additionalProperties": false,
+                    "description": "An instant messaging contact entry with address and optional description"
+                  },
+                  "description": "List of IM contacts to add"
+                }
+              },
+              "required": [
+                "op",
+                "im"
+              ],
+              "additionalProperties": false,
+              "description": "Add operation: Append new contacts to the existing IM list"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "set",
+                  "description": "Set/replace all IM contacts"
+                },
+                "im": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/definitions/data/properties/ims/anyOf/0/properties/im/items"
+                  },
+                  "description": "Complete list of IM contacts to set"
+                }
+              },
+              "required": [
+                "op",
+                "im"
+              ],
+              "additionalProperties": false,
+              "description": "Set operation: Replace entire IM list with new contacts"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "remove",
+                  "description": "Remove specific IM contacts"
+                },
+                "im": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/definitions/data/properties/object/anyOf/0",
+                    "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 contact addresses or names to remove"
+                }
+              },
+              "required": [
+                "op",
+                "im"
+              ],
+              "additionalProperties": false,
+              "description": "Remove operation: Delete specified contacts from the IM list"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "op": {
+                  "type": "string",
+                  "const": "clear",
+                  "description": "Clear all IM contacts"
+                }
+              },
+              "required": [
+                "op"
+              ],
+              "additionalProperties": false,
+              "description": "Clear operation: Remove all contacts from the IM list"
+            }
+          ],
+          "description": "IM contact list operation: add, set, remove, or clear instant messaging contacts"
+        },
+        "owner_receive": {
+          "anyOf": [
+            {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Received object ID"
+                  },
+                  "type": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Object type"
+                  },
+                  "content_raw": {
+                    "description": "Raw content data"
+                  }
+                },
+                "required": [
+                  "id",
+                  "type"
+                ],
+                "additionalProperties": false,
+                "description": "Received normal object record"
+              }
+            },
+            {
+              "type": "object",
+              "properties": {
+                "balance": {
+                  "type": [
+                    "number",
+                    "string"
+                  ],
+                  "description": "Balance type"
+                },
+                "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": {
+                        "$ref": "#/definitions/data/properties/owner_receive/anyOf/1/properties/balance"
+                      },
+                      "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": "Receive objects sent to this contact object and unwrap them to the permission owner"
+        }
+      },
+      "required": [
+        "object"
+      ],
+      "additionalProperties": false,
+      "description": "On-chain Contact operations. USAGE: (1) CREATE NEW: Set 'object' field with OBJECT format {name, permission, ...} to create a Contact. NOTE: 'name' goes INSIDE 'object', NOT at the data root level. 'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with STRING format (object ID or name). The 'object' field is CRITICAL and REQUIRED in both cases. STRING for existing, OBJECT for new creation."
+    },
+    "env": {
+      "type": "object",
+      "properties": {
+        "account": {
+          "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": ""
+        },
+        "permission_guard": {
+          "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."
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on"
+        },
+        "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."
+        }
+      },
+      "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."
+    },
+    "submission": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "submission",
+          "description": "Type of call response: submission"
+        },
+        "guard": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "object": {
+                "type": "string",
+                "description": "Guard object name or ID."
+              },
+              "impack": {
+                "type": "boolean",
+                "description": "Whether the verification result of this Guard participates in the final verification logic. If true, the verification result of this Guard will be included in the final verification result; if false, the verification result of this Guard will not be included."
+              }
+            },
+            "required": [
+              "object",
+              "impack"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "submission": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "guard": {
+                "$ref": "#/definitions/submission/properties/guard/items/properties/object",
+                "description": "Guard object name or ID."
+              },
+              "submission": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "identifier": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 255,
+                      "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": {
+                      "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": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "anyOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "name_or_address": {
+                                  "$ref": "#/definitions/submission/properties/guard/items/properties/object",
+                                  "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/submission/properties/submission/items/properties/submission/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"
+                    },
+                    "object_type": {
+                      "type": "string",
+                      "enum": [
+                        "Permission",
+                        "Repository",
+                        "Arb",
+                        "Arbitration",
+                        "Service",
+                        "Machine",
+                        "Order",
+                        "Progress",
+                        "Payment",
+                        "Treasury",
+                        "Guard",
+                        "Demand",
+                        "Passport",
+                        "Allocation",
+                        "Resource",
+                        "Reward",
+                        "Discount",
+                        "EntityRegistrar",
+                        "EntityLinker",
+                        "Proof",
+                        "WReceivedObject",
+                        "Contact",
+                        "TableItem_ProgressHistory",
+                        "TableItem_PermissionPerm",
+                        "TableItem_DemandPresenter",
+                        "TableItem_MachineNode",
+                        "TableItem_TreasuryHistory",
+                        "TableItem_RepositoryData",
+                        "TableItem_RewardRecord",
+                        "TableItem_EntityLinker",
+                        "TableItem_AddressMark",
+                        "TableItem_EntityRegistrar"
+                      ],
+                      "description": "Object type when value_type is Address and represents a specific object"
+                    }
+                  },
+                  "required": [
+                    "identifier",
+                    "b_submission",
+                    "value_type"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Guard table item"
+                },
+                "description": "User-submitted data required for Guard verification."
+              }
+            },
+            "required": [
+              "guard",
+              "submission"
+            ],
+            "additionalProperties": false,
+            "description": "Permission guard submission data."
+          }
+        }
+      },
+      "required": [
+        "type",
+        "guard",
+        "submission"
+      ],
+      "additionalProperties": false,
+      "description": "Guard verification submission data required to complete an operation. Contains: (1) 'guard' - array of Guard objects to verify, each with an object ID and an 'impack' flag indicating if its result affects the final outcome; (2) 'submission' - array of user data submissions matching the Guard's requirements. The operation proceeds only after all Guards with impack=true are successfully verified."
+    }
+  }
+}