@wowok/skills 2.0.1 → 2.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wowok/skills",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "WoWok AI Skills for Claude and other AI assistants - Dialogue orchestration layer on top of the WoWok MCP server (rules/reference knowledge is served by MCP directly since v2.0.0)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/wowok-order/SKILL.md

@@ -313,7 +313,7 @@ Before calling `order.receive`, query what the Order has received to verify ther
 }
 ```
 
-**Expected response**: A `ReceivedBalance` object with `token_type`, `balance`, and `received[]` array of `CoinWrapper` objects. If empty, there is nothing to withdraw yet.
+**Expected response**: A `ReceivedBalance` object with `token_type`, `balance`, `received[]` array of `CoinWrapper` objects, and `_money_display` annotation (unit-converted values with decimals reminder). If empty, there is nothing to withdraw yet.
 
 #### Step 2: Call `order.receive` with `"recently"` (simplest form)
 

package/wowok-output/SKILL.md

@@ -21,13 +21,23 @@ this skill's shortening rules are DISABLED — display complete 66-character add
 
 ## Short Address Format
 
-**MUST APPLY TO ALL ADDRESSES** (0x prefix + 64 hex chars = 66 chars total):
-1. Remove `0x` prefix
-2. Take first 5 characters
-3. Convert to UPPERCASE
-4. Wrap in parentheses `()`
+**MUST APPLY TO ALL ADDRESSES AND OBJECT IDs** (0x prefix + 64 hex chars = 66 chars total).
 
-**Example**: `0xa1d421902a3e5f2e4da7590e8f243712b3b3479d1a07c48c2de543184fc97a33` → `(A1D42)`
+Generate a short ID by the following rules:
+1. Remove `0x` prefix → get the hex string
+2. Take the first 5 characters (or fewer if the address is shorter)
+3. Convert to UPPERCASE
+4. **If all 5 characters are the same character** (e.g., `00000` → `AAAAA`), fall back to the last 5 characters, prefixed with `...`
+5. **If even the last 5 are all the same character** (extremely rare), find 5 consecutive characters near the middle that differ, wrapped with `...` on both sides
+6. **Display rule**: no parentheses by default; parentheses are only used when paired with a name (see Display Format Rules below)
+
+**Examples**:
+| Full Address | Short ID | Rule |
+|---|---|---|
+| `0xa1d421902a3e5f2e4da7590e8f243712b3b3479d1a07c48c2de543184fc97a33` | `A1D42` | Normal: first 5 |
+| `0x00000123456789abcdef0123456789abcdef0123456789abcdef000000000000` | `...00000` | First 5 all same → last 5 |
+| `0x00000000000000000000000000000000000000000000000000000000000000000` | `...00000...` | Both ends all same → middle 5 |
+| `0x2` | `2` | Short address, take actual length |
 
 ## Resolution Priority & Display Format
 
@@ -39,10 +49,10 @@ Returns: `{ account?: string, local_mark?: string, address: string }`
 
 | Condition | Display Format | Example |
 |-----------|----------------|---------|
-| **Both account AND local_mark exist** | `{account_name} \| {local_mark_name} (ABCDE)` | `alice \| my_mark (A1D42)` |
-| **Only account exists** | `{account_name} (ABCDE)` | `alice_wallet (A1D42)` |
-| **Only local_mark exists** | `{local_mark_name} (ABCDE)` | `my_service (A1D42)` |
-| **Neither exists** | `(ABCDE)` | `(A1D42)` |
+| **Both account AND local_mark exist** | `{account_name} \| {local_mark_name}({ID})` | `alice \| my_mark(A1D42)` |
+| **Only account exists** | `{account_name}({ID})` | `alice_wallet(A1D42)` |
+| **Only local_mark exists** | `{local_mark_name}({ID})` | `my_service(A1D42)` |
+| **Neither exists** | `{ID}` | `A1D42` |
 
 ---
 
@@ -54,24 +64,32 @@ Returns: `{ account?: string, local_mark?: string, address: string }`
 
 # Amount Formatting Rules
 
-## Conservative Principle
+## Primary Source: `_money_display`
+
+The MCP fund layer now annotates all monetary query results with `_money_display` — a map of field paths to `ChainValueDisplay` objects containing `{raw, display, symbol, decimals, precision_known, text}`. **Use `_money_display` directly when present** — it is the authoritative formatted display, consistent with the MCP's own precision resolution.
+
+- `precision_known === true` → `text` field already contains the complete formatted string: e.g. `"2.2 WOW (decimals: 9; raw: 2200000000)"`
+- `precision_known === false` → `text` contains the raw value with a retry hint; show as-is (the true raw value is authoritative)
+
+Supported query types with `_money_display`:
+- `account_balance` — balance and coin amounts
+- `onchain_objects` — Treasury, Service, Order, Allocation, Payment, Reward, Arb, Discount monetary fields
+- `onchain_table_item_treasury_history` / `onchain_table_item_reward_record` — table entry amounts
+- `onchain_received` — CoinWrapper balances
+- `onchain_transaction` — balance_changes (each change has its own `coin_type`)
+- `onchain_events` — NewOrderEvent.amount (via the order's Service generic token type)
+
+## Fallback (when `_money_display` is absent)
 
 **When in doubt, display raw value.**
 
 | Condition | Display | Example |
 |-----------|---------|---------|
 | Token info UNAVAILABLE | Raw amount | `500000000` |
-| Token info AVAILABLE | Converted + symbol + precision | `0.5 WOW (9P)` |
-
-## Conversion Requirements
-
-ONLY convert when ALL conditions met:
-1. Token type explicitly identified
-2. Successfully queried via `query_toolkit` with `query_type: "token_list"`
-3. Metadata contains valid `decimals` and `symbol`
+| Token info AVAILABLE | Converted + symbol + precision | `2.2 WOW (decimals: 9; raw: 2200000000)` |
 
 **Formula**: `converted = raw / (10 ^ decimals)`  
-**Format**: `{amount} {symbol} ({decimals}P)`
+**Format**: `{amount} {symbol} (decimals: {N}; raw: {raw})`
 
 ---
 
@@ -82,10 +100,10 @@ ONLY convert when ALL conditions met:
 ```
 | # | Time | Sender | Service | Amount | Order |
 |---|------|--------|---------|--------|-------|
