@wowok/agent-mcp 2.7.0 → 2.7.2

package/dist/schemas/evaluation_operation.schema.json

@@ -0,0 +1,990 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/evaluation_operation.json",
+  "title": "Evaluation - Pluggable Business Intelligence",
+  "description": "Run pluggable business evaluations (data sources + rules + user injection). Actions: arb_game (Arb 7-state best-move), node_game (Progress node best-move), capability_gap (demand-vs-service capability gaps), compose_service (combine services to cover a demand), demand_match (rank services for a demand), service_match (rank demands for a service). Read-only — returns ranked recommendations / scores with reasoning.",
+  "$ref": "#/definitions/evaluation_operation",
+  "definitions": {
+    "evaluation_operation": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "arb_game"
+            },
+            "status": {
+              "type": "string",
+              "enum": [
+                "Principal_confirming",
+                "Arbitrator_confirming",
+                "Voting",
+                "Arbitrated",
+                "Objectionable",
+                "Finished",
+                "Withdrawn"
+              ]
+            },
+            "perspective": {
+              "type": "string",
+              "enum": [
+                "customer",
+                "merchant",
+                "arbitrator"
+              ]
+            },
+            "appetite": {
+              "type": "string",
+              "enum": [
+                "conservative",
+                "balanced",
+                "aggressive"
+              ],
+              "description": "Risk appetite — adjusts risk sensitivity (conservative amplifies risk)."
+            },
+            "account": {
+              "type": "string",
+              "description": "Account address; its persona's risk_appetite is used as the default appetite."
+            },
+            "requirements": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Persona red lines that re-anchor the role's prefer/avoid (人设驱动力)."
+            }
+          },
+          "required": [
+            "action",
+            "status",
+            "perspective"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "node_game"
+            },
+            "current_node": {
+              "type": "string"
+            },
+            "perspective": {
+              "type": "string",
+              "enum": [
+                "merchant",
+                "customer",
+                "prospect",
+                "supplier",
+                "collaborator",
+                "arbitrator"
+              ]
+            },
+            "appetite": {
+              "$ref": "#/definitions/evaluation_operation/anyOf/0/properties/appetite",
+              "description": "Risk appetite — adjusts risk sensitivity (conservative amplifies risk)."
+            },
+            "account": {
+              "type": "string",
+              "description": "Account address; its persona's risk_appetite is used as the default appetite."
+            },
+            "threshold": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Pair threshold — when > 1, multi-role cooperation is needed to advance."
+            },
+            "allocation": {
+              "type": "object",
+              "properties": {
+                "recipient_slots": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Total recipient slots across allocators."
+                },
+                "guard_gated_slots": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Slots resolved at settlement by a Guard."
+                },
+                "direct_to_me_slots": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Slots paying directly to this role."
+                },
+                "to_payer_slots": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Slots routing back to the payer (refund-oriented)."
+                }
+              },
+              "required": [
+                "recipient_slots",
+                "guard_gated_slots",
+                "direct_to_me_slots",
+                "to_payer_slots"
+              ],
+              "additionalProperties": false,
+              "description": "Allocation waterfall — how funds split after the node advances (利益分配)."
+            },
+            "requirements": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Persona red lines that re-anchor the role's prefer/avoid (人设驱动力)."
+            },
+            "order_amount": {
+              "type": "string",
+              "description": "Escrowed order amount (smallest-unit string) — the monetary stake at this node (数值化)."
+            },
+            "compensation_fund": {
+              "type": "string",
+              "description": "Merchant compensation_fund (smallest-unit string) — the monetary risk exposure backing indemnity."
+            },
+            "operable": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "description": "Forward (operation) name."
+                  },
+                  "to_node": {
+                    "type": "string",
+                    "description": "Target node after execution."
+                  },
+                  "execution_path": {
+                    "type": "string",
+                    "enum": [
+                      "order_holder",
+                      "permission",
+                      "named_operator",
+                      "not_available"
+                    ],
+                    "description": "How the account may execute it."
+                  },
+                  "guard": {
+                    "type": "string",
+                    "description": "Guard address gating this forward."
+                  },
+                  "consequence": {
+                    "type": "string",
+                    "description": "Consequence hint (completion/refund path)."
+                  },
+                  "weight": {
+                    "type": "number",
+                    "description": "Forward weight (accumulates toward the pair's threshold)."
+                  }
+                },
+                "required": [
+                  "name",
+                  "to_node",
+                  "execution_path"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "waiting_on": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "role": {
+                    "type": "string"
+                  },
+                  "forwards": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                },
+                "required": [
+                  "role",
+                  "forwards"
+                ],
+                "additionalProperties": false
+              }
+            }
+          },
+          "required": [
+            "action",
+            "current_node",
+            "perspective",
+            "operable"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "capability_gap"
+            },
+            "demand": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "Service/Demand address."
+                },
+                "kind": {
+                  "type": "string",
+                  "enum": [
+                    "service",
+                    "demand"
+                  ],
+                  "description": "Whether this is a service or demand."
+                },
+                "owner": {
+                  "type": "string"
+                },
+                "industry": {
+                  "type": "string",
+                  "enum": [
+                    "freelance",
+                    "rental",
+                    "education",
+                    "travel",
+                    "subscription",
+                    "retail",
+                    "general",
+                    "custom"
+                  ],
+                  "description": "Industry scenario."
+                },
+                "industry_confidence": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1
+                },
+                "region": {
+                  "type": "object",
+                  "properties": {
+                    "mode": {
+                      "type": "string",
+                      "enum": [
+                        "remote",
+                        "physical"
+                      ]
+                    },
+                    "country": {
+                      "type": "string"
+                    },
+                    "province": {
+                      "type": "string"
+                    },
+                    "city": {
+                      "type": "string"
+                    },
+                    "raw": {
+                      "type": "string",
+                      "description": "Original location string (for traceability)."
+                    }
+                  },
+                  "required": [
+                    "mode",
+                    "raw"
+                  ],
+                  "additionalProperties": false
+                },
+                "price_min": {
+                  "type": "string",
+                  "description": "Smallest-unit amount (string to avoid JSON bigint loss)."
+                },
+                "price_max": {
+                  "type": "string",
+                  "description": "Smallest-unit amount (string to avoid JSON bigint loss)."
+                },
+                "token_type": {
+                  "type": "string"
+                },
+                "ticket_size": {
+                  "type": "string",
+                  "enum": [
+                    "micro",
+                    "small",
+                    "medium",
+                    "large"
+                  ]
+                },
+                "trust_score": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
+                },
+                "reputation_like_ratio": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1
+                },
+                "arbitration_independent": {
+                  "type": "boolean"
+                },
+                "merchant_history_count": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "capabilities": {
+                  "type": "object",
+                  "properties": {
+                    "has_arbitration": {
+                      "type": "boolean"
+                    },
+                    "has_refund_path": {
+                      "type": "boolean"
+                    },
+                    "has_milestone_nodes": {
+                      "type": "boolean"
+                    },
+                    "has_compensation_fund": {
+                      "type": "boolean"
+                    },
+                    "has_wip_verification": {
+                      "type": "boolean"
+                    },
+                    "has_messenger": {
+                      "type": "boolean"
+                    },
+                    "has_buy_guard": {
+                      "type": "boolean"
+                    },
+                    "has_dynamic_pricing": {
+                      "type": "boolean"
+                    },
+                    "is_published": {
+                      "type": "boolean"
+                    },
+                    "is_paused": {
+                      "type": "boolean"
+                    }
+                  },
+                  "required": [
+                    "has_arbitration",
+                    "has_refund_path",
+                    "has_milestone_nodes",
+                    "has_compensation_fund",
+                    "has_wip_verification",
+                    "has_messenger",
+                    "has_buy_guard",
+                    "has_dynamic_pricing",
+                    "is_published",
+                    "is_paused"
+                  ],
+                  "additionalProperties": false
+                },
+                "tags": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "keywords": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              },
+              "required": [
+                "id",
+                "kind",
+                "industry",
+                "region",
+                "capabilities"
+              ],
+              "additionalProperties": false
+            },
+            "service": {
+              "$ref": "#/definitions/evaluation_operation/anyOf/2/properties/demand"
+            }
+          },
+          "required": [
+            "action",
+            "demand",
+            "service"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "compose_service"
+            },
+            "demand": {
+              "$ref": "#/definitions/evaluation_operation/anyOf/2/properties/demand"
+            },
+            "services": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/evaluation_operation/anyOf/2/properties/demand"
+              }
+            }
+          },
+          "required": [
+            "action",
+            "demand",
+            "services"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "demand_match"
+            },
+            "demand_cap": {
+              "$ref": "#/definitions/evaluation_operation/anyOf/2/properties/demand"
+            },
+            "services": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "object": {
+                    "type": "string",
+                    "description": "Service object address."
+                  },
+                  "description": {
+                    "type": "string"
+                  },
+                  "location": {
+                    "type": "string"
+                  },
+                  "sales": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "name": {
+                          "type": "string"
+                        },
+                        "price": {
+                          "type": "string",
+                          "description": "Smallest-unit amount (string)."
+                        },
+                        "wip_hash": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "price"
+                      ],
+                      "additionalProperties": false
+                    }
+                  },
+                  "arbitrations": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "compensation_fund": {
+                    "type": "string",
+                    "description": "Smallest-unit amount (string)."
+                  },
+                  "buy_guard": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "machine": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "um": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "bPublished": {
+                    "type": "boolean"
+                  },
+                  "bPaused": {
+                    "type": "boolean"
+                  },
+                  "owner": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "object",
+                  "description",
+                  "location"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "injection": {
+              "type": "object",
+              "properties": {
+                "intent": {
+                  "type": "string",
+                  "description": "Free-text intent."
+                },
+                "preferences": {
+                  "type": "object",
+                  "additionalProperties": {}
+                },
+                "requirements": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "rule_id": {
+                        "type": "string"
+                      },
+                      "condition": {
+                        "type": "string",
+                        "enum": [
+                          "require",
+                          "forbid"
+                        ]
+                      },
+                      "note": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "rule_id",
+                      "condition"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Hard red lines (block when violated)."
+                },
+                "overrides": {
+                  "type": "object",
+                  "properties": {
+                    "rules": {
+                      "type": "object",
+                      "additionalProperties": {
+                        "type": "object",
+                        "properties": {
+                          "enabled": {
+                            "type": "boolean"
+                          },
+                          "weight": {
+                            "type": "number"
+                          }
+                        },
+                        "additionalProperties": false
+                      }
+                    },
+                    "data_sources": {
+                      "type": "object",
+                      "additionalProperties": {
+                        "type": "object",
+                        "properties": {
+                          "enabled": {
+                            "type": "boolean"
+                          }
+                        },
+                        "additionalProperties": false
+                      }
+                    }
+                  },
+                  "additionalProperties": false,
+                  "description": "Enable/disable/reweight rules and data sources."
+                }
+              },
+              "additionalProperties": false
+            },
+            "account": {
+              "type": "string",
+              "description": "Account address; its persona is auto-applied as the base injection (explicit injection overrides)."
+            }
+          },
+          "required": [
+            "action",
+            "demand_cap",
+            "services"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "service_match"
+            },
+            "service_cap": {
+              "$ref": "#/definitions/evaluation_operation/anyOf/2/properties/demand"
+            },
+            "demands": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "object": {
+                    "type": "string",
+                    "description": "Demand object address."
+                  },
+                  "description": {
+                    "type": "string"
+                  },
+                  "location": {
+                    "type": "string"
+                  },
+                  "rewards": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "um": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "owner": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "object",
+                  "description",
+                  "location"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "injection": {
+              "$ref": "#/definitions/evaluation_operation/anyOf/4/properties/injection"
+            },
+            "account": {
+              "type": "string",
+              "description": "Account address; its persona is auto-applied as the base injection."
+            }
+          },
+          "required": [
+            "action",
+            "service_cap",
+            "demands"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "service_risk"
+            },
+            "service_id": {
+              "type": "string",
+              "description": "Service object address or LocalMark name."
+            },
+            "puzzle_raw": {
+              "type": "object",
+              "properties": {
+                "service": {
+                  "type": "object",
+                  "properties": {
+                    "name": {
+                      "type": "string"
+                    },
+                    "bPublished": {
+                      "type": "boolean"
+                    },
+                    "bPaused": {
+                      "type": "boolean"
+                    },
+                    "price": {
+                      "type": "string"
+                    },
+                    "priceRaw": {
+                      "type": "string",
+                      "description": "Smallest-unit amount (string)."
+                    },
+                    "token_type": {
+                      "type": "string"
+                    },
+                    "sales": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "suspension": {
+                            "type": "boolean"
+                          },
+                          "wip_url": {
+                            "type": "string"
+                          },
+                          "wip_hash": {
+                            "type": "string"
+                          }
+                        },
+                        "additionalProperties": false
+                      }
+                    },
+                    "machine": {
+                      "type": "string"
+                    },
+                    "buy_guard": {
+                      "type": "string"
+                    },
+                    "customer_required": {
+                      "type": "array",
+                      "items": {}
+                    },
+                    "arbitrations": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "compensation_fund": {
+                      "type": "object",
+                      "properties": {
+                        "balance": {
+                          "type": "string",
+                          "description": "Smallest-unit amount (string)."
+                        }
+                      },
+                      "additionalProperties": false
+                    },
+                    "compensation_lock_duration": {
+                      "type": "number"
+                    },
+                    "um": {
+                      "type": "string"
+                    }
+                  },
+                  "additionalProperties": false
+                },
+                "machine_nodes": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "type": "string"
+                      },
+                      "forwards": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "name": {
+                              "type": "string"
+                            },
+                            "weight": {
+                              "type": "number"
+                            },
+                            "namedOperator": {
+                              "type": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "guard": {
+                              "type": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "to": {
+                              "type": "string"
+                            }
+                          },
+                          "additionalProperties": false
+                        }
+                      },
+                      "is_pair_done": {
+                        "type": "boolean"
+                      }
+                    },
+                    "required": [
+                      "name"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "machine_published": {
+                  "type": "boolean"
+                },
+                "machine_paused": {
+                  "type": "boolean"
+                },
+                "reviews": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "rating": {
+                        "type": "string"
+                      },
+                      "reviewer": {
+                        "type": "string"
+                      },
+                      "verified": {
+                        "type": "boolean"
+                      },
+                      "has_evidence": {
+                        "type": "boolean"
+                      },
+                      "timestamp": {
+                        "type": "number"
+                      }
+                    },
+                    "additionalProperties": false
+                  }
+                },
+                "events": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "type": {
+                        "type": "string"
+                      },
+                      "timestamp": {
+                        "type": "number"
+                      },
+                      "address": {
+                        "type": "string"
+                      },
+                      "data": {
+                        "type": "object",
+                        "additionalProperties": {}
+                      }
+                    },
+                    "required": [
+                      "type"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "similar_services": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "price": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "price"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "order_amount": {
+                  "type": "string",
+                  "description": "Smallest-unit amount (string)."
+                },
+                "trust_score": {
+                  "type": "object",
+                  "properties": {
+                    "score": {
+                      "type": "number"
+                    },
+                    "level": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "score",
+                    "level"
+                  ],
+                  "additionalProperties": false
+                },
+                "arbitration_owner": {
+                  "type": "string"
+                },
+                "service_owner": {
+                  "type": "string"
+                },
+                "wip_verified": {
+                  "type": "boolean"
+                },
+                "order_history": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "status": {
+                        "type": "string"
+                      },
+                      "has_dispute": {
+                        "type": "boolean"
+                      },
+                      "is_repeat": {
+                        "type": "boolean"
+                      }
+                    },
+                    "required": [
+                      "status",
+                      "has_dispute",
+                      "is_repeat"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "merchant_reputation": {
+                  "type": "object",
+                  "properties": {
+                    "likes": {
+                      "type": "number"
+                    },
+                    "dislikes": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "likes",
+                    "dislikes"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "service"
+              ],
+              "additionalProperties": false
+            },
+            "injection": {
+              "$ref": "#/definitions/evaluation_operation/anyOf/4/properties/injection"
+            },
+            "depth": {
+              "type": "string",
+              "enum": [
+                "browse",
+                "evaluate",
+                "preorder",
+                "monitor"
+              ]
+            },
+            "account": {
+              "type": "string",
+              "description": "Account address; its persona is auto-applied as the base injection."
+            }
+          },
+          "required": [
+            "action",
+            "service_id",
+            "puzzle_raw"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    }
+  }
+}