@wowok/agent-mcp 2.2.13 → 2.2.15

package/docs/skills/onchain_operations/repository.md

@@ -1,70 +0,0 @@
-# onchain_operations / repository
-
-Define trusted data sources with typed policies, data read/write rules, and contribution incentives.
-
-> **CREATE vs MODIFY**: See [_common.md](./_common.md) for the unified pattern.  
-> Repository uses `WithPermissionObject`: object shape = CREATE, string = MODIFY.
-
-## Data Schema
-
-```typescript
-CallRepository_Data {
-  // Object reference - string (existing) or object (create new)
-  // See _common.md: WithPermissionObject
-  object: WithPermissionObject;
-  
-  description?: string;               // Repository description (max 4000 bcs chars)
-  
-  // Policy rules (discriminated union)
-  policies?: {
-    op: "add" | "set";
-    policy: PolicyRule[];             // Policy rule list
-  } | {
-    op: "remove";
-    policy: string[];                 // Policy rule names to remove
-  } | {
-    op: "clear";
-  };
-  
-  // Add data
-  data_add?: 
-    | {
-        name: string;                  // Data item name (must match PolicyRule)
-        write_guard?: NameOrAddress;   // Guard for write permissions
-        data: SupportedValue;          // Data value (ID = timestamp or signer)
-      }
-    | {
-        name: string;                  // Data item name
-        items: {
-          data: {
-            id: AccountOrMark_Address | number;  // Data item ID
-            data: SupportedValue;       // Data value
-          }[];
-          write_guard?: NameOrAddress;  // Guard for write permissions
-        }[];
-      };
-  
-  // Remove data
-  data_remove?: 
-    | {
-        name: string;                  // Data item name
-        write_guard?: NameOrAddress;   // Guard for verifying deletion permission
-      }
-    | {
-        name: string;
-        items: {
-          id: (AccountOrMark_Address | number)[]; // Data item IDs
-          write_guard?: NameOrAddress;  // Guard for verifying deletion permission
-        }[];
-      };
-  
-  rewards?: ObjectsOp;                 // Reward object list (contribution incentives)
-  owner_receive?: ReceivedObjectsOrRecently;
-  um?: NameOrAddress | null;          // Contact object
-}
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, WithPermissionObject, ObjectsOp, ReceivedObjectsOrRecently.  
-`PolicyRule` schema is defined in the MCP source at `src/schema/query/index.ts`.

package/docs/skills/onchain_operations/reward.md

@@ -1,38 +0,0 @@
-# onchain_operations / reward
-
-Create and manage token rewards with Guards and distribution rules.
-
-> **CREATE vs MODIFY**: See [_common.md](./_common.md) for the unified pattern.  
-> Reward uses `TypedPermissionObject`: object shape = CREATE, string = MODIFY.
-
-## Data Schema
-
-```typescript
-CallReward_Data {
-  // Object reference - string (existing) or object (create new)
-  // See _common.md: TypedPermissionObject
-  object: TypedPermissionObject;
-  
-  claim?: NameOrAddress;                  // Guard object ID — verify Guard to trigger reward distribution
-  
-  description?: string;                    // Reward description (max 4000 bcs chars)
-  
-  coin_add?: CoinParam;                    // Add amount to Reward object
-  
-  // Unwrap received CoinWrappers and store in pending balance
-  receive?: ReceivedBalanceOrRecently;
-  
-  guard_add?: RewardGuard[];               // Add Guard to Reward object
-  
-  guard_remove_expired?: boolean;          // Whether to remove expired Guards
-  
-  guard_expiration_time?: number | null;   // Expiration time (ms, >= 1) — blocks new Guard additions until expired
-  
-  owner_receive?: ReceivedObjectsOrRecently;
-  um?: NameOrAddress | null;              // Contact object
-}
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, TypedPermissionObject, CoinParam, RewardGuard, ReceivedBalanceOrRecently, ReceivedObjectsOrRecently.

package/docs/skills/onchain_operations/service.md

