@wowok/agent-mcp 2.2.13 → 2.2.14

package/docs/skills/onchain_operations/arbitration.md

@@ -1,106 +0,0 @@
-# onchain_operations / arbitration
-
-Create arbitration rules for dispute resolution.
-
-> **CREATE vs MODIFY**: See [_common.md](./_common.md) for the unified pattern.  
-> Arbitration uses `TypedPermissionObject`: object shape = CREATE, string = MODIFY.
-
-## Data Schema
-
-```typescript
-CallArbitration_Data {
-  // Object reference - string (existing) or object (create new)
-  // See _common.md: TypedPermissionObject
-  object: TypedPermissionObject;
-  
-  // Create new Arb object for an order
-  dispute?: {
-    order: NameOrAddress;                // Order ID or name
-    description?: string;                // Dispute description (max 4000 bcs chars)
-    proposition: string[];               // List of dispute propositions (each max 256 bcs chars)
-    fee: CoinParam;                      // Dispute processing fee
-    namedArb?: NamedObject;              // Name for newly created arbitration object
-  };
-  
-  description?: string;                  // Introduction of the Arbitration object (max 4000 bcs chars)
-  location?: string;                     // Arbitration location (max 256 bcs chars)
-  fee?: string | number;                 // Arbitration fee
-  pause?: boolean;                       // Whether to pause arbitration
-  
-  // Confirm materials submitted for arbitration
-  confirm?: {
-    arb: NameOrAddress;                  // Arb object ID or name
-    voting_deadline: number | null;      // Voting deadline
-  };
-  
-  // Change voting deadline
-  voting_deadline_change?: {
-    arb: NameOrAddress;                  // Arb object ID or name
-    voting_deadline: number | null;      // New voting deadline
-  };
-  
-  // Vote on propositions
-  vote?: {
-    arb: NameOrAddress;                  // Arb object ID or name
-    votes: number[];                     // Vote values (per proposition, 0-255)
-    voting_guard?: NameOrAddress;        // Voting Guard object ID or name
-  };
-  
-  // Provide arbitration feedback
-  feedback?: {
-    arb: NameOrAddress;                  // Arb object ID or name
-    feedback: string;                    // Arbitration feedback (max 4000 bcs chars)
-  };
-  
-  // Provide definitive arbitration result
-  arbitration?: {
-    arb: NameOrAddress;                  // Arb object ID or name
-    feedback: string;                    // Arbitration feedback (max 4000 bcs chars)
-    indemnity: number;                   // Indemnity amount (int >= 0)
-  };
-  
-  // User applies to resubmit materials and restart arbitration
-  reset?: {
-    arb: NameOrAddress;                  // Arb object ID or name
-    feedback: string;                    // Arbitration feedback (max 4000 bcs chars)
-  };
-  
-  // Withdraw arbitration fees
-  arb_withdraw?: {
-    arb: NameOrAddress;                  // Arb object ID or name
-  };
-  
-  // Distribute withdrawn arbitration fees
-  fees_transfer?: {
-    to: 
-      | { allocation: NameOrAddress }     // Transfer to Allocation object
-      | { treasury: NameOrAddress };      // Transfer to Treasury object
-    payment_remark: string;              // Payment remark (max 64 bcs chars)
-    payment_index: number;               // Payment index (int >= 0)
-    newPayment?: NamedObject;            // Name for new payment object
-  };
-  
-  usage_guard?: NameOrAddress | null;    // Guard for verifying when users apply
-  voting_guard?: VotingGuardAction;      // Guard for verifying during voting
-  owner_receive?: ReceivedObjectsOrRecently;
-  um?: NameOrAddress | null;            // Contact object
-}
-
-// Voting guard operations (discriminated union)
-VotingGuardAction = 
-  | {
-      op: "add" | "set";
-      guards: VotingGuard[];             // Array of voting guard configs
-    }
-  | {
-      op: "remove";
-      guards: NameOrAddress[];             // Guard IDs or names to remove
-    }
-  | {
-      op: "clear";
-    };
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, TypedPermissionObject, CoinParam, NamedObject, VotingGuard, ReceivedObjectsOrRecently.

package/docs/skills/onchain_operations/contact.md

@@ -1,40 +0,0 @@
-# onchain_operations / contact
-
-Create Contact objects linking social signals to on-chain rewards.
-
-> **CREATE vs MODIFY**: See [_common.md](./_common.md) for the unified pattern.  
-> Contact uses `WithPermissionObject`: object shape = CREATE, string = MODIFY.
-
-## Data Schema
-
-```typescript
-CallContact_Data {
-  // Object reference - string (existing) or object (create new)
-  // See _common.md: WithPermissionObject
-  object: WithPermissionObject;
-  
-  my_status?: string;                    // Set your status message in this contact list (max 64 bcs chars)
-  description?: string;                  // Contact object description or public information (max 4000 bcs chars)
-  location?: string;                     // Physical or virtual location information (max 256 bcs chars)
-  
-  // IM contact list operations (discriminated union)
-  ims?: {
-    op: "add" | "set";
-    im: {
-      at: NameOrAddress;                 // Contact address or name for IM
-      description?: string;              // Optional description (max 256 bcs chars)
-    }[];
-  } | {
-    op: "remove";
-    im: NameOrAddress[];                 // Contact addresses or names to remove
-  } | {
-    op: "clear";
-  };
-  
-  owner_receive?: ReceivedObjectsOrRecently;
-}
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, WithPermissionObject, ReceivedObjectsOrRecently.

