@wowok/agent-mcp 2.2.14 → 2.2.15

package/README.md

@@ -39,18 +39,26 @@ Skills provide structured guidance for AI assistants:
 - **Tool usage failures** — Correct parameter formats, tool selection, error recovery
 - **Safety & authorization** — User confirmation for important operations
 
-#### Available Skills
-
-| Skill | Purpose |
-|-------|---------|
-| `wowok-build` | Complex system building (Service + Machine + Guard + Allocation + Reward) |
-| `wowok-guard` | Guard design mastery (programmable trust rules) |
-| `wowok-tools` | MCP tool usage mastery (13 tools, common pitfalls) |
-| `wowok-safety` | Safety & authorization protocol (dry-run → confirm → execute) |
-| `wowok-machine` | Machine workflow design (state machines, progress tracking) |
-| `wowok-order` | Order lifecycle management (payment, allocation, arbitration) |
+#### Available Skills (Organized by Role)
+
+| Skill | Role | Purpose |
+|-------|------|---------|
+| `wowok-order` | 👤 Customer | Order lifecycle — place orders, track progress, submit disputes, claim compensation |
+| `wowok-provider` | 🏪 Provider | Service provider guide — create Service, design Machine, configure Allocators |
+| `wowok-machine` | 🏪 Provider | Workflow design — state machines, node definitions, progress tracking |
+| `wowok-arbitrator` | ⚖️ Arbitrator | Arbitration service — dispute resolution, voting organization, fee management |
+| `wowok-guard` | 🛠️ Shared | Guard design mastery — programmable trust rules, multi-signature authorization |
+| `wowok-tools` | 🛠️ Shared | MCP tool usage mastery — 13+ tools, parameter formats, schema references |
+| `wowok-safety` | 🛠️ Shared | Safety protocol — dry-run validation, user confirmation checkpoints |
+
+#### Role-Based Skill Selection
+
+- **Use `wowok-order`** when user acts as a customer/buyer placing orders
+- **Use `wowok-provider`** + `wowok-machine` when user is a merchant/service provider
+- **Use `wowok-arbitrator`** when user operates dispute resolution services
+- **Use `wowok-tools`** + `wowok-safety`** (always loaded) for all roles
+- **Use `wowok-guard`** when designing complex validation rules
 
 #### Using Skills
 
 Once installed, Claude Code will automatically use these skills when working with WoWok tools.
-

package/dist/index.js

@@ -89,7 +89,7 @@ Token amounts are HIGHLY SENSITIVE. Always:
 | Send encrypted file via messenger | messenger_operation (send_file) | wip_file |
 | Generate witness timestamp (WTS) | messenger_operation (generate_wts) | wip_file |
 | Query protocol constants | wowok_buildin_info | query_toolkit |
-| Get documentation URL | documents_and_learn | wowok_buildin_info |
+| Query tool schemas | schema_query | wowok_buildin_info |
 
 ## Local vs On-chain Operations
 
@@ -107,7 +107,7 @@ Token amounts are HIGHLY SENSITIVE. Always:
 - query_toolkit
 - onchain_events
 - wowok_buildin_info