@@ -1,78 +0,0 @@
-# onchain_operations / service
-
-Create and manage product/service listings with transparent promises, bind workflow templates, set pricing, issue discount coupons.
-
-> **CREATE vs MODIFY**: See [_common.md](./_common.md) for the unified pattern.  
-> Service uses `TypedPermissionObject`: object shape = CREATE, string = MODIFY.
-
-## Data Schema
-
-```typescript
-CallService_Data {
-  // Object reference - string (existing) or object (create new)
-  // See _common.md: TypedPermissionObject
-  object: TypedPermissionObject;
-  
-  // Create new order (customer purchase)
-  order_new?: {
-    buy: {
-      items: {
-        name: string;              // Product name (max 256 bcs chars)
-        stock: string | number;    // Quantity
-        wip_hash: string;          // WIP file hash
-      }[];
-      total_pay: CoinParam;        // Payment amount
-      discount?: string;           // Discount object ID
-      payment_remark?: string;     // Payment remark
-      payment_index?: number;      // Payment index
-    };
-    agents?: ManyAccountOrMark_Address;  // Order agents
-    order_required_info?: string;        // Contact object ID or WTS Proof
-    transfer?: AccountOrMark_Address;    // New order owner
-    namedNewOrder?: NamedObject;         // Name for new Order
-    namedNewAllocation?: NamedObject;    // Name for new Allocation
-    namedNewProgress?: NamedObject;      // Name for new Progress
-  };
-  
-  description?: string;              // Service description (max 4000 bcs chars)
-  location?: string;                 // Service location (max 256 bcs chars)
-  
-  // Sales operations (discriminated union)
-  sales?: {
-    op: "add" | "set";
-    sales: ServiceSale[];            // Array of sale items (REQUIRED for add/set)
-  } | {
-    op: "remove";
-    sales_name: string[];            // Sale names to remove (REQUIRED) (each max 256 bcs chars)
-  } | {
-    op: "clear";
-  };
-  
-  repositories?: ObjectsOp;          // Repository operations
-  rewards?: ObjectsOp;               // Reward operations
-  arbitrations?: ObjectsOp;          // Arbitration operations
-  machine?: NameOrAddress | null;    // Machine object ID
-  
-  // Discount coupon
-  discount?: Discount;
-  
-  discount_destroy?: NameOrAddress[];  // Discount IDs to destroy
-  customer_required?: NotEmptyName[];  // Required info names (non-empty strings)
-  
-  // Order fund allocators
-  order_allocators?: Allocators | null;
-  
-  buy_guard?: NameOrAddress | null;    // Purchase Guard ID or name
-  compensation_fund_add?: CoinParam; // Compensation fund
-  setting_locked_time_add?: number;  // Additional lock time (ms), extends 30-day default
-  compensation_fund_receive?: ReceivedBalanceOrRecently;
-  owner_receive?: ReceivedObjectsOrRecently;
-  um?: NameOrAddress | null;         // Contact object ID or name
-  pause?: boolean;                   // Pause new orders
-  publish?: boolean;                 // Publish service (immutable after)
-}
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, TypedPermissionObject, NamedObject, CoinParam, ObjectsOp, ServiceSale, Discount, Allocators, AccountOrMark_Address, ManyAccountOrMark_Address, ReceivedBalanceOrRecently, ReceivedObjectsOrRecently.

package/docs/skills/onchain_operations/treasury.md

@@ -1,68 +0,0 @@
-# onchain_operations / treasury
-
-Create secure shared pools for managing deposits, withdrawals, and fund allocation scheduling.
-
-> **CREATE vs MODIFY**: See [_common.md](./_common.md) for the unified pattern.  
-> Treasury uses `TypedPermissionObject`: object shape = CREATE, string = MODIFY.
-
-## Data Schema
-
-```typescript
-CallTreasury_Data {
-  // Object reference - string (existing) or object (create new)
-  // See _common.md: TypedPermissionObject
-  object: TypedPermissionObject;
-  
-  description?: string;                     // Treasury description (max 4000 bcs chars)
-  
-  // Unwrap and deposit received CoinWrappers
-  receive?: ReceivedBalanceOrRecently;
-  
-  // Deposit to Treasury
-  deposit?: {
-    coin: CoinParam;                        // Asset to deposit
-    by_external_deposit_guard?: string;     // Deposit via Guard verification (not Permission)
-    payment_info: PaymentInfo;
-    namedNewPayment?: NamedObject;          // Name for new Payment object
-  };
-  
-  // Withdraw from Treasury
-  withdraw?: {
-    amount: 
-      | { fixed: string | number }          // Fixed amount (Permission-based)
-      | { by_external_withdraw_guard: string }; // Guard-based (amount from Guard index)
-    recipient: AccountOrMark_Address;       // Recipient ID or account
-    payment_info: PaymentInfo;
-    namedNewPayment?: NamedObject;          // Name for new Payment object
-  };
-  
-  // External deposit Guard operations
-  external_deposit_guard?: {
-    op: "add" | "set";
-    guards: AmountFromDepositGuard[];       // Deposit Guard list
-  } | {
-    op: "remove";
-    guards: NameOrAddress[];                // Guard IDs or names to remove
-  } | {
-    op: "clear";
-  };
-  
-  // External withdraw Guard operations
-  external_withdraw_guard?: {
-    op: "add" | "set";
-    guards: AmountFromWithdrawGuard[];      // Withdraw Guard list
-  } | {
-    op: "remove";
-    guards: NameOrAddress[];                // Guard IDs or names to remove
-  } | {
-    op: "clear";
-  };
-  
-  owner_receive?: ReceivedObjectsOrRecently;
-  um?: NamedObject | null;                  // Contact object ({ name?, tags?, onChain?, replaceExistName? })
-}
-```
-
----
-
-See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, TypedPermissionObject, CoinParam, NamedObject, PaymentInfo, AccountOrMark_Address, AmountFromDepositGuard, AmountFromWithdrawGuard, ReceivedBalanceOrRecently, ReceivedObjectsOrRecently.

package/docs/skills/schema-account_operation.md

@@ -1,402 +0,0 @@
-# Schema: account_operation
-
-> 100% LOCAL, NEVER ON-CHAIN - Manage WoWok accounts locally on device: generate, suspend, resume, faucet-test, operate assets, sign data, etc.
-
----
-
-## Top-Level Structure
-
-```typescript
-AccountOperation {
-  // Exactly ONE operation type must be specified
-  gen?: GenOperation;
-  faucet?: FaucetOperation;
-  suspend?: SuspendOperation;
-  resume?: ResumeOperation;
-  rename?: RenameOperation;
-  swap_name?: SwapNameOperation;
-  transfer?: TransferOperation;
-  get?: GetOperation;
-  signData?: SignDataOperation;
-  messenger?: MessengerOperation;
-}
-```
-
----
-
-## Operation Types
-
-### gen
-
-Generate a new account.
-
-```typescript
-GenOperation {
-  name?: string;              // Account name (max 64 chars). Empty = default account
-  replaceExistName?: boolean; // Force claim existing name
-  m?: string | null;          // Messenger name to enable. Null = disable
-}
-```
-
-**Result**:
-
-```typescript
-GenResult {
-  address: string;            // New account ID
-  name?: string;              // Account name
-  m?: string | null;          // Messenger name if enabled
-}
-```
-
----
-
-### faucet
-
-Distribute test coins from faucet.
-
-```typescript
-FaucetOperation {
-  name_or_address?: string;   // Account name or address. Empty = default
-  network: "localnet" | "testnet";
-}
-```
-
-**Result**:
-
-```typescript
-FaucetResult {
-  name_or_address?: string;
-  result: {
-    amount: number;
-    id: string;
-    transferTxDigest: string;
-  }[];
-  network: "localnet" | "testnet";
-}
-```
-
----
-
-### suspend
-
-Remove account from active list (cannot sign transactions).
-
-```typescript
-SuspendOperation {
-  name_or_address?: string;   // Account name or address. Empty = default
-}
-```
-
-**Result**:
-
-```typescript
-SuspendResult {
-  name_or_address?: string;
-  success: boolean;
-}
-```
-
----
-
-### resume
-
-Add account back to active list.
-
-```typescript
-ResumeOperation {
-  address: string;            // Account ID (0x + 64 hex chars)
-  name?: string;              // New name for resumed account
-}
-```
-
-**Result**:
-
-```typescript
-ResumeResult {
-  address: string;
-  name?: string;
-  success: boolean;
-}
-```
-
----
-
-### rename
-
-Rename an account.
-
-```typescript
-RenameOperation {
-  name_or_address?: string;   // Source account. Empty = default
-  new_name: string;           // New account name (max 64 chars)
-}
-```
-
-**Result**:
-
-```typescript
-RenameResult {
-  name_or_address?: string;
-  new_name: string;
-  success: boolean;
-}
-```
-
----
-
-### swap_name
-
-Swap names between two accounts.
-
-```typescript
-SwapNameOperation {
-  name1?: string;             // First account name. Empty = default
-  name2?: string;             // Second account name. Empty = default
-}
-```
-
-**Result**:
-
-```typescript
-SwapNameResult {
-  name1?: string;
-  name2?: string;
-  success: boolean;
-}
-```
-
----
-
-### transfer
-
-Transfer tokens between accounts.
-
-```typescript
-TransferOperation {
-  name_or_address_from?: string;  // Sender. Empty = default
-  name_or_address_to?: string;    // Recipient. Empty = default
-  amount: number | string;        // Amount to transfer
-  token_type?: string;            // Default: 0x2::wow::WOW
-  network?: "localnet" | "testnet";
-}
-```
-
-**Result**: `WowTransactionBlockResponse` (see Transaction Response Schema)
-
----
-
-### get
-
-Generate new coin object by required amount.
-
-```typescript
-GetOperation {
-  name_or_address?: string;       // Account. Empty = default
-  balance_required: number | string;
-  token_type?: string;            // Default: 0x2::wow::WOW
-  network?: "localnet" | "testnet";
-}
-```
-
-**Result**:
-
-```typescript
-GetResult {
-  coin_address?: string;          // New coin object ID
-  name_or_address?: string;
-  balance_required: number | string;
-  token_type?: string;
-  network?: "localnet" | "testnet";
-}
-```
-
----
-
-### signData
-
-Sign data with account's private key.
-
-```typescript
-SignDataOperation {
-  name_or_address?: string;   // Account. Empty = default
-  data: string;               // Data to sign
-  data_encoding?: "utf8" | "base64" | "hex";  // Default: utf8
-}
-```
-
-**Result**:
-
-```typescript
-SignDataResult {
-  name_or_address?: string;
-  signature: string;          // Signature in hex
-  publicKey: string;          // Public key in hex
-  address: string;            // Account address
-}
-```
-
----
-
-### messenger
-
-Enable or disable messenger for an account.
-
-```typescript
-MessengerOperation {
-  name_or_account?: string;   // Account. Empty = default
-  m: string | null;           // Messenger name. Null = disable
-}
-```
-
-**Result**:
-
-```typescript
-MessengerResult {
-  name_or_account?: string;
-  m: string | null;
-}
-```
-
----
-
-## Common Sub-Schemas
-
-### WowTransactionBlockResponse
-
-```typescript
-WowTransactionBlockResponse {
-  digest: string;
-  effects?: TransactionEffects;
-  events?: WowEvent[];
-  balanceChanges?: BalanceChange[];
-  objectChanges?: WowObjectChange[];
-  errors?: string[];
-  // ... additional fields
-}
-```
-
-### TransactionEffects
-
-```typescript
-TransactionEffects {
-  status: {
-    status: "success" | "failure";
-    error?: string;
-  };
-  gasUsed: {
-    computationCost: string;
-    storageCost: string;
-    storageRebate: string;
-    nonRefundableStorageFee: string;
-  };
-  gasObject: OwnedObjectRef;
-  created?: OwnedObjectRef[];
-  mutated?: OwnedObjectRef[];
-  deleted?: WowObjectRef[];
-  // ... additional fields
-}
-```
-
-### WowEvent
-
-```typescript
-WowEvent {
-  id: {
-    eventSeq: string;
-    txDigest: string;
-  };
-  packageId: string;
-  transactionModule: string;
-  sender: string;
-  type: string;
-  parsedJson: Record<string, string | number | boolean>;
-  bcs: string;
-  bcsEncoding: "base64" | "base58";
-  timestampMs?: string;
-}
-```
-
-### BalanceChange
-
-```typescript
-BalanceChange {
-  amount: string;     // Negative for spending, positive for receiving
-  coinType: string;
-  owner: ObjectOwner;
-}
-```
-
-### WowObjectChange
-
-```typescript
-WowObjectChange =
-  | { type: "created"; objectId: string; objectType: string; owner: ObjectOwner; sender: string; version: string | number; digest: string }
-  | { type: "mutated"; objectId: string; objectType: string; owner: ObjectOwner | null; sender: string; version: string | number; digest: string; previousVersion: string | number }
-  | { type: "deleted"; objectId: string; objectType: string; sender: string; version: string | number }
-  | { type: "transferred"; objectId: string; objectType: string; recipient: ObjectOwner; sender: string; version: string | number; digest: string }
-  | { type: "wrapped"; objectId: string; objectType: string; sender: string; version: string | number }
-  | { type: "published"; packageId: string; version: string | number; digest: string; modules: string[] };
-```
-
-### ObjectOwner
-
-```typescript
-ObjectOwner =
-  | { AddressOwner: string }
-  | { ObjectOwner: string }
-  | { Shared: { initial_shared_version: number } }
-  | "Immutable";
-```
-
-### WowObjectRef
-
-```typescript
-WowObjectRef {
-  objectId: string;
-  version: string | number;
-  digest: string;
-}
-```
-
-### OwnedObjectRef
-
-```typescript
-OwnedObjectRef {
-  owner: ObjectOwner;
-  reference: WowObjectRef;
-}
-```
-
----
-
-## Output Structure
-
-```typescript
-AccountOperationOutput {
-  status: "success" | "error";
-  data?: AccountOperationResult;  // Present when status = "success"
-  error?: string;                 // Present when status = "error"
-}
-
-// Wrapped format
-{
-  result: AccountOperationOutput;
-}
-```
-
-### AccountOperationResult
-
-```typescript
-AccountOperationResult {
-  gen?: GenResult;
-  faucet?: FaucetResult;
-  suspend?: SuspendResult;
-  resume?: ResumeResult;
-  rename?: RenameResult;
-  swap_name?: SwapNameResult;
-  transfer?: WowTransactionBlockResponse;
-  get?: GetResult;
-  signData?: SignDataResult;
-  messenger?: MessengerResult;
-}
-```