-| 1 | {time} | {name} (ABCDE) | {name} (ABCDE) | {amount} | (ABCDE) |
+| 1 | {time} | {name}(ABCDE) | {name}(ABCDE) | {amount} | ABCDE |
 ```
 
-**Note**: `{name}` follows Display Format Rules above (account | local_mark). If no name, show only `(ABCDE)`.
+**Note**: `{name}` follows Display Format Rules above (account | local_mark). If no name, show only the short ID (no parentheses).
 
 ## Event Type Fields
 
@@ -108,12 +126,13 @@ When user asks about field meanings:
 - **Sender**: Account that initiated the transaction
 - **Service**: Service object being ordered/interacted with
 - **Order Object**: Unique on-chain identifier for this order
-- **Short Address (ABCDE)**: First 5 chars for quick visual identification
+- **Short Address (ABCDE)**: Shortened ID for quick visual identification — see Short Address Format rules (first 5 chars; fallback to last 5 or middle 5 if all same)
 
 ## Amounts
 - **Raw**: Actual U64 integer stored on-chain
 - **Converted**: Human-readable after applying decimals
-- **Precision (XP)**: Number of decimal places
+- **Precision (N decimals)**: Number of decimal places
+- **`_money_display`**: MCP-annotated display map (see Amount Formatting Rules above)
 
 ## Time
 - **Timestamp**: Unix milliseconds since epoch
@@ -125,9 +144,10 @@ When user asks about field meanings:
 
 - [ ] Extract unique addresses from response
 - [ ] Query `local_names` for resolution
-- [ ] Query `token_list` for amount formatting
+- [ ] Check for `_money_display` annotations in query results (primary amount source)
+- [ ] If `_money_display` absent, query `token_list` for manual amount formatting
 - [ ] Apply address format rules
-- [ ] Apply amount format rules (conservative)
+- [ ] Apply amount format rules (use `_money_display` first; fallback to conservative)
 - [ ] Render final output
 
 ---