@wowok/agent-mcp 2.2.14 → 2.2.16

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.d.ts

@@ -15693,7 +15693,7 @@ declare const WatchQueryOperationsSchema: z.ZodEffects<z.ZodUnion<[z.ZodDiscrimi
         name_or_address?: string | undefined;
         local_mark_first?: boolean | undefined;
     }>]>;
-    all_type: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"CoinWrapper">, z.ZodNull]>>;
     cursor: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
     limit: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodNull]>>;
     no_cache: z.ZodOptional<z.ZodBoolean>;
@@ -15704,9 +15704,9 @@ declare const WatchQueryOperationsSchema: z.ZodEffects<z.ZodUnion<[z.ZodDiscrimi
         local_mark_first?: boolean | undefined;
     };
     query_type: "onchain_received";
+    type?: string | null | undefined;
     no_cache?: boolean | undefined;
     network?: import("@wowok/wowok").ENTRYPOINT | undefined;
-    all_type?: boolean | undefined;
     cursor?: string | null | undefined;
     limit?: number | null | undefined;
 }, {
@@ -15715,9 +15715,9 @@ declare const WatchQueryOperationsSchema: z.ZodEffects<z.ZodUnion<[z.ZodDiscrimi
         local_mark_first?: boolean | undefined;
     };
     query_type: "onchain_received";
+    type?: string | null | undefined;
     no_cache?: boolean | undefined;
     network?: import("@wowok/wowok").ENTRYPOINT | undefined;
-    all_type?: boolean | undefined;
     cursor?: string | null | undefined;
     limit?: number | null | undefined;
 }>]>]>, {
@@ -15803,9 +15803,9 @@ declare const WatchQueryOperationsSchema: z.ZodEffects<z.ZodUnion<[z.ZodDiscrimi
         local_mark_first?: boolean | undefined;
     };
     query_type: "onchain_received";
+    type?: string | null | undefined;
     no_cache?: boolean | undefined;
     network?: import("@wowok/wowok").ENTRYPOINT | undefined;
-    all_type?: boolean | undefined;
     cursor?: string | null | undefined;
     limit?: number | null | undefined;
 }, unknown>;

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
 `;
@@ -598,12 +598,15 @@ const WatchQueryOperationsSchema = z.preprocess((input) => {
         z.object({
             query_type: z.literal("onchain_received"),
             name_or_address: AccountOrMark_AddressAISchema.describe("Name or address of the object that received payments/items - can be a string (name/address) or full object"),
-            all_type: z.boolean().optional().describe("Set to true to query all token types received; defaults to the object's Token type '0x2::payment::CoinWrapper<TOKEN>' (Coins wrapper sent via Payment object). If the object has no Token type, the call will fail."),
+            type: z.union([z.string(), z.literal("CoinWrapper"), z.null()]).optional().describe("Type filter for querying received objects. " +
+                "- If undefined or null: query all types (equivalent to the old all_type=true). " +
+                "- If 'CoinWrapper': query CoinWrapper type for the object's token (equivalent to the old all_type=false). " +
+                "- If string: query specific StructType (e.g., '0x2::payment::CoinWrapper<0x2::wow::WOW>')."),
             cursor: z.union([z.string(), z.null()]).optional().describe("Pagination cursor from previous page"),
             limit: z.union([z.number(), z.null()]).optional().describe("Max records per page"),
             no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
             network: EntrypointSchema.optional(),
-        }).describe("Query objects (Payments, Tokens, NFTs) received by a specific object. Use to track incoming payments or items sent to an on-chain object. Supports pagination and all_type filter. Returns: ReceivedBalance | ReceivedNormal[]"),
+        }).describe("Query objects (Payments, Tokens, NFTs) received by a specific object. Use to track incoming payments or items sent to an on-chain object. Supports pagination and type filter. Returns: ReceivedBalance | ReceivedNormal[]"),
     ]),
 ]));
 async function handleOnchainOperations(args) {
@@ -1040,7 +1043,7 @@ async function handleWatchQueryOperations(args) {
         case "onchain_received": {
             const queryResult = await query_received({
                 name_or_address: normalizeAccountOrMark(validated.name_or_address),
-                all_type: validated.all_type,
+                type: validated.type,
                 cursor: validated.cursor,
                 limit: validated.limit,
                 no_cache: validated.no_cache,
@@ -1394,7 +1397,7 @@ async function main() {
             + "ONCHAIN (blockchain):\n"
             + "7. onchain_personal_profile — Query any user's PUBLIC on-chain profile: social links, reputation (likes/dislikes), personal info records, voting history, referrer.\n"
             + "8. onchain_objects — Batch query on-chain WOWOK objects by ID or name: supports Service, Machine, Order, Treasury, Reward, Arb, Personal, Contact, and more.\n"
-            + "9. onchain_received — Query objects (Payments, Tokens, NFTs) received by a specific object. Supports pagination and all_type filter.\n\n"
+            + "9. onchain_received — Query objects (Payments, Tokens, NFTs) received by a specific object. Supports pagination and type filter.\n\n"
             + "For dynamic table data queries (pagination, table items), use the 'onchain_table_data' tool.",
         inputSchema: WatchQueryOperationsSchema,
         outputSchema: z.object({

package/dist/schema/common/index.d.ts

@@ -568,44 +568,6 @@ export declare const QueryEnvSchema: z.ZodObject<{
     no_cache?: boolean | undefined;
     network?: ENTRYPOINT | undefined;
 }>;
-export declare const QueryReceivedSchema: z.ZodObject<{
-    no_cache: z.ZodOptional<z.ZodBoolean>;
-    network: z.ZodOptional<z.ZodEnum<[ENTRYPOINT.Localnet, ENTRYPOINT.Testnet]>>;
-} & {
-    name_or_address: z.ZodUnion<[z.ZodString, z.ZodObject<{
-        name_or_address: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
-        local_mark_first: z.ZodOptional<z.ZodBoolean>;
-    }, "strict", z.ZodTypeAny, {
-        name_or_address?: string | undefined;
-        local_mark_first?: boolean | undefined;
-    }, {
-        name_or_address?: string | undefined;
-        local_mark_first?: boolean | undefined;
-    }>]>;
-    all_type: z.ZodOptional<z.ZodBoolean>;
-    cursor: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
-    limit: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodNull]>>;
-}, "strict", z.ZodTypeAny, {
-    name_or_address: string | {
-        name_or_address?: string | undefined;
-        local_mark_first?: boolean | undefined;
-    };
-    no_cache?: boolean | undefined;
-    network?: ENTRYPOINT | undefined;
-    all_type?: boolean | undefined;
-    cursor?: string | null | undefined;
-    limit?: number | null | undefined;
-}, {
-    name_or_address: string | {
-        name_or_address?: string | undefined;
-        local_mark_first?: boolean | undefined;
-    };
-    no_cache?: boolean | undefined;
-    network?: ENTRYPOINT | undefined;
-    all_type?: boolean | undefined;
-    cursor?: string | null | undefined;
-    limit?: number | null | undefined;
-}>;
 export declare const ReceivedBalanceObjectSchema: z.ZodObject<{
     id: z.ZodString;
     balance: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
@@ -837,7 +799,6 @@ export type GuardTableItem = z.infer<typeof GuardTableItemSchema>;
 export type Entrypoint = z.infer<typeof EntrypointSchema>;
 export type ObjectBase = z.infer<typeof ObjectBaseSchema>;
 export type QueryEnv = z.infer<typeof QueryEnvSchema>;
-export type QueryReceived = z.infer<typeof QueryReceivedSchema>;
 export type ReceivedBalance = z.infer<typeof ReceivedBalanceSchema>;
 export type ReceivedNormal = z.infer<typeof ReceivedNormalSchema>;
 export type QueryReceivedResult = z.infer<typeof QueryReceivedResultSchema>;

package/dist/schema/common/index.js

@@ -272,12 +272,6 @@ export const QueryEnvSchema = z.object({
     no_cache: z.boolean().optional().describe("Whether to disable cache"),
     network: EntrypointSchema.optional(),
 }).strict().describe("Query environment parameters");
-export const QueryReceivedSchema = QueryEnvSchema.extend({
-    name_or_address: AccountOrMark_AddressAISchema,
-    all_type: z.boolean().optional().describe("Whether to query all types of received objects"),
-    cursor: z.union([z.string(), z.null()]).optional().describe("Pagination cursor"),
-    limit: z.union([z.number(), z.null()]).optional().describe("Number of records returned per page"),
-}).strict().describe("Request parameters for querying object's received objects");
 export const ReceivedBalanceObjectSchema = z.object({
     id: z.string().describe("Received CoinWrapper object ID"),
     balance: BalanceTypeSchema,

package/dist/schema/messenger/index.d.ts

@@ -496,8 +496,8 @@ export declare const MessageFilterSchema: z.ZodObject<{
     skipAutoMarkViewed: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     status?: "pending" | "confirmed" | "read" | "failed" | "rejected" | "decrypted" | "decrypt_failed" | undefined;
-    limit?: number | undefined;
     account?: string | undefined;
+    limit?: number | undefined;
     contentType?: "text" | "wip" | "zip" | "wts" | undefined;
     direction?: "received" | "sent" | undefined;
     msgType?: 1 | 3 | undefined;
@@ -538,8 +538,8 @@ export declare const MessageFilterSchema: z.ZodObject<{
     viewedAtEnd?: number | undefined;
 }, {
     status?: "pending" | "confirmed" | "read" | "failed" | "rejected" | "decrypted" | "decrypt_failed" | undefined;
-    limit?: number | undefined;
     account?: string | undefined;
+    limit?: number | undefined;
     contentType?: "text" | "wip" | "zip" | "wts" | undefined;
     direction?: "received" | "sent" | undefined;
     msgType?: 1 | 3 | undefined;
@@ -1645,8 +1645,8 @@ export declare const MessengerOperationInputSchema: z.ZodDiscriminatedUnion<"ope
         skipAutoMarkViewed: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         status?: "pending" | "confirmed" | "read" | "failed" | "rejected" | "decrypted" | "decrypt_failed" | undefined;
-        limit?: number | undefined;
         account?: string | undefined;
+        limit?: number | undefined;
         contentType?: "text" | "wip" | "zip" | "wts" | undefined;
         direction?: "received" | "sent" | undefined;
         msgType?: 1 | 3 | undefined;
@@ -1687,8 +1687,8 @@ export declare const MessengerOperationInputSchema: z.ZodDiscriminatedUnion<"ope
         viewedAtEnd?: number | undefined;
     }, {
         status?: "pending" | "confirmed" | "read" | "failed" | "rejected" | "decrypted" | "decrypt_failed" | undefined;
-        limit?: number | undefined;
         account?: string | undefined;
+        limit?: number | undefined;
         contentType?: "text" | "wip" | "zip" | "wts" | undefined;
         direction?: "received" | "sent" | undefined;
         msgType?: 1 | 3 | undefined;
@@ -1732,8 +1732,8 @@ export declare const MessengerOperationInputSchema: z.ZodDiscriminatedUnion<"ope
     operation: "watch_messages";
     filter?: {
         status?: "pending" | "confirmed" | "read" | "failed" | "rejected" | "decrypted" | "decrypt_failed" | undefined;
-        limit?: number | undefined;
         account?: string | undefined;
+        limit?: number | undefined;
         contentType?: "text" | "wip" | "zip" | "wts" | undefined;
         direction?: "received" | "sent" | undefined;
         msgType?: 1 | 3 | undefined;
@@ -1777,8 +1777,8 @@ export declare const MessengerOperationInputSchema: z.ZodDiscriminatedUnion<"ope
     operation: "watch_messages";
     filter?: {
         status?: "pending" | "confirmed" | "read" | "failed" | "rejected" | "decrypted" | "decrypt_failed" | undefined;
-        limit?: number | undefined;
         account?: string | undefined;
+        limit?: number | undefined;
         contentType?: "text" | "wip" | "zip" | "wts" | undefined;
         direction?: "received" | "sent" | undefined;
         msgType?: 1 | 3 | undefined;

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-20T13:29:28.773Z",
   "tools": [
     {
       "name": "onchain_operations",

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "@wowok/agent-mcp",
-  "version": "2.2.14",
+  "version": "2.2.16",
   "description": "Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "module": "node",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wowok-ai/agent.git"
+  },
+  "homepage": "https://wowok.net",
   "files": [
     "dist",
     "docs",
@@ -31,7 +36,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@wowok/wowok": "2.2.13",
+    "@wowok/wowok": "2.2.14",
     "lodash": "^4.18.1",
     "zod": "^3.25.76"
   },

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"
-  ]
-}