@wowok/skills 1.0.6 → 1.1.1

package/schemas/onchain_operations/_common.md

@@ -1,236 +0,0 @@
-# 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

@@ -1,22 +0,0 @@
-# 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

@@ -1,50 +0,0 @@
-# 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

@@ -1,95 +0,0 @@
-# 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

@@ -1,36 +0,0 @@
-# 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.

package/schemas/onchain_operations/demand.md

@@ -1,52 +0,0 @@
-# onchain_operations / demand
-
-Post service requests with reward pools on-chain.
-
-## Data Schema
-
-```typescript
-CallDemand_Data {
-  // Object reference - string (existing) or object (create new)
-  object: WithPermissionObject;
-  
-  // Recommend Service to Demand
-  present?: {
-    recommend: string;             // Recommendation text
-    by_guard?: string;             // Guard to verify through
-    service?: string;              // Service ID or name
-  };
-  
-  description?: string;             // Demand description
-  location?: string;                // Demand location
-  
-  rewards?: ObjectsOp;              // Reward operations
-  
-  // Service Guard list (discriminated union)
-  guards?: {
-    op: "add" | "set";
-    guard: {
-      guard: string;               // Guard object ID
-      service_identifier?: number | null; // Service identifier in Guard
-    }[];
-  } | {
-    op: "remove";
-    guard: string[];               // Guard IDs/names to remove
-  } | {
-    op: "clear";
-  };
-  
-  // Feedback on presenters (array — multiple feedback entries)
-  feedback?: {
-    who: AccountOrMark_Address;    // Presenter's account
-    acceptance_score?: number;     // 0-255 acceptance score
-    feedback?: string;             // Feedback content
-  }[];
-  
-  owner_receive?: ReceivedObjectsOrRecently;
-  um?: string | null;               // Contact object
-}
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, WithPermissionObject, ObjectsOp, AccountOrMark_Address, ReceivedObjectsOrRecently.

package/schemas/onchain_operations/gen_passport.md

@@ -1,43 +0,0 @@
-# onchain_operations / gen_passport
-
-Create immutable verified credentials after Guard validation passes.
-
-> **IMPORTANT**: Unlike other onchain operations, `gen_passport` uses a FLAT input structure — fields `guard`, `info`, `env` are directly at the top level, NOT nested under a `data` wrapper.
-
-## Input Schema
-
-```typescript
-CallGenPassport_Input {
-  guard: string | string[];         // Guard object ID(s) to verify. Can be a single guard or an array of guards.
-  info?: SubmissionCall;            // Optional submission data
-  env?: CallEnv;                    // Optional environment configuration
-}
-```
-
-## Features
-
-- **Single Guard**: Pass a single guard ID or name as a string
-- **Multiple Guards**: Pass an array of guard IDs or names to verify multiple guards at once
-- **Name Resolution**: Supports both guard addresses and LocalMark names
-
-## Examples
-
-### Single Guard
-```typescript
-{
-  guard: "my-guard-name",  // or "0x1234567890abcdef..."
-  env: { network: "testnet" }
-}
-```
-
-### Multiple Guards
-```typescript
-{
-  guard: ["guard-1", "guard-2", "0x1234567890abcdef..."],
-  env: { network: "testnet" }
-}
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall.

package/schemas/onchain_operations/guard.md

