wowok_agent 2.2.6 → 2.2.8

package/README.md

@@ -3,7 +3,9 @@ Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.
 
 GitHub: [https://github.com/wowok-ai/agent](https://github.com/wowok-ai/agent)
 
-Docs: [https://github.com/wowok-ai/docs/](https://github.com/wowok-ai/docs/)   
+AI Skills: [https://github.com/wowok-ai/skills](https://github.com/wowok-ai/skills) - Significantly reduces MCP Server learning curve
+
+Docs: [https://github.com/wowok-ai/docs/](https://github.com/wowok-ai/docs/)
 
 ## Quick Start
 
@@ -23,97 +25,19 @@ Docs: [https://github.com/wowok-ai/docs/](https://github.com/wowok-ai/docs/)
 }
 ```
 
-### 2. Use Claude Skills (Optional but Recommended)
-
-This repository includes **Claude Skills** that help AI assistants use WoWok tools correctly. Skills solve common AI challenges:
-
-- **Complex system building** — Dependency chains, build order, step-by-step patterns
-- **Tool usage failures** — Correct parameter formats, tool selection, error recovery
-- **Safety & authorization** — User confirmation for important operations
-
-#### Setup Skills
-
-This repository includes a pre-configured `.claude/settings.json` that references the `skills/` directory. You have three options:
-
-**Option A: Use skills directly in this repo (Recommended for development)**
-
-The repository already contains `.claude/settings.json` configured to use `skills/`:
-
-```bash
-git clone https://github.com/wowok-ai/mcp.git
-cd mcp
-# Claude Code will automatically detect and use the skills
-```
-
-**Option B: Copy skills to your own project**
+### 2. Use WoWok Skills (Recommended)
 
-If you want to customize or own the skills in your project:
+**Skills significantly reduce the learning curve and usage difficulty of the MCP Server.**
 
 ```bash
-# From your project directory
-mkdir -p .claude/skills
-cp -r /path/to/mcp/skills/* .claude/skills/
-
-# Or clone and copy
-git clone https://github.com/wowok-ai/mcp.git /tmp/wowok-mcp
-cp -r /tmp/wowok-mcp/skills/* .claude/skills/
-```
-
-Then create `.claude/settings.json` in your project:
-
-```json
-{
-  "skills": {
-    "directories": [
-      "./skills"
-    ]
-  }
-}
+npm install -g wowok-skills
 ```
 
-**Option C: Reference skills from mcp repo (Recommended for production)**
+Skills provide structured guidance for AI assistants:
 
-Keep skills in the mcp repo and reference them from your project:
-
-```json
-// .claude/settings.json in YOUR project
-{
-  "skills": {
-    "directories": [
-      "/path/to/mcp/skills"
-    ]
-  }
-}
-```
-
-This way you get updates when the mcp repo is updated.
-
-#### Migrating Skills to Your Project
-
-To fully migrate skills to your own project (for customization):
-
-```bash
-# 1. Copy all skills
-mkdir -p .claude/skills
-cp -r /path/to/mcp/skills/* .claude/skills/
-
-# 2. Create settings.json
-cat > .claude/settings.json << 'EOF'
-{
-  "skills": {
-    "directories": [
-      "./skills"
-    ]
-  }
-}
-EOF
-
-# 3. Verify structure
-ls -la .claude/skills/
-# Should show: wowok-build, wowok-guard, wowok-tools, etc.
-```
-
-Now you can modify the skills in `.claude/skills/` to suit your needs.
+- **Complex system building** — Dependency chains, build order, step-by-step patterns
+- **Tool usage failures** — Correct parameter formats, tool selection, error recovery
+- **Safety & authorization** — User confirmation for important operations
 
 #### Available Skills
 
@@ -126,5 +50,7 @@ Now you can modify the skills in `.claude/skills/` to suit your needs.
 | `wowok-machine` | Machine workflow design (state machines, progress tracking) |
 | `wowok-order` | Order lifecycle management (payment, allocation, arbitration) |
 
-## Development
+#### Using Skills
+
+Once installed, Claude Code will automatically use these skills when working with WoWok tools.
 

package/dist/index.d.ts

@@ -714,7 +714,7 @@ declare const OnchainOperationsSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"ope
         }, {
             coin: string;
         }>]>>;
-        compensation_locked_time_add: z.ZodOptional<z.ZodNumber>;
+        setting_locked_time_add: z.ZodOptional<z.ZodNumber>;
         compensation_fund_receive: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
             balance: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
             token_type: z.ZodEffects<z.ZodString, string, string>;
@@ -978,7 +978,7 @@ declare const OnchainOperationsSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"ope
         } | {
             coin: string;
         } | undefined;
-        compensation_locked_time_add?: number | undefined;
+        setting_locked_time_add?: number | undefined;
         compensation_fund_receive?: {
             received: {
                 id: string;
@@ -1170,7 +1170,7 @@ declare const OnchainOperationsSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"ope
         } | {
             coin: string;
         } | undefined;
-        compensation_locked_time_add?: number | undefined;
+        setting_locked_time_add?: number | undefined;
         compensation_fund_receive?: {
             received: {
                 id: string;
@@ -1563,7 +1563,7 @@ declare const OnchainOperationsSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"ope
         } | {
             coin: string;
         } | undefined;
-        compensation_locked_time_add?: number | undefined;
+        setting_locked_time_add?: number | undefined;
         compensation_fund_receive?: {
             received: {
                 id: string;
@@ -1792,7 +1792,7 @@ declare const OnchainOperationsSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"ope
         } | {
             coin: string;
         } | undefined;
-        compensation_locked_time_add?: number | undefined;
+        setting_locked_time_add?: number | undefined;
         compensation_fund_receive?: {
             received: {
                 id: string;
@@ -13164,7 +13164,7 @@ declare const OnchainOperationsSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"ope
     } | undefined;
 }>, z.ZodObject<{
     operation_type: z.ZodLiteral<"gen_passport">;
-    guard: z.ZodString;
+    guard: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
     info: z.ZodOptional<z.ZodObject<{
         type: z.ZodLiteral<"submission">;
         guard: z.ZodArray<z.ZodObject<{
@@ -13365,7 +13365,7 @@ declare const OnchainOperationsSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"ope
         referrer?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    guard: string;
+    guard: string | string[];
     operation_type: "gen_passport";
     env?: {
         account: string;
@@ -13402,7 +13402,7 @@ declare const OnchainOperationsSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"ope
         }[];
     } | undefined;
 }, {
-    guard: string;
+    guard: string | string[];
     operation_type: "gen_passport";
     env?: {
         no_cache?: boolean | undefined;
@@ -13621,7 +13621,7 @@ declare const OnchainOperationsSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"ope
         } | {
             coin: string;
         } | undefined;
-        compensation_locked_time_add?: number | undefined;
+        setting_locked_time_add?: number | undefined;
         compensation_fund_receive?: {
             received: {
                 id: string;
@@ -15134,7 +15134,7 @@ declare const OnchainOperationsSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"ope
         referrer?: string | undefined;
     } | undefined;
 } | {
-    guard: string;
+    guard: string | string[];
     operation_type: "gen_passport";
     env?: {
         account: string;

package/dist/index.js

@@ -271,10 +271,10 @@ const OnchainOperationsSchema = z.preprocess((input) => {
     }).describe("📦 Order Object: Manage the order lifecycle, Including operating order arbitration (Arb Object associated with the order), advancing progress (Progress Object associated with the order), extracting order refunds/payments, setting agents, etc."),
     z.object({
         operation_type: z.literal("gen_passport"),
-        guard: z.string().describe("Guard object ID to verify and generate passport from"),
+        guard: z.union([z.string(), z.array(z.string())]).describe("Guard object ID(s) to verify and generate passport from. Can be a single guard (string) or multiple guards (array of strings). Supports guard names or addresses."),
         info: SubmissionCallSchema.optional().describe("Optional submission data. If not provided, will attempt to get existing submissions from the guard."),
         env: CallEnvSchema.optional(),
-    }).describe("🛂 Generate Verified Passport Object: Create immutable verified credentials after Guard validation passes."),
+    }).describe("🛂 Generate Verified Passport Object: Create immutable verified credentials after Guard validation passes. Supports verifying multiple guards at once."),
 ]));
 const WipOperationsSchema = z.preprocess((input) => {
     if (typeof input === 'object' && input !== null) {

package/dist/schema/call/guard.d.ts

@@ -519,7 +519,7 @@ export declare const CallGuard_InputSchema: z.ZodObject<{
     } | undefined;
 }>;
 export declare const CallGenPassport_InputSchema: z.ZodObject<{
-    guard: z.ZodEffects<z.ZodString, string, string>;
+    guard: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">]>;
     info: z.ZodOptional<z.ZodObject<{
         type: z.ZodLiteral<"submission">;
         guard: z.ZodArray<z.ZodObject<{
@@ -720,7 +720,7 @@ export declare const CallGenPassport_InputSchema: z.ZodObject<{
         referrer?: string | undefined;
     }>>;
 }, "strict", z.ZodTypeAny, {
-    guard: string;
+    guard: string | string[];
     env?: {
         account: string;
         no_cache?: boolean | undefined;
@@ -756,7 +756,7 @@ export declare const CallGenPassport_InputSchema: z.ZodObject<{
         }[];
     } | undefined;
 }, {
-    guard: string;
+    guard: string | string[];
     env?: {
         no_cache?: boolean | undefined;
         network?: import("wowok").ENTRYPOINT | undefined;

package/dist/schema/call/guard.js

@@ -29,10 +29,10 @@ export const CallGuard_InputSchema = z.object({
     env: CallEnvSchema.optional(),
 }).strict().describe("On-chain Guard creation input wrapper. Contains the Guard data definition and optional environment settings.");
 export const CallGenPassport_InputSchema = z.object({
-    guard: NameOrAddressSchema.describe("Guard object ID to verify and generate passport from"),
+    guard: z.union([NameOrAddressSchema, z.array(NameOrAddressSchema)]).describe("Guard object ID(s) to verify and generate passport from. Can be a single guard (string) or multiple guards (array of strings). Supports guard names or addresses."),
     info: SubmissionCallSchema.optional().describe("Optional submission data. If not provided, will attempt to get existing submissions from the guard."),
     env: CallEnvSchema.optional(),
-}).strict().describe("Generate a new Passport object after Guard verification succeeds. The Passport is an immutable on-chain object that can be used for offline friend verification, transaction condition verification, etc.");
+}).strict().describe("Generate a new Passport object after Guard verification succeeds. The Passport is an immutable on-chain object that can be used for offline friend verification, transaction condition verification, etc. Supports verifying multiple guards at once.");
 export const Guard2File_InputSchema = z.object({
     guard: NameOrAddressSchema.describe("Guard object ID or name to export"),
     file_path: z.string().describe("Output file path (absolute or relative)"),

package/dist/schema/call/reward.d.ts

@@ -1,34 +1,4 @@
 import { z } from "zod";
-export declare const RecipientGuardIdentifierSchema: z.ZodObject<{
-    type: z.ZodLiteral<"GuardIdentifier">;
-    GuardIdentifier: z.ZodNumber;
-}, "strict", z.ZodTypeAny, {
-    type: "GuardIdentifier";
-    GuardIdentifier: number;
-}, {
-    type: "GuardIdentifier";
-    GuardIdentifier: number;
-}>;
-export declare const RecipientEntitySchema: z.ZodObject<{
-    type: z.ZodLiteral<"Entity">;
-    Entity: z.ZodEffects<z.ZodString, string, string>;
-}, "strict", z.ZodTypeAny, {
-    type: "Entity";
-    Entity: string;
-}, {
-    type: "Entity";
-    Entity: string;
-}>;
-export declare const RecipientSignerSchema: z.ZodObject<{
-    type: z.ZodLiteral<"Signer">;
-    Signer: z.ZodBoolean;
-}, "strict", z.ZodTypeAny, {
-    type: "Signer";
-    Signer: boolean;
-}, {
-    type: "Signer";
-    Signer: boolean;
-}>;
 export declare const RewardRecordSchema: z.ZodObject<{
     amount: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
     time: z.ZodNumber;

package/dist/schema/call/reward.js

@@ -1,19 +1,7 @@
 import { z } from "zod";
 import { TypedPermissionObjectSchema, CoinParamSchema, CallEnvSchema, SubmissionCallSchema, } from "./base.js";
 import { RewardGuardSchema } from "../query/index.js";
-import { BalanceTypeSchema, ReceivedObjectsOrRecentlySchema, ReceivedBalanceOrRecentlySchema, NameOrAddressSchema, GuardIdentifierSchema, DescriptionSchema } from "../common/index.js";
-export const RecipientGuardIdentifierSchema = z.object({
-    type: z.literal("GuardIdentifier"),
-    GuardIdentifier: GuardIdentifierSchema,
-}).strict().describe("Get recipient ID from specified data index in Guard table. The ID must be of address type.");
-export const RecipientEntitySchema = z.object({
-    type: z.literal("Entity"),
-    Entity: NameOrAddressSchema,
-}).strict().describe("Fixed entity ID");
-export const RecipientSignerSchema = z.object({
-    type: z.literal("Signer"),
-    Signer: z.boolean(),
-}).strict().describe("Signer ID");
+import { BalanceTypeSchema, ReceivedObjectsOrRecentlySchema, ReceivedBalanceOrRecentlySchema, NameOrAddressSchema, DescriptionSchema } from "../common/index.js";
 export const RewardRecordSchema = z.object({
     amount: BalanceTypeSchema,
     time: z.number().int(),

package/dist/schema/call/service.d.ts

@@ -1190,7 +1190,7 @@ export declare const CallService_DataSchema: z.ZodObject<{
     }, {
         coin: string;
     }>]>>;
-    compensation_locked_time_add: z.ZodOptional<z.ZodNumber>;
+    setting_locked_time_add: z.ZodOptional<z.ZodNumber>;
     compensation_fund_receive: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
         balance: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
         token_type: z.ZodEffects<z.ZodString, string, string>;
@@ -1454,7 +1454,7 @@ export declare const CallService_DataSchema: z.ZodObject<{
     } | {
         coin: string;
     } | undefined;
-    compensation_locked_time_add?: number | undefined;
+    setting_locked_time_add?: number | undefined;
     compensation_fund_receive?: {
         received: {
             id: string;
@@ -1646,7 +1646,7 @@ export declare const CallService_DataSchema: z.ZodObject<{
     } | {
         coin: string;
     } | undefined;
-    compensation_locked_time_add?: number | undefined;
+    setting_locked_time_add?: number | undefined;
     compensation_fund_receive?: {
         received: {
             id: string;
@@ -2369,7 +2369,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
         }, {
             coin: string;
         }>]>>;
-        compensation_locked_time_add: z.ZodOptional<z.ZodNumber>;
+        setting_locked_time_add: z.ZodOptional<z.ZodNumber>;
         compensation_fund_receive: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
             balance: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
             token_type: z.ZodEffects<z.ZodString, string, string>;
@@ -2633,7 +2633,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
         } | {
             coin: string;
         } | undefined;
-        compensation_locked_time_add?: number | undefined;
+        setting_locked_time_add?: number | undefined;
         compensation_fund_receive?: {
             received: {
                 id: string;
@@ -2825,7 +2825,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
         } | {
             coin: string;
         } | undefined;
-        compensation_locked_time_add?: number | undefined;
+        setting_locked_time_add?: number | undefined;
         compensation_fund_receive?: {
             received: {
                 id: string;
@@ -3218,7 +3218,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
         } | {
             coin: string;
         } | undefined;
-        compensation_locked_time_add?: number | undefined;
+        setting_locked_time_add?: number | undefined;
         compensation_fund_receive?: {
             received: {
                 id: string;
@@ -3446,7 +3446,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
         } | {
             coin: string;
         } | undefined;
-        compensation_locked_time_add?: number | undefined;
+        setting_locked_time_add?: number | undefined;
         compensation_fund_receive?: {
             received: {
                 id: string;

package/dist/schema/call/service.js

@@ -68,7 +68,7 @@ export const CallService_DataSchema = z.object({
     order_allocators: z.union([AllocatorsSchema, z.null()]).optional().describe("Order fund allocator."),
     buy_guard: z.union([NameOrAddressSchema, z.null()]).optional().describe("Buy guard object ID or name."),
     compensation_fund_add: CoinParamSchema.optional().describe("Compensation fund. Used to claim compensation based on the arbitration result of the Arb object when resolving order disputes."),
-    compensation_locked_time_add: z.number().optional().describe("Lock time for compensation funds added to orders (milliseconds)."),
+    setting_locked_time_add: z.number().optional().describe("Additional lock duration (milliseconds) to extend the 'setting_lock_duration'. Initial value is 30 days, can only be increased, not decreased. Affects: rewards, arbitrations, and compensation_fund_receive."),
     compensation_fund_receive: ReceivedBalanceOrRecentlySchema.optional().describe("Receive order compensation funds."),
     owner_receive: ReceivedObjectsOrRecentlySchema.optional().describe("Unwrap CoinWrapper objects and other objects received by this object and send them to the owner of its Permission object."),
     um: z.union([NameOrAddressSchema, z.null()]).optional().describe("Contact object ID or name."),

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "wowok_agent",
-  "version": "2.2.6",
+  "version": "2.2.8",
   "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",
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "bin": {
     "wowok_agent": "dist/index.js"
@@ -30,7 +31,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "lodash": "^4.18.1",
-    "wowok": "2.2.8",
+    "wowok": "2.2.10",
     "zod": "^3.25.76"
   },
   "devDependencies": {