package/docs/skills/onchain_operations/demand.md

@@ -1,53 +0,0 @@
-# onchain_operations / demand
-
-Create and manage Demand objects for service procurement with Guard validation.
-
-> **CREATE vs MODIFY**: See [_common.md](./_common.md) for the unified pattern.  
-> Demand uses `WithPermissionObject`: object shape = CREATE, string = MODIFY.
-
-## Data Schema
-
-```typescript
-CallDemand_Data {
-  // Object reference - string (existing) or object (create new)
-  // See _common.md: WithPermissionObject
-  object: WithPermissionObject;
-  
-  // Recommend a Service to the Demand
-  present?: {
-    recommend: string;                   // Recommendation description (max 4000 bcs chars)
-    by_guard?: NameOrAddress;            // Guard ID — pass verification via Guard
-    service?: NameOrAddress;             // Service ID or name to present
-  };
-  
-  description?: string;                  // Demand description (max 4000 bcs chars)
-  location?: string;                     // Service location (max 256 bcs chars)
-  
-  rewards?: ObjectsOp;                   // Reward information
-  
-  // User feedback
-  feedback?: {
-    who: AccountOrMark_Address;          // User being rated
-    acceptance_score?: number;           // Acceptance score (0-255)
-    feedback?: string;                   // Feedback content (max 4000 bcs chars)
-  }[];
-  
-  // Validation Guards (discriminated union)
-  guards?: {
-    op: "add" | "set";
-    guard: ServiceGuard[];               // Guard configs to add/set
-  } | {
-    op: "remove";
-    guard: NameOrAddress[];              // Guard IDs or names to remove
-  } | {
-    op: "clear";
-  };
-  
-  owner_receive?: ReceivedObjectsOrRecently;
-  um?: NameOrAddress | null;           // Contact object
-}
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, WithPermissionObject, ObjectsOp, ServiceGuard, AccountOrMark_Address, ReceivedObjectsOrRecently.

package/docs/skills/onchain_operations/gen_passport.md

@@ -1,23 +0,0 @@
-# onchain_operations / gen_passport
-
-Generate Verified Passport Object: Create immutable verified credentials (passport).
-
-> **Structure Exception**: `gen_passport` has a **FLAT** structure — no `data` wrapper, no `submission` field.
-
-## Schema
-
-```typescript
-GenPassport {
-  // Guard verification
-  guard: NameOrAddress | NameOrAddress[];  // Guard object ID(s) to verify and embed
-  
-  // Optional submission data during Guard verification
-  info?: SubmissionCall;              // Submission data for Guards requiring user input
-  
-  env?: CallEnv;                      // Optional execution environment
-}
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall.

package/docs/skills/onchain_operations/guard.md

