@wowok/agent-mcp 2.6.9 → 2.7.1

package/dist/schemas/evaluation_operation.output.json

@@ -0,0 +1,677 @@
+{
+  "$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": {
+      "type": "object",
+      "properties": {
+        "result": {
+          "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": [
+                    "disputant",
+                    "arbitrator",
+                    "voter",
+                    "both"
+                  ]
+                },
+                "actions": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "action": {
+                        "type": "string",
+                        "description": "Recommended move (e.g. 'confirm', 'vote', 'objection', 'arb_withdraw')."
+                      },
+                      "favorability": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "maximum": 100,
+                        "description": "Favorability 0-100 for the perspective."
+                      },
+                      "is_optimal": {
+                        "type": "boolean",
+                        "description": "True when this is the top recommended move."
+                      },
+                      "payoff_note": {
+                        "type": "string",
+                        "description": "What the move achieves."
+                      },
+                      "risk": {
+                        "type": "string",
+                        "enum": [
+                          "low",
+                          "medium",
+                          "high"
+                        ],
+                        "description": "Risk of the move."
+                      }
+                    },
+                    "required": [
+                      "action",
+                      "favorability",
+                      "is_optimal",
+                      "payoff_note",
+                      "risk"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "summary": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "action",
+                "status",
+                "perspective",
+                "actions",
+                "summary"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "node_game"
+                },
+                "current_node": {
+                  "type": "string"
+                },
+                "perspective": {
+                  "type": "string",
+                  "enum": [
+                    "customer",
+                    "operator",
+                    "observer"
+                  ]
+                },
+                "actions": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "forward": {
+                        "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."
+                      },
+                      "favorability": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "maximum": 100,
+                        "description": "Favorability 0-100 for the perspective."
+                      },
+                      "is_optimal": {
+                        "type": "boolean",
+                        "description": "True when this is the top recommended move."
+                      },
+                      "payoff_note": {
+                        "type": "string",
+                        "description": "What the move achieves."
+                      },
+                      "risk": {
+                        "type": "string",
+                        "enum": [
+                          "low",
+                          "medium",
+                          "high"
+                        ],
+                        "description": "Risk of the move."
+                      }
+                    },
+                    "required": [
+                      "forward",
+                      "to_node",
+                      "execution_path",
+                      "favorability",
+                      "is_optimal",
+                      "payoff_note",
+                      "risk"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "summary": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "action",
+                "current_node",
+                "perspective",
+                "actions",
+                "summary"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "capability_gap"
+                },
+                "report": {
+                  "type": "object",
+                  "properties": {
+                    "entity_id": {
+                      "type": "string"
+                    },
+                    "satisfied": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "dimension": {
+                            "type": "string",
+                            "description": "Capability dimension (has_arbitration / region / price / ...)."
+                          },
+                          "requirement": {
+                            "type": "string",
+                            "description": "What the demand requires."
+                          },
+                          "provided": {
+                            "type": "string",
+                            "description": "What the service provides."
+                          },
+                          "status": {
+                            "type": "string",
+                            "enum": [
+                              "satisfied",
+                              "partial",
+                              "missing"
+                            ]
+                          },
+                          "impact": {
+                            "type": "string",
+                            "enum": [
+                              "critical",
+                              "major",
+                              "minor"
+                            ]
+                          },
+                          "suggestion": {
+                            "type": "string",
+                            "description": "Actionable suggestion."
+                          }
+                        },
+                        "required": [
+                          "dimension",
+                          "requirement",
+                          "provided",
+                          "status",
+                          "impact",
+                          "suggestion"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "missing": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/definitions/evaluation_operation/properties/result/anyOf/2/properties/report/properties/satisfied/items"
+                      }
+                    },
+                    "coverage_score": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 100
+                    },
+                    "summary": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "entity_id",
+                    "satisfied",
+                    "missing",
+                    "coverage_score",
+                    "summary"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "action",
+                "report"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "compose_service"
+                },
+                "plan": {
+                  "type": "object",
+                  "properties": {
+                    "demand": {
+                      "type": "string"
+                    },
+                    "services": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string"
+                          },
+                          "covered": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "covered"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "coverage_score": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 100
+                    },
+                    "remaining_missing": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "feasibility": {
+                      "type": "string",
+                      "enum": [
+                        "ready",
+                        "needs_supply_chain",
+                        "infeasible"
+                      ]
+                    },
+                    "summary": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "demand",
+                    "services",
+                    "coverage_score",
+                    "remaining_missing",
+                    "feasibility",
+                    "summary"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "action",
+                "plan"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "demand_match"
+                },
+                "matches": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "service": {
+                        "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
+                      },
+                      "result": {
+                        "type": "object",
+                        "properties": {
+                          "evaluation_id": {
+                            "type": "string"
+                          },
+                          "total": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 100
+                          },
+                          "level": {
+                            "type": "string",
+                            "enum": [
+                              "low",
+                              "medium_low",
+                              "medium_high",
+                              "high"
+                            ]
+                          },
+                          "breakdown": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "rule_id": {
+                                  "type": "string"
+                                },
+                                "dimension": {
+                                  "type": "string"
+                                },
+                                "score": {
+                                  "type": "number"
+                                },
+                                "weight": {
+                                  "type": "number"
+                                },
+                                "reason": {
+                                  "type": "string"
+                                },
+                                "matched": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string"
+                                  }
+                                },
+                                "mismatched": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string"
+                                  }
+                                },
+                                "red_flag": {
+                                  "type": "boolean"
+                                }
+                              },
+                              "required": [
+                                "rule_id",
+                                "dimension",
+                                "score",
+                                "weight"
+                              ],
+                              "additionalProperties": false
+                            }
+                          },
+                          "red_flags": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "blocked": {
+                            "type": "boolean"
+                          },
+                          "trace": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "kind": {
+                                  "type": "string",
+                                  "enum": [
+                                    "data_source",
+                                    "rule",
+                                    "override"
+                                  ]
+                                },
+                                "id": {
+                                  "type": "string"
+                                },
+                                "detail": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "kind",
+                                "id",
+                                "detail"
+                              ],
+                              "additionalProperties": false
+                            }
+                          },
+                          "summary": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "evaluation_id",
+                          "total",
+                          "level",
+                          "breakdown",
+                          "red_flags",
+                          "blocked",
+                          "trace",
+                          "summary"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "required": [
+                      "service",
+                      "result"
+                    ],
+                    "additionalProperties": false
+                  }
+                }
+              },
+              "required": [
+                "action",
+                "matches"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "service_match"
+                },
+                "matches": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "demand": {
+                        "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
+                      },
+                      "result": {
+                        "$ref": "#/definitions/evaluation_operation/properties/result/anyOf/4/properties/matches/items/properties/result"
+                      }
+                    },
+                    "required": [
+                      "demand",
+                      "result"
+                    ],
+                    "additionalProperties": false
+                  }
+                }
+              },
+              "required": [
+                "action",
+                "matches"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "service_risk"
+                },
+                "result": {
+                  "$ref": "#/definitions/evaluation_operation/properties/result/anyOf/4/properties/matches/items/properties/result"
+                }
+              },
+              "required": [
+                "action",
+                "result"
+              ],
+              "additionalProperties": false
+            }
+          ],
+          "description": "Evaluation result — shape depends on action"
+        }
+      },
+      "required": [
+        "result"
+      ],
+      "additionalProperties": false
+    }
+  }
+}