@wowok/agent-mcp 2.6.1 → 2.6.4

package/dist/schemas/trust_score.schema.json

@@ -26,7 +26,272 @@
             "evaluate",
             "preorder"
           ],
-          "description": "InfoPuzzle collection depth. browse: only Service basics + trust score; evaluate (default): + workflow/fund/trust dimensions risk assessment; preorder: + merchant behavior + market context (most thorough)."
+          "description": "InfoPuzzle collection depth. browse: only Service basics + trust score; evaluate (default): + workflow/fund/trust dimensions risk assessment; preorder: + full preorder advice (confidence, game strategies, preference match, industry risks, blocking reminders)."
+        },
+        "industry": {
+          "type": "string",
+          "enum": [
+            "freelance",
+            "rental",
+            "education",
+            "travel",
+            "subscription",
+            "retail"
+          ],
+          "description": "Explicit industry override for industry-specific risk checks and needs matrix. If omitted at depth=preorder, the industry is inferred from the puzzle."
+        },
+        "preferences": {
+          "type": "object",
+          "properties": {
+            "price_sensitivity": {
+              "type": "string",
+              "enum": [
+                "low",
+                "medium",
+                "high"
+              ]
+            },
+            "budget_range": {
+              "type": "object",
+              "properties": {
+                "min": {
+                  "type": [
+                    "string",
+                    "number"
+                  ],
+                  "description": "Budget lower bound (smallest token unit)."
+                },
+                "max": {
+                  "type": [
+                    "string",
+                    "number"
+                  ],
+                  "description": "Budget upper bound (smallest token unit)."
+                }
+              },
+              "required": [
+                "min",
+                "max"
+              ],
+              "additionalProperties": false
+            },
+            "value_orientation": {
+              "type": "string",
+              "enum": [
+                "quality",
+                "balanced",
+                "budget"
+              ]
+            },
+            "discount_sensitivity": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "delivery_speed_priority": {
+              "type": "string",
+              "enum": [
+                "urgent",
+                "normal",
+                "flexible"
+              ]
+            },
+            "max_acceptable_cycle": {
+              "type": "number",
+              "minimum": 0,
+              "description": "Max acceptable delivery cycle (days)."
+            },
+            "response_time_expectation": {
+              "type": "number",
+              "minimum": 0,
+              "description": "Expected merchant response time (hours)."
+            },
+            "merchant_preference": {
+              "type": "string",
+              "enum": [
+                "established",
+                "emerging",
+                "neutral"
+              ]
+            },
+            "min_order_history": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "bargain_hunting": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "reward_seeking": {
+              "type": "boolean"
+            },
+            "referral_participation": {
+              "type": "boolean"
+            },
+            "communication_style": {
+              "type": "string",
+              "enum": [
+                "formal",
+                "casual",
+                "friendly"
+              ]
+            },
+            "transparency_demand": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "after_sales_expectation": {
+              "type": "string",
+              "enum": [
+                "full",
+                "basic",
+                "minimal"
+              ]
+            },
+            "risk_appetite": {
+              "type": "string",
+              "enum": [
+                "conservative",
+                "balanced",
+                "aggressive"
+              ]
+            },
+            "min_trust_score": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
+            },
+            "require_arbitration": {
+              "type": "boolean"
+            },
+            "require_compensation_fund": {
+              "type": "boolean"
+            },
+            "preferred_industries": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "preferred_tokens": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "preferred_merchants": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "additionalProperties": false,
+          "description": "Optional user preference overrides (partial; merged over profile-derived defaults). Only used at depth=preorder for preference matching and pref-aware strategies."
+        },
+        "user_metrics": {
+          "type": "object",
+          "properties": {
+            "metrics": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "description": "Stable metric identifier (e.g. 'merchant_tenure_days')."
+                  },
+                  "label": {
+                    "type": "string",
+                    "description": "Human-readable label shown to the user."
+                  },
+                  "evaluator": {
+                    "type": "string",
+                    "enum": [
+                      "threshold",
+                      "ratio",
+                      "boolean",
+                      "presence",
+                      "regex_match",
+                      "custom_query"
+                    ],
+                    "description": "How the metric is evaluated against the puzzle context."
+                  },
+                  "params": {
+                    "type": "object",
+                    "properties": {
+                      "path": {
+                        "type": "string",
+                        "description": "JSON path in the raw data context (e.g. 'service.name')."
+                      },
+                      "threshold": {
+                        "type": [
+                          "string",
+                          "number"
+                        ],
+                        "description": "Threshold value (threshold/presence evaluators)."
+                      },
+                      "invert": {
+                        "type": "boolean",
+                        "description": "true: pass when value <= threshold."
+                      },
+                      "min": {
+                        "type": "number",
+                        "description": "Min ratio (ratio evaluator)."
+                      },
+                      "max": {
+                        "type": "number",
+                        "description": "Max ratio (ratio evaluator)."
+                      },
+                      "pattern": {
+                        "type": "string",
+                        "description": "Regex pattern (regex_match evaluator)."
+                      },
+                      "query_key": {
+                        "type": "string",
+                        "description": "Custom query identifier (custom_query evaluator)."
+                      }
+                    },
+                    "additionalProperties": false
+                  },
+                  "weight": {
+                    "type": "number",
+                    "minimum": 0,
+                    "maximum": 1,
+                    "description": "Relative weight vs other user metrics (0-1)."
+                  },
+                  "advice_on_fail": {
+                    "type": "string"
+                  },
+                  "advice_on_pass": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "name",
+                  "label",
+                  "evaluator",
+                  "params",
+                  "weight"
+                ],
+                "additionalProperties": false
+              },
+              "minItems": 1,
+              "description": "User-defined scoring factors."
+            },
+            "adjustment_cap": {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "description": "Global cap for the composite confidence adjustment (default ±10 points)."
+            }
+          },
+          "required": [
+            "metrics"
+          ],
+          "additionalProperties": false,
+          "description": "Optional user-controllable scoring factors (评分体系用户可控). Evaluated at depth=preorder; the composite adjustment (±cap) nudges the order confidence score."
         },
         "network": {
           "type": "string",
@@ -35,6 +300,15 @@
         "no_cache": {
           "type": "boolean",
           "description": "Skip object cache and force a fresh on-chain query."
+        },
+        "compare_with": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1,
+          "maxItems": 9,
+          "description": "Optional candidate Service addresses/LocalMark names (1-9) for deterministic multi-service comparison. Only used at depth=preorder. The SAME preferences/user_metrics/industry are applied uniformly to all candidates; output gains a `comparison` block with per-metric bests (NO overall ranking — the buyer decides)."
         }
       },
       "required": [

package/dist/schemas/wowok_buildin_info.output.json

@@ -69,19 +69,23 @@
                     "properties": {
                       "index": {
                         "type": "number",
-                        "description": "Permission index"
+                        "description": "Permission index (e.g. 315 for service.compensation_fund_deposit)"
                       },
                       "name": {
                         "type": "string",
-                        "description": "Name"
+                        "description": "Permission name (e.g. \"service.compensation_fund_deposit\")"
                       },
                       "description": {
                         "type": "string",
-                        "description": "Description"
+                        "description": "Description of what this permission allows"
                       },
                       "object_type": {
                         "type": "string",
-                        "description": "Object type"
+                        "description": "Object type this permission belongs to (e.g. \"Service\", \"Arbitration\")"
+                      },
+                      "operation": {
+                        "type": "string",
+                        "description": "The SDK/MCP operation field name that triggers this permission check (e.g. \"compensation_fund_add\", \"publish\", \"pause\"). Undefined for permissions with no direct Call*_Data field (e.g. \"*.new\" permissions). Use this to answer: \"What permission does operation X require?\" by filtering with {operation: \"compensation_fund_add\"}."
                       }
                     },
                     "required": [
@@ -91,9 +95,78 @@
                       "object_type"
                     ],
                     "additionalProperties": false,
-                    "description": "Permission info type"
+                    "description": "Permission info type — includes the operation field name that maps to this permission, so AI can look up required permissions by operation name."
+                  },
+                  "description": "Built-in permissions result. Each item includes an optional \"operation\" field mapping to the SDK/MCP field name that triggers this permission."
+                }
+              },
+              "required": [
+                "info",
+                "result"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "info": {
+                  "type": "string",
+                  "const": "common mistakes"
+                },
+                "result": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "object_type": {
+                        "type": "string",
+                        "description": "The object type this mistake applies to (e.g. \"Service\", \"Arbitration\")"
+                      },
+                      "operation": {
+                        "type": "string",
+                        "description": "The operation field name this mistake applies to (e.g. \"compensation_fund_add\", \"voting_deadline\")"
+                      },
+                      "category": {
+                        "type": "string",
+                        "enum": [
+                          "field_name",
+                          "unit",
+                          "value_range",
+                          "workflow",
+                          "timing"
+                        ],
+                        "description": "Category of the mistake: field_name (wrong field name), unit (wrong unit like seconds vs ms), value_range (wrong expected value), workflow (wrong operation order), timing (wrong time constraint)"
+                      },
+                      "mistake": {
+                        "type": "string",
+                        "description": "Short description of the mistake"
+                      },
+                      "correct_usage": {
+                        "type": "string",
+                        "description": "The correct usage pattern"
+                      },
+                      "wrong_example": {
+                        "type": "string",
+                        "description": "Example of the wrong usage"
+                      },
+                      "correct_example": {
+                        "type": "string",
+                        "description": "Example of the correct usage"
+                      }
+                    },
+                    "required": [
+                      "object_type",
+                      "operation",
+                      "category",
+                      "mistake",
+                      "correct_usage",
+                      "wrong_example",
+                      "correct_example"
+                    ],
+                    "additionalProperties": false,
+                    "description": "A known common mistake for an on-chain operation. Use this to proactively warn users before they submit a transaction."
                   },