@@ -1,56 +0,0 @@
-# onchain_operations / guard
-
-Create immutable programmable validation rules that return boolean results.
-
-> **CREATE vs MODIFY**: See [_common.md](./_common.md) for the unified pattern.  
-> Guard is **CREATE-only** and immutable. No `object` field — use `namedNew` for naming.
-
-## Data Schema
-
-```typescript
-CallGuard_Data {
-  namedNew?: NamedObject;             // Name for new Guard (optional naming)
-  description?: string;               // Guard description (max 4000 bcs chars)
-  
-  // Data table definitions (uses GuardTableItemBaseSchema — no object_type field)
-  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 (default: "")
-  }[];
-  
-  // Rule tree root (required)
-  root: {
-    type: "node";
-    node: GuardNode;                  // Direct node tree
-  } | {
-    type: "file";
-    file_path: string;                // Path to JSON or Markdown file
-    format?: "json" | "markdown";     // File format (default: "json")
-  };
-  
-  // Dependent Guards
-  rely?: {
-    guards: string[];                 // Dependent Guard object IDs
-    logic_or?: boolean;               // OR logic (default: AND)
-  };
-}
-```
-
-## Guard Root Notes
-
-- **`root.type === "node"`**: Build the Guard computational tree directly inline using `node: GuardNode`
-- **`root.type === "file"`**: Load the Guard definition from a JSON or Markdown file. The file can define `namedNew`, `description`, `table`, `root`, `rely`. Any fields defined in the schema will **OVERRIDE** the corresponding fields in the file.
-
-## GuardNode (recursive, lazy-evaluated)
-
-The GuardNode is a recursive, strongly-typed computational tree with 70+ node types.
-Each node has a `type` field that discriminates its behavior.
-
-For the complete canonical list of all GuardNode types, see the MCP source at `src/schema/query/index.ts` `GuardNodeSchema`.
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, NamedObject.

package/docs/skills/onchain_operations/machine.md

@@ -1,89 +0,0 @@
-# onchain_operations / machine
-
-Design and deploy automated workflow templates (Machines) that define how services are delivered.
-
-> **CREATE vs MODIFY**: See [_common.md](./_common.md) for the unified pattern.  
-> Machine uses `WithPermissionObject`: object shape = CREATE, string = MODIFY.
-
-## Data Schema
-
-```typescript
-CallMachine_Data {
-  // Object reference - string (existing) or object (create new)
-  // See _common.md: WithPermissionObject
-  object: WithPermissionObject;
-  
-  // Generate new Progress
-  progress_new?: {
-    task?: string | null;             // Task ID bound to Progress
-    repository?: ObjectsOp;           // Repository list
-    progress_namedOperator?: {        // Manage namespace operators
-      op: "add" | "set" | "remove";
-      name: string;                   // Namespace name (non-empty)
-      operators: ManyAccountOrMark_Address;
-    };
-    namedNew?: NamedObject;           // Name for new Progress
-  };
-  
-  description?: string;               // Machine description
-  repository?: ObjectsOp;             // Consensus repositories
-  
-  // Node operations - TWO MODES (mutually exclusive)
-  node?: 
-    // Mode 1: Incremental operations
-    | {
-        op: "add" | "set";
-        nodes: MachineNode[];         // Node array
-        bReplace?: boolean;           // Whether to replace existing
-      }
-    | { op: "remove"; nodes: string[] }       // Node names to delete
-    | { op: "clear" }
-    | { op: "exchange"; node_one: string; node_other: string } // Swap two nodes
-    | { op: "rename"; node_name_old: string; node_name_new: string } // Rename node
-    | { op: "remove prior node"; pairs: { prior_node_name: string[]; node_name: string; }[] } // Delete prev→next pairs
-    | { op: "add forward"; data: {
-        prior_node_name: string;      // Previous node name
-        node_name: string;            // Next node name
-        forward: {
-          name: string;               // Operation name
-          namedOperator?: string | null;     // Per-Progress namespace operator (null or empty "" = order permission)
-          permissionIndex?: number | null;   // Shared permission index
-          weight: number;             // Forward weight (0-65535)
-        }[];
-        threshold?: number | null;    // Weight threshold (int >= 0)
-      }[] }
-    | { op: "remove forward"; data: {
-        prior_node_name: string;
-        node_name: string;
-        forward_name: string[];       // Operation names to delete
-      }[] }
-    // Mode 2: Complete replacement from file
-    | { json_or_markdown_file: string };
-  
-  pause?: boolean;                    // Pause new Progress
-  publish?: boolean;                  // Publish (nodes immutable after)
-  owner_receive?: ReceivedObjectsOrRecently;
-  um?: NameOrAddress | null;          // Contact object
-}
-
-// MachineNode definition (referenced by node operations)
-// For the canonical MachineNodeNodeSchema, see MCP source at src/schema/query
-MachineNode {
-  name: string;                       // Node name
-  pairs: {
-    prior_node: string;               // Previous node name ("" for entry)
-    forwards: {
-      name: string;                   // Forward name
-      namedOperator?: string;         // Per-Progress namespace
-      permissionIndex?: number;       // Shared permission index
-      weight: number;                 // Forward weight
-      guard?: MachineForwardGuard;    // { guard: string; retained_submission?: number[] }
-    }[];
-    threshold?: number;               // Weight threshold (null = any single forward triggers)
-  }[];
-}
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, WithPermissionObject, NamedObject, ObjectsOp, ManyAccountOrMark_Address, ReceivedObjectsOrRecently.

package/docs/skills/onchain_operations/order.md

@@ -1,56 +0,0 @@
-# onchain_operations / order
-
-Track and manage service delivery lifecycle — progress, arbitration, compensation.
-
-> **Note**: Order is **MODIFY-only**.
-
-## Data Schema
-
-```typescript
-CallOrder_Data {
-  object: NameOrAddress;                 // Order object ID or name (required)
-  
-  agents?: ManyAccountOrMark_Address;   // Order agents (operate, but cannot receive funds)
-  
-  required_info?: NameOrAddress | null; // Contact object ID (recipient) or WTS Proof (delivery proof)
-  
-  // Advance order progress workflow
-  progress?: {
-    operation: {
-      next_node_name: string;           // Target node name (max 64 bcs chars)
-      forward: string;                  // Forward (operation) name (max 64 bcs chars)
-    };
-    hold?: boolean;                     // Lock operation permission
-    adminUnhold?: boolean;              // Allow admin to force unlock
-    message?: string;                   // Operation note
-  };
-  
-  // Submit compensation request and apply for arbitration
-  arb_confirm?: {
-    arb: NameOrAddress;                 // Arb object ID or name
-    confirm: boolean;                   // Confirm arbitration materials are valid
-    description?: string;               // Message description for compensation (max 4000 bcs chars)
-    proposition?: string[];             // Compensation claims (each max 256 bcs chars)
-  };
-  
-  // Oppose and appeal arbitration result
-  arb_objection?: {
-    arb: NameOrAddress;                 // Arb object ID or name
-    objection: string;                  // Reason for objection (max 4000 bcs chars)
-  };
-  
-  // Claim order compensation from adjudicated Arb
-  arb_claim_compensation?: {
-    arb: NameOrAddress;                 // Arb object ID or name
-  };
-  
-  // Unwrap received CoinWrappers/objects and transfer to owner
-  receive?: QueryReceivedResult;
-  
-  transfer_to?: AccountOrMark_Address;  // Transfer order ownership
-}
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, ManyAccountOrMark_Address, AccountOrMark_Address, QueryReceivedResult.

