@wowok/skills 1.0.6

package/examples/Travel/calc-weather-timestamps.js

@@ -0,0 +1,8 @@
+
+const now = Date.now();
+const oneDay = 24 * 60 * 60 * 1000;
+
+for (let i = 4; i >= 0; i--) {
+    const ts = now - i * oneDay;
+    console.log(`Day ${4 - i + 1}: ${ts}`);
+}

package/examples/Travel/travel_machine_v2_export.json

@@ -0,0 +1,104 @@
+[
+  {
+    "name": "Ice Scooting",
+    "pairs": [
+      {
+        "prev_node": "SPA",
+        "threshold": 1,
+        "forwards": [
+          {
+            "name": "complete_trip",
+            "weight": 1,
+            "namedOperator": null,
+            "permissionIndex": 1003,
+            "guard": {
+              "guard": "0xe00d9482b61fd7e7a4782f43d678a9fb19bd101737de92e453559b5e09565b51",
+              "retained_submission": []
+            }
+          },
+          {
+            "name": "cancel_trip",
+            "weight": 1,
+            "namedOperator": null,
+            "permissionIndex": 1004,
+            "guard": {
+              "guard": "0x831cb9cfe91f81cdcedef7811f4e9b48023cf95d25887c9639615613191e6595",
+              "retained_submission": []
+            }
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "name": "Start",
+    "pairs": [
+      {
+        "prev_node": "",
+        "threshold": 0,
+        "forwards": [
+          {
+            "name": "buy_insurance",
+            "weight": 1,
+            "namedOperator": null,
+            "permissionIndex": 1000
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "name": "Buy Insurance",
+    "pairs": [
+      {
+        "prev_node": "Start",
+        "threshold": 1,
+        "forwards": [
+          {
+            "name": "go_ice_scooting",
+            "weight": 1,
+            "namedOperator": null,
+            "permissionIndex": 1001
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "name": "Cancel",
+    "pairs": [
+      {
+        "prev_node": "Ice Scooting",
+        "threshold": 1,
+        "forwards": []
+      }
+    ]
+  },
+  {
+    "name": "Complete",
+    "pairs": [
+      {
+        "prev_node": "Ice Scooting",
+        "threshold": 1,
+        "forwards": []
+      }
+    ]
+  },
+  {
+    "name": "SPA",
+    "pairs": [
+      {
+        "prev_node": "Buy Insurance",
+        "threshold": 1,
+        "forwards": [
+          {
+            "name": "go_ice_scooting",
+            "weight": 1,
+            "namedOperator": null,
+            "permissionIndex": 1002
+          }
+        ]
+      }
+    ]
+  }
+]

package/examples/Travel/weather_check_guard_v1.json

@@ -0,0 +1,51 @@
+{
+  "namedNew": {
+    "name": "weather_check_guard_v1",
+    "tags": ["weather", "check", "travel"],
+    "replaceExistName": true
+  },
+  "description": "Weather check guard for ice scooting activity. Checks if weather data exists for the activity date.",
+  "table": [
+    {
+      "identifier": 0,
+      "b_submission": false,
+      "value_type": "Address",
+      "value": "weather_repo_v2",
+      "name": "Weather Repository address"
+    },
+    {
+      "identifier": 1,
+      "b_submission": false,
+      "value_type": "String",
+      "value": "Condition",
+      "name": "Repository policy name"
+    },
+    {
+      "identifier": 2,
+      "b_submission": true,
+      "value_type": "U64",
+      "value": 0,
+      "name": "Activity date timestamp (submitted at runtime)"
+    }
+  ],
+  "root": {
+    "type": "query",
+    "query": 1166,
+    "object": {
+      "identifier": 0
+    },
+    "parameters": [
+      {
+        "type": "identifier",
+        "identifier": 1
+      },
+      {
+        "type": "convert_number_address",
+        "node": {
+          "type": "identifier",
+          "identifier": 2
+        }
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@wowok/skills",
+  "version": "1.0.6",
+  "description": "WoWok AI Skills for Claude and other AI assistants - Helping AI use WoWok MCP tools correctly",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "wowok-skills": "dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "wowok-build/",
+    "wowok-guard/",
+    "wowok-tools/",
+    "wowok-safety/",
+    "wowok-machine/",
+    "wowok-order/",
+    "examples/",
+    "schemas/",
+    "scripts/install.js",
+    "README.md"
+  ],
+  "scripts": {
+    "prebuild": "node scripts/copy-assets.js",
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build",
+    "postinstall": "node scripts/install.js",
+    "preuninstall": "node scripts/install.js"
+  },
+  "keywords": [
+    "wowok",
+    "ai",
+    "skills",
+    "claude",
+    "mcp",
+    "blockchain",
+    "web3",
+    "ai-agent"
+  ],
+  "author": "wowok <build@wowok.net>",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wowok-ai/skills.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wowok-ai/skills/issues"
+  },
+  "homepage": "https://github.com/wowok-ai/skills#readme",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.8.0"
+  },
+  "dependencies": {}
+}

package/schemas/onchain_operations/_common.md

@@ -0,0 +1,236 @@
+# onchain_operations / Common Types
+
+Shared types referenced by all `onchain_operations` operation types.
+
+---
+
+## Top-Level Structure
+
+Most operations follow this standard wrapper:
+
+```typescript
+OnchainOperations {
+  operation_type: string;     // One of 16 types
+  data: object;               // Type-specific data (required)
+  env?: CallEnv;              // Optional environment
+  submission?: SubmissionCall; // Optional Guard submission data
+}
+```
+
+### Exceptions
+
+| Operation | Structure | Notes |
+|-----------|-----------|-------|
+| `gen_passport` | `{ guard, info?, env? }` | FLAT — no `data` wrapper, no `submission` |
+| `guard` | `{ data, env? }` | No `submission` field |
+| `payment` | `{ data, env? }` | No `submission` field |
+| `personal` | `{ data, env? }` | No `submission` field |
+
+## CallEnv
+
+```typescript
+CallEnv {
+  account?: string;              // Operating account (empty = default)
+  permission_guard?: string[];   // Permission Guard ID list
+  no_cache?: boolean;            // Disable cache
+  network?: "localnet" | "testnet"; // Target network
+  referrer?: string;             // Referrer ID
+}
+```
+
+## SubmissionCall
+
+```typescript
+SubmissionCall {
+  type: "submission";
+  guard: {
+    object: string;    // Guard object name or ID
+    impack: boolean;   // Whether affects final outcome
+  }[];
+  submission: {
+    guard: string;     // Guard object name or ID
+    submission: {
+      identifier: number;        // 0-255
+      b_submission: boolean;     // Whether user submission is required
+      value_type: ValueType;     // Expected type
+      value?: SupportedValue;    // User-provided value (optional)
+      name: string;              // Name/description (default: "")
+      object_type?: ObjectType;  // Object type when value is Address
+    }[];
+  }[];
+}
+```
+
+---
+
+## Common Sub-Schemas
+
+### TypedPermissionObject
+
+```typescript
+TypedPermissionObject = 
+  | string                          // Object ID or name (existing)
+  | {
+      name?: string;                // Name for new object
+      tags?: string[];              // Tags for discoverability
+      onChain?: boolean;            // Register name on-chain
+      replaceExistName?: boolean;   // Force claim existing name
+      type_parameter: string;       // Token type parameter (default: "0x2::wow::WOW")
+      permission?: DescriptionObject;  // Permission for the new object
+    };
+```
+
+### WithPermissionObject
+
+```typescript
+WithPermissionObject = 
+  | string                           // Existing object ID or name
+  | {
+      name?: string;
+      tags?: string[];
+      onChain?: boolean;
+      replaceExistName?: boolean;
+      permission?: DescriptionObject;
+    };
+```
+
+### DescriptionObject
+
+```typescript
+DescriptionObject = 
+  | string                           // Existing object ID or name
+  | {
+      name?: string;
+      tags?: string[];
+      onChain?: boolean;
+      replaceExistName?: boolean;
+      description?: string;
+    };
+```
+
+### NormalObject
+
+```typescript
+NormalObject = 
+  | string                           // Existing object ID or name
+  | {
+      name?: string;
+      tags?: string[];
+      onChain?: boolean;
+      replaceExistName?: boolean;
+    };
+```
+
+### NamedObject
+
+```typescript
+NamedObject {
+  name?: string;
+  tags?: string[];
+  onChain?: boolean;
+  replaceExistName?: boolean;
+}
+```
+
+### CoinParam
+
+```typescript
+CoinParam = 
+  | { balance: string | number }     // Amount (can include unit like "10WOW")
+  | { coin: string };                // Specific coin object ID
+```
+
+### ObjectsOp
+
+```typescript
+ObjectsOp = {
+  op: "add" | "set" | "remove";
+  objects: string[];
+} | {
+  op: "clear";
+};
+```
+
+### AccountOrMark_Address
+
+```typescript
+AccountOrMark_Address = {
+  name_or_address?: string;
+  local_mark_first?: boolean;
+};
+```
+
+### ManyAccountOrMark_Address
+
+```typescript
+ManyAccountOrMark_Address = {
+  entities: AccountOrMark_Address[];
+  check_all_founded?: boolean;
+};
+```
+
+### ReceivedBalanceOrRecently
+
+```typescript
+ReceivedBalanceOrRecently = 
+  | {
+      balance: string | number;  // Balance amount
+      token_type: string;        // Token type
+      received: {                // Unwrapped coin objects
+        id: string;              // CoinWrapper object ID
+        balance: string | number; // Amount
+        payment: string;         // Info string, usually the payment object ID @any
+      }[];
+    }
+  | "recently";                  // Shortcut: automatically unwrap most recently received CoinWrapper
+```
+
+### ReceivedObjectsOrRecently
+
+```typescript
+ReceivedObjectsOrRecently = 
+  | {
+      id: string;                // Object ID
+      type: string;              // Object type
+      content_raw?: any;         // Raw content (optional)
+    }[]
+  | ReceivedBalanceOrRecently;   // Or: empty/clear then receive CoinWrapper objects
+```
+
+---
+
+## Value Types
+
+| Type | ID | Description |
+|------|-----|-------------|
+| Bool | 0 | Boolean true/false |
+| Address | 1 | Object or account address |
+| String | 2 | UTF-8 string |
+| U8 | 3 | 8-bit unsigned integer |
+| U16 | 4 | 16-bit unsigned integer |
+| U32 | 5 | 32-bit unsigned integer |
+| U64 | 6 | 64-bit unsigned integer |
+| U128 | 7 | 128-bit unsigned integer |
+| U256 | 8 | 256-bit unsigned integer |
+| VecBool | 9 | Vector of booleans |
+| VecAddress | 10 | Vector of addresses |
+| VecString | 11 | Vector of strings |
+| VecU8 | 12 | Vector of U8 |
+| VecU16 | 13 | Vector of U16 |
+| VecU32 | 14 | Vector of U32 |
+| VecU64 | 15 | Vector of U64 |
+| VecU128 | 16 | Vector of U128 |
+| VecU256 | 17 | Vector of U256 |
+| VecVecU8 | 18 | Vector of VecU8 |
+
+---
+
+### Recipient
+Used by `service` (order allocators), `reward` (guard recipients), and `allocation` (who field).
+
+```typescript
+Recipient =
+  | { GuardIdentifier: number }
+  | { Entity: AccountOrMark_Address }
+  | { Signer: "signer" }
+```

package/schemas/onchain_operations/_index.md

@@ -0,0 +1,22 @@
+# onchain_operations / Index
+
+16 discriminated operation types. Each links to its schema file. Common types (CallEnv, SubmissionCall, Recipient, NamedObject, CoinParam, ValueTypes, etc.) are in [_common.md](./_common.md).
+
+| operation_type | File | Description |
+|---|---|---|
+| `service` | [service.md](./service.md) | Create/manage product listings, pricing, discounts, bind workflows, customer purchases via order_new |
+| `machine` | [machine.md](./machine.md) | Design/deploy workflow templates with node/forward structures |
+| `progress` | [progress.md](./progress.md) | Track active workflows, advance through nodes |
+| `repository` | [repository.md](./repository.md) | Consensus database with typed policies and data read/write |
+| `arbitration` | [arbitration.md](./arbitration.md) | Transparent on-chain arbitration, dispute/vote/resolve lifecycle |
+| `contact` | [contact.md](./contact.md) | On-chain IM contact profiles |
+| `treasury` | [treasury.md](./treasury.md) | Team fund management with deposit/withdraw Guard rules |
+| `reward` | [reward.md](./reward.md) | Reward pools with Guard-verified claiming |
+| `allocation` | [allocation.md](./allocation.md) | Auto-distribution plans to multiple recipients |
+| `permission` | [permission.md](./permission.md) | Access control indices for object operations |
+| `guard` | [guard.md](./guard.md) | Programmable boolean validation rules (recursive GuardNode tree) |
+| `personal` | [personal.md](./personal.md) | PUBLIC on-chain identity — everything permanently visible |
+| `payment` | [payment.md](./payment.md) | Irreversible coin transfers to wallets |
+| `demand` | [demand.md](./demand.md) | Service request postings with reward pools |
+| `order` | [order.md](./order.md) | Order lifecycle: progress, arbitration, refunds, ownership |
+| `gen_passport` | [gen_passport.md](./gen_passport.md) | Immutable verified credentials after Guard validation |

package/schemas/onchain_operations/allocation.md

@@ -0,0 +1,50 @@
+# onchain_operations / allocation
+
+Create distribution plans to auto-distribute funds to multiple recipients.
+
+## Data Schema
+
+```typescript
+// Allocation has TWO modes — discriminated by object format
+
+// MODE 1: Create a new Allocation with allocators
+CallAllocation_Create {
+  object: {
+    name?: string;                 // Object name
+    tags?: string[];               // Tags
+    onChain?: boolean;             // Public on-chain name
+    replaceExistName?: boolean;    // Force claim name
+    type_parameter?: string;       // Token type (default: "0x2::wow::WOW")
+  };
+  allocators: {
+    description: string;           // Allocator list description
+    threshold: number;             // Trigger threshold
+    allocators: {
+      guard: string;               // Guard object ID — allocation triggers on verify
+      sharing: {
+        who: Recipient;            // Recipient specification
+        sharing: number;           // Amount or rate
+        mode: "Amount" | "Rate" | "Surplus";
+      }[];
+      fix?: number;                // Fixed amount per recipient
+      max?: number | null;         // Maximum allocation amount
+    }[];
+  };
+  coin: CoinParam;                 // Initial funding
+  payment_info: {
+    remark?: string;
+    index?: number;
+  };
+}
+
+// MODE 2: Operate existing Allocation
+CallAllocation_Operate {
+  object: string;                  // Allocation object ID or name (required)
+  received_coins?: ReceivedBalanceOrRecently; // Unwrap CoinWrapper
+  alloc_by_guard?: string;         // Verify Guard and trigger allocation
+}
+```
+
+---
+
+See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, CoinParam, Recipient, ReceivedBalanceOrRecently.

package/schemas/onchain_operations/arbitration.md

@@ -0,0 +1,95 @@
+# onchain_operations / arbitration
+
+Access a transparent on-chain arbitration system for resolving order conflicts.
+
+## Data Schema
+
+```typescript
+CallArbitration_Data {
+  // Object reference - string (existing) or object (create new)
+  object: TypedPermissionObject;
+  
+  // Create new Arb for order
+  dispute?: {
+    order: string;                  // Order ID
+    description?: string;
+    proposition: string[];          // Dispute propositions
+    fee: CoinParam;                 // Arbitration fee
+    namedArb?: NamedObject;         // Name for new Arb
+  };
+  
+  description?: string;             // Institution description
+  location?: string;                // Arbitration location
+  fee?: number;                     // Arbitration fee
+  pause?: boolean;                  // Pause arbitration
+  
+  // Confirm user's materials
+  confirm?: {
+    arb: string;                    // Arb object ID
+    voting_deadline: number | null;
+  };
+  
+  // Modify voting deadline
+  voting_deadline_change?: {
+    arb: string;
+    voting_deadline: number | null;
+  };
+  
+  // Vote on propositions
+  vote?: {
+    arb: string;
+    votes: number[];                // Supported proposition indices
+    voting_guard?: string;          // Guard for voting
+  };
+  
+  // Arbitration feedback
+  feedback?: {
+    arb: string;
+    feedback: string;
+  };
+  
+  // Final arbitration result
+  arbitration?: {
+    arb: string;
+    feedback: string;
+    indemnity: number;              // Compensation amount
+  };
+  
+  // Request resubmission
+  reset?: {
+    arb: string;
+    feedback: string;
+  };
+  
+  // Withdraw arbitration fee
+  arb_withdraw?: {
+    arb: string;
+  };
+  
+  // Distribute fees
+  fees_transfer?: {
+    to: { allocation: string } | { treasury: string };
+    payment_remark: string;
+    payment_index: number;
+    newPayment?: NamedObject;
+  };
+  
+  usage_guard?: string | null;      // Guard for applying
+  
+  // Guard for voting
+  voting_guard?: {
+    op: "add" | "set" | "remove" | "clear";
+    guards?: {
+      guard: string;
+      service_identifier?: number;
+    }[];
+  };
+  
+  owner_receive?: ReceivedObjectsOrRecently;
+  um?: string | null;               // Contact object
+}
+```
+
+---
+
+See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, TypedPermissionObject, CoinParam, NamedObject, ReceivedObjectsOrRecently.

package/schemas/onchain_operations/contact.md

@@ -0,0 +1,36 @@
+# onchain_operations / contact
+
+Manage on-chain instant messaging contact profiles.
+
+## Data Schema
+
+```typescript
+CallContact_Data {
+  // Object reference - string (existing) or object (create new)
+  object: WithPermissionObject;
+  
+  my_status?: string;               // Status message
+  description?: string;             // Contact description
+  location?: string;                // Location
+  
+  // IM contact list (discriminated union)
+  ims?: {
+    op: "add" | "set";
+    im: {                           // Contact entries
+      at: string;                   // IM address
+      description?: string;         // Optional note
+    }[];
+  } | {
+    op: "remove";
+    im: string[];                   // Addresses/names to remove
+  } | {
+    op: "clear";
+  };
+  
+  owner_receive?: ReceivedObjectsOrRecently;
+}
+```
+
+---
+
+See [_common.md](./_common.md) for shared types: CallEnv, WithPermissionObject, ReceivedObjectsOrRecently.