@wowok/agent-mcp 2.6.3 → 2.6.4

package/dist/schemas/query_toolkit.output.json

@@ -2652,7 +2652,7 @@
               },
               "wip_hash": {
                 "type": "string",
-                "description": "WIP file hash (hex string). EMPTY string \"\" skips hash comparison (TESTING ONLY). Production: fill with the hash you saw when viewing the product, to prevent merchant replacing the WIP file before order."
+                "description": "SHA-256 hash (hex string) of the sale's WIP file, committed on-chain by the merchant. BUY RULE: if this is NON-EMPTY, the buyer MUST pass this exact value as wip_hash when creating an order (ServiceBuyItem.wip_hash) — NEVER use \"\". Pinning the on-chain hash prevents the merchant from replacing the WIP file (a legitimate update) between the buyer's view and order placement, ensuring 'what you see is what you get'. EMPTY means no hash was committed (TESTING ONLY, no delivery-integrity guarantee)."
               }
             },
             "required": [

package/dist/schemas/query_toolkit.schema.json

@@ -584,6 +584,43 @@
           ],
           "additionalProperties": false,
           "description": "FORENSICS TOOL — query all transactions sent by an address. WARNING: like onchain_object_history, this can lead to non-convergent queries. For AI context building, use assemble_context (extracts embedded history) or query_events (real-time transitions) instead. This tool is for auditing/user-activity profiling only. Returns: TransactionHistoryAnswer | undefined"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "token_value_convert"
+            },
+            "token_type": {
+              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/token_type",
+              "description": "Full token type in Move format: 0x<package>::<module>::<struct>. Examples: \"0x2::wow::WOW\" (9 decimals). The token's decimals drive the conversion — resolved from official registry → local cache → on-chain coin metadata."
+            },
+            "raw": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "Raw smallest-unit value (u64, e.g. \"2200000000\") to convert TO a human unit value. Provide EXACTLY ONE of raw / unit."
+            },
+            "unit": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "Human unit value (e.g. \"2.2\") to convert TO raw smallest units (u64). Provide EXACTLY ONE of raw / unit. Conversion is REFUSED when the token's decimals cannot be resolved (guessing would forge wrong on-chain values)."
+            },
+            "network": {
+              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/network",
+              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+            }
+          },
+          "required": [
+            "query_type",
+            "token_type"
+          ],
+          "additionalProperties": false,
+          "description": "Convert between raw on-chain smallest units (u64) and human unit values, in EITHER direction. Provide EXACTLY ONE of raw / unit (handler-validated). raw → unit: \"2200000000\" → \"2.2\" (pass-through when precision unknown). unit → raw: \"2.2\" → \"2200000000\" (REFUSED when precision unknown — never guesses decimals). Use this before displaying chain values to users, and before entering amounts for on-chain operations. Returns: { token_type, symbol?, decimals?, precision_known, direction, input, output, error?, text }"
         }
       ]
     }

package/dist/schemas/schema_query.output.json

@@ -109,7 +109,7 @@
             {
               "type": "object",
               "additionalProperties": {},
-              "description": "JSON Schema object (get/get_output/get_field) or Guard template data."
+              "description": "JSON Schema object (get/get_output/get_field), Guard template data, tool reference data (get_tool_reference), Guard design pattern catalog (get_guard_design_patterns), or safety rules tables (get_safety_rules)."
             },
             {
               "type": "null",

package/dist/schemas/schema_query.schema.json

@@ -18,17 +18,21 @@
             "list_operations",
             "get_guard_templates",
             "get_field",
-            "search_examples"
+            "search_examples",
+            "get_tool_reference",
+            "get_guard_design_patterns",
+            "get_safety_rules",
+            "get_templates"
           ],