package/docs/skills/onchain_operations/payment.md

@@ -1,24 +0,0 @@
-# onchain_operations / payment
-
-Token payment (transfer) operations with detailed remarks.
-
-> **Note**: Payment is **CREATE-only** — it issues immutable payment records. No `submission` field.
-
-## Data Schema
-
-```typescript
-CallPayment_Data {
-  object: TypeNamedObject;             // CREATE new payment object with {name, type_parameter?}
-  
-  revenue: {
-    recipient: AccountOrMark_Address;  // Payment recipient
-    amount: CoinParam;                 // Payment amount
-  }[];
-  
-  info: PaymentInfo;                   // Payment record info
-}
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, TypeNamedObject, CoinParam, PaymentInfo, AccountOrMark_Address.

package/docs/skills/onchain_operations/permission.md

@@ -1,68 +0,0 @@
-# onchain_operations / permission
-
-Define who can perform which operations on WoWok objects.
-
-> **CREATE vs MODIFY**: See [_common.md](./_common.md) for the unified pattern.  
-> Permission uses `NormalObject`: object shape = CREATE, string = MODIFY.
-
-## Data Schema
-
-```typescript
-CallPermission_Data {
-  // Object reference - string (existing) or object (create new)
-  // See _common.md: NormalObject
-  object?: NormalObject;
-  
-  description?: string;               // Permission description (max 4000 bcs chars)
-  
-  // Remark operations (discriminated union)
-  remark?: {
-    op: "set";
-    index: number;                    // Permission index (REQUIRED)
-    remark: string;                   // Permission remark (REQUIRED)
-  } | {
-    op: "remove";
-    index: number;                    // Permission index (REQUIRED)
-  } | {
-    op: "clear";
-  };
-  
-  // Permission table operations (discriminated union)
-  table?: {
-    // Permission-centric: assign ONE permission to MANY entities
-    op: "add perm by index" | "set perm by index" | "remove perm by index";
-    index: number;                    // Permission index
-    entity: ManyAccountOrMark_Address;
-  } | {
-    // Entity-centric: assign MANY permissions to ONE entity
-    op: "add perm by entity" | "set perm by entity" | "remove perm by entity";
-    entity: AccountOrMark_Address;
-    index: number[];                  // Permission indices
-  };
-  
-  // Advanced entity operations (requires admin)
-  entity?: {
-    op: "swap" | "replace" | "copy";
-    entity1: AccountOrMark_Address;
-    entity2: AccountOrMark_Address;
-  } | {
-    op: "del";
-    entity: AccountOrMark_Address;
-  };
-  
-  // Admin management (builder/owner only)
-  admin?: {
-    op: "add" | "remove" | "set";
-    addresses: ManyAccountOrMark_Address;
-  };
-  
-  apply?: NameOrAddress[];            // Object IDs to apply permission to
-  builder?: AccountOrMark_Address;    // Set/transfer ownership
-  owner_receive?: ReceivedObjectsOrRecently;
-  um?: string | null;                 // Contact object
-}
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, NormalObject, AccountOrMark_Address, ManyAccountOrMark_Address, ReceivedObjectsOrRecently.