-- documents_and_learn
+- schema_query
 - guard2file
 - machineNode2file
 `;

package/dist/schema/query/index.js

@@ -117,7 +117,7 @@ export const ObjectOrderSchema = ObjectBaseSchema.extend({
     amount: BalanceTypeSchema.describe("Order amount"),
     builder: z.string().describe("Purchaser ID"),
     service: z.string().describe("Service ID"),
-    dispute: z.array(z.string()).describe("Dispute object ID list. When unsatisfied with order delivery, dispute objects can be created."),
+    dispute: z.array(z.string()).describe("Arb object ID list. When unsatisfied with order delivery, dispute objects can be created."),
     agent: z.array(z.string()).describe("Agent ID list. Agents handle all order operations except payment collection."),
     allocation: z.union([z.string(), z.null()]).describe("Order amount allocation object ID"),
     claimed_by: z.union([z.string(), z.null()]).describe("Order dispute object ID that has claimed order arbitration amount."),

package/dist/schemas/index.json

@@ -2,7 +2,7 @@
   "$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",
+  "generatedAt": "2026-05-20T11:48:42.252Z",
   "tools": [
     {
       "name": "onchain_operations",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wowok/agent-mcp",
-  "version": "2.2.14",
+  "version": "2.2.15",
   "description": "Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/schemas/operations/guard.json

@@ -1,163 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://wowok.net/schemas/operations/guard.json",
-  "title": "Guard Operation",
-  "description": "On-chain Guard operations",
-  "type": "object",
-  "properties": {
-    "operation_type": {
-      "const": "guard"
-    },
-    "data": {
-      "type": "object",
-      "description": "On-chain Guard creation. IMPORTANT: All defined data (include all submitted data) must be defined in the 'table' field. USAGE: Set 'namedNew' field with {name, tags?, onChain?} to name the new Guard. The Guard is immutable once created. Define the validation logic in 'root' field. When root.type='file', the file can contain all Guard fields, and any fields defined in the schema will OVERRIDE the file content.",
-      "properties": {
-        "namedNew": {
-          "type": "object",
-          "description": "Name and optional tags for the new Guard object. Set 'onChain: true' to create a public on-chain identity. When using root.type='file', this field OVERRIDES namedNew in the file.",
-          "properties": {
-            "name": {
-              "type": "string",
-              "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."
-            },
-            "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."
-            }
-          },
-          "additionalProperties": false
-        },
-        "description": {
-          "type": "string",
-          "description": "Guard description. When using root.type='file', this field OVERRIDES description in the file."
-        },
-        "table": {
-          "type": "array",
-          "description": "Data table of the Guard object. When using root.type='file', this field OVERRIDES table in the file.",
-          "items": {
-            "type": "object",
-            "properties": {
-              "identifier": {
-                "type": "integer",
-                "minimum": 0,
-                "maximum": 255,
-                "description": "Identifier index (0-255) for referencing this value in Guard nodes"
-              },
-              "bWitness": {
-                "type": "boolean",
-                "description": "Whether this is a witness parameter (provided at runtime)"
-              },
-              "value_type": {
-                "type": "string",
-                "description": "Value type: Bool, Address, String, U8, U16, U32, U64, U128, U256, VecBool, VecAddress, VecString, VecU8, VecU16, VecU32, VecU64, VecU128, VecU256, VecVecU8"
-              },
-              "value": {
-                "description": "The actual value (omit if bWitness is true)"
-              }
-            },
-            "required": [
-              "identifier",
-              "bWitness",
-              "value_type"
-            ]
-          }
-        },
-        "root": {
-          "description": "Root definition: either a direct node tree (type='node') or a file reference (type='file'). When type='file', the file can define all Guard fields (namedNew, description, table, root, rely), and schema fields override file content.",
-          "oneOf": [
-            {
-              "type": "object",
-              "description": "Direct node tree",
-              "properties": {
-                "type": {
-                  "const": "node"
-                },
-                "node": {
-                  "type": "object",
-                  "description": "Guard computational tree root node. MUST return a Bool value (pass/fail). See GuardNode documentation for details.",
-                  "properties": {
-                    "type": {
-                      "type": "string"
-                    }
-                  },
-                  "additionalProperties": true
-                }
-              },
-              "required": [
-                "type",
-                "node"
-              ]
-            },
-            {
-              "type": "object",
-              "description": "File reference",
-              "properties": {
-                "type": {
-                  "const": "file"
-                },
-                "file_path": {
-                  "type": "string",
-                  "description": "Path to JSON or Markdown file containing Guard definition"
-                },
-                "format": {
-                  "type": "string",
-                  "enum": [
-                    "json",
-                    "markdown"
-                  ],
-                  "default": "json",
-                  "description": "File format: 'json' or 'markdown'"
-                }
-              },
-              "required": [
-                "type",
-                "file_path"
-              ]
-            }
-          ]
-        },
-        "rely": {
-          "type": "object",
-          "description": "All Guard objects that the new Guard object depends on.",
-          "properties": {
-            "guards": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              },
-              "description": "List of dependent Guard object IDs or names."
-            },
-            "logic_or": {
-              "type": "boolean",
-              "description": "Whether to use logical OR operator."
-            }
-          },
-          "required": [
-            "guards"
-          ]
-        }
-      },
-      "required": [
-        "root"
-      ]
-    },
-    "env": {
-      "type": "object"
-    }
-  },
-  "required": [
-    "operation_type",
-    "data"
-  ]
-}

package/dist/schemas/operations/permission.json

@@ -1,22 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://wowok.net/schemas/operations/permission.json",
-  "title": "Permission Operation",
-  "description": "On-chain Permission operations",
-  "type": "object",
-  "properties": {
-    "operation_type": {
-      "const": "permission"
-    },
-    "data": {
-      "$ref": "../onchain_operations_permission.schema.json#/properties/data"
-    },
-    "env": {
-      "type": "object"
-    }
-  },
-  "required": [
-    "operation_type",
-    "data"
-  ]
-}