@wowok/skills 1.0.6 → 1.1.1

package/schemas/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;
-}
-```

package/schemas/schema-guard2file.md

@@ -1,153 +0,0 @@
-# Guard2File Tool Schema
-
-> **Tool Name**: `guard2file`
-> **Description**: Export a Guard object's definition from the blockchain to a local JSON or Markdown file for editing and creating new Guard objects. Note: To query on-chain object information, use the 'query_toolkit' tool instead.
-
----
-
-## Tool Schema
-
-```typescript
-guard2file: Guard2File_Input
-```
-
----
-
-## Input Schema
-
-```typescript
-Guard2File_Input {
-  guard: NameOrAddress,           // REQUIRED - Guard object ID or name to export
-  file_path: string,              // REQUIRED - Output file path (absolute or relative)
-  format?: "json" | "markdown",   // OPTIONAL - Output format (default: 'json')
-  env?: CallEnv                   // OPTIONAL - Environment configuration
-}
-```
-
----
-
-## Sub Schemas
-
-### NameOrAddress
-
-```typescript
-NameOrAddress = string           // Object ID (0x prefix + 64 hex chars) or name (max 64 chars)
-```
-
-### CallEnv
-
-```typescript
-CallEnv {
-  account?: NameOrAddress,        // Account/Object name or ID for signing
-  network?: "localnet" | "testnet", // Network entrypoint
-  no_cache?: boolean,             // Whether to disable caching
-  permission_guard?: string[],    // Permission guard IDs for extended permissions
-  referrer?: string               // Referrer ID for first-time network users
-}
-```
-
----
-
-## Output Schema
-
-```typescript
-Guard2File_OutputWrapped {
-  result: Guard2File_Output       // Guard2File operation output
-}
-
-Guard2File_Output =
-  | { status: "success"; data: Guard2File_SuccessData }
-  | { status: "error"; error: string }
-```
-
-### Success Data
-
-```typescript
-Guard2File_SuccessData {
-  file_path: string,              // Absolute path of the exported file
-  format: "json" | "markdown",    // Export format
-  guard_object: string            // Guard object ID
-}
-```
-
----
-
-## Usage Guide
-
-### Purpose
-
-The `guard2file` tool is specifically designed to:
-1. Export an existing Guard object's definition from the blockchain
-2. Save it to a local file for editing
-3. Use the exported file to create new Guard objects
-
-### When to Use
-
-| Scenario | Tool to Use |
-|----------|-------------|
-| Export Guard for editing | `guard2file` |
-| Query Guard on-chain state | `query_toolkit` |
-| Create new Guard | `onchain_operations` (guard) |
-| Modify existing Guard | `onchain_operations` (guard) |
-
-### File Formats
-
-**JSON Format** (`format: "json"`):
-- Machine-readable format
-- Suitable for programmatic processing
-- Default format
-
-**Markdown Format** (`format: "markdown"`):
-- Human-readable format with comments
-- Suitable for manual editing
-- Includes documentation
-
----
-
-## Example
-
-```typescript
-// Export a Guard to JSON file
-guard2file: {
-  guard: "0x1234...abcd",         // Guard object ID
-  file_path: "./my_guard.json",   // Output path
-  format: "json"
-}
-
-// Export a Guard to Markdown file
-guard2file: {
-  guard: "my_guard_name",         // Guard name
-  file_path: "./my_guard.md",     // Output path
-  format: "markdown"
-}
-```
-
----
-
-## Output Examples
-
-### Success Response
-
-```json
-{
-  "result": {
-    "status": "success",
-    "data": {
-      "file_path": "/absolute/path/to/my_guard.json",
-      "format": "json",
-      "guard_object": "0x1234567890abcdef..."
-    }
-  }
-}
-```
-
-### Error Response
-
-```json
-{
-  "result": {
-    "status": "error",
-    "error": "Guard object not found: 0x1234..."
-  }
-}
-```

package/schemas/schema-local_info_operation.md

@@ -1,160 +0,0 @@
-# Schema: local_info_operation
-
-> 100% LOCAL, NEVER ON-CHAIN - Manage sensitive personal information stored ONLY on your device: delivery addresses, phone numbers, contacts.
-
----
-
-## Top-Level Structure
-
-```typescript
-LocalInfoOperation {
-  // Exactly ONE operation type must be specified
-  add?: AddOperation;
-  remove?: RemoveOperation;
-  reset?: ResetOperation;
-  clear?: ClearOperation;
-}
-```
-
----
-
-## Operation Types
-
-### add
-
-Add one or more info entries.
-
-```typescript
-AddOperation {
-  op: "add";
-  data: InfoData[];  // At least 1 item required
-}
-
-InfoData {
-  name: string;       // Unique identifier (max 64 bcs characters)
-  default: string;    // Primary/default value (max 300 bcs characters)
-  contents?: string[]; // Additional values (max 50 items, each max 300 bcs)
-  createdAt?: number; // Unix timestamp (ms)
-  updatedAt?: number; // Unix timestamp (ms)
-}
-```
-
-**Result**:
-
-```typescript
-AddResult {
-  success: boolean;
-}
-```
-
----
-
-### remove
-
-Remove info entries by name.
-
-```typescript
-RemoveOperation {
-  op: "remove";
-  data: string[];     // Array of info names to remove (at least 1)
-}
-```
-
-**Result**:
-
-```typescript
-RemoveResult {
-  success: boolean;
-}
-```
-
----
-
-### reset
-
-Reset the contents of an existing info entry.
-
-```typescript
-ResetOperation {
-  op: "reset";
-  name: string;       // Name of info entry to reset
-  contents: string[]; // New content list to replace existing
-}
-```
-
-**Result**:
-
-```typescript
-ResetResult {
-  success: boolean;
-}
-```
-
----
-
-### clear
-
-Remove all info entries.
-
-```typescript
-ClearOperation {
-  op: "clear";
-}
-```
-
-**Result**:
-
-```typescript
-ClearResult {
-  success: boolean;
-}
-```
-
----
-
-## Output Structure
-
-```typescript
-LocalInfoOperationOutput {
-  status: "success" | "error";
-  data?: LocalInfoOperationResult;  // Present when status = "success"
-  error?: string;                   // Present when status = "error"
-}
-
-LocalInfoOperationResult {
-  success: boolean;
-}
-
-// Wrapped format
-{
-  result: LocalInfoOperationOutput;
-}
-```
-
----
-
-## Query Local Info List
-
-```typescript
-QueryLocalInfoList {
-  filter?: LocalInfoFilter;
-}
-
-LocalInfoFilter {
-  name?: string;              // Filter by info name (fuzzy match)
-  default?: string;           // Filter by default value (fuzzy match)
-  contents?: string[];        // Filter by contents (contains ANY of specified)
-  createdAt?: {
-    gte?: number;             // Created on or after (ms)
-    lte?: number;             // Created on or before (ms)
-  };
-  updatedAt?: {
-    gte?: number;             // Updated on or after (ms)
-    lte?: number;             // Updated on or before (ms)
-  };
-}
-
-QueryLocalInfoListResult {
-  result: InfoData[];
-}
-```