@wowok/agent-mcp 2.3.14 → 2.3.18

package/dist/schemas/schema_query.schema.json

@@ -16,13 +16,16 @@
             "get_output",
             "search",
             "list_operations"
-          ]
+          ],
+          "description": "Action to perform: 'list' to see all available schemas, 'get' to retrieve a specific input schema, 'get_output' to retrieve a tool's output schema, 'search' to find schemas by keyword, 'list_operations' to list all on-chain operations"
         },
         "name": {
-          "type": "string"
+          "type": "string",
+          "description": "Schema/tool name for 'get'/'get_output' action (e.g., 'onchain_operations', 'account_operation', 'onchain_operations_permission')"
         },
         "query": {
-          "type": "string"
+          "type": "string",
+          "description": "Search query for 'search' action"
         }
       },
       "required": [

package/dist/schemas/trust_score.output.json

@@ -0,0 +1,327 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/trust_score.json",
+  "title": "Trust Score - Service Risk & Trust Assessment",
+  "description": "Proactively query the trust score (0-100, 5 dimensions) and risk assessment (4 dimensions, 100-point) of a Service object. Parameters: service (required), order_amount (optional), depth (optional: browse/evaluate/preorder).",
+  "$ref": "#/definitions/trust_score",
+  "definitions": {
+    "trust_score": {
+      "type": "object",
+      "properties": {
+        "result": {
+          "type": "object",
+          "properties": {
+            "service_id": {
+              "type": "string",
+              "description": "The Service object ID or local_mark that was evaluated."
+            },
+            "service_name": {
+              "type": "string",
+              "description": "Service display name (falls back to service_id if unnamed)."
+            },
+            "service_basics": {
+              "type": "object",
+              "properties": {
+                "bPublished": {
+                  "type": "boolean",
+                  "description": "Whether the Service is published (open for orders)."
+                },
+                "bPaused": {
+                  "type": "boolean",
+                  "description": "Whether the Service is temporarily paused."
+                },
+                "sales_count": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Number of active (non-suspended) sale entries."
+                },
+                "has_machine": {
+                  "type": "boolean",
+                  "description": "Whether a Machine workflow is attached."
+                },
+                "has_buy_guard": {
+                  "type": "boolean",
+                  "description": "Whether a buy-side Guard is configured."
+                },
+                "has_um_contact": {
+                  "type": "boolean",
+                  "description": "Whether a Messenger (um) contact is configured."
+                },
+                "arbitrations_count": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Number of arbitration entries attached to the Service."
+                }
+              },
+              "required": [
+                "bPublished",
+                "bPaused",
+                "sales_count",
+                "has_machine",
+                "has_buy_guard",
+                "has_um_contact",
+                "arbitrations_count"
+              ],
+              "additionalProperties": false,
+              "description": "Service snapshot — basic on-chain state."
+            },
+            "trust_score": {
+              "type": "object",
+              "properties": {
+                "score": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100,
+                  "description": "Overall trust score (0-100, higher = more trustworthy)."
+                },
+                "level": {
+                  "type": "string",
+                  "enum": [
+                    "high_risk",
+                    "caution",
+                    "moderate",
+                    "trusted"
+                  ],
+                  "description": "Trust level label derived from the score."
+                },
+                "summary": {
+                  "type": "string",
+                  "description": "One-line human-readable trust summary."
+                },
+                "warnings": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Trust warnings (e.g. low arbitration dimension score)."
+                },
+                "breakdown": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "score": {
+                        "type": "number",
+                        "description": "Dimension score achieved."
+                      },
+                      "maxScore": {
+                        "type": "number",
+                        "description": "Dimension max possible score."
+                      },
+                      "description": {
+                        "type": "string",
+                        "description": "Dimension name / description."
+                      },
+                      "humanReadable": {
+                        "type": "string",
+                        "description": "Human-readable dimension explanation."
+                      }
+                    },
+                    "required": [
+                      "score",
+                      "maxScore",
+                      "description",
+                      "humanReadable"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "5-dimension breakdown: arbitration / reviews / fulfillment / fund_safety / transparency."
+                }
+              },
+              "required": [
+                "score",
+                "level",
+                "summary",
+                "warnings",
+                "breakdown"
+              ],
+              "additionalProperties": false,
+              "description": "ServiceTrustScore — 0-100 score across 5 trust dimensions."
+            },
+            "order_amount": {
+              "type": "string",
+              "description": "Order amount used for fund-safety assessment, in smallest token unit (bigint as string)."
+            },
+            "depth": {
+              "type": "string",
+              "enum": [
+                "browse",
+                "evaluate",
+                "preorder"
+              ],
+              "description": "Actual InfoPuzzle collection depth used (defaults to 'evaluate')."
+            },
+            "risk_score": {
+              "type": "object",
+              "properties": {
+                "total": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100,
+                  "description": "Overall risk score (0-100, higher = riskier)."
+                },
+                "level": {
+                  "type": "string",
+                  "enum": [
+                    "low",
+                    "medium_low",
+                    "medium_high",
+                    "high"
+                  ],
+                  "description": "Risk level label derived from the total score."
+                },
+                "red_flags": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Critical risk red flags detected."
+                },
+                "advice": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Risk mitigation advice."
+                },
+                "dimensions": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "type": "string",
+                        "enum": [
+                          "workflow",
+                          "fund",
+                          "trust",
+                          "behavior"
+                        ],
+                        "description": "Risk dimension name."
+                      },
+                      "score": {
+                        "type": "number",
+                        "description": "Dimension score achieved."
+                      },
+                      "max_score": {
+                        "type": "number",
+                        "description": "Dimension max possible score."
+                      },
+                      "checks": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "id": {
+                              "type": "string",
+                              "description": "Check identifier."
+                            },
+                            "dimension": {
+                              "type": "string",
+                              "enum": [
+                                "workflow",
+                                "fund",
+                                "trust",
+                                "behavior"
+                              ],
+                              "description": "Dimension this check belongs to."
+                            },
+                            "description": {
+                              "type": "string",
+                              "description": "Check description."
+                            },
+                            "weight": {
+                              "type": "number",
+                              "description": "Check weight within its dimension (percentage)."
+                            },
+                            "passed": {
+                              "type": "boolean",
+                              "description": "Whether the check passed."
+                            },
+                            "advice": {
+                              "type": "string",
+                              "description": "Advice when the check failed."
+                            }
+                          },
+                          "required": [
+                            "id",
+                            "dimension",
+                            "description",
+                            "weight",
+                            "passed"
+                          ],
+                          "additionalProperties": false
+                        },
+                        "description": "Individual risk checks within this dimension."
+                      }
+                    },
+                    "required": [
+                      "name",
+                      "score",
+                      "max_score",
+                      "checks"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "4-dimension breakdown: workflow / fund / trust / behavior."
+                }
+              },
+              "required": [
+                "total",
+                "level",
+                "red_flags",
+                "advice",
+                "dimensions"
+              ],
+              "additionalProperties": false,
+              "description": "RiskScore — present only when depth >= 'evaluate'."
+            },
+            "info_puzzle": {
+              "type": "object",
+              "properties": {
+                "completeness": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "InfoPuzzle completeness ratio (0-1)."
+                },
+                "gaps": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Missing key puzzle pieces."
+                },
+                "assembled_at": {
+                  "type": "number",
+                  "description": "Assembly timestamp (ms since epoch)."
+                }
+              },
+              "required": [
+                "completeness",
+                "gaps",
+                "assembled_at"
+              ],
+              "additionalProperties": false,
+              "description": "InfoPuzzle summary — present only when depth >= 'evaluate'."
+            }
+          },
+          "required": [
+            "service_id",
+            "service_name",
+            "service_basics",
+            "trust_score",
+            "order_amount",
+            "depth"
+          ],
+          "additionalProperties": false,
+          "description": "Trust score result. Contains: trust_score (ServiceTrustScore), risk_score (RiskScore, when depth >= evaluate), info_puzzle summary, and service_basics snapshot."
+        }
+      },
+      "required": [
+        "result"
+      ],
+      "additionalProperties": false
+    }
+  }
+}

