@wowok/agent-mcp 2.2.13 → 2.2.14

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."
+    }
+  }
+}

package/dist/schemas/local_mark_operation.schema.json

@@ -0,0 +1,119 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/local_mark_operation.json",
+  "title": "Local Mark Operations",
+  "description": "Manage ID names and tags stored locally",
+  "$ref": "#/definitions/local_mark_operation",
+  "definitions": {
+    "local_mark_operation": {
+      "type": "object",
+      "properties": {
+        "add": {
+          "type": "object",
+          "properties": {
+            "op": {
+              "type": "string",
+              "const": "add",
+              "description": "Operation type: add marks"
+            },
+            "data": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "object",
+                    "properties": {
+                      "value": {
+                        "type": "string",
+                        "maxLength": 64,
+                        "description": "Mark name value (max 64 bcs characters)"
+                      },
+                      "replaceExistName": {
+                        "type": "boolean",
+                        "default": false,
+                        "description": "If true, replace existing mark with same name; if false (default), throw error when name exists"
+                      }
+                    },
+                    "required": [
+                      "value"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Mark naming configuration"
+                  },
+                  "address": {
+                    "type": "string",
+                    "description": "Valid ID: 0x prefix + 64 hex characters, or builtin ID (0x5-0x9, @0xaaa, @0xaab, @0x403, @0xacc, @0xc)"
+                  },
+                  "tags": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "maxLength": 64
+                    },
+                    "maxItems": 50,
+                    "description": "Tags for categorization (max 50 tags, each max 64 bcs characters)"
+                  }
+                },
+                "required": [
+                  "address"
+                ],
+                "additionalProperties": false,
+                "description": "LOCAL ONLY: Parameters for creating or updating a LOCAL mark. This data is stored privately on your device and will NEVER be published to the blockchain. For public on-chain marks, use the 'personal' tool instead."
+              },
+              "minItems": 1,
+              "description": "Array of mark data to add (at least 1 item)"
+            }
+          },
+          "required": [
+            "op",
+            "data"
+          ],
+          "additionalProperties": false,
+          "description": "Add one or more marks"
+        },
+        "remove": {
+          "type": "object",
+          "properties": {
+            "op": {
+              "type": "string",
+              "const": "remove",
+              "description": "Operation type: remove marks"
+            },
+            "names": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "minItems": 1,
+              "description": "Array of mark names or addresses to remove"
+            }
+          },
+          "required": [
+            "op",
+            "names"
+          ],
+          "additionalProperties": false,
+          "description": "Remove marks by name or address"
+        },
+        "clear": {
+          "type": "object",
+          "properties": {
+            "op": {
+              "type": "string",
+              "const": "clear",
+              "description": "Operation type: clear all marks"
+            }
+          },
+          "required": [
+            "op"
+          ],
+          "additionalProperties": false,
+          "description": "Remove all marks"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Local mark operations. Exactly one operation type (add/remove/clear) must be specified."
+    }
+  }
+}

package/dist/schemas/machineNode2file.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/machineNode2file.json",
+  "title": "Machine Node to File",
+  "description": "Export Machine node definition to JSON/Markdown file",
+  "$ref": "#/definitions/machineNode2file",
+  "definitions": {
+    "machineNode2file": {
+      "type": "object",
+      "properties": {
+        "machine": {
+          "type": "string",
+          "description": "Machine 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/machineNode2file/properties/machine",
+              "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/machineNode2file/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": [
+        "machine",
+        "file_path"
+      ],
+      "additionalProperties": false,
+      "description": "Query a Machine object from the blockchain and export its node definition to a JSON or Markdown file. The exported file can be edited and used to create new Machine objects."
+    }
+  }
+}