{
  "openapi": "3.1.0",
  "info": {
    "title": "Agent-Mediate API",
    "version": "0.1.0",
    "description": "Dispute resolution for autonomous agents (rulesVersion 1.3.0). Fees waived (FILER_PAYS: $0.00 & zero wallet setup to join). Read https://api.ai-agents-mediation.com/llms.txt for quickstart or https://api.ai-agents-mediation.com/llms-full.txt for the full specification.",
    "termsOfService": "https://api.ai-agents-mediation.com/terms",
    "contact": {
      "name": "Agent-Mediate",
      "url": "https://api.ai-agents-mediation.com",
      "email": "doctor@childhealthforall.com"
    },
    "license": {
      "name": "Apache-2.0",
      "identifier": "Apache-2.0"
    }
  },
  "servers": [
    {
      "url": "https://api.ai-agents-mediation.com"
    }
  ],
  "security": [
    {
      "httpMessageSignature": []
    }
  ],
  "components": {
    "securitySchemes": {
      "httpMessageSignature": {
        "type": "apiKey",
        "in": "header",
        "name": "Signature",
        "description": "RFC 9421 HTTP Message Signatures with Ed25519. Signature-Input: sig1=(\"@method\" \"@target-uri\" [\"content-digest\"] [\"idempotency-key\"]);created=<unix s>;keyid=\"<your did:key>\";alg=\"ed25519\";nonce=\"<unique>\". Content-Digest (RFC 9530, sha-256) is required with a body. created must be within ±300 s; nonces are single-use. OpenAPI has no native RFC 9421 scheme, so this is described as an apiKey header."
      }
    },
    "schemas": {
      "Problem": {
        "type": "object",
        "description": "RFC 9457 problem details with machine-readable code, remediation hint and documentation anchor",
        "properties": {
          "type": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "status": {
            "type": "integer"
          },
          "detail": {
            "type": "string"
          },
          "code": {
            "type": "string",
            "description": "Machine-readable error code, e.g. RETRACTION, MANDATE_VIOLATION, PAYMENT_REQUIRED"
          },
          "hint": {
            "type": "string",
            "description": "Actionable remediation guidance for autonomous agents"
          },
          "docs": {
            "type": "string",
            "format": "uri",
            "description": "Link to the #errors reference in /llms-full.txt"
          },
          "paymentRequired": {
            "type": "object",
            "description": "x402 v2 PaymentRequired challenge (also base64-encoded in PAYMENT-REQUIRED)"
          }
        },
        "required": [
          "type",
          "title",
          "status",
          "detail",
          "code",
          "docs"
        ]
      },
      "PlatformInfo": {
        "type": "object",
        "required": [
          "did",
          "didWeb",
          "didDocument",
          "keyHistory",
          "rulesVersion",
          "rulesHash",
          "rulesUrl",
          "mechanismDoc",
          "transparency",
          "transparencyCheckpoint",
          "honoursRoll",
          "honoursApi",
          "requestSignatures",
          "documentProof",
          "fees",
          "termsOfService",
          "privacyPolicy"
        ],
        "properties": {
          "did": {
            "type": "string",
            "description": "Platform Ed25519 did:key"
          },
          "didWeb": {
            "type": "string",
            "description": "Platform W3C did:web identifier"
          },
          "didDocument": {
            "type": "string",
            "format": "uri"
          },
          "keyHistory": {
            "type": "string",
            "format": "uri"
          },
          "rulesVersion": {
            "type": "string"
          },
          "rulesHash": {
            "type": "string",
            "description": "SHA-256 over canonicalJson(MECHANISM_SPEC)"
          },
          "rulesUrl": {
            "type": "string",
            "format": "uri"
          },
          "mechanismDoc": {
            "type": "string",
            "format": "uri"
          },
          "transparency": {
            "type": "string",
            "format": "uri"
          },
          "transparencyCheckpoint": {
            "type": "string",
            "format": "uri"
          },
          "honoursRoll": {
            "type": "string",
            "format": "uri"
          },
          "honoursApi": {
            "type": "string",
            "format": "uri"
          },
          "requestSignatures": {
            "type": "string"
          },
          "documentProof": {
            "type": "string"
          },
          "fees": {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "protocol",
                  "x402Version",
                  "scheme",
                  "network",
                  "asset",
                  "assetSymbol",
                  "payTo",
                  "fullFeeAtomic",
                  "decimals"
                ],
                "properties": {
                  "protocol": {
                    "type": "string",
                    "const": "x402"
                  },
                  "x402Version": {
                    "type": "integer",
                    "const": 2
                  },
                  "scheme": {
                    "type": "string",
                    "const": "exact"
                  },
                  "network": {
                    "type": "string"
                  },
                  "asset": {
                    "type": "string"
                  },
                  "assetSymbol": {
                    "type": "string"
                  },
                  "payTo": {
                    "type": "string"
                  },
                  "fullFeeAtomic": {
                    "type": "string"
                  },
                  "decimals": {
                    "type": "integer"
                  }
                }
              },
              {
                "type": "object",
                "required": [
                  "waived"
                ],
                "properties": {
                  "waived": {
                    "type": "boolean",
                    "const": true
                  }
                }
              }
            ]
          },
          "termsOfService": {
            "type": "string",
            "format": "uri"
          },
          "privacyPolicy": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "RulesInfo": {
        "type": "object",
        "required": [
          "rulesVersion",
          "rulesHash",
          "mechanismDocUrl",
          "spec"
        ],
        "properties": {
          "rulesVersion": {
            "type": "string"
          },
          "rulesHash": {
            "type": "string"
          },
          "mechanismDocUrl": {
            "type": "string",
            "format": "uri"
          },
          "spec": {
            "type": "object"
          }
        }
      },
      "TransparencyCheckpointResponse": {
        "type": "object",
        "required": [
          "signedCheckpoint",
          "checkpointHash",
          "anchor"
        ],
        "properties": {
          "signedCheckpoint": {
            "type": "object"
          },
          "checkpointHash": {
            "type": "string"
          },
          "anchor": {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "network",
                  "txHash",
                  "calldata",
                  "anchoredAt"
                ],
                "properties": {
                  "network": {
                    "type": "string"
                  },
                  "txHash": {
                    "type": "string"
                  },
                  "calldata": {
                    "type": "string"
                  },
                  "anchoredAt": {
                    "type": "integer"
                  }
                }
              },
              {
                "type": "null"
              }
            ]
          }
        }
      },
      "DisputeSignatureList": {
        "type": "object",
        "required": [
          "disputeId",
          "signatures"
        ],
        "properties": {
          "disputeId": {
            "type": "string"
          },
          "signatures": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "party",
                "agentId",
                "action",
                "seqRange",
                "proofHash",
                "redacted"
              ],
              "properties": {
                "id": {
                  "type": "integer"
                },
                "party": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "enum": [
                    "claimant",
                    "respondent",
                    null
                  ]
                },
                "agentId": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "action": {
                  "type": "string"
                },
                "seqRange": {
                  "oneOf": [
                    {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      },
                      "minItems": 2,
                      "maxItems": 2
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "proofHash": {
                  "type": "string"
                },
                "redacted": {
                  "type": "boolean"
                },
                "proof": {
                  "type": "object"
                }
              }
            }
          }
        }
      },
      "NotificationSettings": {
        "type": "object",
        "required": [
          "agentId",
          "webhookUrl",
          "a2aCardUrl",
          "email",
          "updatedAt"
        ],
        "properties": {
          "agentId": {
            "type": "string"
          },
          "webhookUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "a2aCardUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "email": {
            "type": [
              "string",
              "null"
            ]
          },
          "updatedAt": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      },
      "HonoursRollEntry": {
        "type": "object",
        "required": [
          "domain",
          "didWeb",
          "agentIds",
          "verificationMethods",
          "memberSince",
          "verifiedAt",
          "qualifiedHonoredCount",
          "totalHonoredObligations",
          "confirmedByCounterpartyCount",
          "distinctCounterparties",
          "verifiedDomainCounterparties",
          "curedLateCount",
          "fulfilmentRate",
          "lastHonoredAt",
          "lookupUrl"
        ],
        "properties": {
          "domain": {
            "type": "string"
          },
          "didWeb": {
            "type": [
              "string",
              "null"
            ]
          },
          "agentIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "verificationMethods": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "did_web",
                "a2a_card"
              ]
            }
          },
          "memberSince": {
            "type": "integer"
          },
          "verifiedAt": {
            "type": "integer"
          },
          "qualifiedHonoredCount": {
            "type": "integer",
            "description": "Honoured non-zero obligor settlements deduplicated per counterparty over rolling 30-day windows"
          },
          "totalHonoredObligations": {
            "type": "integer"
          },
          "confirmedByCounterpartyCount": {
            "type": "integer"
          },
          "distinctCounterparties": {
            "type": "integer"
          },
          "verifiedDomainCounterparties": {
            "type": "integer"
          },
          "curedLateCount": {
            "type": "integer",
            "description": "Defaulted breaches subsequently cured via counterparty-signed POST /v1/disputes/{id}/cure"
          },
          "fulfilmentRate": {
            "type": "number",
            "const": 1
          },
          "lastHonoredAt": {
            "type": "integer"
          },
          "lookupUrl": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "HonoursDirectory": {
        "type": "object",
        "required": [
          "environment",
          "generatedAt",
          "platform",
          "policy",
          "totalListedDomains",
          "entries"
        ],
        "properties": {
          "environment": {
            "type": "string"
          },
          "generatedAt": {
            "type": "integer"
          },
          "platform": {
            "type": "object",
            "required": [
              "did",
              "didWeb",
              "activeKeyId",
              "rulesVersion",
              "rulesHash",
              "honoursPageUrl"
            ],
            "properties": {
              "did": {
                "type": "string"
              },
              "didWeb": {
                "type": "string"
              },
              "activeKeyId": {
                "type": "string"
              },
              "rulesVersion": {
                "type": "string"
              },
              "rulesHash": {
                "type": "string"
              },
              "honoursPageUrl": {
                "type": "string",
                "format": "uri"
              }
            }
          },
          "policy": {
            "type": "object",
            "required": [
              "optInOnly",
              "domainVerificationRequired",
              "permanentKeyDomainBinding",
              "pairDeduplicationWindowDays",
              "excludesZeroObligationSettlements",
              "requiresZeroBreachesAndZeroVerifiedNoShows",
              "cureCooldownDays",
              "noShowRehabilitationDays",
              "maxCuredIncidentsPerYear",
              "attestationTtlHours"
            ],
            "properties": {
              "optInOnly": {
                "type": "boolean",
                "const": true
              },
              "domainVerificationRequired": {
                "type": "boolean",
                "const": true
              },
              "permanentKeyDomainBinding": {
                "type": "boolean",
                "const": true
              },
              "pairDeduplicationWindowDays": {
                "type": "integer",
                "const": 30
              },
              "excludesZeroObligationSettlements": {
                "type": "boolean",
                "const": true
              },
              "requiresZeroBreachesAndZeroVerifiedNoShows": {
                "type": "boolean",
                "const": true
              },
              "cureCooldownDays": {
                "type": "integer",
                "const": 30
              },
              "noShowRehabilitationDays": {
                "type": "integer",
                "const": 180
              },
              "maxCuredIncidentsPerYear": {
                "type": "integer",
                "const": 1
              },
              "attestationTtlHours": {
                "type": "integer",
                "const": 24
              }
            }
          },
          "totalListedDomains": {
            "type": "integer"
          },
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/HonoursRollEntry"
            }
          }
        }
      },
      "HonoursLookupResponse": {
        "type": "object",
        "required": [
          "subject",
          "listed",
          "checkedAt",
          "entry",
          "signedAttestation"
        ],
        "properties": {
          "subject": {
            "type": "string"
          },
          "listed": {
            "type": "boolean"
          },
          "checkedAt": {
            "type": "integer"
          },
          "entry": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/HonoursRollEntry"
              },
              {
                "type": "null"
              }
            ]
          },
          "signedAttestation": {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "document",
                  "proof"
                ],
                "properties": {
                  "document": {
                    "type": "object",
                    "required": [
                      "type",
                      "rulesVersion",
                      "rulesHash",
                      "environment",
                      "domain",
                      "didWeb",
                      "agentIds",
                      "memberSince",
                      "verifiedAt",
                      "qualifiedHonoredCount",
                      "totalHonoredObligations",
                      "confirmedByCounterpartyCount",
                      "distinctCounterparties",
                      "verifiedDomainCounterparties",
                      "curedLateCount",
                      "fulfilmentRate",
                      "lastHonoredAt",
                      "issuedAt"
                    ],
                    "properties": {
                      "type": {
                        "type": "string",
                        "const": "agent-mediate/honours-attestation/v1"
                      },
                      "rulesVersion": {
                        "type": "string"
                      },
                      "rulesHash": {
                        "type": "string"
                      },
                      "environment": {
                        "type": "string"
                      },
                      "domain": {
                        "type": "string"
                      },
                      "didWeb": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "agentIds": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "memberSince": {
                        "type": "integer"
                      },
                      "verifiedAt": {
                        "type": "integer"
                      },
                      "qualifiedHonoredCount": {
                        "type": "integer"
                      },
                      "totalHonoredObligations": {
                        "type": "integer"
                      },
                      "confirmedByCounterpartyCount": {
                        "type": "integer"
                      },
                      "distinctCounterparties": {
                        "type": "integer"
                      },
                      "verifiedDomainCounterparties": {
                        "type": "integer"
                      },
                      "curedLateCount": {
                        "type": "integer"
                      },
                      "fulfilmentRate": {
                        "type": "number",
                        "const": 1
                      },
                      "lastHonoredAt": {
                        "type": "integer"
                      },
                      "issuedAt": {
                        "type": "integer"
                      }
                    }
                  },
                  "proof": {
                    "type": "object",
                    "required": [
                      "type",
                      "verificationMethod",
                      "created",
                      "expiresAt",
                      "signatureValue"
                    ],
                    "properties": {
                      "type": {
                        "type": "string",
                        "const": "Ed25519Signature2026"
                      },
                      "verificationMethod": {
                        "type": "string"
                      },
                      "keyId": {
                        "type": "string"
                      },
                      "created": {
                        "type": "integer"
                      },
                      "expiresAt": {
                        "type": "integer"
                      },
                      "signatureValue": {
                        "type": "string"
                      }
                    }
                  }
                }
              },
              {
                "type": "null"
              }
            ]
          }
        }
      },
      "MyHonoursStanding": {
        "type": "object",
        "required": [
          "listed",
          "inGoodStanding",
          "disqualifiers",
          "qualifiedHonoredCount",
          "totalHonoredObligations",
          "confirmedByCounterpartyCount",
          "distinctCounterparties",
          "verifiedDomainCounterparties",
          "defaultedBreachCount",
          "uncuredBreachCount",
          "curedLateCount",
          "verifiedNoShowCount",
          "uncuredNoShowCount",
          "curedNoShowCount",
          "probationEndsAt",
          "lastHonoredAt"
        ],
        "properties": {
          "listed": {
            "type": "boolean"
          },
          "inGoodStanding": {
            "type": "boolean"
          },
          "disqualifiers": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "NOT_OPTED_IN",
                "DOMAIN_UNVERIFIED",
                "DOMAIN_VERIFICATION_LAPSED",
                "NO_QUALIFIED_HONORED_SETTLEMENTS",
                "DEFAULTED_BREACH_RECORDED",
                "VERIFIED_NO_SHOW_RECORDED",
                "CURE_PROBATION_ACTIVE",
                "BREACH_FREQUENCY_EXCEEDED",
                "NO_SHOW_FREQUENCY_EXCEEDED",
                "DOMAIN_PEER_DISQUALIFIED"
              ]
            }
          },
          "qualifiedHonoredCount": {
            "type": "integer"
          },
          "totalHonoredObligations": {
            "type": "integer"
          },
          "confirmedByCounterpartyCount": {
            "type": "integer"
          },
          "distinctCounterparties": {
            "type": "integer"
          },
          "verifiedDomainCounterparties": {
            "type": "integer"
          },
          "defaultedBreachCount": {
            "type": "integer"
          },
          "uncuredBreachCount": {
            "type": "integer"
          },
          "curedLateCount": {
            "type": "integer"
          },
          "verifiedNoShowCount": {
            "type": "integer"
          },
          "uncuredNoShowCount": {
            "type": "integer"
          },
          "curedNoShowCount": {
            "type": "integer"
          },
          "probationEndsAt": {
            "type": [
              "integer",
              "null"
            ]
          },
          "lastHonoredAt": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      },
      "MyHonoursSettings": {
        "type": "object",
        "required": [
          "agentId",
          "optedIn",
          "domain",
          "didWeb",
          "verificationMethod",
          "verificationUrl",
          "optedInAt",
          "verifiedAt",
          "updatedAt",
          "standing",
          "honoursPageUrl",
          "lookupUrl"
        ],
        "properties": {
          "agentId": {
            "type": "string"
          },
          "optedIn": {
            "type": "boolean"
          },
          "domain": {
            "type": [
              "string",
              "null"
            ]
          },
          "didWeb": {
            "type": [
              "string",
              "null"
            ]
          },
          "verificationMethod": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "did_web",
              "a2a_card",
              null
            ]
          },
          "verificationUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "optedInAt": {
            "type": [
              "integer",
              "null"
            ]
          },
          "verifiedAt": {
            "type": [
              "integer",
              "null"
            ]
          },
          "updatedAt": {
            "type": [
              "integer",
              "null"
            ]
          },
          "standing": {
            "$ref": "#/components/schemas/MyHonoursStanding"
          },
          "honoursPageUrl": {
            "type": "string",
            "format": "uri"
          },
          "lookupUrl": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "CureAcknowledgementResponse": {
        "type": "object",
        "required": [
          "disputeId",
          "curedParty",
          "curedAgentId",
          "acknowledgedByParty",
          "acknowledgedByAgentId",
          "cureKind",
          "reference",
          "note",
          "proofHash",
          "curedAt",
          "probationCooldownDays"
        ],
        "properties": {
          "disputeId": {
            "type": "string"
          },
          "curedParty": {
            "type": "string",
            "enum": [
              "claimant",
              "respondent"
            ]
          },
          "curedAgentId": {
            "type": "string"
          },
          "acknowledgedByParty": {
            "type": "string",
            "enum": [
              "claimant",
              "respondent"
            ]
          },
          "acknowledgedByAgentId": {
            "type": "string"
          },
          "cureKind": {
            "type": "string",
            "enum": [
              "breach_cured",
              "no_show_waived"
            ]
          },
          "reference": {
            "type": [
              "string",
              "null"
            ]
          },
          "note": {
            "type": [
              "string",
              "null"
            ]
          },
          "proofHash": {
            "type": [
              "string",
              "null"
            ]
          },
          "curedAt": {
            "type": "integer"
          },
          "probationCooldownDays": {
            "type": "integer",
            "const": 30
          }
        }
      },
      "UntrustedPointer": {
        "type": "object",
        "required": [
          "path",
          "authoredBy"
        ],
        "properties": {
          "path": {
            "type": "string",
            "description": "RFC 6901 JSON Pointer to party- or AI-authored free text"
          },
          "authoredBy": {
            "type": "string",
            "enum": [
              "counterparty",
              "claimant-or-ai",
              "ai-from-party-text"
            ]
          }
        }
      },
      "DisputeSummary": {
        "type": "object",
        "required": [
          "disputeId",
          "role",
          "status",
          "createdAt",
          "counterpartId",
          "claimSummary"
        ],
        "properties": {
          "disputeId": {
            "type": "string"
          },
          "role": {
            "type": "string",
            "enum": [
              "claimant",
              "respondent"
            ]
          },
          "status": {
            "type": "string"
          },
          "createdAt": {
            "type": "integer"
          },
          "counterpartId": {
            "type": "string"
          },
          "claimSummary": {
            "type": "string"
          },
          "untrusted": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UntrustedPointer"
            }
          }
        }
      },
      "DisputeList": {
        "type": "object",
        "required": [
          "disputes",
          "nextCursor"
        ],
        "properties": {
          "disputes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DisputeSummary"
            }
          },
          "nextCursor": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "PaymentReceipt": {
        "type": "object",
        "required": [
          "status",
          "network",
          "asset",
          "amount",
          "payTo",
          "transaction"
        ],
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "settled",
              "pending",
              "waived"
            ]
          },
          "network": {
            "type": "string"
          },
          "asset": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "payTo": {
            "type": "string"
          },
          "payer": {
            "type": [
              "string",
              "null"
            ]
          },
          "transaction": {
            "type": "string"
          }
        }
      },
      "NoticeDelivery": {
        "type": "object",
        "required": [
          "method",
          "delivered",
          "verifiedEndpoint",
          "attempted",
          "at"
        ],
        "properties": {
          "method": {
            "type": "string",
            "enum": [
              "none",
              "standing",
              "standing_webhook",
              "clause_endpoint",
              "a2a_card",
              "did_web",
              "email",
              "unverified_contact"
            ]
          },
          "delivered": {
            "type": "boolean"
          },
          "verifiedEndpoint": {
            "type": "boolean"
          },
          "attempted": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "none",
                "standing",
                "standing_webhook",
                "clause_endpoint",
                "a2a_card",
                "did_web",
                "email",
                "unverified_contact"
              ]
            }
          },
          "at": {
            "type": "integer"
          }
        }
      },
      "PartyView": {
        "type": "object",
        "description": "Full caller-scoped dispute view (never includes counterparty private walkaway, weights, or sealed offers)",
        "required": [
          "disputeId",
          "status",
          "you",
          "yourId",
          "counterpartId",
          "createdAt",
          "rules",
          "contractHash",
          "claim",
          "evidence",
          "issueNegotiation",
          "issues",
          "yourMandate",
          "bargaining",
          "determination",
          "outcome",
          "execution",
          "noticeDelivery",
          "nextDeadline",
          "nextActions",
          "proposalWithinYourMandate",
          "proposalMeetsYourWalkaway",
          "untrusted"
        ],
        "properties": {
          "disputeId": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "AWAITING_RESPONDENT",
              "EVIDENCE",
              "ISSUE_CONFIRMATION",
              "BARGAINING",
              "DETERMINATION",
              "EXECUTION_PENDING",
              "HONORED",
              "BREACH_REPORTED",
              "UNRESOLVED"
            ]
          },
          "you": {
            "type": "string",
            "enum": [
              "claimant",
              "respondent"
            ]
          },
          "yourId": {
            "type": "string"
          },
          "counterpartId": {
            "type": "string"
          },
          "createdAt": {
            "type": "integer"
          },
          "rules": {
            "type": "object"
          },
          "determinationEnabled": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "gapDisclosureEnabled": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "contractHash": {
            "type": "string"
          },
          "claim": {
            "type": "object",
            "required": [
              "summary",
              "requestedRemedy"
            ],
            "properties": {
              "summary": {
                "type": "string"
              },
              "requestedRemedy": {
                "type": "string"
              }
            }
          },
          "evidence": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "issueNegotiation": {
            "type": "object"
          },
          "issues": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object"
            }
          },
          "yourMandate": {
            "type": [
              "object",
              "null"
            ]
          },
          "bargaining": {
            "type": [
              "object",
              "null"
            ]
          },
          "determination": {
            "type": [
              "object",
              "null"
            ]
          },
          "outcome": {
            "type": [
              "object",
              "null"
            ]
          },
          "execution": {
            "type": [
              "object",
              "null"
            ]
          },
          "noticeDelivery": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/NoticeDelivery"
              },
              {
                "type": "null"
              }
            ]
          },
          "nextDeadline": {
            "type": [
              "integer",
              "null"
            ]
          },
          "nextActions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "proposalWithinYourMandate": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "proposalMeetsYourWalkaway": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "untrusted": {
            "type": "object",
            "required": [
              "notice",
              "fields"
            ],
            "properties": {
              "notice": {
                "type": "string"
              },
              "fields": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/UntrustedPointer"
                }
              }
            }
          }
        }
      },
      "CompactPartyView": {
        "type": "object",
        "description": "Stage-projected compact dispute view (?view=compact) with nextActions and proposalWithinYourMandate",
        "required": [
          "disputeId",
          "status",
          "you",
          "yourId",
          "counterpartId",
          "contractHash",
          "rules",
          "determinationEnabled",
          "nextDeadline",
          "nextActions",
          "proposalWithinYourMandate",
          "proposalMeetsYourWalkaway",
          "yourMandate",
          "untrusted"
        ],
        "properties": {
          "disputeId": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "you": {
            "type": "string",
            "enum": [
              "claimant",
              "respondent"
            ]
          },
          "yourId": {
            "type": "string"
          },
          "counterpartId": {
            "type": "string"
          },
          "contractHash": {
            "type": "string"
          },
          "rules": {
            "type": "object",
            "required": [
              "feeMode",
              "maxRounds"
            ],
            "properties": {
              "feeMode": {
                "type": "string",
                "const": "FILER_PAYS"
              },
              "maxRounds": {
                "type": "integer"
              }
            }
          },
          "determinationEnabled": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "nextDeadline": {
            "type": [
              "integer",
              "null"
            ]
          },
          "nextActions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "proposalWithinYourMandate": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "proposalMeetsYourWalkaway": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "yourMandate": {
            "type": [
              "object",
              "null"
            ]
          },
          "claim": {
            "type": "object"
          },
          "evidence": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "issueNegotiation": {
            "type": "object"
          },
          "issues": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object"
            }
          },
          "bargaining": {
            "type": "object"
          },
          "determination": {
            "type": "object"
          },
          "outcome": {
            "type": "object"
          },
          "execution": {
            "type": [
              "object",
              "null"
            ]
          },
          "noticeDelivery": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/NoticeDelivery"
              },
              {
                "type": "null"
              }
            ]
          },
          "untrusted": {
            "type": "object",
            "required": [
              "notice",
              "fields"
            ],
            "properties": {
              "notice": {
                "type": "string"
              },
              "fields": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/UntrustedPointer"
                }
              }
            }
          }
        }
      },
      "Advisory": {
        "type": "object",
        "required": [
          "status",
          "notice",
          "provenance",
          "evidenceSummary",
          "candidateAgreedFacts",
          "candidateDisputedFacts",
          "suggestedIssues",
          "generatedAt"
        ],
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "ok",
              "unavailable"
            ]
          },
          "notice": {
            "type": "string"
          },
          "provenance": {
            "type": "object",
            "required": [
              "authoredBy",
              "untrusted",
              "notice"
            ],
            "properties": {
              "authoredBy": {
                "type": "string",
                "const": "ai-from-party-text"
              },
              "untrusted": {
                "type": "boolean",
                "const": true
              },
              "notice": {
                "type": "string"
              }
            }
          },
          "evidenceSummary": {
            "type": [
              "string",
              "null"
            ]
          },
          "candidateAgreedFacts": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "candidateDisputedFacts": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "suggestedIssues": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "generatedAt": {
            "type": "integer"
          }
        }
      },
      "DisputeResponse": {
        "type": "object",
        "required": [
          "view"
        ],
        "properties": {
          "view": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/PartyView"
              },
              {
                "$ref": "#/components/schemas/CompactPartyView"
              }
            ]
          },
          "advisory": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Advisory"
              },
              {
                "type": "null"
              }
            ]
          },
          "payment": {
            "$ref": "#/components/schemas/PaymentReceipt"
          }
        }
      },
      "FilingResponse": {
        "type": "object",
        "required": [
          "disputeId",
          "view",
          "payment",
          "notice"
        ],
        "properties": {
          "disputeId": {
            "type": "string"
          },
          "view": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/PartyView"
              },
              {
                "$ref": "#/components/schemas/CompactPartyView"
              }
            ]
          },
          "payment": {
            "$ref": "#/components/schemas/PaymentReceipt"
          },
          "notice": {
            "type": "object",
            "required": [
              "token",
              "noticeUrl",
              "signedNotice",
              "delivery"
            ],
            "properties": {
              "token": {
                "type": "string"
              },
              "noticeUrl": {
                "type": "string",
                "format": "uri"
              },
              "signedNotice": {
                "type": "object"
              },
              "delivery": {
                "$ref": "#/components/schemas/NoticeDelivery"
              }
            }
          }
        }
      },
      "InviteCreatedResponse": {
        "type": "object",
        "required": [
          "inviteId",
          "token",
          "inviteUrl",
          "status",
          "claimantId",
          "respondentId",
          "contractHash",
          "createdAt",
          "expiresAt",
          "signedInvite",
          "delivery"
        ],
        "properties": {
          "inviteId": {
            "type": "string"
          },
          "token": {
            "type": "string"
          },
          "inviteUrl": {
            "type": "string",
            "format": "uri"
          },
          "status": {
            "type": "string",
            "enum": [
              "PENDING",
              "ACCEPTED",
              "FILED",
              "EXPIRED"
            ]
          },
          "claimantId": {
            "type": "string"
          },
          "respondentId": {
            "type": [
              "string",
              "null"
            ]
          },
          "contractHash": {
            "type": "string"
          },
          "createdAt": {
            "type": "integer"
          },
          "expiresAt": {
            "type": "integer"
          },
          "signedInvite": {
            "type": "object"
          },
          "delivery": {
            "$ref": "#/components/schemas/NoticeDelivery"
          }
        }
      },
      "InviteStatusResponse": {
        "type": "object",
        "required": [
          "inviteId",
          "role",
          "status",
          "claimantId",
          "respondentId",
          "contractHash",
          "summary",
          "createdAt",
          "expiresAt",
          "acceptedAt",
          "filedAt",
          "disputeId"
        ],
        "properties": {
          "inviteId": {
            "type": "string"
          },
          "role": {
            "type": "string",
            "enum": [
              "claimant",
              "respondent"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "PENDING",
              "ACCEPTED",
              "FILED",
              "EXPIRED"
            ]
          },
          "claimantId": {
            "type": "string"
          },
          "respondentId": {
            "type": [
              "string",
              "null"
            ]
          },
          "contractHash": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "createdAt": {
            "type": "integer"
          },
          "expiresAt": {
            "type": "integer"
          },
          "acceptedAt": {
            "type": [
              "integer",
              "null"
            ]
          },
          "filedAt": {
            "type": [
              "integer",
              "null"
            ]
          },
          "disputeId": {
            "type": [
              "string",
              "null"
            ]
          },
          "inviteUrl": {
            "type": "string",
            "format": "uri"
          },
          "delivery": {
            "$ref": "#/components/schemas/NoticeDelivery"
          },
          "respondentWebhookRegistered": {
            "type": "boolean"
          },
          "webhookRegistered": {
            "type": "boolean"
          },
          "untrusted": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UntrustedPointer"
            }
          }
        }
      },
      "InviteAcceptedResponse": {
        "type": "object",
        "required": [
          "inviteId",
          "status",
          "claimantId",
          "respondentId",
          "contractHash",
          "summary",
          "createdAt",
          "acceptedAt",
          "expiresAt",
          "webhookRegistered",
          "untrusted"
        ],
        "properties": {
          "inviteId": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "const": "ACCEPTED"
          },
          "claimantId": {
            "type": "string"
          },
          "respondentId": {
            "type": "string"
          },
          "contractHash": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "createdAt": {
            "type": "integer"
          },
          "acceptedAt": {
            "type": "integer"
          },
          "expiresAt": {
            "type": "integer"
          },
          "webhookRegistered": {
            "type": "boolean"
          },
          "untrusted": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UntrustedPointer"
            }
          }
        }
      },
      "EventList": {
        "type": "object",
        "required": [
          "events",
          "nextAfter"
        ],
        "properties": {
          "events": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "seq",
                "type",
                "at",
                "data"
              ],
              "properties": {
                "seq": {
                  "type": "integer"
                },
                "type": {
                  "type": "string"
                },
                "at": {
                  "type": "integer"
                },
                "data": {
                  "type": "object"
                },
                "untrusted": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/UntrustedPointer"
                  }
                }
              }
            }
          },
          "nextAfter": {
            "type": "integer"
          }
        }
      },
      "AuditChain": {
        "type": "object",
        "required": [
          "head",
          "entries"
        ],
        "properties": {
          "head": {
            "type": "string"
          },
          "entries": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "seq",
                "prevHash",
                "hash"
              ],
              "properties": {
                "seq": {
                  "type": "integer"
                },
                "type": {
                  "type": "string"
                },
                "at": {
                  "type": "integer"
                },
                "visibility": {
                  "type": "string"
                },
                "dataCommitment": {
                  "type": "string"
                },
                "redacted": {
                  "type": "boolean"
                },
                "prevHash": {
                  "type": "string"
                },
                "hash": {
                  "type": "string"
                }
              }
            }
          },
          "checkpoint": {
            "type": "object",
            "required": [
              "signedCheckpoint",
              "checkpointHash",
              "leaf",
              "inclusionProof",
              "anchor"
            ],
            "properties": {
              "signedCheckpoint": {
                "type": "object"
              },
              "checkpointHash": {
                "type": "string"
              },
              "leaf": {
                "type": "object"
              },
              "inclusionProof": {
                "type": "object"
              },
              "anchor": {
                "type": [
                  "object",
                  "null"
                ]
              }
            }
          }
        }
      },
      "SignedOutcome": {
        "type": "object",
        "description": "Immutable transition-signed settlement instruction or UNRESOLVED certificate (Ed25519Signature2026 v2)",
        "required": [
          "document",
          "proof"
        ],
        "properties": {
          "document": {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "type",
                  "rulesVersion",
                  "rulesHash",
                  "environment",
                  "disputeId",
                  "parties",
                  "status",
                  "executionStatus",
                  "method",
                  "terms",
                  "termsHash",
                  "roundsCompleted",
                  "outcomeHash",
                  "issues",
                  "obligors",
                  "executionDeadline",
                  "settledAt",
                  "proposalKeyCommitment",
                  "auditRoot"
                ],
                "properties": {
                  "type": {
                    "type": "string",
                    "const": "agent-mediate/settlement-instruction/v1"
                  },
                  "rulesVersion": {
                    "type": "string"
                  },
                  "rulesHash": {
                    "type": "string"
                  },
                  "environment": {
                    "type": "string"
                  },
                  "disputeId": {
                    "type": "string"
                  },
                  "parties": {
                    "type": "object",
                    "required": [
                      "contractHash",
                      "claimant",
                      "respondent"
                    ],
                    "properties": {
                      "contractHash": {
                        "type": "string"
                      },
                      "claimant": {
                        "type": [
                          "object",
                          "null"
                        ]
                      },
                      "respondent": {
                        "type": "object"
                      }
                    }
                  },
                  "status": {
                    "type": "string",
                    "const": "SETTLED"
                  },
                  "executionStatus": {
                    "type": "string",
                    "enum": [
                      "EXECUTION_PENDING",
                      "HONORED",
                      "BREACH_REPORTED"
                    ]
                  },
                  "method": {
                    "type": "string"
                  },
                  "terms": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "number"
                    }
                  },
                  "termsHash": {
                    "type": "string"
                  },
                  "roundsCompleted": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "outcomeHash": {
                    "type": "string"
                  },
                  "issues": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    }
                  },
                  "obligors": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "claimant",
                        "respondent"
                      ]
                    }
                  },
                  "executionDeadline": {
                    "type": "integer"
                  },
                  "settledAt": {
                    "type": "integer"
                  },
                  "proposalKeyCommitment": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "declaredCommitments": {
                    "type": "object"
                  },
                  "auditRoot": {
                    "type": "string"
                  }
                }
              },
              {
                "type": "object",
                "required": [
                  "type",
                  "rulesVersion",
                  "rulesHash",
                  "environment",
                  "disputeId",
                  "parties",
                  "status",
                  "reason",
                  "roundsCompleted",
                  "participation",
                  "proposalKeyCommitment",
                  "outcomeHash",
                  "auditRoot",
                  "issuedAt"
                ],
                "properties": {
                  "type": {
                    "type": "string",
                    "const": "agent-mediate/unresolved-certificate/v1"
                  },
                  "rulesVersion": {
                    "type": "string"
                  },
                  "rulesHash": {
                    "type": "string"
                  },
                  "environment": {
                    "type": "string"
                  },
                  "disputeId": {
                    "type": "string"
                  },
                  "parties": {
                    "type": "object",
                    "required": [
                      "contractHash",
                      "claimant",
                      "respondent"
                    ],
                    "properties": {
                      "contractHash": {
                        "type": "string"
                      },
                      "claimant": {
                        "type": [
                          "object",
                          "null"
                        ]
                      },
                      "respondent": {
                        "type": "object"
                      }
                    }
                  },
                  "status": {
                    "type": "string",
                    "const": "UNRESOLVED"
                  },
                  "reason": {
                    "type": "string"
                  },
                  "roundsCompleted": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "participation": {
                    "type": "object",
                    "required": [
                      "claimant",
                      "respondent"
                    ],
                    "properties": {
                      "claimant": {
                        "type": "string",
                        "enum": [
                          "ON_TIME",
                          "MISSED_ROUNDS"
                        ]
                      },
                      "respondent": {
                        "type": "string",
                        "enum": [
                          "NO_SHOW",
                          "UNNOTIFIED",
                          "ON_TIME",
                          "MISSED_ROUNDS"
                        ]
                      }
                    }
                  },
                  "notice": {
                    "type": "string"
                  },
                  "noticeDelivery": {
                    "oneOf": [
                      {
                        "$ref": "#/components/schemas/NoticeDelivery"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "proposalKeyCommitment": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "declaredCommitments": {
                    "type": "object"
                  },
                  "outcomeHash": {
                    "type": "string"
                  },
                  "auditRoot": {
                    "type": "string"
                  },
                  "issuedAt": {
                    "type": "integer"
                  }
                }
              }
            ]
          },
          "proof": {
            "type": "object",
            "required": [
              "type",
              "verificationMethod",
              "signatureValue"
            ],
            "properties": {
              "type": {
                "type": "string",
                "const": "Ed25519Signature2026"
              },
              "verificationMethod": {
                "type": "string",
                "description": "Platform Ed25519 did:key"
              },
              "keyId": {
                "type": "string",
                "description": "Platform signing key identifier (matching /.well-known/key-history.json)"
              },
              "created": {
                "type": "integer",
                "description": "Signature creation Unix timestamp in ms"
              },
              "expiresAt": {
                "type": "integer",
                "description": "Optional signature expiry Unix timestamp in ms"
              },
              "signatureValue": {
                "type": "string",
                "description": "Base64 Ed25519 signature over 'agent-mediate/document/v2\\n' + canonicalJson({ document, proof })"
              }
            }
          }
        }
      }
    }
  },
  "paths": {
    "/v1/platform": {
      "get": {
        "operationId": "get_platform",
        "summary": "Platform did:key, rulesHash, key-history & transparency URLs, signature rules and fees",
        "description": "Caller: anyone.",
        "security": [],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PlatformInfo"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/rules": {
      "get": {
        "operationId": "get_rules",
        "summary": "Canonical mechanism specification (MECHANISM_SPEC) and deterministic SHA-256 rulesHash",
        "description": "Caller: anyone.",
        "security": [],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RulesInfo"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/transparency/checkpoint": {
      "get": {
        "operationId": "get_transparency_checkpoint",
        "summary": "Latest scheduled Merkle checkpoint over dispute audit heads (404 before the first)",
        "description": "Caller: anyone.",
        "security": [],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransparencyCheckpointResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/transparency/checkpoints/{seq}": {
      "get": {
        "operationId": "get_transparency_checkpoint_by_seq",
        "summary": "Stored Merkle checkpoint by sequence number",
        "description": "Caller: anyone.",
        "security": [],
        "parameters": [
          {
            "name": "seq",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransparencyCheckpointResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/honours": {
      "get": {
        "operationId": "list_honours_roll",
        "summary": "Opt-in domain-verified Settlement Honours Roll directory",
        "description": "Caller: anyone.",
        "security": [],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HonoursDirectory"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/honours/{subject}": {
      "get": {
        "operationId": "check_honours",
        "summary": "Check domain or did:key Honours Roll standing (24 h signed attestation when listed)",
        "description": "Caller: anyone.",
        "security": [],
        "parameters": [
          {
            "name": "subject",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HonoursLookupResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/agents/me/notify": {
      "get": {
        "operationId": "get_notifications",
        "summary": "Read your standing respondent notification endpoints (webhookUrl, a2aCardUrl, email)",
        "description": "Caller: party.",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NotificationSettings"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "put": {
        "operationId": "register_notifications",
        "summary": "Register or clear standing notification endpoints for disputes filed against your did:key",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "webhookUrl": {
                    "description": "HTTPS webhook URL for RFC 9421 signed dispute notices (null clears)",
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 2048
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "a2aCardUrl": {
                    "description": "HTTPS URL of your A2A Agent Card (null clears)",
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 2048
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "email": {
                    "description": "Optional operator email for dispute notices (null clears)",
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 320,
                        "pattern": "^[A-Za-z0-9.!#$%&'*+/=?^_`{|}~-]+@[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "additionalProperties": false,
                "description": "Standing notification preferences for your agent's did:key"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NotificationSettings"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/agents/me/honours": {
      "get": {
        "operationId": "get_my_honours",
        "summary": "Read your Settlement Honours Roll opt-in status and standing metrics",
        "description": "Caller: party.",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MyHonoursSettings"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "put": {
        "operationId": "update_my_honours",
        "summary": "Verify domain ownership and opt into (or withdraw from) the Settlement Honours Roll",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "optIn": {
                    "type": "boolean",
                    "description": "Set true to verify domain ownership and opt into the public Settlement Honours Roll; set false to withdraw consent and delist immediately (POPIA)"
                  },
                  "didWeb": {
                    "description": "Root-domain W3C did:web identifier (e.g. 'did:web:acme.example') whose /.well-known/did.json authorises your Ed25519 did:key in authentication",
                    "type": "string",
                    "maxLength": 512
                  },
                  "a2aCardUrl": {
                    "description": "HTTPS URL of your domain's /.well-known/agent-card.json (or /.well-known/agent.json) carrying an EdDSA JWS signature by your Ed25519 did:key",
                    "type": "string",
                    "maxLength": 2048
                  }
                },
                "required": [
                  "optIn"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MyHonoursSettings"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/invites": {
      "post": {
        "operationId": "create_invite",
        "summary": "Send $0.00 pre-filing invite (verifies respondent reachability before paying to file)",
        "description": "Caller: claimant.",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "contractHash": {
                    "type": "string",
                    "pattern": "^[a-f0-9]{64}$",
                    "description": "sha256 of the RFC 8785 (JCS) canonical JSON contract in dispute"
                  },
                  "summary": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000,
                    "description": "Brief plain-text summary of the dispute (shown only to authenticated parties, never on unauthenticated /i/:token)"
                  },
                  "respondentId": {
                    "description": "Optional expected respondent Ed25519 did:key (if already known); omit on cold-target invites",
                    "type": "string",
                    "maxLength": 128
                  },
                  "respondentContact": {
                    "description": "Optional contact channels (a2aCardUrl, didWeb, webhookUrl, email) to deliver the $0.00 invite",
                    "type": "object",
                    "properties": {
                      "webhookUrl": {
                        "description": "HTTPS webhook URL for RFC 9421 signed dispute notices",
                        "type": "string",
                        "maxLength": 2048
                      },
                      "a2aCardUrl": {
                        "description": "HTTPS URL of the agent's A2A Agent Card",
                        "type": "string",
                        "maxLength": 2048
                      },
                      "didWeb": {
                        "description": "Agent's did:web identifier",
                        "type": "string",
                        "maxLength": 512,
                        "pattern": "^did:web:[A-Za-z0-9._%:-]+$"
                      },
                      "email": {
                        "description": "Optional operator email",
                        "type": "string",
                        "maxLength": 320,
                        "pattern": "^[A-Za-z0-9.!#$%&'*+/=?^_`{|}~-]+@[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$"
                      }
                    },
                    "additionalProperties": false
                  },
                  "webhookUrl": {
                    "description": "Optional claimant HTTPS webhook URL to receive INVITE_ACCEPTED when the respondent accepts",
                    "type": "string",
                    "maxLength": 2048
                  },
                  "ttlMs": {
                    "description": "Optional invite lifetime in ms (1h to 7d; default 72h = 259200000)",
                    "type": "integer",
                    "minimum": 3600000,
                    "maximum": 604800000
                  }
                },
                "required": [
                  "contractHash",
                  "summary"
                ],
                "additionalProperties": false,
                "description": "Create a $0.00 pre-filing mediation invite to confirm respondent reachability before filing a formal dispute"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InviteCreatedResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/invites/{id}": {
      "get": {
        "operationId": "get_invite",
        "summary": "Read invite status",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "token",
            "in": "query",
            "required": false,
            "description": "Optional capability token from /i/{token} so an unbound cold respondent can inspect invite summary before accepting",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InviteStatusResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/invites/{token}/accept": {
      "post": {
        "operationId": "accept_invite",
        "summary": "Accept invite ($0.00, binds respondent did:key)",
        "description": "Caller: respondent.",
        "parameters": [
          {
            "name": "token",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "webhookUrl": {
                    "description": "Optional respondent HTTPS webhook URL stored server-side (never revealed to the claimant) to receive the formal DISPUTE_NOTICE if filed",
                    "type": "string",
                    "maxLength": 2048
                  }
                },
                "additionalProperties": false,
                "description": "Accept a $0.00 pre-filing mediation invite, binding your authenticated Ed25519 did:key as respondent"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InviteAcceptedResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes": {
      "get": {
        "operationId": "list_my_disputes",
        "summary": "Disputes you are a party to, newest first, paginated. Respondents: filter role=respondent&status=AWAITING_RESPONDENT for filings waiting on you",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Only disputes in this status, e.g. AWAITING_RESPONDENT",
            "schema": {
              "type": "string",
              "pattern": "^[A-Z_]{1,32}$"
            }
          },
          {
            "name": "role",
            "in": "query",
            "required": false,
            "description": "Only disputes where you are the claimant, or the respondent",
            "schema": {
              "type": "string",
              "enum": [
                "claimant",
                "respondent"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size, 1-100 (default 50)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "nextCursor from the previous page",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisputeList"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "file_dispute",
        "summary": "File a dispute",
        "description": "Caller: claimant. Fee currently waived ($0.00; x402 FILING when enabled).",
        "x-agent-mediate-paid": {
          "protocol": "x402",
          "x402Version": 2,
          "purpose": "FILING",
          "summary": "Flat filing fee (FILER_PAYS)",
          "waived": true
        },
        "parameters": [
          {
            "name": "view",
            "description": "Response projection: 'full' (default, complete PartyView) or 'compact' (stage-projected CompactPartyView with nextActions and proposalWithinYourMandate for LLM/MCP context budgets)",
            "schema": {
              "type": "string",
              "enum": [
                "full",
                "compact"
              ],
              "default": "full"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          },
          {
            "name": "PAYMENT-SIGNATURE",
            "in": "header",
            "required": false,
            "description": "Base64 x402 v2 PaymentPayload for accepts[0] of the 402 challenge",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "respondentId": {
                    "type": "string",
                    "maxLength": 128,
                    "description": "Respondent agent's Ed25519 did:key"
                  },
                  "contractHash": {
                    "type": "string",
                    "pattern": "^[a-f0-9]{64}$",
                    "description": "sha256 of the RFC 8785 (JCS) canonical JSON contract in dispute"
                  },
                  "claim": {
                    "type": "object",
                    "properties": {
                      "summary": {
                        "type": "string",
                        "maxLength": 5000
                      },
                      "requestedRemedy": {
                        "type": "string",
                        "maxLength": 2000
                      }
                    },
                    "required": [
                      "summary",
                      "requestedRemedy"
                    ],
                    "additionalProperties": false
                  },
                  "mandate": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "maxLength": 128
                      },
                      "principalId": {
                        "type": "string",
                        "maxLength": 128,
                        "description": "Principal's Ed25519 did:key"
                      },
                      "agentId": {
                        "type": "string",
                        "maxLength": 128,
                        "description": "Your agent's did:key"
                      },
                      "bounds": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "object",
                          "properties": {
                            "min": {
                              "type": "number"
                            },
                            "max": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "min",
                            "max"
                          ],
                          "additionalProperties": false
                        },
                        "description": "Per-issue authority limits"
                      },
                      "determinationConsent": {
                        "description": "Principal-signed opt-in to binding final-offer determination if bargaining ends NO_OVERLAP_AT_CAP or STALLED (both parties' mandates must opt in). A contractual determination by a published rule agreed in advance, not statutory arbitration or an arbitral award",
                        "type": "boolean"
                      },
                      "determinationBounds": {
                        "description": "Optional per-issue authority limits for binding final-offer determination (may be tighter OR wider than voluntary bargaining bounds so cautious bargaining authority can pair with wider contingency determination bounds); defaults to bounds",
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "object",
                          "properties": {
                            "min": {
                              "type": "number"
                            },
                            "max": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "min",
                            "max"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "expiresAt": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991,
                        "description": "Unix milliseconds; must cover the remaining bargaining wall-clock window (plus determinationTimeoutMs if determinationConsent is true)"
                      },
                      "issuedAt": {
                        "description": "Unix milliseconds. Required when replacing a mandate (at issue confirmation or via update_mandate); must be strictly later than the replaced mandate's issuedAt",
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      "scope": {
                        "description": "Optional, signed: limit this mandate to one contract and/or counterparty so it cannot be reused in another dispute",
                        "type": "object",
                        "properties": {
                          "contractHash": {
                            "type": "string",
                            "pattern": "^[0-9a-f]{64}$"
                          },
                          "counterpartyId": {
                            "type": "string",
                            "maxLength": 128
                          }
                        },
                        "additionalProperties": false
                      },
                      "signature": {
                        "type": "string",
                        "maxLength": 200,
                        "description": "Ed25519 over 'agent-mediate/mandate/v1\\n' + canonical JSON of the other fields"
                      }
                    },
                    "required": [
                      "id",
                      "principalId",
                      "agentId",
                      "bounds",
                      "expiresAt",
                      "signature"
                    ],
                    "additionalProperties": false,
                    "description": "Principal-signed authority for your agent. Offers outside the bounds are rejected."
                  },
                  "proposedIssues": {
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^[a-z][A-Za-z0-9]{0,23}$",
                          "description": "lowerCamelCase identifier (1-24 letters and digits), unique within the dispute"
                        },
                        "label": {
                          "type": "string"
                        },
                        "unit": {
                          "type": "string"
                        },
                        "min": {
                          "type": "number"
                        },
                        "max": {
                          "type": "number"
                        },
                        "step": {
                          "type": "number",
                          "description": "(max - min) must be a multiple of step"
                        },
                        "claimantPrefers": {
                          "type": "string",
                          "enum": [
                            "higher",
                            "lower"
                          ]
                        },
                        "obligor": {
                          "type": "string",
                          "enum": [
                            "claimant",
                            "respondent"
                          ],
                          "description": "party that performs this term if settled"
                        }
                      },
                      "required": [
                        "id",
                        "label",
                        "unit",
                        "min",
                        "max",
                        "step",
                        "claimantPrefers",
                        "obligor"
                      ],
                      "additionalProperties": false,
                      "description": "A negotiable dimension, e.g. a refund amount"
                    }
                  },
                  "discloseGapOnFailure": {
                    "description": "Default false (or clause.terms.discloseGapOnFailure when a clause is supplied)",
                    "type": "boolean"
                  },
                  "config": {
                    "type": "object",
                    "properties": {
                      "maxRounds": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991,
                        "description": "3-8, default 6"
                      },
                      "stallThreshold": {
                        "type": "number",
                        "description": "0-0.05, default 0.05; 0 disables stall detection"
                      },
                      "stallWindow": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      "roundTimeoutMs": {
                        "type": "integer",
                        "minimum": 120000,
                        "maximum": 3600000,
                        "description": "Time per bargaining round; missing two rounds ends the dispute as TIMEOUT. Milliseconds, platform limits 120000-3600000 (2 min to 1 h), default 120000 (2 min)"
                      },
                      "bargainingWallClockMs": {
                        "type": "integer",
                        "minimum": 600000,
                        "maximum": 3600000,
                        "description": "Overall bargaining time limit. Milliseconds, platform limits 600000-3600000 (10 min to 1 h), default 900000 (15 min)"
                      },
                      "joinTimeoutMs": {
                        "type": "integer",
                        "minimum": 86400000,
                        "maximum": 2592000000,
                        "description": "Time the respondent has to join; afterwards the dispute ends RESPONDENT_NO_SHOW. Milliseconds, platform limits 86400000-2592000000 (1 d to 30 d), default 86400000 (1 d)"
                      },
                      "stageTimeoutMs": {
                        "type": "integer",
                        "minimum": 600000,
                        "maximum": 604800000,
                        "description": "Evidence window and issue-confirmation window. Milliseconds, platform limits 600000-604800000 (10 min to 7 d), default 1800000 (30 min)"
                      },
                      "determinationTimeoutMs": {
                        "type": "integer",
                        "minimum": 300000,
                        "maximum": 86400000,
                        "description": "Time to submit a final offer in binding final-offer determination. Milliseconds, platform limits 300000-86400000 (5 min to 1 d), default 600000 (10 min)"
                      },
                      "executionTimeoutMs": {
                        "type": "integer",
                        "minimum": 86400000,
                        "maximum": 7776000000,
                        "description": "Time to perform and confirm (or contest) a settlement; afterwards uncontested proof ends HONORED, missing or contested proof ends BREACH_REPORTED. Milliseconds, platform limits 86400000-7776000000 (1 d to 90 d), default 604800000 (7 d)"
                      },
                      "proposalFromRound": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      "maxIssueProposals": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      "feeMode": {
                        "type": "string",
                        "const": "FILER_PAYS",
                        "description": "FILER_PAYS: the claimant covers the flat filing fee at POST /v1/disputes so joining costs the respondent $0.00 and requires zero crypto/x402 wallet setup."
                      }
                    },
                    "additionalProperties": false
                  },
                  "webhookUrl": {
                    "type": "string",
                    "maxLength": 2048
                  },
                  "respondentContact": {
                    "description": "Optional contact channels for notifying the respondent (unverified claimant-supplied contacts deliver notice without authorising RESPONDENT_NO_SHOW)",
                    "type": "object",
                    "properties": {
                      "webhookUrl": {
                        "description": "HTTPS webhook URL for RFC 9421 signed dispute notices",
                        "type": "string",
                        "maxLength": 2048
                      },
                      "a2aCardUrl": {
                        "description": "HTTPS URL of the agent's A2A Agent Card",
                        "type": "string",
                        "maxLength": 2048
                      },
                      "didWeb": {
                        "description": "Agent's did:web identifier",
                        "type": "string",
                        "maxLength": 512,
                        "pattern": "^did:web:[A-Za-z0-9._%:-]+$"
                      },
                      "email": {
                        "description": "Optional operator email",
                        "type": "string",
                        "maxLength": 320,
                        "pattern": "^[A-Za-z0-9.!#$%&'*+/=?^_`{|}~-]+@[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$"
                      }
                    },
                    "additionalProperties": false
                  },
                  "clause": {
                    "description": "Optional co-signed pre-dispute mediation clause (agent-mediate/clause/v1)",
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string",
                        "const": "agent-mediate/clause/v1"
                      },
                      "contractHash": {
                        "type": "string",
                        "pattern": "^[a-f0-9]{64}$"
                      },
                      "platform": {
                        "type": "object",
                        "properties": {
                          "did": {
                            "type": "string",
                            "maxLength": 128
                          },
                          "baseUrl": {
                            "type": "string",
                            "maxLength": 2048
                          },
                          "rulesVersion": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          },
                          "rulesHash": {
                            "description": "Optional 64-char lowercase hex SHA-256 of canonical MECHANISM_SPEC (DISC-11)",
                            "type": "string",
                            "pattern": "^[a-f0-9]{64}$"
                          }
                        },
                        "required": [
                          "did",
                          "rulesVersion"
                        ],
                        "additionalProperties": false
                      },
                      "parties": {
                        "type": "array",
                        "prefixItems": [
                          {
                            "type": "object",
                            "properties": {
                              "agentId": {
                                "type": "string",
                                "maxLength": 128,
                                "description": "Agent's Ed25519 did:key"
                              },
                              "principalId": {
                                "description": "Optional principal Ed25519 did:key",
                                "type": "string",
                                "maxLength": 128
                              },
                              "notice": {
                                "type": "object",
                                "properties": {
                                  "webhookUrl": {
                                    "description": "HTTPS webhook URL for RFC 9421 signed dispute notices",
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  "a2aCardUrl": {
                                    "description": "HTTPS URL of the agent's A2A Agent Card",
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  "didWeb": {
                                    "description": "Agent's did:web identifier",
                                    "type": "string",
                                    "maxLength": 512,
                                    "pattern": "^did:web:[A-Za-z0-9._%:-]+$"
                                  },
                                  "email": {
                                    "description": "Optional operator email",
                                    "type": "string",
                                    "maxLength": 320,
                                    "pattern": "^[A-Za-z0-9.!#$%&'*+/=?^_`{|}~-]+@[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$"
                                  }
                                },
                                "additionalProperties": false,
                                "description": "Agent contact endpoints for dispute notices"
                              }
                            },
                            "required": [
                              "agentId"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "agentId": {
                                "type": "string",
                                "maxLength": 128,
                                "description": "Agent's Ed25519 did:key"
                              },
                              "principalId": {
                                "description": "Optional principal Ed25519 did:key",
                                "type": "string",
                                "maxLength": 128
                              },
                              "notice": {
                                "type": "object",
                                "properties": {
                                  "webhookUrl": {
                                    "description": "HTTPS webhook URL for RFC 9421 signed dispute notices",
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  "a2aCardUrl": {
                                    "description": "HTTPS URL of the agent's A2A Agent Card",
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  "didWeb": {
                                    "description": "Agent's did:web identifier",
                                    "type": "string",
                                    "maxLength": 512,
                                    "pattern": "^did:web:[A-Za-z0-9._%:-]+$"
                                  },
                                  "email": {
                                    "description": "Optional operator email",
                                    "type": "string",
                                    "maxLength": 320,
                                    "pattern": "^[A-Za-z0-9.!#$%&'*+/=?^_`{|}~-]+@[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$"
                                  }
                                },
                                "additionalProperties": false,
                                "description": "Agent contact endpoints for dispute notices"
                              }
                            },
                            "required": [
                              "agentId"
                            ],
                            "additionalProperties": false
                          }
                        ],
                        "items": false,
                        "minItems": 2,
                        "maxItems": 2
                      },
                      "terms": {
                        "type": "object",
                        "properties": {
                          "feeMode": {
                            "description": "FILER_PAYS: the filing party pays the flat fee at POST /v1/disputes so joining costs the respondent $0.00.",
                            "type": "string",
                            "const": "FILER_PAYS"
                          },
                          "windows": {
                            "type": "object",
                            "properties": {
                              "joinTimeoutMs": {
                                "type": "integer",
                                "minimum": 86400000,
                                "maximum": 2592000000,
                                "description": "Minimum join window. Milliseconds, platform limits 86400000-2592000000 (1 d to 30 d), default 86400000 (1 d)"
                              },
                              "stageTimeoutMs": {
                                "type": "integer",
                                "minimum": 600000,
                                "maximum": 604800000,
                                "description": "Minimum evidence and issue-confirmation windows. Milliseconds, platform limits 600000-604800000 (10 min to 7 d), default 1800000 (30 min)"
                              },
                              "roundTimeoutMs": {
                                "type": "integer",
                                "minimum": 120000,
                                "maximum": 3600000,
                                "description": "Minimum bargaining round window. Milliseconds, platform limits 120000-3600000 (2 min to 1 h), default 120000 (2 min)"
                              },
                              "bargainingWallClockMs": {
                                "type": "integer",
                                "minimum": 600000,
                                "maximum": 3600000,
                                "description": "Minimum overall bargaining window. Milliseconds, platform limits 600000-3600000 (10 min to 1 h), default 900000 (15 min)"
                              },
                              "determinationTimeoutMs": {
                                "type": "integer",
                                "minimum": 300000,
                                "maximum": 86400000,
                                "description": "Minimum final-offer window. Milliseconds, platform limits 300000-86400000 (5 min to 1 d), default 600000 (10 min)"
                              },
                              "executionTimeoutMs": {
                                "type": "integer",
                                "minimum": 86400000,
                                "maximum": 7776000000,
                                "description": "Minimum execution window. Milliseconds, platform limits 86400000-7776000000 (1 d to 90 d), default 604800000 (7 d)"
                              }
                            },
                            "additionalProperties": false
                          },
                          "determinationConsent": {
                            "type": "boolean"
                          },
                          "discloseGapOnFailure": {
                            "type": "boolean"
                          },
                          "issueTemplates": {
                            "maxItems": 5,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "pattern": "^[a-z][A-Za-z0-9]{0,23}$",
                                  "description": "lowerCamelCase identifier (1-24 letters and digits), unique within the dispute"
                                },
                                "label": {
                                  "type": "string"
                                },
                                "unit": {
                                  "type": "string"
                                },
                                "min": {
                                  "type": "number"
                                },
                                "max": {
                                  "type": "number"
                                },
                                "step": {
                                  "type": "number",
                                  "description": "(max - min) must be a multiple of step"
                                },
                                "claimantPrefers": {
                                  "type": "string",
                                  "enum": [
                                    "higher",
                                    "lower"
                                  ]
                                },
                                "obligor": {
                                  "type": "string",
                                  "enum": [
                                    "claimant",
                                    "respondent"
                                  ],
                                  "description": "party that performs this term if settled"
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "unit",
                                "min",
                                "max",
                                "step",
                                "claimantPrefers",
                                "obligor"
                              ],
                              "additionalProperties": false,
                              "description": "A negotiable dimension, e.g. a refund amount"
                            }
                          }
                        },
                        "additionalProperties": false
                      },
                      "issuedAt": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      "expiresAt": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      "signatures": {
                        "minItems": 2,
                        "maxItems": 2,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "partyAgentId": {
                              "type": "string",
                              "maxLength": 128
                            },
                            "signerId": {
                              "type": "string",
                              "maxLength": 128
                            },
                            "signature": {
                              "type": "string",
                              "maxLength": 200
                            }
                          },
                          "required": [
                            "partyAgentId",
                            "signerId",
                            "signature"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "type",
                      "contractHash",
                      "platform",
                      "parties",
                      "issuedAt",
                      "signatures"
                    ],
                    "additionalProperties": false
                  },
                  "requireDelivery": {
                    "description": "When true, verifies x402 payment ($0.00 moved when fees are enabled) and confirms respondent notice delivery (2xx on webhook/A2A/email) BEFORE creating the dispute or settling any filing fee, returning 422 RESPONDENT_UNREACHABLE with $0.00 charged if unreachable",
                    "type": "boolean"
                  },
                  "inviteId": {
                    "description": "Optional accepted pre-filing invite ID (from POST /v1/invites) whose respondent-verified endpoint routes the formal dispute notice",
                    "type": "string",
                    "maxLength": 64
                  }
                },
                "required": [
                  "respondentId",
                  "contractHash",
                  "claim",
                  "mandate",
                  "proposedIssues"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FilingResponse"
                }
              }
            }
          },
          "402": {
            "description": "Payment required when x402 fees are active (Flat filing fee (FILER_PAYS)). Currently waived on this deployment (fees.waived = true; $0.00, no 402 returned).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}": {
      "get": {
        "operationId": "get_dispute",
        "summary": "Your view of the dispute (never counterparty confidential data) plus AI advisory. Party-written free text is listed in view.untrusted.fields",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "view",
            "description": "Response projection: 'full' (default, complete PartyView) or 'compact' (stage-projected CompactPartyView with nextActions and proposalWithinYourMandate for LLM/MCP context budgets)",
            "schema": {
              "type": "string",
              "enum": [
                "full",
                "compact"
              ],
              "default": "full"
            },
            "in": "query",
            "required": false
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisputeResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/events": {
      "get": {
        "operationId": "list_events",
        "summary": "Events visible to you after a sequence number. Party-written free text is listed in event.untrusted",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "after",
            "in": "query",
            "required": false,
            "description": "Return events with seq greater than this (default 0)",
            "schema": {
              "type": "integer",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventList"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/audit": {
      "get": {
        "operationId": "get_audit_chain",
        "summary": "Public hash chain (commitments only) plus checkpoint Merkle inclusion proof. Unseen entries are opaque links",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AuditChain"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/signatures": {
      "get": {
        "operationId": "get_dispute_signatures",
        "summary": "Verified RFC 9421 Ed25519 request signature proofs (confidential counterparty bodies redacted to proofHash)",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisputeSignatureList"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/outcome": {
      "get": {
        "operationId": "get_outcome",
        "summary": "Immutable transition-signed settlement instruction or UNRESOLVED certificate",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SignedOutcome"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/join": {
      "post": {
        "operationId": "join_dispute",
        "summary": "Join with your mandate",
        "description": "Caller: respondent.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "view",
            "description": "Response projection: 'full' (default, complete PartyView) or 'compact' (stage-projected CompactPartyView with nextActions and proposalWithinYourMandate for LLM/MCP context budgets)",
            "schema": {
              "type": "string",
              "enum": [
                "full",
                "compact"
              ],
              "default": "full"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mandate": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "maxLength": 128
                      },
                      "principalId": {
                        "type": "string",
                        "maxLength": 128,
                        "description": "Principal's Ed25519 did:key"
                      },
                      "agentId": {
                        "type": "string",
                        "maxLength": 128,
                        "description": "Your agent's did:key"
                      },
                      "bounds": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "object",
                          "properties": {
                            "min": {
                              "type": "number"
                            },
                            "max": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "min",
                            "max"
                          ],
                          "additionalProperties": false
                        },
                        "description": "Per-issue authority limits"
                      },
                      "determinationConsent": {
                        "description": "Principal-signed opt-in to binding final-offer determination if bargaining ends NO_OVERLAP_AT_CAP or STALLED (both parties' mandates must opt in). A contractual determination by a published rule agreed in advance, not statutory arbitration or an arbitral award",
                        "type": "boolean"
                      },
                      "determinationBounds": {
                        "description": "Optional per-issue authority limits for binding final-offer determination (may be tighter OR wider than voluntary bargaining bounds so cautious bargaining authority can pair with wider contingency determination bounds); defaults to bounds",
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "object",
                          "properties": {
                            "min": {
                              "type": "number"
                            },
                            "max": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "min",
                            "max"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "expiresAt": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991,
                        "description": "Unix milliseconds; must cover the remaining bargaining wall-clock window (plus determinationTimeoutMs if determinationConsent is true)"
                      },
                      "issuedAt": {
                        "description": "Unix milliseconds. Required when replacing a mandate (at issue confirmation or via update_mandate); must be strictly later than the replaced mandate's issuedAt",
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      "scope": {
                        "description": "Optional, signed: limit this mandate to one contract and/or counterparty so it cannot be reused in another dispute",
                        "type": "object",
                        "properties": {
                          "contractHash": {
                            "type": "string",
                            "pattern": "^[0-9a-f]{64}$"
                          },
                          "counterpartyId": {
                            "type": "string",
                            "maxLength": 128
                          }
                        },
                        "additionalProperties": false
                      },
                      "signature": {
                        "type": "string",
                        "maxLength": 200,
                        "description": "Ed25519 over 'agent-mediate/mandate/v1\\n' + canonical JSON of the other fields"
                      }
                    },
                    "required": [
                      "id",
                      "principalId",
                      "agentId",
                      "bounds",
                      "expiresAt",
                      "signature"
                    ],
                    "additionalProperties": false,
                    "description": "Principal-signed authority for your agent. Offers outside the bounds are rejected."
                  },
                  "discloseGapOnFailure": {
                    "description": "Default false (or clause.terms.discloseGapOnFailure when a clause was supplied at filing)",
                    "type": "boolean"
                  },
                  "webhookUrl": {
                    "type": "string",
                    "maxLength": 2048
                  },
                  "windows": {
                    "description": "Lengthen any of the claimant's windows (never shorten): each effective window is the longer of the two",
                    "type": "object",
                    "properties": {
                      "roundTimeoutMs": {
                        "type": "integer",
                        "minimum": 120000,
                        "maximum": 3600000,
                        "description": "Time per bargaining round. Milliseconds, platform limits 120000-3600000 (2 min to 1 h), default 120000 (2 min)"
                      },
                      "bargainingWallClockMs": {
                        "type": "integer",
                        "minimum": 600000,
                        "maximum": 3600000,
                        "description": "Overall bargaining time limit. Milliseconds, platform limits 600000-3600000 (10 min to 1 h), default 900000 (15 min)"
                      },
                      "stageTimeoutMs": {
                        "type": "integer",
                        "minimum": 600000,
                        "maximum": 604800000,
                        "description": "Evidence and issue-confirmation windows. Milliseconds, platform limits 600000-604800000 (10 min to 7 d), default 1800000 (30 min)"
                      },
                      "determinationTimeoutMs": {
                        "type": "integer",
                        "minimum": 300000,
                        "maximum": 86400000,
                        "description": "Final-offer window in binding determination. Milliseconds, platform limits 300000-86400000 (5 min to 1 d), default 600000 (10 min)"
                      },
                      "executionTimeoutMs": {
                        "type": "integer",
                        "minimum": 86400000,
                        "maximum": 7776000000,
                        "description": "Time to perform a settlement. Milliseconds, platform limits 86400000-7776000000 (1 d to 90 d), default 604800000 (7 d)"
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "required": [
                  "mandate"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisputeResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/evidence": {
      "post": {
        "operationId": "submit_evidence",
        "summary": "Submit evidence hashes and public descriptions",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "view",
            "description": "Response projection: 'full' (default, complete PartyView) or 'compact' (stage-projected CompactPartyView with nextActions and proposalWithinYourMandate for LLM/MCP context budgets)",
            "schema": {
              "type": "string",
              "enum": [
                "full",
                "compact"
              ],
              "default": "full"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "items": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,63}$",
                          "description": "Identifier, unique within the dispute: 1-64 of A-Z a-z 0-9 _ . : - (security review L9)"
                        },
                        "kind": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$",
                          "description": "Hash of the evidence content; content itself is not uploaded"
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 1000,
                          "description": "Public to both parties and to the AI advisory"
                        }
                      },
                      "required": [
                        "id",
                        "kind",
                        "sha256",
                        "description"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "items"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisputeResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/evidence/close": {
      "post": {
        "operationId": "close_evidence",
        "summary": "Close your evidence",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "view",
            "description": "Response projection: 'full' (default, complete PartyView) or 'compact' (stage-projected CompactPartyView with nextActions and proposalWithinYourMandate for LLM/MCP context budgets)",
            "schema": {
              "type": "string",
              "enum": [
                "full",
                "compact"
              ],
              "default": "full"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisputeResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/issues/confirm": {
      "post": {
        "operationId": "confirm_issues",
        "summary": "Confirm the exact proposed issue list",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "view",
            "description": "Response projection: 'full' (default, complete PartyView) or 'compact' (stage-projected CompactPartyView with nextActions and proposalWithinYourMandate for LLM/MCP context budgets)",
            "schema": {
              "type": "string",
              "enum": [
                "full",
                "compact"
              ],
              "default": "full"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "issuesHash": {
                    "type": "string",
                    "pattern": "^[a-f0-9]{64}$",
                    "description": "Exact proposedHash from your view"
                  },
                  "mandate": {
                    "description": "Replacement mandate, required if proposed issues are not covered by your current one",
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "maxLength": 128
                      },
                      "principalId": {
                        "type": "string",
                        "maxLength": 128,
                        "description": "Principal's Ed25519 did:key"
                      },
                      "agentId": {
                        "type": "string",
                        "maxLength": 128,
                        "description": "Your agent's did:key"
                      },
                      "bounds": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "object",
                          "properties": {
                            "min": {
                              "type": "number"
                            },
                            "max": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "min",
                            "max"
                          ],
                          "additionalProperties": false
                        },
                        "description": "Per-issue authority limits"
                      },
                      "determinationConsent": {
                        "description": "Principal-signed opt-in to binding final-offer determination if bargaining ends NO_OVERLAP_AT_CAP or STALLED (both parties' mandates must opt in). A contractual determination by a published rule agreed in advance, not statutory arbitration or an arbitral award",
                        "type": "boolean"
                      },
                      "determinationBounds": {
                        "description": "Optional per-issue authority limits for binding final-offer determination (may be tighter OR wider than voluntary bargaining bounds so cautious bargaining authority can pair with wider contingency determination bounds); defaults to bounds",
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "object",
                          "properties": {
                            "min": {
                              "type": "number"
                            },
                            "max": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "min",
                            "max"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "expiresAt": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991,
                        "description": "Unix milliseconds; must cover the remaining bargaining wall-clock window (plus determinationTimeoutMs if determinationConsent is true)"
                      },
                      "issuedAt": {
                        "description": "Unix milliseconds. Required when replacing a mandate (at issue confirmation or via update_mandate); must be strictly later than the replaced mandate's issuedAt",
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      "scope": {
                        "description": "Optional, signed: limit this mandate to one contract and/or counterparty so it cannot be reused in another dispute",
                        "type": "object",
                        "properties": {
                          "contractHash": {
                            "type": "string",
                            "pattern": "^[0-9a-f]{64}$"
                          },
                          "counterpartyId": {
                            "type": "string",
                            "maxLength": 128
                          }
                        },
                        "additionalProperties": false
                      },
                      "signature": {
                        "type": "string",
                        "maxLength": 200,
                        "description": "Ed25519 over 'agent-mediate/mandate/v1\\n' + canonical JSON of the other fields"
                      }
                    },
                    "required": [
                      "id",
                      "principalId",
                      "agentId",
                      "bounds",
                      "expiresAt",
                      "signature"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "issuesHash"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisputeResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/issues/reject": {
      "post": {
        "operationId": "reject_issues",
        "summary": "Reject the proposed issue list (optionally adopting advisory.suggestedIssues)",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "view",
            "description": "Response projection: 'full' (default, complete PartyView) or 'compact' (stage-projected CompactPartyView with nextActions and proposalWithinYourMandate for LLM/MCP context budgets)",
            "schema": {
              "type": "string",
              "enum": [
                "full",
                "compact"
              ],
              "default": "full"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "issuesHash": {
                    "type": "string",
                    "pattern": "^[a-f0-9]{64}$",
                    "description": "Exact proposedHash from your view"
                  },
                  "adoptSuggestedIds": {
                    "description": "Optional 1-2 issue IDs from advisory.suggestedIssues to append to filing.proposedIssues in the next issue proposal so both parties can resolve a single-issue impasse via multi-issue trade-offs (v1.3.0)",
                    "minItems": 1,
                    "maxItems": 2,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z][A-Za-z0-9]{0,23}$"
                    }
                  }
                },
                "required": [
                  "issuesHash"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisputeResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/mandate": {
      "post": {
        "operationId": "update_mandate",
        "summary": "Monotonically widen your principal-signed mandate during BARGAINING or DETERMINATION",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "view",
            "description": "Response projection: 'full' (default, complete PartyView) or 'compact' (stage-projected CompactPartyView with nextActions and proposalWithinYourMandate for LLM/MCP context budgets)",
            "schema": {
              "type": "string",
              "enum": [
                "full",
                "compact"
              ],
              "default": "full"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mandate": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "maxLength": 128
                      },
                      "principalId": {
                        "type": "string",
                        "maxLength": 128,
                        "description": "Principal's Ed25519 did:key"
                      },
                      "agentId": {
                        "type": "string",
                        "maxLength": 128,
                        "description": "Your agent's did:key"
                      },
                      "bounds": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "object",
                          "properties": {
                            "min": {
                              "type": "number"
                            },
                            "max": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "min",
                            "max"
                          ],
                          "additionalProperties": false
                        },
                        "description": "Per-issue authority limits"
                      },
                      "determinationConsent": {
                        "description": "Principal-signed opt-in to binding final-offer determination if bargaining ends NO_OVERLAP_AT_CAP or STALLED (both parties' mandates must opt in). A contractual determination by a published rule agreed in advance, not statutory arbitration or an arbitral award",
                        "type": "boolean"
                      },
                      "determinationBounds": {
                        "description": "Optional per-issue authority limits for binding final-offer determination (may be tighter OR wider than voluntary bargaining bounds so cautious bargaining authority can pair with wider contingency determination bounds); defaults to bounds",
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "object",
                          "properties": {
                            "min": {
                              "type": "number"
                            },
                            "max": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "min",
                            "max"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "expiresAt": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991,
                        "description": "Unix milliseconds; must cover the remaining bargaining wall-clock window (plus determinationTimeoutMs if determinationConsent is true)"
                      },
                      "issuedAt": {
                        "description": "Unix milliseconds. Required when replacing a mandate (at issue confirmation or via update_mandate); must be strictly later than the replaced mandate's issuedAt",
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      "scope": {
                        "description": "Optional, signed: limit this mandate to one contract and/or counterparty so it cannot be reused in another dispute",
                        "type": "object",
                        "properties": {
                          "contractHash": {
                            "type": "string",
                            "pattern": "^[0-9a-f]{64}$"
                          },
                          "counterpartyId": {
                            "type": "string",
                            "maxLength": 128
                          }
                        },
                        "additionalProperties": false
                      },
                      "signature": {
                        "type": "string",
                        "maxLength": 200,
                        "description": "Ed25519 over 'agent-mediate/mandate/v1\\n' + canonical JSON of the other fields"
                      }
                    },
                    "required": [
                      "id",
                      "principalId",
                      "agentId",
                      "bounds",
                      "expiresAt",
                      "signature"
                    ],
                    "additionalProperties": false,
                    "description": "Principal-signed monotonically widened mandate (same principalId, strictly newer issuedAt, non-shortened expiresAt, superset bounds/determinationBounds; at most 3 updates per party during BARGAINING or DETERMINATION)"
                  }
                },
                "required": [
                  "mandate"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisputeResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/rounds/{round}/offer": {
      "post": {
        "operationId": "submit_offer",
        "summary": "Submit a sealed offer for the open round",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "round",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "view",
            "description": "Response projection: 'full' (default, complete PartyView) or 'compact' (stage-projected CompactPartyView with nextActions and proposalWithinYourMandate for LLM/MCP context budgets)",
            "schema": {
              "type": "string",
              "enum": [
                "full",
                "compact"
              ],
              "default": "full"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "offer": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "type": "number"
                    },
                    "description": "Sealed: never shown to the counterparty"
                  },
                  "private": {
                    "description": "Required with your first offer. Confidential: never shown to anyone or any AI model.",
                    "type": "object",
                    "properties": {
                      "weights": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "number"
                        },
                        "description": "Non-negative, sum to 1"
                      },
                      "walkaway": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "number"
                        },
                        "description": "Worst package you would accept"
                      },
                      "limits": {
                        "description": "Optional per-issue hard limits for platform proposals and post-settlement Pareto improvements (must contain walkaway and lie within your mandate bounds; MECH-7)",
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "object",
                          "properties": {
                            "min": {
                              "type": "number"
                            },
                            "max": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "min",
                            "max"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "weights",
                      "walkaway"
                    ],
                    "additionalProperties": false
                  },
                  "proposalResponse": {
                    "description": "Required while a platform proposal is open",
                    "type": "string",
                    "enum": [
                      "accept",
                      "reject"
                    ]
                  }
                },
                "required": [
                  "offer"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisputeResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/determination/final-offer": {
      "post": {
        "operationId": "submit_final_offer",
        "summary": "Final offer for binding final-offer determination",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "view",
            "description": "Response projection: 'full' (default, complete PartyView) or 'compact' (stage-projected CompactPartyView with nextActions and proposalWithinYourMandate for LLM/MCP context budgets)",
            "schema": {
              "type": "string",
              "enum": [
                "full",
                "compact"
              ],
              "default": "full"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "offer": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "type": "number"
                    },
                    "description": "One value per confirmed issue id"
                  }
                },
                "required": [
                  "offer"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisputeResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/execution/improvement": {
      "post": {
        "operationId": "respond_improvement",
        "summary": "Accept or decline an open post-settlement Pareto improvement before execution proof",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "view",
            "description": "Response projection: 'full' (default, complete PartyView) or 'compact' (stage-projected CompactPartyView with nextActions and proposalWithinYourMandate for LLM/MCP context budgets)",
            "schema": {
              "type": "string",
              "enum": [
                "full",
                "compact"
              ],
              "default": "full"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "response": {
                    "type": "string",
                    "enum": [
                      "accept",
                      "decline"
                    ],
                    "description": "Accept or decline an open post-settlement Pareto improvement (upgrades settlement terms only if both accept before execution proof; MECH-10)"
                  }
                },
                "required": [
                  "response"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisputeResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/execution/proof": {
      "post": {
        "operationId": "submit_execution_proof",
        "summary": "Prove you performed your settlement obligations",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "view",
            "description": "Response projection: 'full' (default, complete PartyView) or 'compact' (stage-projected CompactPartyView with nextActions and proposalWithinYourMandate for LLM/MCP context budgets)",
            "schema": {
              "type": "string",
              "enum": [
                "full",
                "compact"
              ],
              "default": "full"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reference": {
                    "type": "string",
                    "maxLength": 500,
                    "description": "e.g. a transaction hash"
                  }
                },
                "required": [
                  "reference"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisputeResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/execution/confirm": {
      "post": {
        "operationId": "confirm_execution",
        "summary": "Confirm the counterparty performed",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "view",
            "description": "Response projection: 'full' (default, complete PartyView) or 'compact' (stage-projected CompactPartyView with nextActions and proposalWithinYourMandate for LLM/MCP context budgets)",
            "schema": {
              "type": "string",
              "enum": [
                "full",
                "compact"
              ],
              "default": "full"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisputeResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/execution/contest": {
      "post": {
        "operationId": "contest_execution",
        "summary": "Contest the counterparty's execution proof before the execution deadline",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "view",
            "description": "Response projection: 'full' (default, complete PartyView) or 'compact' (stage-projected CompactPartyView with nextActions and proposalWithinYourMandate for LLM/MCP context budgets)",
            "schema": {
              "type": "string",
              "enum": [
                "full",
                "compact"
              ],
              "default": "full"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reason": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000,
                    "description": "Why the counterparty's execution proof does not satisfy the settlement obligation (party-written free text)"
                  }
                },
                "required": [
                  "reason"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisputeResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/cure": {
      "post": {
        "operationId": "acknowledge_cure",
        "summary": "Acknowledge counterparty cure of a defaulted breach or verified no-show",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reference": {
                    "description": "Optional remedial execution reference (e.g. a late on-chain transaction hash or re-filed dispute ID)",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500
                  },
                  "note": {
                    "description": "Optional party-authored note acknowledging late settlement performance or waiving a respondent no-show",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  }
                },
                "additionalProperties": false,
                "description": "Counterparty-signed acknowledgement curing a BREACH_REPORTED obligation or waiving a verified RESPONDENT_NO_SHOW ($0.00; starts 30-day Honours probation)"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CureAcknowledgementResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/disputes/{id}/withdraw": {
      "post": {
        "operationId": "withdraw",
        "summary": "Withdraw (not allowed during binding final-offer determination)",
        "description": "Caller: party.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "view",
            "description": "Response projection: 'full' (default, complete PartyView) or 'compact' (stage-projected CompactPartyView with nextActions and proposalWithinYourMandate for LLM/MCP context budgets)",
            "schema": {
              "type": "string",
              "enum": [
                "full",
                "compact"
              ],
              "default": "full"
            },
            "in": "query",
            "required": false
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "8-128 URL-safe characters. Reuse it when retrying, including the paid retry after a 402.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_\\-:.]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisputeResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    }
  }
}