@wowok/agent-mcp 2.2.11 → 2.2.14

package/dist/schemas/account_operation.schema.json

@@ -0,0 +1,255 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/account_operation.json",
+  "title": "Account Operations",
+  "description": "Manage WoWok accounts locally: generate, suspend, resume, faucet-test, operate assets, sign data",
+  "$ref": "#/definitions/account_operation",
+  "definitions": {
+    "account_operation": {
+      "type": "object",
+      "properties": {
+        "gen": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string",
+              "description": "Account name (max 64 characters). Use empty string '' or omit for the default account."
+            },
+            "replaceExistName": {
+              "type": "boolean",
+              "description": "If true, existing account with the same name will lose the name; if false (default), throw error when name exists"
+            },
+            "m": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/account_operation/properties/gen/properties/name"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Messenger name to enable messenger for this account (max 64 characters). If null, disable messenger. Omit to leave messenger unchanged."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Generate new account"
+        },
+        "faucet": {
+          "type": "object",
+          "properties": {
+            "name_or_address": {
+              "type": "string",
+              "description": "Account name or address. Use empty string '' for the default account. Defaults to '' if omitted."
+            },
+            "network": {
+              "type": "string",
+              "enum": [
+                "localnet",
+                "testnet"
+              ],
+              "description": "Network entrypoint for Faucet: Specifies which network the operation occurs on"
+            }
+          },
+          "required": [
+            "network"
+          ],
+          "additionalProperties": false,
+          "description": "Distribute test coins from faucet to the specified account"
+        },
+        "suspend": {
+          "type": "object",
+          "properties": {
+            "name_or_address": {
+              "$ref": "#/definitions/account_operation/properties/faucet/properties/name_or_address",
+              "description": "Account name or address. Use empty string '' for the default account. Defaults to '' if omitted."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Remove account from active account list (cannot sign transactions), and delete its name"
+        },
+        "resume": {
+          "type": "object",
+          "properties": {
+            "address": {
+              "type": "string",
+              "description": "Valid ID: 0x prefix + 64 hex characters, or builtin ID (0x5-0x9, @0xaaa, @0xaab, @0x403, @0xacc, @0xc)"
+            },
+            "name": {
+              "$ref": "#/definitions/account_operation/properties/gen/properties/name",
+              "description": "New name for the resumed account. Omit to leave unnamed."
+            }
+          },
+          "required": [
+            "address"
+          ],
+          "additionalProperties": false,
+          "description": "Add account back to active account list"
+        },
+        "rename": {
+          "type": "object",
+          "properties": {
+            "name_or_address": {
+              "$ref": "#/definitions/account_operation/properties/faucet/properties/name_or_address",
+              "description": "Source account name or address. Use empty string '' for the default account. Defaults to '' if omitted. Can be a name or address."
+            },
+            "new_name": {
+              "$ref": "#/definitions/account_operation/properties/gen/properties/name",
+              "description": "New account name (max 64 characters). Must be a name (not an address)."
+            }
+          },
+          "required": [
+            "new_name"
+          ],
+          "additionalProperties": false,
+          "description": "Rename account. name_or_address can be name or address, new_name must be a name."
+        },
+        "swap_name": {
+          "type": "object",
+          "properties": {
+            "name1": {
+              "$ref": "#/definitions/account_operation/properties/gen/properties/name",
+              "description": "First account name. Use empty string '' for the default account."
+            },
+            "name2": {
+              "$ref": "#/definitions/account_operation/properties/gen/properties/name",
+              "description": "Second account name. Use empty string '' for the default account."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Swap the names of two accounts"
+        },
+        "transfer": {
+          "type": "object",
+          "properties": {
+            "name_or_address_from": {
+              "$ref": "#/definitions/account_operation/properties/faucet/properties/name_or_address",
+              "description": "Sender account name or address. Use empty string '' for the default account."
+            },
+            "name_or_address_to": {
+              "$ref": "#/definitions/account_operation/properties/faucet/properties/name_or_address",
+              "description": "Recipient account name or address. Use empty string '' for the default account."
+            },
+            "amount": {
+              "type": [
+                "number",
+                "string"
+              ],
+              "description": "Amount of tokens to transfer"
+            },
+            "token_type": {
+              "type": "string",
+              "description": "Token type; default token type is 0x2::wow::WOW"
+            },
+            "network": {
+              "type": "string",
+              "enum": [
+                "localnet",
+                "testnet"
+              ],
+              "description": "Network entrypoint: Specifies which network the operation occurs on"
+            }
+          },
+          "required": [
+            "amount"
+          ],
+          "additionalProperties": false,
+          "description": "Transfer tokens from one account to another"
+        },
+        "get": {
+          "type": "object",
+          "properties": {
+            "name_or_address": {
+              "$ref": "#/definitions/account_operation/properties/faucet/properties/name_or_address",
+              "description": "Account name or address. Use empty string '' for the default account."
+            },
+            "balance_required": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "Required balance amount"
+            },
+            "token_type": {
+              "type": "string",
+              "description": "Token type; default token type is 0x2::wow::WOW"
+            },
+            "network": {
+              "$ref": "#/definitions/account_operation/properties/transfer/properties/network",
+              "description": "Network entrypoint: Specifies which network the operation occurs on"
+            }
+          },
+          "required": [
+            "balance_required"
+          ],
+          "additionalProperties": false,
+          "description": "Generate new coin object ID from account by required amount and return"
+        },
+        "signData": {
+          "type": "object",
+          "properties": {
+            "name_or_address": {
+              "$ref": "#/definitions/account_operation/properties/faucet/properties/name_or_address",
+              "description": "Account name or address. Use empty string '' for the default account."
+            },
+            "data": {
+              "type": "string",
+              "description": "Data to sign. If data_encoding is not specified, treated as UTF-8 string."
+            },
+            "data_encoding": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "const": "utf8",
+                  "description": "Data is UTF-8 encoded string"
+                },
+                {
+                  "type": "string",
+                  "const": "base64",
+                  "description": "Data is base64 encoded bytes"
+                },
+                {
+                  "type": "string",
+                  "const": "hex",
+                  "description": "Data is hex encoded bytes (with or without 0x prefix)"
+                }
+              ],
+              "description": "Encoding format of the data field. If not specified, defaults to utf8."
+            }
+          },
+          "required": [
+            "data"
+          ],
+          "additionalProperties": false,
+          "description": "Sign data with account's private key"
+        },
+        "messenger": {
+          "type": "object",
+          "properties": {
+            "name_or_account": {
+              "$ref": "#/definitions/account_operation/properties/faucet/properties/name_or_address",
+              "description": "Account name or address. Use empty string '' for the default account. Defaults to '' if omitted."
+            },
+            "m": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/account_operation/properties/gen/properties/name"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Messenger name to enable messenger for this account (max 64 characters). If null, disable messenger."
+            }
+          },
+          "required": [
+            "m"
+          ],
+          "additionalProperties": false,
+          "description": "Enable or disable messenger for an account"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Account operations"
+    }
+  }
+}