-          "description": "Action to perform: 'list' (all schemas), 'get' (specific input schema), 'get_output' (tool output schema), 'get_field' (field-path query e.g. field_path='data.node'), 'search' (by keyword), 'list_operations' (on-chain operations), 'get_guard_templates' (Guard creation templates + best practices), 'search_examples' (search verified example files by keyword — matches title, description, tags, operation_type, industry)."
+          "description": "Action to perform: 'list' (all schemas), 'get' (specific input schema), 'get_output' (tool output schema), 'get_field' (field-path query e.g. field_path='data.node'), 'search' (by keyword), 'list_operations' (on-chain operations), 'get_guard_templates' (Guard creation templates + best practices), 'search_examples' (search verified example files by keyword — matches title, description, tags, operation_type, industry), 'get_tool_reference' (MCP tool usage reference: summaries, actions, prerequisites, notes — sunk from wowok-tools skill), 'get_guard_design_patterns' (curated Guard design pattern catalog: business requirement → logic tree template — sunk from wowok-guard skill), 'get_safety_rules' (object reuse/immutability/operation-classification/naming rules — sunk from wowok-safety skill), 'get_templates' (unified template registry: ~90 parameterized templates across 11 object types — guard/machine/service/order/progress/arbitration/treasury/permission/passport/allocation/reward; omit 'template' to list metadata, provide 'template' for full detail, provide 'template' + 'params' to instantiate into executable JSON)."
         },
         "name": {
           "type": "string",
-          "description": "Schema/tool name for 'get'/'get_output'/'get_field' action (e.g., 'onchain_operations', 'onchain_operations_machine')."
+          "description": "Schema/tool name for 'get'/'get_output'/'get_field'/'get_tool_reference' action (e.g., 'onchain_operations', 'onchain_operations_machine'), or pattern id for 'get_guard_design_patterns' (e.g., 'pattern.identity_check_allowlist')."
         },
         "query": {
           "type": "string",
-          "description": "Search query for 'search' action"
+          "description": "Search query for 'search' action, keyword filter for 'get_tool_reference', or host filter for 'get_guard_design_patterns' (e.g. 'service_buy_guard', 'machine_forward', 'reward_claim')."
         },
         "field_path": {
           "type": "string",
@@ -36,7 +40,28 @@
         },
         "template": {
           "type": "string",
-          "description": "Guard template name for 'get_guard_templates' action. Omit to list all available templates. Available: signer_verification, progress_node_check, order_owner_verification, service_belonging_check, reward_not_claimed, combined_reward_guard."
+          "description": "Guard template name for 'get_guard_templates' action. Omit to list all available templates. Available: signer_verification, progress_node_check, order_owner_verification, service_belonging_check, reward_not_claimed, combined_reward_guard. For 'get_templates': unified template id (e.g. 'tpl_buy_guard_whitelist', 'tpl_machine_ecommerce_standard', 'T-S-01', 'T-O-01', 'first_order')."
+        },
+        "object_type": {
+          "type": "string",
+          "enum": [
+            "guard",
+            "machine",
+            "service",
+            "order",
+            "progress",
+            "arbitration",
+            "treasury",
+            "permission",
+            "passport",
+            "allocation",
+            "reward"
+          ],
+          "description": "Object-type filter for 'get_templates' list mode (e.g. 'guard' lists only Guard templates)."
+        },
+        "params": {
+          "type": "string",
+          "description": "JSON-encoded parameter object for 'get_templates' instantiation mode (e.g. '{\"whitelist\":[\"0xabc\"]}'). Required params are declared in each template's 'parameters' list (see detail mode)."
         },
         "output_file": {
           "type": "string",

package/dist/schemas/trust_score.output.json

@@ -304,6 +304,397 @@
               ],
               "additionalProperties": false,
               "description": "InfoPuzzle summary — present only when depth >= 'evaluate'."