package/docs/skills/onchain_operations/personal.md

@@ -1,58 +0,0 @@
-# onchain_operations / personal
-
-Manage your personal on-chain account profile and identity marks.
-
-> **Note**: Personal has no `submission` field. There is only one Personal object per account, created automatically on first use.
-
-## Data Schema
-
-```typescript
-CallPersonal_Data {
-  description?: string;                 // Personal description (max 4000 bcs chars)
-  
-  referrer?: NameOrAddress | null;    // Referrer ID for joining network
-  
-  // Public personal info records (discriminated union)
-  information?: {
-    op: "add";
-    data: RecordsInEntity[];            // Records to add (PUBLIC: social handles, URLs — NEVER private data)
-  } | {
-    op: "remove";
-    name: string[];                     // Record names to remove
-  } | {
-    op: "clear";
-  };
-  
-  // Public on-chain identity mark (discriminated union)
-  mark?: {
-    op: "add";
-    data: {
-      address: string;                  // Address
-      name?: string;                    // Name (optional)
-      tags?: string[];                  // Tags (optional)
-    }[];
-  } | {
-    op: "remove";
-    data: {
-      address: string;                  // Address
-      tags?: string[];                  // Tags to remove
-    }[];
-  } | {
-    op: "clear";
-    address: ManyAccountOrMark_Address; // Addresses to clear
-  } | {
-    op: "transfer";
-    to: string;                         // Transfer mark to another address
-  } | {
-    op: "replace";
-    new_mark_object: string;            // Replace with new mark object ID
-  } | {
-    op: "destroy";                     // Permanently destroy identity mark
-  };
-}
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, AccountOrMark_Address, ManyAccountOrMark_Address.  
-`RecordsInEntity` schema is defined in the MCP source at `src/schema/query/index.ts`.

package/docs/skills/onchain_operations/progress.md

@@ -1,38 +0,0 @@
-# onchain_operations / progress
-
-Track and manage active workflows in real-time.
-
-> **Note**: Progress is **MODIFY-only** — Progress objects are created via `machine.progress_new`, not directly.
-
-## Data Schema
-
-```typescript
-CallProgress_Data {
-  object: NameOrAddress;              // Progress ID or name (required) — MODIFY only
-  
-  task?: NameOrAddress;                 // Task ID (cannot be changed after setting)
-  repository?: ObjectsOp;             // Context repositories
-  
-  // Manage namespace operators
-  progress_namedOperator?: {
-    op: "add" | "set" | "remove";
-    name: string;                     // Namespace name (non-empty, max 64 bcs chars)
-    operators: ManyAccountOrMark_Address;
-  };
-  
-  // Advance workflow
-  operate?: {
-    operation: {
-      next_node_name: string;         // Target node name (max 64 bcs chars)
-      forward: string;                // Forward (operation) name (max 64 bcs chars)
-    };
-    hold?: boolean;                   // Lock operation permission
-    adminUnhold?: boolean;            // Allow admin to force unlock
-    message?: string;                 // Operation note
-  };
-}
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, ObjectsOp, ManyAccountOrMark_Address.