package/dist/schemas/guard2file.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/guard2file.json",
+  "title": "Guard to File",
+  "description": "Export Guard definition to JSON/Markdown file",
+  "$ref": "#/definitions/guard2file",
+  "definitions": {
+    "guard2file": {
+      "type": "object",
+      "properties": {
+        "guard": {
+          "type": "string",
+          "description": "Guard object ID or name to export"
+        },
+        "file_path": {
+          "type": "string",
+          "description": "Output file path (absolute or relative)"
+        },
+        "format": {
+          "type": "string",
+          "enum": [
+            "json",
+            "markdown"
+          ],
+          "description": "Output format: 'json' (default) or 'markdown'"
+        },
+        "env": {
+          "type": "object",
+          "properties": {
+            "account": {
+              "$ref": "#/definitions/guard2file/properties/guard",
+              "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/guard2file/properties/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."
+        }
+      },
+      "required": [
+        "guard",
+        "file_path"
+      ],
+      "additionalProperties": false,
+      "description": "Query a Guard object from the blockchain and export its definition to a JSON or Markdown file. The exported file can be edited and used to create new Guard objects."
+    }
+  }
+}

package/dist/schemas/index.json

@@ -0,0 +1,139 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "WoWok MCP Schema Index",
+  "description": "Index of all available JSON schemas for WoWok MCP tools",
+  "generatedAt": "2026-05-19T05:26:18.541Z",
+  "tools": [
+    {
+      "name": "onchain_operations",
+      "title": "On-chain Operations",
+      "path": "./onchain_operations.schema.json"
+    },
+    {
+      "name": "account_operation",
+      "title": "Account Operations",
+      "path": "./account_operation.schema.json"
+    },
+    {
+      "name": "local_mark_operation",
+      "title": "Local Mark Operations",
+      "path": "./local_mark_operation.schema.json"
+    },
+    {
+      "name": "local_info_operation",
+      "title": "Local Info Operations",
+      "path": "./local_info_operation.schema.json"
+    },
+    {
+      "name": "wip_file",
+      "title": "WIP File Operations",
+      "path": "./wip_file.schema.json"
+    },
+    {
+      "name": "messenger_operation",
+      "title": "Messenger Operations",
+      "path": "./messenger_operation.schema.json"
+    },
+    {
+      "name": "guard2file",
+      "title": "Guard to File",
+      "path": "./guard2file.schema.json"
+    },
+    {
+      "name": "machineNode2file",
+      "title": "Machine Node to File",
+      "path": "./machineNode2file.schema.json"
+    },
+    {
+      "name": "query_toolkit",
+      "title": "Data Query Toolkit",
+      "path": "./query_toolkit.schema.json"
+    },
+    {
+      "name": "onchain_table_data",
+      "title": "On-chain Table Data Query",
+      "path": "./onchain_table_data.schema.json"
+    },
+    {
+      "name": "onchain_events",
+      "title": "On-chain Events",
+      "path": "./onchain_events.schema.json"
+    },
+    {
+      "name": "wowok_buildin_info",
+      "title": "WoWok Build-in Information",
+      "path": "./wowok_buildin_info.schema.json"
+    },
+    {
+      "name": "schema_query",
+      "title": "Schema Query",
+      "path": "./schema_query.schema.json"
+    }
+  ],
+  "operations": [
+    {
+      "name": "onchain_operations_permission",
+      "path": "./onchain_operations_permission.schema.json"
+    },
+    {
+      "name": "onchain_operations_service",
+      "path": "./onchain_operations_service.schema.json"
+    },
+    {
+      "name": "onchain_operations_machine",
+      "path": "./onchain_operations_machine.schema.json"
+    },
+    {
+      "name": "onchain_operations_progress",
+      "path": "./onchain_operations_progress.schema.json"
+    },
+    {
+      "name": "onchain_operations_guard",
+      "path": "./onchain_operations_guard.schema.json"
+    },
+    {
+      "name": "onchain_operations_arbitration",
+      "path": "./onchain_operations_arbitration.schema.json"
+    },
+    {
+      "name": "onchain_operations_repository",
+      "path": "./onchain_operations_repository.schema.json"
+    },
+    {
+      "name": "onchain_operations_contact",
+      "path": "./onchain_operations_contact.schema.json"
+    },
+    {
+      "name": "onchain_operations_treasury",
+      "path": "./onchain_operations_treasury.schema.json"
+    },
+    {
+      "name": "onchain_operations_reward",
+      "path": "./onchain_operations_reward.schema.json"
+    },
+    {
+      "name": "onchain_operations_allocation",
+      "path": "./onchain_operations_allocation.schema.json"
+    },
+    {
+      "name": "onchain_operations_personal",
+      "path": "./onchain_operations_personal.schema.json"
+    },
+    {
+      "name": "onchain_operations_payment",
+      "path": "./onchain_operations_payment.schema.json"
+    },
+    {
+      "name": "onchain_operations_demand",
+      "path": "./onchain_operations_demand.schema.json"
+    },
+    {
+      "name": "onchain_operations_order",
+      "path": "./onchain_operations_order.schema.json"
+    },
+    {
+      "name": "onchain_operations_gen_passport",
+      "path": "./onchain_operations_gen_passport.schema.json"
+    }
+  ]
+}