-                  "description": "Built-in permissions result"
+                  "description": "Common mistakes result. Each item documents a known pitfall (wrong field name, wrong unit, wrong workflow order, etc.) with wrong/correct examples."
                 }
               },
               "required": [
@@ -486,12 +559,12 @@
                       "parameters": {
                         "type": "array",
                         "items": {
-                          "$ref": "#/definitions/wowok_buildin_info/properties/result/anyOf/2/properties/result/items/properties/returnType"
+                          "$ref": "#/definitions/wowok_buildin_info/properties/result/anyOf/3/properties/result/items/properties/returnType"
                         },
                         "description": "Parameters for guard query"
                       },
                       "return": {
-                        "$ref": "#/definitions/wowok_buildin_info/properties/result/anyOf/2/properties/result/items/properties/returnType",
+                        "$ref": "#/definitions/wowok_buildin_info/properties/result/anyOf/3/properties/result/items/properties/returnType",
                         "description": "Return type for guard query"
                       },
                       "parameters_description": {

package/dist/schemas/wowok_buildin_info.schema.json

@@ -80,17 +80,61 @@
                 "description": {
                   "type": "string",
                   "description": "Description filter"
+                },
+                "operation": {
+                  "type": "string",
+                  "description": "Filter by SDK/MCP operation field name (e.g. \"compensation_fund_add\"). Returns only permissions triggered by this operation. Use this to answer: \"What permission does operation X require?\""
+                }
+              },
+              "additionalProperties": false,
+              "description": "Filter for built-in permissions. Use operation:\"compensation_fund_add\" to find which permission a specific operation requires."
+            }
+          },
+          "required": [
+            "info"
+          ],
+          "additionalProperties": false,
+          "description": "Built-in permissions query. Each permission includes an optional \"operation\" field that maps to the SDK/MCP Call*_Data field name triggering it. Use this to answer: \"What permission does operation X require?\" — e.g. filter operation:\"compensation_fund_add\" returns permission index 315 (service.compensation_fund_deposit)."
+        },
+        {
+          "type": "object",
+          "properties": {
+            "info": {
+              "type": "string",
+              "const": "common mistakes"
+            },
+            "filter": {
+              "type": "object",
+              "properties": {
+                "object_type": {
+                  "type": "string",
+                  "description": "Filter by object type (e.g. \"Service\")"
+                },
+                "operation": {
+                  "type": "string",
+                  "description": "Filter by operation field name (e.g. \"compensation_fund_add\")"
+                },
+                "category": {
+                  "type": "string",
+                  "enum": [
+                    "field_name",
+                    "unit",
+                    "value_range",
+                    "workflow",
+                    "timing"
+                  ],
+                  "description": "Filter by category (e.g. \"field_name\" for field-name mistakes, \"unit\" for unit mistakes)"
                 }
               },
               "additionalProperties": false,
-              "description": "Filter for built-in permissions"
+              "description": "Filter for common mistakes. Use operation:\"compensation_fund_add\" to find mistakes for a specific operation, or category:\"field_name\" for all field-name mistakes."
             }
           },
           "required": [
             "info"
           ],
           "additionalProperties": false,
-          "description": "Built-in permissions query"
+          "description": "Common mistakes query. Returns known field-name, unit, value-range, workflow, and timing pitfalls for on-chain operations. Use this to proactively warn users before submitting a transaction. Example: query operation:\"compensation_fund_add\" to learn about the {amount} vs {balance} field name mistake."
         },
         {
           "type": "object",