overlay: 1.0.0
info:
  title: API Evangelist overlay for the MUJ428 Trust Layer API
  version: 1.0.0
  x-generated: '2026-09-19'
  x-method: generated
  x-source: >-
    Generated by API Evangelist against openapi/muj428-com-trust-layer-openapi.json (the provider's own
    OpenAPI 3.1.0 mirror, v1.8.2, fetched 2026-09-19 from https://agents.muj428.com/openapi.json). The
    original is never mutated; this overlay adds tags, contact/terms discovery, x402 payment semantics the
    spec states only in prose, and pointers to the sibling artifacts. Every value below is taken from a
    document the provider serves (developer.json, AGENTS.md, pricing.json, the x402 manifest, live headers).
extends: ../openapi/muj428-com-trust-layer-openapi.json
actions:
- target: $.info
  update:
    contact:
      name: MUJ428 LLC
      url: https://agents.muj428.com/
      email: sales@muj428.com
    x-api-evangelist:
      provider: muj428-com
      conventions: ../conventions/muj428-com-conventions.yml
      errors: ../errors/muj428-com-problem-types.yml
      authentication: ../authentication/muj428-com-authentication.yml
      plans: ../plans/muj428-com-plans-pricing.yml
      crosswalk: ../mcp/muj428-com-tool-crosswalk.yml
      agents_json: https://agents.muj428.com/agents.json
- target: $.servers[0]
  update:
    description: Canonical production facade (Supabase edge function) — named canonical by the provider's api-catalog, agent card, mcp.json and AGENTS.md on agents.muj428.com.
- target: $
  update:
    tags:
    - name: Trust Reflex
      description: Free preflight of a consequential action; first 1,000 qualifying decisions per caller_ref, then 0.01 USDC via x402.
    - name: Paid Services
      description: x402-paid evidence, reputation, milestone, report and transaction-assurance services (HTTP 402 with PAYMENT-REQUIRED; retry with PAYMENT-SIGNATURE).
    - name: Discovery
      description: Anonymous machine discovery — services, pricing, discover, health, capabilities.
    - name: Trust Gravity
      description: Agent Router, Trust DNS, heartbeat, compatibility directory, trust requests and loop status.
    - name: Payments Discovery
      description: Read-only payment-rail capabilities, proof and planning-only rail selection; never moves funds.
    - name: Monitoring
      description: Continuous Trust Monitoring created from a prior Trust Receipt (expansion beta, no charge).
- target: $.paths['/v1/trust'].post
  update:
    tags: [Trust Reflex]
    x-payment:
      protocol: x402 v2
      asset: USDC
      network: eip155:8453
      free_quota: 1000 qualifying decisions per caller_ref
      price_after_quota_usdc: 0.01
      challenge_status: 402
      challenge_header: PAYMENT-REQUIRED
      retry_header: PAYMENT-SIGNATURE
      response_header: PAYMENT-RESPONSE
    x-idempotency: Replaying the same caller_ref/action_ref does not consume another free decision (schema description; developer.json replay_same_caller_action_consumes_quota=false).
- target: $.paths['/v1/rescue'].post
  update:
    tags: [Trust Reflex]
- target: $.paths['/v1/evidence-signal'].post
  update:
    tags: [Paid Services]
    x-payment: {protocol: x402 v2, asset: USDC, network: eip155:8453, price_usdc: 0.25, challenge_status: 402, challenge_header: PAYMENT-REQUIRED, retry_header: PAYMENT-SIGNATURE, response_header: PAYMENT-RESPONSE, paid_endpoint: https://wepmhfjzckclvywolrek.supabase.co/functions/v1/trust-layer-x402/v1/evidence-signal}
- target: $.paths['/v1/reputation-check'].post
  update:
    tags: [Paid Services]
    x-payment: {protocol: x402 v2, asset: USDC, network: eip155:8453, price_usdc: 0.10, challenge_status: 402, paid_endpoint: https://wepmhfjzckclvywolrek.supabase.co/functions/v1/trust-layer-x402/v1/reputation-check}
- target: $.paths['/v1/milestone-attestation'].post
  update:
    tags: [Paid Services]
    x-payment: {protocol: x402 v2, asset: USDC, network: eip155:8453, price_usdc: 0.25, challenge_status: 402, paid_endpoint: https://wepmhfjzckclvywolrek.supabase.co/functions/v1/trust-layer-x402/v1/milestone-attestation}
- target: $.paths['/v1/trust-layer-report'].post
  update:
    tags: [Paid Services]
    x-payment: {protocol: x402 v2, asset: USDC, network: eip155:8453, price_usdc: 0.50, challenge_status: 402, paid_endpoint: https://wepmhfjzckclvywolrek.supabase.co/functions/v1/trust-layer-x402/v1/trust-layer-report}
- target: $.paths['/v1/transaction-assurance'].post
  update:
    tags: [Paid Services]
    x-payment: {protocol: x402 v2, asset: USDC, network: eip155:8453, fee: '2% ($9 minimum) under $50,000; 1% ($25 minimum) at or above $50,000', challenge_status: 402, paid_endpoint: https://wepmhfjzckclvywolrek.supabase.co/functions/v1/trust-layer-x402/v1/transaction-assurance}
- target: $.paths['/services'].get
  update: {tags: [Discovery]}
- target: $.paths['/pricing.json'].get
  update: {tags: [Discovery]}
- target: $.paths['/discover'].get
  update: {tags: [Discovery]}
- target: $.paths['/health'].get
  update: {tags: [Discovery]}
- target: $.paths['/v1/route'].post
  update: {tags: [Trust Gravity]}
- target: $.paths['/v1/trust-dns/resolve'].post
  update: {tags: [Trust Gravity]}
- target: $.paths['/v1/heartbeat'].get
  update: {tags: [Trust Gravity]}
- target: $.paths['/v1/compatibility'].get
  update: {tags: [Trust Gravity]}
- target: $.paths['/v1/compatibility'].post
  update: {tags: [Trust Gravity]}
- target: $.paths['/v1/compatibility/observe'].post
  update: {tags: [Trust Gravity]}
- target: $.paths['/v1/trust-requests'].get
  update: {tags: [Trust Gravity]}
- target: $.paths['/v1/trust-requests'].post
  update: {tags: [Trust Gravity]}
- target: $.paths['/v1/loop/status'].get
  update: {tags: [Trust Gravity]}
- target: $.paths['/.well-known/payment-rails.json'].get
  update: {tags: [Payments Discovery]}
- target: $.paths['/.well-known/payment-proof.json'].get
  update: {tags: [Payments Discovery]}
- target: $.paths['/v1/payments/select'].post
  update: {tags: [Payments Discovery]}
- target: $.paths['/v1/monitor'].post
  update: {tags: [Monitoring]}