@wowok/agent-mcp 2.7.2 → 2.7.3

package/dist/schemas/account_operation.schema.json

@@ -2,241 +2,248 @@
   "$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": {
+  "description": "Account operations (mutations only: gen/faucet/suspend/resume/rename/swap_name/transfer/get/signData/messenger). Parameters MUST be wrapped in the operation type property (e.g. {transfer: {...}}, NOT {amount: ...}). Unwrapped parameters are rejected. TO LIST ALL ACCOUNTS: use the query_toolkit tool with query_type='account_list' (returns name, address, suspended status, messenger status for all local accounts). This separation follows CQRS: account_operation = mutations, query_toolkit = queries. Common workflow after MCP restart: (1) query_toolkit query_type='account_list' to see all accounts, (2) account_operation with the appropriate mutation.",
+  "type": "object",
+  "properties": {
+    "gen": {
+      "description": "Generate new account",
       "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. Recommended convention: <role>-<number> (e.g. shop-001, user-001, arb-001) for easy filtering and batch operations."
-            },
-            "replaceExistName": {
-              "type": "boolean",
-              "description": "DISCOURAGED. If true, an existing account with the same name will be SUSPENDED (not just renamed) to free the name for the new account. The old account moves to the Suspended tab and cannot sign transactions until resumed with a new name. FORBIDDEN on the default account (name='' or omitted) — the default account is unique and cannot be replaced; use suspend() explicitly instead. Prefer versioned names (e.g. 'shop_v2') over replaceExistName for production. Default: false (throws AccountNameExist on collision)."
-            },
-            "messenger": {
-              "type": "boolean",
-              "description": "Enable messenger for this account. true=enable, false=disable, omit=unchanged. Account name is used for messenger identity lookup (no separate messenger name)."
-            }
-          },
-          "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"
+        "name": {
+          "description": "Account name (max 64 characters). Use empty string '' or omit for the default account. Recommended convention: <role>-<number> (e.g. shop-001, user-001, arb-001) for easy filtering and batch operations.",
+          "type": "string"
+        },
+        "replaceExistName": {
+          "description": "DISCOURAGED. If true, an existing account with the same name will be SUSPENDED (not just renamed) to free the name for the new account. The old account moves to the Suspended tab and cannot sign transactions until resumed with a new name. FORBIDDEN on the default account (name='' or omitted) — the default account is unique and cannot be replaced; use suspend() explicitly instead. Prefer versioned names (e.g. 'shop_v2') over replaceExistName for production. Default: false (throws AccountNameExist on collision).",
+          "type": "boolean"
+        },
+        "messenger": {
+          "description": "Enable messenger for this account. true=enable, false=disable, omit=unchanged. Account name is used for messenger identity lookup (no separate messenger name).",
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false
+    },
+    "faucet": {
+      "description": "Distribute test coins from faucet to the specified account",
+      "type": "object",
+      "properties": {
+        "name_or_address": {
+          "description": "Account name or address. Use empty string '' for the default account. Defaults to '' if omitted.",
+          "type": "string"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet"
           ],
-          "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, 0xa, 0xc, 0xd, 0x403, 0xaaa, 0xaab, 0xacc)"
+          "description": "Network entrypoint for Faucet: Specifies which network the operation occurs on"
+        }
+      },
+      "required": [
+        "network"
+      ],
+      "additionalProperties": false
+    },
+    "suspend": {
+      "description": "Remove account from active account list (cannot sign transactions), and delete its name",
+      "type": "object",
+      "properties": {
+        "name_or_address": {
+          "description": "Account name or address. Use empty string '' for the default account. Defaults to '' if omitted.",
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "resume": {
+      "description": "Add account back to active account list",
+      "type": "object",
+      "properties": {
+        "address": {
+          "type": "string",
+          "description": "Valid ID: 0x prefix + 64 hex characters, or builtin ID (0x5-0x9, 0xa, 0xc, 0xd, 0x403, 0xaaa, 0xaab, 0xacc)"
+        },
+        "name": {
+          "description": "New name for the resumed account. Omit to leave unnamed.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "address"
+      ],
+      "additionalProperties": false
+    },
+    "rename": {
+      "description": "Rename account. name_or_address can be name or address, new_name must be a name.",
+      "type": "object",
+      "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.",
+          "type": "string"
+        },
+        "new_name": {
+          "type": "string",
+          "description": "New account name (max 64 characters). Must be a name (not an address)."
+        }
+      },
+      "required": [
+        "new_name"
+      ],
+      "additionalProperties": false
+    },
+    "swap_name": {
+      "description": "Swap the names of two accounts",
+      "type": "object",
+      "properties": {
+        "name1": {
+          "description": "First account name. Use empty string '' for the default account.",
+          "type": "string"
+        },
+        "name2": {
+          "description": "Second account name. Use empty string '' for the default account.",
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "transfer": {
+      "description": "Transfer tokens from one account to another",
+      "type": "object",
+      "properties": {
+        "name_or_address_from": {
+          "description": "Sender account name or address. Use empty string '' for the default account.",
+          "type": "string"
+        },
+        "name_or_address_to": {
+          "description": "Recipient account name or address. Use empty string '' for the default account.",
+          "type": "string"
+        },
+        "amount": {
+          "anyOf": [
+            {
+              "type": "number"
             },
-            "name": {
-              "$ref": "#/definitions/account_operation/properties/gen/properties/name",
-              "description": "New name for the resumed account. Omit to leave unnamed."
+            {
+              "type": "string"
             }
-          },
-          "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"
+          "description": "Amount of tokens to transfer"
+        },
+        "token_type": {
+          "description": "Token type; default token type is 0x2::wow::WOW",
+          "type": "string"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
           ],
-          "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"
+          "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."
+        }
+      },
+      "required": [
+        "amount"
+      ],
+      "additionalProperties": false
+    },
+    "get": {
+      "description": "Generate new coin object ID from account by required amount and return",
+      "type": "object",
+      "properties": {
+        "name_or_address": {
+          "description": "Account name or address. Use empty string '' for the default account.",
+          "type": "string"
+        },
+        "balance_required": {
+          "anyOf": [
+            {
+              "type": "string"
             },
-            "network": {
-              "type": "string",
-              "enum": [
-                "localnet",
-                "testnet",
-                "mainnet"
-              ],
-              "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."
+            {
+              "type": "number"
             }
-          },
-          "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. 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."
-            }
-          },
-          "required": [
-            "balance_required"
+          "description": "Required balance amount"
+        },
+        "token_type": {
+          "description": "Token type; default token type is 0x2::wow::WOW",
+          "type": "string"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
           ],
-          "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."
+          "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."
+        }
+      },
+      "required": [
+        "balance_required"
+      ],
+      "additionalProperties": false
+    },
+    "signData": {
+      "description": "Sign data with account's private key",
+      "type": "object",
+      "properties": {
+        "name_or_address": {
+          "description": "Account name or address. Use empty string '' for the default account.",
+          "type": "string"
+        },
+        "data": {
+          "type": "string",
+          "description": "Data to sign. If data_encoding is not specified, treated as UTF-8 string."
+        },
+        "data_encoding": {
+          "description": "Encoding format of the data field. If not specified, defaults to utf8.",
+          "anyOf": [
+            {
+              "type": "string",
+              "const": "utf8",
+              "description": "Data is UTF-8 encoded string"
             },
-            "data": {
+            {
               "type": "string",
-              "description": "Data to sign. If data_encoding is not specified, treated as UTF-8 string."
+              "const": "base64",
+              "description": "Data is base64 encoded bytes"
             },
-            "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."
+            {
+              "type": "string",
+              "const": "hex",
+              "description": "Data is hex encoded bytes (with or without 0x prefix)"
             }
-          },
-          "required": [
-            "data"
-          ],
-          "additionalProperties": false,
-          "description": "Sign data with account's private key"
+          ]
+        }
+      },
+      "required": [
+        "data"
+      ],
+      "additionalProperties": false
+    },
+    "messenger": {
+      "description": "Enable or disable messenger for an account",
+      "type": "object",
+      "properties": {
+        "name_or_account": {
+          "description": "Account name or address. Use empty string '' for the default account. Defaults to '' if omitted.",
+          "type": "string"
         },
-        "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."
-            },
-            "enabled": {
-              "type": "boolean",
-              "description": "true to enable messenger, false to disable"
-            }
-          },
-          "required": [
-            "enabled"
-          ],
-          "additionalProperties": false,
-          "description": "Enable or disable messenger for an account"
+        "enabled": {
+          "type": "boolean",
+          "description": "true to enable messenger, false to disable"
         }
       },
-      "additionalProperties": false,
-      "description": "Account operations (mutations only: gen/faucet/suspend/resume/rename/swap_name/transfer/get/signData/messenger). Parameters MUST be wrapped in the operation type property (e.g. {transfer: {...}}, NOT {amount: ...}). Unwrapped parameters are rejected. TO LIST ALL ACCOUNTS: use the query_toolkit tool with query_type='account_list' (returns name, address, suspended status, messenger status for all local accounts). This separation follows CQRS: account_operation = mutations, query_toolkit = queries. Common workflow after MCP restart: (1) query_toolkit query_type='account_list' to see all accounts, (2) account_operation with the appropriate mutation."
+      "required": [
+        "enabled"
+      ],
+      "additionalProperties": false
     }
-  }
+  },
+  "additionalProperties": false
 }