Ghost X402 Market Intel Vet Schema

{
  "type": "object",
  "$defs": {
    "ProviderCandidateModel": {
      "type": "object",
      "title": "ProviderCandidateModel",
      "required": [
        "provider"
      ],
      "properties": {
        "payee": {
          "type": "string",
          "title": "Payee",
          "default": "",
          "maxLength": 64
        },
        "network": {
          "type": "string",
          "title": "Network",
          "default": "",
          "maxLength": 64,
          "description": "CAIP-2, e.g. eip155:8453"
        },
        "provider": {
          "type": "string",
          "title": "Provider",
          "maxLength": 2048,
          "description": "Resource URL or payee address of the candidate"
        },
        "quoted_cost": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 1000000,
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "title": "Quoted Cost",
          "default": null,
          "description": "What this provider quoted for this call, in `currency`. Prefer the LIVE 402 amount over an advertised price — the two disagreeing is itself a recheck trigger."
        }
      },
      "description": "One provider the task could pay, as the caller's own payment path sees it.",
      "additionalProperties": false
    }
  },
  "title": "GateDecideRequest",
  "required": [
    "task_id",
    "task_type",
    "success_definition",
    "provider_candidates"
  ],
  "properties": {
    "task_id": {
      "type": "string",
      "title": "Task Id",
      "maxLength": 200
    },
    "currency": {
      "type": "string",
      "title": "Currency",
      "default": "USD",
      "maxLength": 16
    },
    "task_type": {
      "type": "string",
      "title": "Task Type",
      "maxLength": 120,
      "description": "What kind of job this is. Success history is pooled under it, so it must be stable."
    },
    "max_budget": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 100000000,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Budget",
      "default": null
    },
    "failure_cost": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 100000000,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Failure Cost",
      "default": null
    },
    "revenue_models": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "title": "Revenue Models",
      "maxItems": 6,
      "description": "Optional. Say what the task is worth in the terms you actually measure, and Ghost derives value_of_success / customer_revenue / max_budget from it — never overriding a value you stated yourself. Each entry needs a `type`: SALES_ROI (spend, qualified_leads?, meetings?, closed_deals?, realized_revenue?), AFFILIATE_ROI (commission_rate?, order_value?, conversion_probability?, tool_cost?, inference_cost?, transaction_cost?), PROCUREMENT_SAVINGS (current_total_cost?, alternative_total_cost?, switching_cost?, migration_cost?), RETURN_ROI (expected_return, data_cost?, model_cost?, execution_cost?, expected_risk_loss?; expected_return is YOURS to state and is never estimated by Ghost), CREDIT_AFFORDABILITY (available_credit, planned_spend?). Ratios are derived only where the denominator exists; conversion rates are never invented."
    },
    "switching_cost": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 100000000,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Switching Cost",
      "default": null
    },
    "required_margin": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 1,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Required Margin",
      "default": null
    },
    "customer_revenue": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 100000000,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Customer Revenue",
      "default": null
    },
    "value_of_success": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 100000000,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Value Of Success",
      "default": null
    },
    "payment_signature": {
      "type": "string",
      "description": "x402 PAYMENT-SIGNATURE header value. Omit it to receive the payment terms; call again with it to run the tool."
    },
    "success_definition": {
      "type": "string",
      "title": "Success Definition",
      "maxLength": 1000,
      "description": "What counts as success, written down BEFORE paying. verified_success is later judged against this."
    },
    "fallback_authorized": {
      "type": "boolean",
      "title": "Fallback Authorized",
      "default": false,
      "description": "May Ghost route to a different candidate than the first? Off by default: an unrequested reroute is a payment the operator did not choose."
    },
    "provider_candidates": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/ProviderCandidateModel"
      },
      "title": "Provider Candidates",
      "maxItems": 20,
      "minItems": 1
    }
  },
  "description": "The inline pre-spend gate's input: one task, its economics, its candidates.\n\nEvery optional economic field is genuinely optional and stays UNKNOWN. Ghost will not\nsubstitute a default revenue or an assumed margin — a gate that invents the numbers\nit gates on is not a control.",
  "additionalProperties": false
}