+            },
+            "preorder_advice": {
+              "type": "object",
+              "properties": {
+                "confidence": {
+                  "type": "object",
+                  "properties": {
+                    "score": {
+                      "type": "number",
+                      "minimum": 0,
+                      "maximum": 100,
+                      "description": "Composite order confidence (0-100, higher = safer to order)."
+                    },
+                    "base": {
+                      "type": "number",
+                      "description": "Base confidence = 100 - risk.total."
+                    },
+                    "user_adjustment": {
+                      "type": "number",
+                      "description": "User-controllable adjustment from user_metrics (±cap)."
+                    },
+                    "preference_nudge": {
+                      "type": "number",
+                      "description": "Preference-match nudge (±5, only when preferences were provided)."
+                    },
+                    "explanation": {
+                      "type": "string",
+                      "description": "Transparent breakdown of the confidence components."
+                    }
+                  },
+                  "required": [
+                    "score",
+                    "base",
+                    "user_adjustment",
+                    "preference_nudge",
+                    "explanation"
+                  ],
+                  "additionalProperties": false,
+                  "description": "ConfidenceScore — user-controllable composite order confidence."
+                },
+                "industry": {
+                  "type": "string",
+                  "enum": [
+                    "freelance",
+                    "rental",
+                    "education",
+                    "travel",
+                    "subscription",
+                    "retail"
+                  ],
+                  "description": "Industry used for the industry-specific risk checks (explicit input or inferred)."
+                },
+                "strategies": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "scenario": {
+                        "type": "string",
+                        "enum": [
+                          "info_asymmetry",
+                          "fund_safety",
+                          "refund_dispute",
+                          "arbitration_fairness",
+                          "pricing",
+                          "delivery_sla",
+                          "quality_verification",
+                          "after_sales"
+                        ],
+                        "description": "Game scenario detected from the puzzle."
+                      },
+                      "merchant_tactic": {
+                        "type": "string",
+                        "description": "Merchant's potential tactic in this scenario."
+                      },
+                      "user_strategy": {
+                        "type": "string",
+                        "description": "Recommended user-side strategy (protection/mitigation)."
+                      },
+                      "nash_equilibrium": {
+                        "type": "string",
+                        "description": "Win-win equilibrium the strategy pushes toward."
+                      },
+                      "confidence": {
+                        "type": "number",
+                        "minimum": 0,
+                        "maximum": 1,
+                        "description": "Strategy confidence (0-1)."
+                      },
+                      "fallback": {
+                        "type": "string",
+                        "description": "Alternative when the user rejects the main strategy."
+                      },
+                      "rationale": {
+                        "type": "string",
+                        "description": "Trigger-condition explanation from puzzle evidence."
+                      }
+                    },
+                    "required": [
+                      "scenario",
+                      "merchant_tactic",
+                      "user_strategy",
+                      "nash_equilibrium",
+                      "confidence",
+                      "rationale"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Top merchant-vs-user game strategies (user side, max 3)."
+                },
+                "preference_match": {
+                  "type": "object",
+                  "properties": {
+                    "score": {
+                      "type": "number",
+                      "minimum": 0,
+                      "maximum": 100,
+                      "description": "Preference match score (0-100)."
+                    },
+                    "matches": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Aspects matching the user's preferences."
+                    },
+                    "mismatches": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Aspects mismatching the user's preferences."
+                    },
+                    "warnings": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Match warnings (e.g. budget stretch)."
+                    }
+                  },
+                  "required": [
+                    "score",
+                    "matches",
+                    "mismatches",
+                    "warnings"
+                  ],
+                  "additionalProperties": false,
+                  "description": "PreferenceMatchResult — present when preferences (input or profile) were available."
+                },
+                "preference_issues": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Validation issues found in the merged preferences (e.g. budget min > max)."
+                },
+                "industry_risks": {
+                  "type": "object",
+                  "properties": {
+                    "score_adjustment": {
+                      "type": "number",
+                      "description": "Industry risk adjustment applied to the base risk score (-10 to +10)."
+                    },
+                    "summary": {
+                      "type": "string",
+                      "description": "Industry risk assessment summary."
+                    },
+                    "checks": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/definitions/trust_score/properties/result/properties/risk_score/properties/dimensions/items/properties/checks/items"
+                      },
+                      "description": "Industry-specific risk checks."
+                    },
+                    "unmet_needs": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string",
+                            "description": "Need identifier."
+                          },
+                          "tier": {
+                            "type": "string",
+                            "enum": [
+                              "common",
+                              "personalized",
+                              "advanced"
+                            ],
+                            "description": "Need tier."
+                          },
+                          "description": {
+                            "type": "string",
+                            "description": "Need description."
+                          },
+                          "advice": {
+                            "type": "string",
+                            "description": "Advice for fulfilling the need."
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "tier",
+                          "description"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "description": "Industry needs not satisfied by this Service."
+                    }
+                  },
+                  "required": [
+                    "score_adjustment",
+                    "summary",
+                    "checks",
+                    "unmet_needs"
+                  ],
+                  "additionalProperties": false,
+                  "description": "IndustryRiskResult — industry pain-point checks (needs met / risks triggered)."
+                },
+                "reminders": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "description": "Reminder rule identifier."
+                      },
+                      "stage": {
+                        "type": "string",
+                        "enum": [
+                          "browse",
+                          "evaluate",
+                          "preorder",
+                          "in_progress",
+                          "complete",
+                          "after_sale"
+                        ],
+                        "description": "Workflow stage this reminder belongs to."
+                      },
+                      "priority": {
+                        "type": "string",
+                        "enum": [
+                          "required",
+                          "recommended",
+                          "info",
+                          "reminder"
+                        ],
+                        "description": "Priority: required = blocking, recommended = strongly suggested."
+                      },
+                      "message": {
+                        "type": "string",
+                        "description": "Human-readable reminder message."
+                      },
+                      "action": {
+                        "type": "string",
+                        "description": "Suggested follow-up action, if any."
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "stage",
+                      "priority",
+                      "message"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Transaction-safety reminders at the preorder stage (sorted, capped)."
+                },
+                "blocking_reminders": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/definitions/trust_score/properties/result/properties/preorder_advice/properties/reminders/items"
+                  },
+                  "description": "Blocking (priority=required) reminders — resolve these before ordering."
+                },
+                "summary": {
+                  "type": "string",
+                  "description": "AI-ready paragraph summarizing the whole preorder report."
+                }
+              },
+              "required": [
+                "confidence",
+                "strategies",
+                "reminders",
+                "blocking_reminders",
+                "summary"
+              ],
+              "additionalProperties": false,
+              "description": "PreorderAdvice (GLM6/94 §3) — present only when depth = 'preorder'. AI presents evidence and options; the USER decides whether to order."
+            },
+            "comparison": {
+              "type": "object",
+              "properties": {
+                "rows": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "service_id": {
+                        "type": "string"
+                      },
+                      "service_name": {
+                        "type": "string"
+                      },
+                      "error": {
+                        "type": "string",
+                        "description": "Per-service evaluation failure (row excluded from best-per-metric)."
+                      },
+                      "industry": {
+                        "$ref": "#/definitions/trust_score/properties/result/properties/preorder_advice/properties/industry"
+                      },
+                      "confidence": {
+                        "type": "number",
+                        "description": "Order confidence 0-100 (higher = safer)."
+                      },
+                      "risk_total": {
+                        "type": "number",
+                        "description": "Risk score 0-100 (lower = safer)."
+                      },
+                      "risk_level": {
+                        "type": "string"
+                      },
+                      "trust_score": {
+                        "type": "number",
+                        "description": "Trust score 0-100 (higher = more trustworthy)."
+                      },
+                      "trust_level": {
+                        "type": "string"
+                      },
+                      "preference_match": {
+                        "type": "number",
+                        "description": "Preference match 0-100 (higher = better fit)."
+                      },
+                      "reputation_like_ratio": {
+                        "type": "number",
+                        "description": "likes/(likes+dislikes); 1 when no votes."
+                      },
+                      "reputation_votes": {
+                        "type": "number"
+                      },
+                      "red_flags_count": {
+                        "type": "number"
+                      },
+                      "blocking_reminders_count": {
+                        "type": "number"
+                      },
+                      "info_gaps_count": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "service_id",
+                      "service_name"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "One row per evaluated service (primary first, then compare_with candidates)."
+                },
+                "best_per_metric": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "description": "metric name → service_ids with the best value (ties all listed). Per-metric ONLY."
+                },
+                "evaluated_metrics": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Metrics actually compared (skipped when fewer than 2 rows have data)."
+                },
+                "note": {
+                  "type": "string",
+                  "description": "Neutrality note: no overall ranking; metric weights belong to the buyer."
+                }
+              },
+              "required": [
+                "rows",
+                "best_per_metric",
+                "evaluated_metrics",
+                "note"
+              ],
+              "additionalProperties": false,
+              "description": "Deterministic multi-service comparison (GLM6/94 L6) — present only when depth='preorder' and compare_with is provided. Per-metric bests ONLY, no overall ranking — the buyer decides."
             }
           },
           "required": [
@@ -315,7 +706,7 @@
             "depth"
           ],
           "additionalProperties": false,
-          "description": "Trust score result. Contains: trust_score (ServiceTrustScore), risk_score (RiskScore, when depth >= evaluate), info_puzzle summary, and service_basics snapshot."
+          "description": "Trust score result. Contains: trust_score (ServiceTrustScore), risk_score (RiskScore, when depth >= evaluate), info_puzzle summary, preorder_advice (PreorderAdvice, when depth = preorder), comparison (PreorderComparison, when depth = preorder and compare_with given), and service_basics snapshot."
         }
       },
       "required": [