@@ -1,136 +0,0 @@
-# onchain_operations / guard
-
-Create immutable programmable validation rules that return boolean results.
-
-## Data Schema
-
-```typescript
-CallGuard_Data {
-  namedNew?: NamedObject;           // Name for new Guard
-  description?: string;             // Guard description
-  
-  // Data table definitions
-  table?: {
-    identifier: number;             // 0-255
-    b_submission: boolean;          // User submission required
-    value_type: ValueType;          // Expected type
-    value?: SupportedValue;         // Default value (if b_submission=false)
-    name?: string;                  // Description
-  }[];
-  
-  // Rule tree root (required)
-  root: {
-    type: "node";
-    node: GuardNode;                // Direct node tree
-  } | {
-    type: "file";
-    file_path: string;              // Load from file
-    format?: "json" | "markdown";
-  };
-  
-  // Dependent Guards
-  rely?: {
-    guards: string[];
-    logic_or?: boolean;             // OR vs AND logic
-  };
-}
-
-// GuardNode (recursive structure)
-//
-// The GuardNode is a recursive, strongly-typed computational tree.
-// Each node has a `type` field that discriminates its behavior.
-// Below are the major categories:
-//
-// Logic & Comparison:
-//   logic_and (nodes[], 2-8) → Bool: ALL must be true
-//   logic_or (nodes[], 2-8) → Bool: ANY must be true
-//   logic_not (node, 1) → Bool: Inverts boolean
-//   logic_equal (nodes[], 2-8) → Bool: Type+value equality
-//   logic_string_contains (nodes[], 2-8) → Bool: Substring (case-sensitive)
-//   logic_string_nocase_contains (nodes[], 2-8) → Bool: Substring (case-insensitive)
-//   logic_string_nocase_equal (nodes[], 2-8) → Bool: String equality (ci)
-//   logic_as_u256_equal (nodes[], 2-8) → Bool: Numeric equality
-//   logic_as_u256_greater (nodes[], 2-8) → Bool: First > all others
-//   logic_as_u256_lesser (nodes[], 2-8) → Bool: First < all others
-//   logic_as_u256_greater_or_equal (nodes[], 2-8) → Bool: First >= all others
-//   logic_as_u256_lesser_or_equal (nodes[], 2-8) → Bool: First <= all others
-//
-// Arithmetic (calc_*):
-//   calc_number_add (nodes[], 2-8) → U256: Sequential addition
-//   calc_number_subtract (nodes[], 2-8) → U256: Sequential subtraction
-//   calc_number_multiply (nodes[], 2-8) → U256: Sequential multiplication
-//   calc_number_divide (nodes[], 2-8) → U256: Sequential division
-//   calc_number_mod (nodes[], 2-8) → U256: Sequential modulo
-//   calc_string_length (node, 1) → U64: UTF-8 byte length
-//   calc_string_contains (nodes[], 2-8) → Bool: cs substring check
-//   calc_string_nocase_contains (nodes[], 2-8) → Bool: ci substring check
-//   calc_string_nocase_equal (nodes[], 2-8) → Bool: ci string equality
-//   calc_string_indexof (left+right+order) → U64: Find substring index
-//   calc_string_nocase_indexof (left+right+order) → U64: Find substring index (ci)
-//
-// Type Conversion (convert_*):
-//   convert_number_address (node, 1) → Address: Number → Address
-//   convert_address_number (node, 1) → U256: Address → Number
-//   convert_number_string (node, 1) → String: Number → String
-//   convert_string_number (node, 1) → U256: Parse string as number
-//   convert_safe_u8..convert_safe_u256 (node, 1) → U8..U256: Safe numeric cast
-//
-// Vector Operations (vec_*):
-//   vec_length (node, 1) → U64: Element count
-//   vec_contains_bool (nodes[], 2-8) → Bool: All values present
-//   vec_contains_address (nodes[], 2-8) → Bool: Address containment
-//   vec_contains_string (nodes[], 2-8) → Bool: String containment (cs)
-//   vec_contains_string_nocase (nodes[], 2-8) → Bool: String containment (ci)
-//   vec_contains_number (nodes[], 2-8) → Bool: Number containment
-//   vec_indexof_* (left+right+order) → U64: Find index in vector
-//
-// WoWok Object Query:
-//   query (query + object + parameters) → varies: Query on-chain data
-//   identifier (identifier 0-255) → varies: Read from Guard table
-//   value_type (node, 1) → U8: Get ValueType of child result
-//
-// Record Check Operations (record_*):
-//   record_check_recipient_order (...) → Bool: Order count by recipient
-//   record_check_recipient_progress (...) → Bool: Progress count by recipient
-//   record_check_recipient_reward (...) → Bool: Reward count by recipient
-//   record_check_treasury_history_item (...) → Bool: Treasury history
-//   record_check_progress_history_item (...) → Bool: Progress history
-//
-// For the complete canonical list of all 70+ types, see
-// the MCP source at `src/schema/query/index.ts` `GuardNodeSchema`.
-GuardNode = {
-  // Multi-operand nodes (2-8 children)
-  logic?: "and" | "or";
-  nodes: GuardNode[];
-} | {
-  // Single-operand nodes
-  logic?: "not";
-  node: GuardNode;
-} | {
-  // Query nodes
-  type: "query";
-  query: number | string;
-  object: {
-    identifier: number;
-    convert_witness?: number;
-  };
-  parameters: GuardNode[];
-} | {
-  // Context nodes
-  type: "context";
-  context: "Signer" | "Clock" | "Guard";
-} | {
-  // Identifier nodes
-  type: "identifier";
-  identifier: number;
-} | {
-  // Constant value nodes
-  type: "constant";
-  value_type: ValueType;
-  value: SupportedValue;
-}
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, NamedObject.