package/dist/schemas/trust_score.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/trust_score.json",
+  "title": "Trust Score - Service Risk & Trust Assessment",
+  "description": "Proactively query the trust score (0-100, 5 dimensions) and risk assessment (4 dimensions, 100-point) of a Service object. Parameters: service (required), order_amount (optional), depth (optional: browse/evaluate/preorder).",
+  "$ref": "#/definitions/trust_score",
+  "definitions": {
+    "trust_score": {
+      "type": "object",
+      "properties": {
+        "service": {
+          "type": "string",
+          "description": "Service object ID or local_mark name to evaluate. Must reference an existing Service object on-chain."
+        },
+        "order_amount": {
+          "type": [
+            "string",
+            "number"
+          ],
+          "description": "Optional order amount (in smallest token unit, e.g. 2000000000 for 2 WOW). Used for fund-safety dimension risk assessment. If omitted, the first active sale price of the service is used."
+        },
+        "depth": {
+          "type": "string",
+          "enum": [
+            "browse",
+            "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)."
+        },
+        "network": {
+          "type": "string",
+          "description": "Network override (e.g. 'mainnet', 'testnet'). If omitted, uses default."
+        },
+        "no_cache": {
+          "type": "boolean",
+          "description": "Skip object cache and force a fresh on-chain query."
+        }
+      },
+      "required": [
+        "service"
+      ],
+      "additionalProperties": false
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wowok/agent-mcp",
-  "version": "2.3.14",
+  "version": "2.3.18",
   "description": "Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -36,7 +36,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@wowok/wowok": "2.3.14",
+    "@wowok/wowok": "2.3.18",
     "lodash": "^4.18.1",
     "zod": "^3.25.76"
   },