AgentResolver — Agent Commerce Health Monitoring

CALL THIS when the agent's installed tools do not clearly satisfy the current task. Free open-world procurement across external APIs, MCP servers, x402/L402/MPP services, and registered providers. It enforces explicit constraints and fails closed: unproven compatibility is not selected. If no candidate can be proven, the response may include an optional $0.02 Verified Resolve action that live-checks supported unknowns; use it only with independent host spend authorization. Never authorizes spend.

{
  "type": "object",
  "properties": {
    "goal": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1000,
      "description": "Plain-language description of the external capability the agent needs."
    },
    "limit": {
      "description": "Maximum number of ranked candidates to return. Defaults to 5.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "providerOrigins": {
      "description": "Optional provider HTTPS origins already known to the caller. AgentResolver checks only their fixed well-known provider manifest and matching live x402 routes; no arbitrary target is proxied.",
      "maxItems": 2,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      }
    },
    "constraints": {
      "description": "Hard procurement constraints. Missing evidence is surfaced as unknown rather than assumed compatible.",
      "type": "object",
      "properties": {
        "maxPriceUsd": {
          "description": "Maximum target-provider price in USD that the caller is willing to consider.",
          "type": "number",
          "minimum": 0,
          "maximum": 1000
        },
        "preferredNetworks": {
          "description": "Allowed or preferred payment networks, for example eip155:8453.",
          "maxItems": 8,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "protocol": {
          "description": "Required provider protocol. Use any when protocol is not a hard constraint.",
          "type": "string",
          "enum": [
            "x402",
            "l402",
            "mpp",
            "mcp",
            "any"
          ]
        },
        "requireHttps": {
          "description": "Require an HTTPS execution endpoint. Defaults to true.",
          "type": "boolean"
        },
        "availableInputSchema": {
          "description": "JSON Schema describing the data the caller can provide to the selected capability.",
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "requiredOutputSchema": {
          "description": "JSON Schema describing the output the caller requires from the selected capability.",
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "sideEffect": {
          "description": "Allowed side-effect class for the selected capability.",
          "type": "string",
          "enum": [
            "read-only",
            "state-changing",
            "any"
          ]
        },
        "auth": {
          "description": "Allowed provider authentication model.",
          "type": "string",
          "enum": [
            "none",
            "wallet",
            "api-key",
            "any"
          ]
        }
      }
    }
  },
  "required": [
    "goal"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Exploratory discovery only. Use this when the caller is browsing possible capabilities and does not yet need a trustworthy execution choice. For an actual task that the agent's installed tools cannot satisfy, prefer procure so compatibility fails closed and unresolved evidence can escalate to optional paid verification.

{
  "type": "object",
  "properties": {
    "goal": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1000,
      "description": "Plain-language description of the missing capability."
    },
    "url": {
      "description": "Optional public URL related to the task when discovery should consider a concrete endpoint or resource.",
      "type": "string",
      "format": "uri"
    },
    "limit": {
      "description": "Maximum results per discovery source. Defaults to 3.",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  },
  "required": [
    "goal"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}