package/dist/schemas/local_info_operation.schema.json

@@ -0,0 +1,142 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/local_info_operation.json",
+  "title": "Local Info Operations",
+  "description": "Manage sensitive personal information locally",
+  "$ref": "#/definitions/local_info_operation",
+  "definitions": {
+    "local_info_operation": {
+      "type": "object",
+      "properties": {
+        "add": {
+          "type": "object",
+          "properties": {
+            "op": {
+              "type": "string",
+              "const": "add",
+              "description": "Operation type: add info"
+            },
+            "data": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "default": {
+                    "type": "string",
+                    "maxLength": 300,
+                    "description": "Primary/default value for this info (max 300 bcs characters)"
+                  },
+                  "contents": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "maxLength": 300
+                    },
+                    "maxItems": 50,
+                    "description": "Additional content values (max 50 items, each max 300 bcs characters)"
+                  },
+                  "createdAt": {
+                    "type": "number",
+                    "description": "Unix timestamp (ms) when this info was created"
+                  },
+                  "updatedAt": {
+                    "type": "number",
+                    "description": "Unix timestamp (ms) when this info was last modified"
+                  },
+                  "name": {
+                    "type": "string",
+                    "maxLength": 64,
+                    "description": "Unique identifier for this info entry (max 64 bcs characters)"
+                  }
+                },
+                "required": [
+                  "default",
+                  "name"
+                ],
+                "additionalProperties": false,
+                "description": "LOCAL PRIVATE: Local info data structure for storing sensitive personal information like delivery addresses, phone numbers, etc. This data is stored ONLY on your device and NEVER published to the blockchain."
+              },
+              "minItems": 1,
+              "description": "Array of info data to add (at least 1 item)"
+            }
+          },
+          "required": [
+            "op",
+            "data"
+          ],
+          "additionalProperties": false,
+          "description": "Add one or more info entries"
+        },
+        "remove": {
+          "type": "object",
+          "properties": {
+            "op": {
+              "type": "string",
+              "const": "remove",
+              "description": "Operation type: remove info"
+            },
+            "data": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "minItems": 1,
+              "description": "Array of info names to remove"
+            }
+          },
+          "required": [
+            "op",
+            "data"
+          ],
+          "additionalProperties": false,
+          "description": "Remove info entries by name"
+        },
+        "reset": {
+          "type": "object",
+          "properties": {
+            "op": {
+              "type": "string",
+              "const": "reset",
+              "description": "Operation type: reset contents"
+            },
+            "name": {
+              "type": "string",
+              "description": "Name of info entry to reset"
+            },
+            "contents": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "New content list to replace existing contents"
+            }
+          },
+          "required": [
+            "op",
+            "name",
+            "contents"
+          ],
+          "additionalProperties": false,
+          "description": "Reset the contents of an existing info entry"
+        },
+        "clear": {
+          "type": "object",
+          "properties": {
+            "op": {
+              "type": "string",
+              "const": "clear",
+              "description": "Operation type: clear all info"
+            }
+          },
+          "required": [
+            "op"
+          ],
+          "additionalProperties": false,
+          "description": "Remove all info entries"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Local info operations. Exactly one operation type (add/remove/reset/clear) must be specified."
+    }
+  }
+}